Manage Azure Connected Machine agent versions for Azure Arc-enabled servers

Links to releases of the Windows agents appear under the heading of each release note. To find an agent version that's more than six months old, see the release notes archive.

1. If you didn't already, configure your package manager with the Linux Software Repository for Microsoft Products.

2. Search for available agent versions by using apt-cache:

   sudo apt-cache madison azcmagent
   

3. Find the version you want to install. Replace VERSION in the following command with the full (four-part) version number, and run the command to install the agent:

   sudo apt install azcmagent=VERSION
   

   For example, to install version 1.28, the install command is:

   sudo apt install azcmagent=1.28.02260.736
   

1. If you didn't already, configure your package manager with the Linux Software Repository for Microsoft Products.

2. Search for available agent versions with yum list:

   sudo yum list azcmagent --showduplicates
   

3. Find the version you want to install. Replace VERSION in the following command with the full (four-part) version number, and run the command to install the agent:

   sudo yum install azcmagent-VERSION
   

   For example, to install version 1.28, the install command looks like:

   sudo yum install azcmagent-1.28.02260-755
   

1. If you didn't already, configure your package manager with the Linux Software Repository for Microsoft Products.

2. Search for available agent versions by using zypper search.

   sudo zypper search -s azcmagent
   

3. Find the version you want to install. Replace VERSION in the following command with the full (four-part) version number, and run the command to install the agent:

   sudo zypper install -f azcmagent-VERSION
   

   For example, to install version 1.28, the install command looks like:

   sudo zypper install -f azcmagent-1.28.02260-755
   

Get the latest version of the Azure Connected Machine agent for Windows-based machines from:

• Microsoft Update
• Microsoft Update Catalog
• Microsoft Download Center

Microsoft Update configuration

To keep the Windows agent version up to date, we recommend using Microsoft Update to automatically get the latest version. By using your existing update infrastructure, such as Microsoft Configuration Manager or Windows Server Update Services, you can include Azure Connected Machine agent updates with your regular OS update schedule.

Windows Server doesn't check for updates in Microsoft Update by default. To receive automatic updates for the Azure Connected Machine Agent, you must configure the Windows Update client on the machine to check for other Microsoft products.

For Windows Servers that belong to a workgroup and connect to the Internet to check for updates, run the following commands in PowerShell as an administrator to enable Microsoft Update:

$ServiceManager = (New-Object -com "Microsoft.Update.ServiceManager")
$ServiceID = "7971f918-a847-4430-9279-4a52d1efe18d"
$ServiceManager.AddService2($ServiceId,7,"")

For Windows Servers that belong to a domain and connect to the Internet to check for updates, configure this setting at scale by using Group Policy:

1. Sign in to a computer used for server administration with an account that can manage Group Policy Objects (GPO) for your organization.
2. Open the Group Policy Management Console.
3. Expand the forest, domain, and organizational unit to select the appropriate scope for your new GPO. If you already have a GPO you want to modify, skip to step 6.
4. Right-click the container and select Create a GPO in this domain, and Link it here....
5. Enter a name for your policy such as "Enable Microsoft Update".
6. Right-click the policy and select Edit.
7. Go to Computer Configuration > Administrative Templates > Windows Components > Windows Update.
8. Select the Configure Automatic Updates setting to edit it.
9. Select the Enabled option to allow the policy to take effect.
10. At the bottom of the Options section, check the box for Install updates for other Microsoft products.
11. Select OK.

The next time computers in your selected scope refresh their policy, they start to check for updates in both Windows Update and Microsoft Update.

For organizations that use Microsoft Configuration Manager or Windows Server Update Services (WSUS) to deliver updates to their servers, you need to configure WSUS to synchronize the Azure Connected Machine Agent packages and approve them for installation on your servers. Follow the guidance for Windows Server Update Services or Configuration Manager to add the following products and classifications to your configuration:

• Product Name: Azure Connected Machine Agent (select all suboptions)
• Classifications: Critical Updates, Updates

After the updates are synchronized, you can optionally add the Azure Connected Machine Agent product to your autoapproval rules, so that your servers automatically stay up to date with the latest agent software.

Manually upgrade by using the Setup Wizard

1. Sign in to the computer with an account that has administrative rights.
2. Download the latest agent installer from https://aka.ms/AzureConnectedMachineAgent
3. Run AzureConnectedMachineAgent.msi to start the Setup Wizard.

If the Setup Wizard discovers a previous version of the agent, it upgrades it automatically. When the upgrade completes, the Setup Wizard closes automatically.

Upgrade from the command line

If you're unfamiliar with the command-line options for Windows Installer packages, review Msiexec standard command-line options and Msiexec command-line options.

1. Sign in to the computer with an account that has administrative rights.

2. Download the latest agent installer from https://aka.ms/AzureConnectedMachineAgent

3. To upgrade the agent silently and create a setup log file in the C:\Support\Logs folder, run the following command:

   msiexec.exe /i AzureConnectedMachineAgent.msi /qn /l*v "C:\Support\Logs\azcmagentupgradesetup.log"
   

To update the agent on a Linux machine, you run a command that updates the local package index with the list of latest available packages from the repositories, and then a command that upgrades the local package.

You can download the latest agent package from Microsoft's package repository.

1. To update the local package index with the latest changes in the repositories, run the following command:

   sudo apt update
   

2. To upgrade your system, run the following command:

   sudo apt upgrade azcmagent
   

The /var/log/dpkg.log log file records actions of the apt command, such as installation and removal of packages.

To update the agent on a Linux machine, you run a command that updates the local package index with the list of latest available packages from the repositories, and then a command that upgrades the local package.

You can download the latest agent package from Microsoft's package repository.

1. To update the local package index with the latest changes in the repositories, run the following command:

   sudo yum check-update
   

2. To upgrade your system, run the following command:

   sudo yum update azcmagent
   

Actions of the yum command, such as installation and removal of packages, are logged in the /var/log/yum.log log file.

To update the agent on a Linux machine, you run a command that updates the local package index with the list of latest available packages from the repositories, and then a command that upgrades the local package.

You can download the latest agent package from Microsoft's package repository.

1. To update the local package index with the latest changes in the repositories, run the following command:

   sudo zypper refresh
   

2. To upgrade your system, run the following command:

   sudo zypper update azcmagent
   

The /var/log/zypper.log log file records the actions of the zypper command, such as installation and removal of packages.