Skip to content

Commit 8f6ea91

Browse files
authored
Merge pull request #285143 from ankitaduttaMSFT/tsts
TS docs
2 parents cffb9f3 + c41bc9c commit 8f6ea91

9 files changed

+319
-81
lines changed

articles/site-recovery/azure-to-azure-troubleshoot-replication.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ You should see the event **Data change rate beyond supported limits**:
3333

3434
If you select the event, you should see the exact disk information:
3535

36-
:::image type="content" source="./media/site-recovery-azure-to-azure-troubleshoot/data_change_event2.png" alt-text="Page that shows the data change rate event details.":::
36+
3737

3838
### Azure Site Recovery limits
3939

34.2 KB
Loading
136 KB
Loading

articles/site-recovery/toc.yml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -585,6 +585,10 @@
585585
href: vmware-azure-troubleshoot-configuration-server.md
586586
- name: Process server errors
587587
href: vmware-physical-azure-troubleshoot-process-server.md
588+
- name: Replication appliance health
589+
href: vmware-troubleshoot-appliance-health-issue.md
590+
- name: Mobility agent health
591+
href: vmware-troubleshoot-mobility-agent-health.md
588592
- name: Mobility service - push installation errors
589593
href: vmware-azure-troubleshoot-push-install.md
590594
- name: Failover to Azure errors

articles/site-recovery/upgrade-mobility-service-modernized.md

Lines changed: 67 additions & 54 deletions
Large diffs are not rendered by default.

articles/site-recovery/vmware-azure-troubleshoot-replication.md

Lines changed: 17 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
---
2-
title: Troubleshoot replication issues for disaster recovery of VMware VMs and physical servers to Azure by using Azure Site Recovery
3-
description: This article provides troubleshooting information for common replication issues during disaster recovery of VMware VMs and physical servers to Azure by using Azure Site Recovery.
2+
title: Troubleshoot replication issues for disaster recovery of VMware virtual machines and physical servers to Azure by using Azure Site Recovery
3+
description: This article provides troubleshooting information for common replication issues during disaster recovery of VMware virtual machines and physical servers to Azure by using Azure Site Recovery.
44
author: ankitaduttaMSFT
5-
manager: rochakm
65
ms.service: azure-site-recovery
76
ms.topic: troubleshooting
8-
ms.date: 04/26/2023
7+
ms.date: 08/21/2024
98
ms.author: ankitadutta
109

1110
---
11+
1212
# Troubleshoot replication issues for VMware VMs and physical servers
1313

