Acrolinx edits

Author: v-ksreedevan

articles/migrate/troubleshoot-replication-vmware.md

@@ -11,45 +11,45 @@ ms.custom: mvc, engagement-fy23
 
 # Troubleshoot slow replication or stuck migration issues in agentless VMware migration 
 
-This article helps you troubleshoot slow replication or stuck migration issues in agentless VMware migration. 
+This article helps you troubleshoot slow replication or stuck migration issues that you may encounter when you replicate on-premises VMware VMs using the Azure Migrate: Server Migration agentless method.
 
 ## Slow or stuck replication 
 
 ### Replication is slow or stuck for VM 
 
-While performing replications, you might observe that replication for a particular VM is not progressing at the expected pace. Generally, the underlying reason for this issue is an unavailability or scarcity of some resources required for replication. The resources might be consumed by other VMs that are replicating or some other process running on the appliance in the datacenter. 
+While performing replications, you might observe that replication for a particular VM isn't progressing at the expected pace. Generally, the underlying reason for this issue is an unavailability or scarcity of some resources required for replication. The resources might be consumed by other VMs that are replicating or some other process running on the appliance in the datacenter. 
 
 Following are some reasons that generally cause this issue and remediations. 
 
 #### NFC buffer size low 
 
-The Azure Migrate appliance operates under the constraint of using 32MB of NFC buffer to concurrently replicate 8 disks on the ESXi host. An NFC buffer size of less than 32MB might cause slow replication. 
+The Azure Migrate appliance operates under the constraint of using 32 MB of NFC buffer to concurrently replicate 8 disks on the ESXi host. An NFC buffer size of less than 32 MB might cause slow replication. 
 You may also get the following exception:  
 
 Exception: GatewayErrorHandling.GatewayServiceException: The operation failed with the error 'Memory allocation failed. Out of memory.'  
 
 #### Remediation
 
-You can increase the NFC buffer size beyond 32MB to increase concurrency. The setting needs to be done on both the ESXi host and on the appliance. If not, the replication may perform even worse. 
+You can increase the NFC buffer size beyond 32 MB to increase concurrency. The setting needs to be done on both the ESXi host and on the appliance. If not, the replication may perform even worse. 
 
 > [!Caution]
-> Increasing the size to more than 32MB might cause resource constraints in the environment. Before proceeding, consult with the System Administrator to understand the implications. 
+> Increasing the size to more than 32 MB might cause resource constraints in the environment. Before proceeding, consult with the System Administrator to understand the implications. 
 
 **Changes in ESXi host** 
 
 1. SSH to the ESXi host as root. 
 2. Use the vi editor to open “/etc/vmware/hostd/config.xml”. 
-3. Find the section that looks like th one below:
-
-```
-<nfcsvc> 
-<enabled>true</enabled> 
-<maxMemory>134217728</maxMemory> 
-<maxStreamMemory>10485760</maxStreamMemory> 
-<path>libnfcsvc.so</path> 
-</nfcsvc> 
-```
-4. Edit the value of `maxMemory` to the value (in Bytes) that you’d like to configure for the NFC buffer. In this example, it is set to 128MB (128*1024*1024). 
+3. Find the section that looks like the one below:
+
+   ```
+   <nfcsvc> 
+   <enabled>true</enabled> 
+   <maxMemory>134217728</maxMemory> 
+   <maxStreamMemory>10485760</maxStreamMemory> 
+   <path>libnfcsvc.so</path> 
+   </nfcsvc> 
+   ```
+4. Edit the value of `maxMemory` to the value (in Bytes) that you’d like to configure for the NFC buffer. In this example, it's set to 128 MB (128 * 1024 * 1024). 
 5. Save and exit. 
 6. Restart the management agents from the shell using the following commands: 
    - /etc/init.d/hostd restart 
@@ -58,14 +58,14 @@ You can increase the NFC buffer size beyond 32MB to increase concurrency. The se
 **Changes in Appliance**  
 
 1. Sign in to the Azure Migrate appliance as an administrator using the Remote Desktop.
-2. Open the "GatewayDataWorker.json" file in "%programdata%\Microsoft Azure\Config".  
-3. Create an empty json if one doesn’t exist and paste the following text in the new file created. 
+2. Open the GatewayDataWorker.json file in the "%programdata%\Microsoft Azure\Config" folder.  
+3. Create an empty json file if it doesn’t exist and paste the following text in the new file created. 
    ```
    { 
     "HostBufferSizeInMB": "32", 
    } 
    ```
