From this modernized mobility service and appliance components, you don't need to maintain source machine's Root/Admin credentials for performing upgrades. The credentials are required only for the initial installation of the agent on source machines. Once done, you can remove the credentials and the upgrades would occur automatically.
Update mobility agent automatically
By default, automatic updates are enabled on a vault. Automatic updates are triggered at 12:00 AM local time every day, if a new version is available.
To avail the latest features, enhancements, and fixes, we recommend you choose Allow Site Recovery to manage option on the Mobility agent upgrade settings. Automatic updates don't require a reboot or affect ongoing replication of your virtual machines. Automatic updates also ensure that all the replication appliances in the vault are automatically updated.
To turn off the automatic updates, toggle the Allow Site Recovery to manage button.
Update mobility agent manually
If you have turned off automatic updates for your mobility agent, you can update the agent manually using the following procedures:
Upgrade mobility agent on multiple protected items through portal
To manually update mobility agent on multiple protected items, follow these steps:
Navigate to Recovery services vault > Replicated items and select New Site Recovery mobility agent update is available. Select to install.
Choose the source machines to update and then select OK.
Note
If prerequisites to upgrade Mobility service aren't met, then the virtual machine can't be selected. See information on how to resolve.
After initiating the upgrade, a Site Recovery job is created in the vault for each upgrade operation, and can be tracked by navigating to Monitoring > Site Recovery jobs.
Update mobility agent for a single protected machine through portal
To update mobility agent of a protected item, follow these steps:
Navigate to recovery services vault > Replicated items and select a virtual machine.
In virtual machine's Overview blade, against Agent version, view the current version of the mobility agent. If a new update is available, the status is updated as New update available.
Select New update available, latest available version is displayed. Select Update to this version to initiate the update job.
Note
If upgrade is blocked, check and resolve the errors as detailed here.
Update mobility agent using command line or when private endpoint is enabled
When you enable private endpoints, automatic updates won't be available. You need to manually update mobility agent using command line.
To update mobility agent of a protected item, follow these steps:
Navigate to Recovery services vault > Replicated items, and select a virtual machine.
In virtual machine's Overview
blade, under Agent version, you can view the current version of the mobility agent. If a new update is available, the status is updated as New update available.Confirm the availability of new version, download the latest agent version’s package from here on the source machine and update the agent version.
Update mobility agent on Windows machines
To update mobility agent on Windows machines, follow these steps:
cd C:\Azure Site Recovery\AgentMicrosoft-ASR_UA*Windows*release.exe /q /x:C:\Azure Site Recovery\AgentUnifiedAgent.exe /Role "MS" /Platform VmWare /Silent /InstallationType Upgrade /CSType CSPrime /InstallLocation "C:\Program Files (x86)\Microsoft Azure Site Recovery""C:\Azure Site Recovery\Agent\agent\UnifiedAgentConfigurator.exe" /SourceConfigFilePath "config.json" /CSType CSPrimeUpgrade settings
.\UnifiedAgent.exe /Role "MS" /Platform vmware /Silent /InstallationType Upgrade /CSType CSPrime /InstallLocation "C:\Azure Site Recovery\Agent"/Role/InstallLocation/Platform/Silent/CSTypeRegistration settings
"\UnifiedAgentConfigurator.exe" /SourceConfigFilePath "config.json" /CSType CSPrime >/SourceConfigFilePath/CSType Update mobility agent on Linux machines
To update mobility agent on Linux machines, follow these steps:
/tmpcd /tmp ;tar -xvf Microsoft-ASR_UA_version_LinuxVersion_GA_date_release.tar.gz./install -q -r MS -v VmWare -a Upgrade -c CSPrime/Vx/bin/UnifiedAgentConfigurator.sh -c CSPrime -S config.json -q Installation settings
./install -q -r MS -v VmWare -a Upgrade -c CSPrime-r-d/usr/local/ASR-v-q-c-aRegistration settings
/Vx/bin/UnifiedAgentConfigurator.sh -c CSPrime -S config.json -q-S-c-q Mobility agent on latest version
After Mobility agent is updated to the latest version or has been updated automatically to the latest version, the status displays as Up to date.
Resolve blocking issues for agent upgrade
If prerequisites to upgrade the mobility agent aren't met, then virtual machine can't be updated. Resolve these to proceed with the upgrade.
The prerequisite includes, but not limited to:
A pending mandatory reboot on the protected machine.
If the replication appliance is on an incompatible version.
If the replication appliance components – Proxy server or Process server is unable to communicate with Azure services.
If mobility agent on the protected machine isn't able to communicate with the replication appliance.
In case any of the above issues are applicable, the status is updated as Cannot update to latest version. Select the status to view the reasons blocking the update and recommended actions to fix the issue.
Mobility agent upgrade job failure
In case mobility agent upgrade operation fails (manually triggered or automatic upgrade operation), the job is updated with the reason for failure. Resolve the errors and then retry the operation.
To view the failure errors, you can either navigate to Site Recovery jobs and select a specific job to fetch the resolution of errors, or you can use the steps following:
Navigate to replicated items section and select a specific virtual machine.
In the Overview blade, against Agent version, the current version of the mobility agent displayed.
Next to the current version, the status is updated with the message Update failed. Select the status to retry the update operation.
A link to the previous upgrade job is available. Select the job to navigate to the specific job.
Resolve the previous job errors.
Trigger the update operation after resolving the errors from previous failed job.
Upgrade appliance
By default, automatic updates are enabled on the appliance. Automatic updates are triggered at 12:00 AM local time every day, if a new version is available for any of the components.
To check the update status of any of the components, navigate to appliance server and open Microsoft Azure Appliance Configuration Manager. Navigate to Appliance components and expand it to view the list of all the components and their version.
If any of these need to be updated, then the Status reflects the same. Select the status message to upgrade the component.
Turn off autoupdate
On the server running the appliance, open the Registry Editor.
Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\AzureAppliance.
To turn off autoupdate, create a registry key AutoUpdate key with DWORD value of 0.
Turn on autoupdate
You can turn on autoupdate by deleting the AutoUpdate registry key from HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\AzureAppliance.
To delete the registry key:
- On the server running the appliance, open the Registry Editor.
- Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\AzureAppliance.
- Delete the registry key AutoUpdate that was previously created to turn off autoupdate.
Update appliance components manually or when private endpoint is enabled
When you enable private endpoints, automatic updates won't be available. To update all the components of Azure Site Recovery replication appliance, follow these steps:
- Navigate to this page and check if a new version for the components has been released for a particular version.
- Download packages of all the versions for which an update is available on the appliance and update all the components.
Update Process server
cd C:\Downloadsmsiexec.exe /i ProcessServer.msi ALLUSERS=1 REINSTALL=ALL REINSTALLMODE=vomus /l*v msi.logUpdate Recovery Services agent
To update the Recovery Service agent, download the latest version here.
cd C:\DownloadsMARSAgentInstaller.exe /q /nu for mars agentUpdate remaining components of appliance
.msiResolve issues with component upgrade
If prerequisites to upgrade any of the components aren't met, then it can't be updated. The reasons/prerequisites include, but not limited to,
If one of the components of the replication appliance is on an incompatible version.
If replication appliance is unable to communicate with Azure services.
In case any of the above issues are applicable, the status is updated as Cannot update to latest version. Select the status to view the reasons blocking the update and recommended actions to fix the issue. After resolving the blocking reasons, try the update manually.