1414
This article describes some common issues and specific errors you might encounter when you replicate on-premises VMware VMs and physical servers to Azure using [Site Recovery](site-recovery-overview.md).
@@ -33,15 +33,15 @@ To solve these issues, [troubleshoot connectivity and replication](vmware-physic
3333

3434
When you try to select the source machine to enable replication by using Site Recovery, the machine might not be available for one of the following reasons:
3535

36-
* **Two virtual machines with the same instance UUID**: If two virtual machines under the vCenter have the same instance UUID, the first virtual machine discovered by the configuration server is displayed in the Azure portal. To resolve this issue, ensure that no two virtual machines have the same instance UUID. This scenario is commonly seen in instances where a backup VM becomes active and is logged into our discovery records. Refer to [Azure Site Recovery VMware-to-Azure: How to clean up duplicate or stale entries](https://social.technet.microsoft.com/wiki/contents/articles/32026.asr-vmware-to-azure-how-to-cleanup-duplicatestale-entries.aspx) to resolve.
37-
* **Incorrect vCenter user credentials**: Ensure that you added the correct vCenter credentials when you set up the configuration server by using the OVF template or unified setup. To verify the credentials that you added during setup, see [Modify credentials for automatic discovery](vmware-azure-manage-configuration-server.md#modify-credentials-for-automatic-discovery).
38-
* **vCenter insufficient privileges**: If the permissions provided to access vCenter don't have the required permissions, failure to discover virtual machines might occur. Ensure that the permissions described in [Prepare an account for automatic discovery](vmware-azure-tutorial-prepare-on-premises.md#prepare-an-account-for-automatic-discovery) are added to the vCenter user account.
39-
* **Azure Site Recovery management servers**: If the virtual machine is used as a management server under one or more of the following roles - Configuration server /scale-out process server / Master target server, then you won't be able to choose the virtual machine from the portal. Management servers cannot be replicated.
40-
* **Already protected/failed over through Azure Site Recovery services**: If the virtual machine is already protected or failed over through Site Recovery, the virtual machine isn't available to select for protection in the portal. Ensure that the virtual machine you're looking for in the portal isn't already protected by any other user or under a different subscription.
41-
* **vCenter not connected**: Check if vCenter is in a connected state. To verify, go to Recovery Services vault > Site Recovery Infrastructure > Configuration Servers > Click on respective configuration server > a blade opens on your right with details of associated servers. Check if vCenter is connected. If it's in a "Not Connected" state, resolve the issue, and then [refresh the configuration server](vmware-azure-manage-configuration-server.md#refresh-configuration-server) on the portal. After this, virtual machine isn't listed on the portal.
42-
* **ESXi powered off**: If the ESXi host under which the virtual machine resides is in a powered-off state, then the virtual machine isn't listed or isn't selectable on the Azure portal. Power on the ESXi host, and [refresh the configuration server](vmware-azure-manage-configuration-server.md#refresh-configuration-server) on the portal. After this, virtual machine is listed on the portal.
43-
* **Pending reboot**: If there is a pending reboot on the virtual machine, then you won't be able to select the machine on the Azure portal. Ensure to complete the pending reboot activities and [refresh the configuration server](vmware-azure-manage-configuration-server.md#refresh-configuration-server). After this, virtual machine is listed on the portal.
44-
* **IP not found or Machine does not have an IP address**: If the virtual machine doesn't have a valid IP address associated with it, then you are not able to select the machine on the Azure portal. Ensure to assign a valid IP address to the virtual machine, and [refresh the configuration server](vmware-azure-manage-configuration-server.md#refresh-configuration-server). It could also be caused if the machine does not have a valid IP address associated with one of its NICs. Either assign a valid IP address to all NICs or remove the NIC that's missing the IP. After this, the virtual machine is listed on the portal.
36+
- **Two virtual machines with the same instance UUID**: If two virtual machines under the vCenter have the same instance UUID, the first virtual machine discovered by the configuration server is displayed in the Azure portal. To resolve this issue, ensure that no two virtual machines have the same instance UUID. This scenario is commonly seen in instances where a backup VM becomes active and is logged into our discovery records. Refer to [Azure Site Recovery VMware-to-Azure: How to clean up duplicate or stale entries](https://social.technet.microsoft.com/wiki/contents/articles/32026.asr-vmware-to-azure-how-to-cleanup-duplicatestale-entries.aspx) to resolve.
37+
- **Incorrect vCenter user credentials**: Ensure that you added the correct vCenter credentials when you set up the configuration server by using the OVF template or unified setup. To verify the credentials that you added during setup, see [Modify credentials for automatic discovery](vmware-azure-manage-configuration-server.md#modify-credentials-for-automatic-discovery).
38+
- **vCenter insufficient privileges**: If the permissions provided to access vCenter don't have the required permissions, failure to discover virtual machines might occur. Ensure that the permissions described in [Prepare an account for automatic discovery](vmware-azure-tutorial-prepare-on-premises.md#prepare-an-account-for-automatic-discovery) are added to the vCenter user account.
39+
- **Azure Site Recovery management servers**: If the virtual machine is used as a management server under one or more of the following roles - Configuration server /scale-out process server / Master target server, then you won't be able to choose the virtual machine from the portal. Management servers cannot be replicated.
40+
- **Already protected/failed over through Azure Site Recovery services**: If the virtual machine is already protected or failed over through Site Recovery, the virtual machine isn't available to select for protection in the portal. Ensure that the virtual machine you're looking for in the portal isn't already protected by any other user or under a different subscription.
41+
- **vCenter not connected**: Check if vCenter is in a connected state. To verify, go to Recovery Services vault > Site Recovery Infrastructure > Configuration Servers > Click on respective configuration server > a blade opens on your right with details of associated servers. Check if vCenter is connected. If it's in a "Not Connected" state, resolve the issue, and then [refresh the configuration server](vmware-azure-manage-configuration-server.md#refresh-configuration-server) on the portal. After this, virtual machine isn't listed on the portal.
42+
- **ESXi powered off**: If the ESXi host under which the virtual machine resides is in a powered-off state, then the virtual machine isn't listed or isn't selectable on the Azure portal. Power on the ESXi host, and [refresh the configuration server](vmware-azure-manage-configuration-server.md#refresh-configuration-server) on the portal. After this, virtual machine is listed on the portal.
43+
- **Pending reboot**: If there is a pending reboot on the virtual machine, then you won't be able to select the machine on the Azure portal. Ensure to complete the pending reboot activities and [refresh the configuration server](vmware-azure-manage-configuration-server.md#refresh-configuration-server). After this, virtual machine is listed on the portal.
44+
- **IP not found or Machine does not have an IP address**: If the virtual machine doesn't have a valid IP address associated with it, then you are not able to select the machine on the Azure portal. Ensure to assign a valid IP address to the virtual machine, and [refresh the configuration server](vmware-azure-manage-configuration-server.md#refresh-configuration-server). It could also be caused if the machine does not have a valid IP address associated with one of its NICs. Either assign a valid IP address to all NICs or remove the NIC that's missing the IP. After this, the virtual machine is listed on the portal.
4545

4646
### Troubleshoot protected virtual machines greyed out in the portal
4747

@@ -54,6 +54,7 @@ Another reason could be that the machine was cloned. When machines move between
5454

5555

5656
Following is a list of some of the most common issues:
57+
5758
### Initial replication issues [error 78169]
5859

5960
Over and above ensuring that there are no connectivity, bandwidth, or time sync-related issues, ensure that:
@@ -119,6 +120,7 @@ To resolve the issue, use the following steps to verify the service status:
119120

120121
*C:\Program Files (X86)\Microsoft Azure Site Recovery\agent\svagents\*.log*
121122
3. To register the master target with the configuration server, navigate to folder **%PROGRAMDATA%\ASR\Agent**, and run the following on command prompt:
123+
122124
```
123125
cmd
124126
cdpcli.exe --registermt
@@ -140,7 +142,7 @@ To resolve the issue, you can associate the policy with the configuration server
140142

141143
## Error ID 78144 - No app-consistent recovery point available for the VM in the last 'XXX' minutes
142144

143-
Enhancements have been made in mobility agent [9.23](vmware-physical-mobility-service-overview.md#mobility-service-agent-version-923-and-higher) & [9.27](site-recovery-whats-new-archive.md#update-rollup-39) versions to handle VSS installation failure behaviors. Ensure that you're on the latest versions for best guidance on troubleshooting VSS failures.
145+
Enhancements have been made in mobility agent [9.23](vmware-physical-mobility-service-overview.md#mobility-service-agent-version-923-and-later) & [9.27](site-recovery-whats-new-archive.md#update-rollup-39) versions to handle VSS installation failure behaviors. Ensure that you're on the latest versions for best guidance on troubleshooting VSS failures.
144146

145147
Some of the most common issues are listed:
146148

@@ -171,7 +173,7 @@ Search for the string "vacpError" by opening the vacp.log file in an editor
171173

172174
`Ex: `**`vacpError`**`:220#Following disks are in FilteringStopped state [\\.\PHYSICALDRIVE1=5, ]#220|^|224#FAILED: CheckWriterStatus().#2147754994|^|226#FAILED to revoke tags.FAILED: CheckWriterStatus().#2147754994|^|`
173175

174-
In the preceeding example **2147754994** is the error code that tells you about the failure as shown:
176+
In the preceding example **2147754994** is the error code that tells you about the failure as shown:
175177

176178
#### VSS writer is not installed - Error 2147221164
177179

articles/site-recovery/vmware-physical-mobility-service-overview.md

Lines changed: 17 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ manager: gaggupta
66
ms.service: azure-site-recovery
77
ms.topic: how-to
88
ms.author: ankitadutta
9-
ms.date: 07/10/2024
9+
ms.date: 08/21/2024
1010
ms.custom: engagement-fy23, linux-related-content
1111
---
1212

@@ -41,7 +41,7 @@ Push installation is an integral part of the job that runs from the Azure portal
4141

4242
The push installation workflow is described in the following sections:
4343

44-
### Mobility service agent version 9.23 and higher
44+
### Mobility service agent version 9.23 and later
4545

4646
For more information about version 9.23, see [Update Rollup 35 for Azure Site Recovery](https://support.microsoft.com/help/4494485/update-rollup-35-for-azure-site-recovery).
4747

@@ -57,7 +57,7 @@ During a push installation of the Mobility service, the following steps are perf
5757
- To generate application-consistent recovery points, refer to [our guidance](vmware-physical-manage-mobility-service.md#install-site-recovery-vss-provider-on-source-machine) to complete a manual installation of the Site Recovery VSS provider.
5858
- If you don't want to generate application-consistent recovery points, [modify the replication policy](vmware-azure-set-up-replication.md#create-a-policy) to turn off application-consistent recovery points.
5959

60-
### Mobility service agent version 9.22 and below
60+
### Mobility service agent version 9.22 and older
6161

6262
1. The agent is pushed to the source machine. Copying the agent to the source machine can fail due to multiple environmental errors. Refer to [our guidance](vmware-azure-troubleshoot-push-install.md) to troubleshoot push installation failures.
6363
1. After the agent is successfully copied to the server, a prerequisite check is performed on the server.
@@ -67,7 +67,7 @@ During a push installation of the Mobility service, the following steps are perf
6767
1. As part of the agent installation, the Volume Shadow Copy Service (VSS) provider for Azure Site Recovery is installed. The VSS provider is used to generate application-consistent recovery points.
6868
- If the VSS provider installation fails, the agent installation fails. To avoid failure of the agent installation, use [version 9.23](https://support.microsoft.com/help/4494485/update-rollup-35-for-azure-site-recovery) or higher to generate crash-consistent recovery points and do a manual install of the VSS provider.
6969

70-
### Mobility service agent version 9.55 and higher
70+
### Mobility service agent version 9.55 and later
7171

7272
1. The modernized architecture of mobility agent is set as default for the version 9.55 and above. Follow the instructions [here](#install-the-mobility-service-using-ui-modernized) to install the agent.
7373
2. To install the modernized architecture of mobility agent on versions 9.54 and above, follow the instructions [here](#install-the-mobility-service-using-command-prompt-modernized).
@@ -117,20 +117,21 @@ Locate the installer files for the server’s operating system using the followi
117117
> This section is applicable to Azure Site Recovery - Modernized. [Here are the installation instructions for Classic](#install-the-mobility-service-using-command-prompt-classic).
118118
119119
### Windows machine
120+
120121
1. Open command prompt and navigate to the folder where the installer file has been placed.
121122

122123
```cmd
123124
cd C:\Program Files (x86)\Microsoft Azure Site Recovery
124125
```
125126
2. Run the following command to extract the installer file:
126127
```cmd
127-
.\Microsoft-ASR_UA*Windows*release.exe /q /x:"C:\Program Files (x86)\Microsoft Azure Site Recovery"
128+
Microsoft-ASR_UA*Windows*release.exe /q /x:"C:\Program Files (x86)\Microsoft Azure Site Recovery"
128129
```
129130
3. To proceed with the installation, run the following command:
130131
131132
```cmd
132133
133-
.\UnifiedAgentInstaller.exe /Platform vmware /Silent /Role MS /CSType CSPrime /InstallLocation "C:\Program Files (x86)\Microsoft Azure Site Recovery"
134+
UnifiedAgentInstaller.exe /Platform vmware /Silent /Role MS /CSType CSPrime /InstallLocation "C:\Program Files (x86)\Microsoft Azure Site Recovery"
134135
```
135136
Once the installation is complete, copy the string that is generated alongside the parameter *Agent Config Input*. This string is required to [generate the Mobility Service configuration file](#generate-mobility-service-configuration-file).
136137

@@ -139,7 +140,7 @@ Locate the installer files for the server’s operating system using the followi
139140
4. After successfully installing, register the source machine with the above appliance using the following command:
140141

141142
```cmd
142-
"C:\Program Files (x86)\Microsoft Azure Site Recovery\agent\UnifiedAgentConfigurator.exe" /SourceConfigFilePath "config.json" /CredentialLessDiscovery true /CSType CSPrime
143+
"C:\Program Files (x86)\Microsoft Azure Site Recovery\agent\UnifiedAgentConfigurator.exe" /SourceConfigFilePath "config.json" /CSType CSPrime
143144
```
144145

145146
#### Installation settings
@@ -216,8 +217,14 @@ When providing both the machine credentials and the vCenter server or vSphere ES
216217
Use the following steps to generate mobility service configuration file:
217218

218219
1. Navigate to the appliance with which you want to register your source machine. Open the Microsoft Azure Appliance Configuration Manager and navigate to the section **Mobility service configuration details**.
219-
2. Paste the Machine Details string that you copied from Mobility Service and paste it in the input field here.
220-
3. Click **Download configuration file**.
220+
2. Paste the machine details string that you've copied from the Mobility Service and paste it in the input field here. In case you're re-registering the Mobility service, use the following commands to get the machine details string:
221+
1. **Linux** :
222+
`cd /usr/local/ASR/Vx/bin/ ./AzureRcmCli --getagentconfiginput`
223+
1. **Windows** :
224+
`cd "C:\Program Files (x86)\Microsoft Azure Site Recovery\agent"`
225+
`./AzureRcmCli.exe --getagentconfiginput`
226+
227+
1. Select **Download configuration file**.
221228

222229
![Image showing download configuration file option for Mobility Service](./media/vmware-physical-mobility-service-overview-modernized/download-configuration-file.png)
223230

@@ -450,5 +457,4 @@ As a **prerequisite to update or protect Ubuntu 14.04 machines** from 9.42 versi
450457

451458
## Next steps
452459

453-
> [!div class="nextstepaction"]
454-
> [Set up push installation for the Mobility service](vmware-azure-install-mobility-service.md).
460+
- [Set up push installation for the Mobility service](vmware-azure-install-mobility-service.md).

0 commit comments

Comments
 (0)