-4. Change the value of “HostBufferSizeInMB” to the value you set in the ESXi host. 
+4. Change the value of `HostBufferSizeInMB` to the value that you set in the ESXi host. 
 5. Save and exit. 
 6. Restart the Azure Migrate gateway service that is running on the appliance. Open PowerShell and execute the following:
    - net stop asrgwy (wait for the service to stop) 
@@ -78,19 +78,19 @@ When the ESXi host on which the replicating VM is present is too busy, the repli
 
 #### Remediation
 
-Use VMotion to move the VM with slow replication to an ESXi host which is not too busy. 
+Use VMotion to move the VM with slow replication to an ESXi host, which isn't too busy. 
 
 #### Network bandwidth  
 
 Replications might be slow because of low network bandwidth available to the Azure Migrate appliance. Low bandwidth might be due to other applications using up the bandwidth or presence of bandwidth throttling applications or a proxy setting restricting the bandwidth use of replication appliance.  
 
 #### Remediation
 
-In case of low bandwidth, you can first reduce the number of applications using network bandwidth. Check with you network administrator if any throttling application or proxy setting is present. 
+In case of low bandwidth, you can first reduce the number of applications using network bandwidth. Check with your network administrator if any throttling application or proxy setting is present. 
 
 #### Disk I/O 
 
-Replications can be slow because the server that is being replicated has too much load on it and this is causing high I/O operations on disks attached to it. It is advised to reduce the load on the server to increase the replication speed. You may also encounter the following error: 
+Replications can be slow because the server that is being replicated has too much load on it and this is causing high I/O operations on disks attached to it. It's advised to reduce the load on the server to increase the replication speed. You may also encounter the following error: 
 
 The last replication cycle for the virtual machine ‘VM Name’ failed. Encountered timeout event. 
 
@@ -101,26 +101,26 @@ If no action is taken, the replication will proceed and be completed with a dela
 Replications can be slower than expected if the data upload speed is higher than the write speed of the disk that you selected while enabling replication. To get better speeds at same upload speeds, you would need to restart the replication and select **Premium** while selecting the disk type for replication.  
 
 > [!Caution]
-> The disk type recommended during Assessment might not be **Premium** for a particular VM. In this case, switching to Premium disk to improve replication speeds is not advisable since it might not be required post migration to have a Premium disk attached to this VM. 
+> The disk type recommended during Assessment might not be **Premium** for a particular VM. In this case, switching to Premium disk to improve replication speeds isn't advisable since it might not be required post migration to have a Premium disk attached to this VM. 
 
 ## Slow or stuck migration 
 
 ### Migration operation on VM is stuck 
 
-While triggering migration for a particular VM, you might observe that the migration is stuck at some stage (queued or delta sync) longer than expected. Generally, the underlying reason for this issue is an unavailability or scarcity of some resources required for replication. The resources might be consumed by other VMs that are replicating or some other process running on appliance on in the datacenter. Below are some reasons that generally cause this issue and solutions for them. 
+While triggering migration for a particular VM, you might observe that the migration is stuck at some stage (queued or delta sync) longer than expected. Generally, the underlying reason for this issue is an unavailability or scarcity of some resources required for replication. The resources might be consumed by other VMs that are replicating or some other process running on appliance on in the datacenter. Following are some reasons that generally cause this issue and the remedies. 
 
 #### NFC buffer size low 
 
-If an IR cycle for a server with large disks is ongoing while migration is triggered for second VM, the second VM’s migration job can get stuck. Even though migration jobs are given high priority, the NFC buffer might not be available for migration. In this case, it is recommended to stop or pause the initial replication of servers with large disks and complete the migration of the second VM. 
+If an IR cycle for a server with large disks is ongoing while migration is triggered for second VM, the second VM’s migration job can get stuck. Even though migration jobs are given high priority, the NFC buffer might not be available for migration. In this case, it's recommended to stop or pause the initial replication of servers with large disks and complete the migration of the second VM. 
 
-#### Ongoing delta sync cycle is not complete 
+#### Ongoing delta sync cycle isn't complete 
 
 If migration is triggered during an ongoing delta replication cycle, it would be queued. The delta replication cycle on the VM will be completed first after which migration will start. The time required to trigger migration depends on the time taken to complete one delta sync cycle. 
 
-#### Shutdown of on-premises VM taking longer than usual.  
+#### Shutdown of on-premises VM taking longer than usual
 
 Try to migrate without shutting down the VM or turn off the VM manually and then migrate it. 
 
 ## Next steps
-- [Learn more](tutorial-migrate-vmware.md) about migrating VMware VMs.
+[Learn more](tutorial-migrate-vmware.md) about migrating VMware VMs.