Merge pull request #2721 from MicrosoftDocs/main

Auto Publish – main to live - 2025-12-03 23:00 UTC

Author: learn-build-service-prod[bot]

articles/service-fabric/service-fabric-how-to-remove-node-type.md

@@ -46,7 +46,7 @@ When removing a node type that is Bronze, all the nodes in the node type go down
     - All the services modified above are no longer running on the Node belonging to the node type.
     - All the services are healthy.
 
-3. Unmark the node-type as non-primary (Skip for non-primary node types)
+3. Mark the node type as non-primary (Skip for non-primary node types).
 
     - Locate the Azure Resource Manager template used for deployment.
     - Find the section related to the node type in the Service Fabric section.

articles/virtual-machines/disks-shared-enable.md

@@ -4,19 +4,19 @@ description: Configure an Azure managed disk with shared disks so that you can s
 author: roygara
 ms.service: azure-disk-storage
 ms.topic: how-to
-ms.date: 04/11/2023
+ms.date: 12/03/2025
 ms.author: rogarana
 ms.custom: devx-track-azurecli, devx-track-azurepowershell
 # Customer intent: As a cloud engineer, I want to configure shared disks for Azure managed disks, so that I can enable simultaneous access from multiple virtual machines to support clustered applications.
 ---
 
-# Enable shared disk
+# Enable shared disks
 
 **Applies to:** :heavy_check_mark: Linux VMs :heavy_check_mark: Windows VMs :heavy_check_mark: Flexible scale sets :heavy_check_mark: Uniform scale sets
 
-This article covers how to enable the shared disks feature for Azure managed disks. Azure shared disks is a new feature for Azure managed disks that enables you to attach a managed disk to multiple virtual machines (VMs) simultaneously. Attaching a managed disk to multiple VMs allows you to either deploy new or migrate existing clustered applications to Azure. 
-
-If you are looking for conceptual information on managed disks that have shared disks enabled, see [Azure shared disks](disks-shared.md).
+This article explains how to enable the shared disks feature for Azure managed disks. With Azure shared disks, you can attach a managed disk to multiple virtual machines (VMs) simultaneously, enabling the deployment or migration of clustered applications to Azure.
+ 
+If you're looking for conceptual information on managed disks that have shared disks enabled, see [Azure shared disks](disks-shared.md).
 
 ## Prerequisites
 
@@ -57,7 +57,7 @@ To deploy a managed disk with the shared disk feature enabled, use the new prope
 1. Select **+ Create** to create a new managed disk.
 1. Fill in the details and select an appropriate region, then select **Change size**.
 
-    :::image type="content" source="media/disks-shared-enable/create-shared-disk-basics-pane.png" alt-text="Screenshot of the create a managed disk pane, change size highlighted.." lightbox="media/disks-shared-enable/create-shared-disk-basics-pane.png":::
+    :::image type="content" source="media/disks-shared-enable/create-shared-disk-basics-pane.png" alt-text="Screenshot of the Azure portal showing the create a managed disk pane with the change size option highlighted." lightbox="media/disks-shared-enable/create-shared-disk-basics-pane.png":::
 
 1. Select the premium SSD size and SKU that you want and select **OK**.
 
