diff --git a/cloud/assets/portal-product-details-edit-storage-premium-ssd-v2.png b/cloud/assets/portal-product-details-edit-storage-premium-ssd-v2.png new file mode 100644 index 0000000000..8012ddc5be Binary files /dev/null and b/cloud/assets/portal-product-details-edit-storage-premium-ssd-v2.png differ diff --git a/cloud/assets/portal-product-details-migrate-to-data-disk-premium-v2.png b/cloud/assets/portal-product-details-migrate-to-data-disk-premium-v2.png new file mode 100644 index 0000000000..47bef251ea Binary files /dev/null and b/cloud/assets/portal-product-details-migrate-to-data-disk-premium-v2.png differ diff --git a/cloud/assets/portal-product-details-storage-upgrade-to-premium-v2.png b/cloud/assets/portal-product-details-storage-upgrade-to-premium-v2.png new file mode 100644 index 0000000000..fdc49373d3 Binary files /dev/null and b/cloud/assets/portal-product-details-storage-upgrade-to-premium-v2.png differ diff --git a/cloud/assets/portal-product-details-upgrade-to-premium-v2-modal.png b/cloud/assets/portal-product-details-upgrade-to-premium-v2-modal.png new file mode 100644 index 0000000000..7771ed26e6 Binary files /dev/null and b/cloud/assets/portal-product-details-upgrade-to-premium-v2-modal.png differ diff --git a/cloud/cloud-scaling.mdx b/cloud/cloud-scaling.mdx index 8afec568e2..c8f723d61f 100644 --- a/cloud/cloud-scaling.mdx +++ b/cloud/cloud-scaling.mdx @@ -137,13 +137,75 @@ running on a Disk of size for which a given *Performance Tier* is the default one. -### Data disks +#### Azure Premium SSD v2 {#azure-premium-ssd-v2} + +**Premium SSD v2** is an Azure disk type available alongside **Standard** and **Premium**. It offers +**IOPS** and **Throughput** that can be configured independently of the disk size, giving you finer +control over storage performance and cost. + +!["Figure - Azure Premium SSD v2 storage edit form with editable IOPS and Throughput"](./assets/portal-product-details-edit-storage-premium-ssd-v2.png) + +**Availability and constraints:** + +* Available **only as a data disk** — it cannot be used as the OS disk. This means **Premium SSD v2** + is offered only for products that use the **Single Data Disk** layout (see [Data disks](#data-disks)). + Products with the *Root Only* disk layout use **Premium SSD v1**; **Premium SSD v2** is not available + for them. +* Not available for **PN\*** (ephemeral) instance types of the *Performance Tier*. +* Not available for products on a **yearly** payment plan. +* Available only in **Azure regions that support Premium SSD v2**. The portal automatically detects + the region and shows the option only when it qualifies. +* Unlike **Premium**, **Premium SSD v2** does **not** offer an *Azure Performance Tier* customization. +* **IOPS** and **Throughput** are configurable independently of the disk size. The available + **Throughput** range depends on the configured **IOPS** value. + + +Switching to **Premium SSD v2** is a **one-way operation**: + +* **Downgrade from Premium SSD v2 to Standard** is **not possible** when using the *Single Data Disk* + layout. +* **Downgrade from Premium SSD v2 to Premium (v1)** is **not possible**. + +Plan the change carefully — once a product is on **Premium SSD v2**, it cannot be moved back. + + +There are two ways to start using **Premium SSD v2**: + +1. **Migrate the storage to a Data Disk** — when the product's region supports **Premium SSD v2**, + the new data disk is automatically created as **Premium SSD v2**. The migration modal indicates + when this is the case. See [Data disks](#data-disks). +2. **Upgrade an existing Premium Single Data disk to Premium SSD v2** — if your product already + runs on a **Premium** *Single Data Disk* and is eligible, the **Upgrade to Premium V2** button + is shown in the *Storage* section of the product page. See + [Managing an Existing Product](../cloud/portal/cloud-portal-products-tab.mdx#change-instance-type-and-storage) + in the portal documentation. + +!["Figure - Upgrade to Azure Premium SSD v2 modal with IOPS and Throughput fields"](./assets/portal-product-details-upgrade-to-premium-v2-modal.png) + +The upgrade is performed **node by node**. Each node being migrated is briefly unavailable, and the +full operation may take **multiple hours** to complete. The migration uses your current **IOPS** and +**Throughput** values; you can adjust them afterwards from the storage settings. + + +For **Premium SSD v2**, **IOPS** and **Throughput** are billed separately from disk capacity. +For up-to-date rates, see the [Pricing page](https://cloud.ravendb.net/pricing). + + +### Data disks {#data-disks} **Data Disks** are dedicated storage volumes used exclusively for RavenDB data. They are available for instances running in the *Production Tier*. These disks are entirely separate from the operating system disk, which remains isolated to ensure system stability and optimal performance. The use of a data disk is mandatory for deployments requiring more than 1TB of storage. **Data Disk** can be selected during instance creation or migrated to on already existing instances. + +!["Figure - Migrate to data disk modal showing Premium SSD v2 information"](./assets/portal-product-details-migrate-to-data-disk-premium-v2.png) + + +On **Azure**, when the product's region supports **Premium SSD v2**, migrating to a Data Disk +automatically creates the new data disk as **Premium SSD v2**. The migration modal indicates this. +See [Azure Premium SSD v2](#azure-premium-ssd-v2) for capabilities and constraints. + ### GCP Disks diff --git a/cloud/portal/assets/portal-product-details-storage-upgrade-to-premium-v2.png b/cloud/portal/assets/portal-product-details-storage-upgrade-to-premium-v2.png new file mode 100644 index 0000000000..e62e1155eb Binary files /dev/null and b/cloud/portal/assets/portal-product-details-storage-upgrade-to-premium-v2.png differ diff --git a/cloud/portal/cloud-portal-products-tab.mdx b/cloud/portal/cloud-portal-products-tab.mdx index 1d6ed48524..cc96c6b81a 100644 --- a/cloud/portal/cloud-portal-products-tab.mdx +++ b/cloud/portal/cloud-portal-products-tab.mdx @@ -165,7 +165,14 @@ You can view your configuration and change your product's instance type and stor !["Figure 17 - Manage Product: Storage"](./assets/portal-product-details-storage.png) - More details can be found [here](../cloud-scaling.mdx#scaling---change-storage). + When eligible, the *Storage* section also shows an **Upgrade to Premium V2** button to upgrade + the disk to **Azure Premium SSD v2**. + +!["Figure 18 - Storage section with Upgrade to Premium V2 button"](./assets/portal-product-details-storage-upgrade-to-premium-v2.png) + + More details can be found [here](../cloud-scaling.mdx#scaling---change-storage). For + **Azure Premium SSD v2** — eligibility, constraints, and behavior of the upgrade — see + [Azure Premium SSD v2](../cloud-scaling.mdx#azure-premium-ssd-v2). ### Instance Access @@ -176,7 +183,7 @@ You can view your configuration and change your product's instance type and stor Use the security tab to download your [certificate](../../cloud/cloud-security.mdx) or determine which addresses are allowed to connect your database instance. -!["Figure 18 - Manage Product: Manage access"](./assets/portal-product-details-manage-access.png) +!["Figure 19 - Manage Product: Manage access"](./assets/portal-product-details-manage-access.png) * **Download Certificate** Click this button to download the **Initial Client Certificate**. This is an **operator-level** certificate used to perform cluster-wide operations (like creating/deleting databases) and for your first login to RavenDB Studio. @@ -202,12 +209,12 @@ allowed to connect your database instance. * **See audit logs** Click this button to view audit logs. A popup will show where you have to select a year and month. You can download audit logs from there. - !["Figure 19 - See audit logs"](./assets/portal-product-details-audit-logs.png) + !["Figure 20 - See audit logs"](./assets/portal-product-details-audit-logs.png) * **Edit** Click this button to edit your product's list of Allowed IPs. - !["Figure 20 - Manage Product: Edit IPs"](./assets/portal-product-details-allowed-ips.png) + !["Figure 21 - Manage Product: Edit IPs"](./assets/portal-product-details-allowed-ips.png) You can increase your system's security further using this in-depth security measure and restrict access to @@ -223,7 +230,7 @@ You can view features available for your product, enable, disable and configure After enabling features some of them must be configured to work properly. -!["Figure 21 - Manage Features: Configure or disable features"](./assets/portal-product-features-enabled.png) +!["Figure 22 - Manage Features: Configure or disable features"](./assets/portal-product-features-enabled.png) Available features are described on [Product Features](../cloud-features.mdx) page. @@ -231,14 +238,14 @@ Available features are described on [Product Features](../cloud-features.mdx) pa You can expand your cluster by adding *more product nodes* to your cluster. This helps improve *High Availability* and *task/load balancing*. -!["Figure 22 - Nodes: Manage additional nodes"](./assets/portal-product-nodes-additional-nodes.png) +!["Figure 23 - Nodes: Manage additional nodes"](./assets/portal-product-nodes-additional-nodes.png) More details can be found [here](../cloud-scaling.mdx#additional-product-nodes---general). ### Maintenance and Danger Zones You can restart your product nodes, deploy additional tools and terminate your product here. -!["Figure 23 - Manage Product: Maintenance and Termination"](./assets/portal-product-details-maintenance-and-termination.png) +!["Figure 24 - Manage Product: Maintenance and Termination"](./assets/portal-product-details-maintenance-and-termination.png) * **Maintenance Zone** Use this tab to restart selected node and deploy RavenDB tools. For *Serverless* products, you can switch to regular deployment. @@ -246,11 +253,11 @@ You can restart your product nodes, deploy additional tools and terminate your p Changing your product deployment type is **irreversible**. -!["Figure 24 - Manage Product: Storage"](./assets/portal-product-details-maintenance-zone.png) +!["Figure 25 - Manage Product: Storage"](./assets/portal-product-details-maintenance-zone.png) * **Danger Zone** Use this tab's **Terminate** button to eliminate your cluster. -!["Figure 25 - Manage Product: Terminate"](./assets/portal-product-details-terminate-product.png) +!["Figure 26 - Manage Product: Terminate"](./assets/portal-product-details-terminate-product.png) Terminating your instance is **irreversible**. Your data and cluster properties will be permanently lost.