@@ -196,7 +196,7 @@ To deploy a managed disk with the shared disk feature enabled, change the `maxSh
 1. Fill in the details, then select **Change size**.
 1. Select ultra disk for the **Disk SKU**.
 
-    :::image type="content" source="media/disks-shared-enable/select-ultra-shared-disk.png" alt-text="Screenshot of the disk SKU, ultra disk highlighted.." lightbox="media/disks-shared-enable/select-ultra-shared-disk.png":::
+    :::image type="content" source="media/disks-shared-enable/select-ultra-shared-disk.png" alt-text="Screenshot of the disk SKU, ultra disk highlighted." lightbox="media/disks-shared-enable/select-ultra-shared-disk.png":::
 
 1. Select the disk size that you want and select **OK**.
 1. Proceed through the deployment until you get to the **Advanced** pane.
@@ -279,7 +279,7 @@ To share an existing disk, or update how many VMs it can mount to, set the `maxS
 > Host caching isn't supported for shared disks.
 > 
 > The value of `maxShares` can only be set or changed when a disk is unmounted from all VMs. See the [Disk sizes](#disk-sizes) for the allowed values for `maxShares`.
-> Before detaching a disk, record the LUN ID for when you re-attach it.
+> Before detaching a disk, record the LUN ID for when you reattach it.
 
 ### PowerShell
 
@@ -300,12 +300,12 @@ az disk update --name mySharedDisk --max-shares 5 --resource-group myResourceGro
 
 ## Using Azure shared disks with your VMs
 
-Once you've deployed a shared disk with `maxShares>1`, you can mount the disk to one or more of your VMs.
+After you deploy a shared disk with `maxShares>1`, you can mount the disk to one or more of your VMs.
 
 > [!NOTE]
 > Host caching isn't supported for shared disks.
 > 
-> If you are deploying an ultra disk, make sure it matches the necessary requirements. See [Using Azure ultra disks](disks-enable-ultra-ssd.md) for details.
+> If you're deploying an ultra disk, make sure it matches the necessary requirements. See [Using Azure ultra disks](disks-enable-ultra-ssd.md) for details.
 
 ```azurepowershell-interactive
 
@@ -366,9 +366,4 @@ You also need to provide a persistent-reservation-key when using PR_RESERVE, PR_
 
 ## Next steps
 
-If you prefer to use Azure Resource Manager templates to deploy your disk, the following sample templates are available:
-- [Premium SSD](https://aka.ms/SharedPremiumDiskARMtemplate)
-- [Regional ultra disks](https://aka.ms/SharedUltraDiskARMtemplateRegional)
-- [Zonal ultra disks](https://aka.ms/SharedUltraDiskARMtemplateZonal)
-
-If you've additional questions, see the [shared disks](faq-for-disks.yml#azure-shared-disks) section of the FAQ.
+If you have more questions, see the [shared disks](faq-for-disks.yml#azure-shared-disks) section of the FAQ.

articles/virtual-machines/disks-shared.md

@@ -5,16 +5,16 @@ author: roygara
 ms.service: azure-disk-storage
 ms.custom: linux-related-content
 ms.topic: concept-article
-ms.date: 02/20/2024
+ms.date: 12/03/2025
 ms.author: rogarana
 # Customer intent: As a cloud architect, I want to understand how to share Azure managed disks across multiple VMs, so that I can effectively deploy and manage clustered applications in the cloud.
 ---
 
-# Share an Azure managed disk
+# Share an Azure managed disk across VMs
 
 **Applies to:** :heavy_check_mark: Linux VMs :heavy_check_mark: Windows VMs :heavy_check_mark: Flexible scale sets :heavy_check_mark: Uniform scale sets
 
-Azure shared disks is a feature for Azure managed disks that allow you to attach a managed disk to multiple virtual machines (VMs) simultaneously. Attaching a managed disk to multiple VMs allows you to either deploy new or migrate existing clustered applications to Azure.
+Azure shared disks is a feature for Azure managed disks that allows you to attach a managed disk to multiple virtual machines (VMs) simultaneously. This capability enables you to deploy new or migrate existing clustered applications to Azure without modifying your architecture. Shared disks ensure high availability for clustered applications, as other VMs in the cluster retain full access to the disk if one VM fails.
 
 Shared disks require a cluster manager, like Windows Server Failover Cluster (WSFC), or Pacemaker, that handles cluster node communication and write locking. Shared managed disks don't natively offer a fully managed file system that can be accessed using SMB/NFS.
 
@@ -36,13 +36,13 @@ Shared disks support several operating systems. See the [Windows](#windows) or [
 
 When you share a disk, your billing could be impacted in two different ways, depending on the type of disk.
 
-For shared premium SSD disks, in addition to cost of the disk's tier, there's an extra charge that increases with each VM the SSD is mounted to. See [managed disks pricing](https://azure.microsoft.com/pricing/details/managed-disks/) for details.
+For shared Premium SSD disks, in addition to cost of the disk's tier, there's an extra charge that increases with each VM the SSD is mounted to. See [managed disks pricing](https://azure.microsoft.com/pricing/details/managed-disks/) for details.
 
-Both shared ultra disks and shared premium SSD v2 disks don't have an extra charge for each VM that they're mounted to. They're billed on the total IOPS and MB/s that the disk is configured for. Normally, ultra disks and premium SSD v2 has two performance throttles that determine its total IOPS/MB/s. However, when configured as a shared disk, two more performance throttles are exposed, for a total of four. These two additional throttles allow for increased performance at an extra expense and each meter has a default value, which raises the performance and cost of the disk.
+Both shared Ultra Disks and shared Premium SSD v2 disks don't have an extra charge for each VM that they're mounted to. They're billed on the total IOPS and MB/s that the disk is configured for. Normally, Ultra Disks and Premium SSD v2 has two performance throttles that determine its total IOPS/MB/s. However, when configured as a shared disk, two more performance throttles are exposed, for a total of four. These two extra throttles allow for increased performance at an extra expense and each meter has a default value, which raises the performance and cost of the disk.
 
-The four performance throttles a shared ultra disk and shared premium SSD v2 disk have are diskIOPSReadWrite, diskMB/sReadWrite, diskIOPSReadOnly, and diskMB/sReadOnly. Each performance throttle can be configured to change the performance of your disk. The performance for shared ultra disk premium SSD v2 disk are calculated in the following ways: total provisioned IOPS (diskIOPSReadWrite + diskIOPSReadOnly) and for total provisioned throughput MB/s (diskMB/sReadWrite + diskMB/sReadOnly).
+The four performance throttles a shared Ultra Disk and shared Premium SSD v2 disk have are diskIOPSReadWrite, diskMB/sReadWrite, diskIOPSReadOnly, and diskMB/sReadOnly. Each performance throttle can be configured to change the performance of your disk. The performance of shared Ultra Disks and Premium SSD v2 disks are calculated in the following ways: total provisioned IOPS (diskIOPSReadWrite + diskIOPSReadOnly) and for total provisioned throughput MB/s (diskMB/sReadWrite + diskMB/sReadOnly).
 
-Once you've determined your total provisioned IOPS and total provisioned throughput, you can use them in the [pricing calculator](https://azure.microsoft.com/pricing/calculator/?service=managed-disks) to determine the cost of an ultra shared disk and a premium SSD v2 shared disk.
+Once you've determined your total provisioned IOPS and total provisioned throughput, you can use them in the [pricing calculator](https://azure.microsoft.com/pricing/calculator/?service=managed-disks) to determine the cost of an Ultra shared disk or a Premium SSD v2 shared disk.
 
 ## Disk sizes
 
@@ -58,9 +58,9 @@ Some popular applications running on WSFC include:
 
 - [Create an FCI with Azure shared disks (SQL Server on Azure VMs)](/azure/azure-sql/virtual-machines/windows/failover-cluster-instance-azure-shared-disks-manually-configure)
     - [Migrate your failover cluster instance to SQL Server on Azure VMs with shared disks](/azure/azure-sql/migration-guides/virtual-machines/sql-server-failover-cluster-instance-to-sql-on-azure-vm)
-- Scale-out File Server (SoFS) [template](https://aka.ms/azure-shared-disk-sofs-template)
-- SAP ASCS/SCS [template](https://aka.ms/azure-shared-disk-sapacs-template)
-- File Server for General Use (IW workload)
+- File servers. You can use the Scale-Out File Server features deployed on a Windows Server failover cluster, which uses shared disk in active-active mode. Cluster witness resources are stored on Azure shared disks and all file shares are simultaneously online on all nodes. For an example, see the Scale-out File Server (SoFS) [template](https://aka.ms/azure-shared-disk-sofs-template)
+- SAP application servers use clustered shared disks to store SAP Central Services (ASCS for ABAP and SCS for Java) and SAP global host files. SAP ASCS/SCS [template](https://aka.ms/azure-shared-disk-sapacs-template)
+- File Server for General Use (IW workload) - shared disks enable high availability for file servers in general
 - Remote Desktop Server User Profile Disk (RDS UPD)
 
 ### Linux
@@ -111,7 +111,7 @@ Both Ultra disks and Premium SSD v2 managed disks offer two extra throttles, giv
 
 ### Premium SSD performance throttles
 
-With premium SSD, the disk IOPS and throughput is fixed, for example, IOPS of a P30 is 5000. This value remains whether the disk is shared across 2 VMs or 5 VMs. The disk limits can be reached from a single VM or divided across two or more VMs. 
+With Premium SSD, the disk IOPS and throughput is fixed, for example, IOPS of a P30 is 5000. This value remains whether the disk is shared across 2 VMs or 5 VMs. The disk limits can be reached from a single VM or divided across two or more VMs. 
 
 ### Ultra Disk and Premium SSD v2 performance throttles
 
@@ -145,7 +145,7 @@ The following formulas explain how the performance attributes can be set, since
 
 #### Examples
 
-The following examples depict a few scenarios that show how the throttling can work with shared ultra disks, specifically.
+The following examples depict a few scenarios that show how the throttling can work with shared Ultra Disks, specifically.
 
 ##### Two nodes cluster using cluster shared volumes
 
@@ -173,4 +173,4 @@ Both shared Ultra Disks and shared Premium SSD v2 managed disks are priced based
 
 If you're interested in enabling and using shared disks for your managed disks, proceed to our article [Enable shared disk](disks-shared-enable.md)
 
-If you've additional questions, see the [shared disks](faq-for-disks.yml#azure-shared-disks) section of the FAQ.
+If you have additional questions, see the [shared disks](faq-for-disks.yml#azure-shared-disks) section of the FAQ.