Skip to content

Commit e7dc368

Browse files
authored
Merge pull request #4 from rpsqrd/patch-7
CLI changes and removed rollback text
2 parents efcf755 + ba08c91 commit e7dc368

File tree

1 file changed

+12
-17
lines changed

1 file changed

+12
-17
lines changed

articles/azure-arc/servers/manage-automatic-vm-extension-upgrade.md

Lines changed: 12 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ Automatic Extension Upgrade (preview) is available for Azure Arc-enabled servers
2020
2121
## How does Automatic Extension Upgrade work?
2222

23-
The extension upgrade process replaces the existing Azure VM extension version supported by Azure Arc-enabled servers with a new version of the same extension when published by the extension publisher. The health of the machine is monitored after the new extension is installed. If the machine is not in a healthy state within 5 minutes of the upgrade completion, the extension version is rolled back to the previous version.
23+
The extension upgrade process replaces the existing Azure VM extension version supported by Azure Arc-enabled servers with a new version of the same extension when published by the extension publisher.
2424

2525
A failed extension update is automatically retried. A retry is attempted every few days automatically without user intervention.
2626

@@ -32,8 +32,7 @@ For a group of Arc-enabled servers undergoing an update, the Azure platform will
3232

3333
**Across regions:**
3434

35-
- Geo-paired regions is not applicable.
36-
- The success of an update is measured by tracking the health of a machine post update. Machine health is tracked through platform health indicators for the Arc-enabled server.
35+
- Geo-paired regions are not applicable.
3736

3837
**Within a region:**
3938

@@ -44,37 +43,35 @@ For a group of Arc-enabled servers undergoing an update, the Azure platform will
4443

4544
Automatic Extension Upgrade (preview) supports the following extensions (and more are added periodically):
4645

47-
- Dependency agent – Linux and Windows
4846
- Azure Monitor Agent - Linux and Windows
4947
- Azure Security agent - Linux and Windows
48+
- Dependency agent – Linux and Windows
5049
- Key Vault Extension - Linux only
51-
- Log Analytics agent - Linux only
50+
- Log Analytics agent (OMS agent) - Linux only
5251

5352
## Enabling Automatic Extension Upgrade (preview)
5453

5554
To enable Automatic Extension Upgrade (preview) for an extension, you must ensure the property `enable-auto-upgrade` is set to `true` and added to every extension definition individually.
5655

57-
Use the [az connectedmachine extension ](/cli/azure/connectedmachine/extension) cmdlet with the `--extension-name`, `--machine-name`, `-publisher`, `--enable-auto-upgrade`, and `--resource-group` parameters.
56+
Use the [az connectedmachine extension](/cli/azure/connectedmachine/extension) cmdlet with the `--name`, `--machine-name`, `--enable-auto-upgrade`, and `--resource-group` parameters.
5857

5958
```azurecli
60-
az connectedmachine extension set \
59+
az connectedmachine extension update \
6160
--resource-group resourceGroupName \
6261
--machine-name machineName \
63-
--extension-name DependencyAgentLinux \
64-
--publisher Microsoft.Azure.Monitoring.DependencyAgent \
65-
--version 9.5 \
62+
--name DependencyAgentLinux \
6663
--enable-auto-upgrade true
6764
```
6865

69-
To verify Automatic Extension Upgrade (preview) is available, run the following command:
66+
To check the status of Automatic Extension Upgrade (preview) for all extensions on an Arc-enabled server, run the following command:
7067

7168
```azurecli
7269
az connectedmachine extension list --resource-group resourceGroupName --machine-name machineName --query "[].{Name:name, AutoUpgrade:properties.enableAutoUpgrade}" --output table
7370
```
7471

7572
## Extension upgrades with multiple extensions
7673

77-
A machine managed by Arc-enabled servers can have multiple extensions with automatic extension upgrade enabled. The same machine can also have other extensions without automatic extension upgrade enabled.
74+
A machine managed by Arc-enabled servers can have multiple extensions with automatic extension upgrade enabled. The same machine can also have other extensions without automatic extension upgrade enabled.
7875

7976
If multiple extension upgrades are available for a machine, the upgrades may be batched together, but each extension upgrade is applied individually on a machine. A failure on one extension does not impact the other extension(s) to be upgraded. For example, if two extensions are scheduled for an upgrade, and the first extension upgrade fails, the second extension will still be upgraded.
8077

@@ -84,20 +81,18 @@ To disable Automatic Extension Upgrade (preview) for an extension, you must ensu
8481

8582
### Using the Azure CLI
8683

87-
Use the [az connectedmachine extension ](/cli/azure/connectedmachine/extension) cmdlet with the `--extension-name`, `--machine-name`, `--publisher`, `--enable-auto-upgrade`, and `--resource-group` parameters.
84+
Use the [az connectedmachine extension ](/cli/azure/connectedmachine/extension) cmdlet with the `--name`, `--machine-name`, `--enable-auto-upgrade`, and `--resource-group` parameters.
8885

8986
```azurecli
90-
az connectedmachine extension set \
87+
az connectedmachine extension update \
9188
--resource-group resourceGroupName \
9289
--machine-name machineName \
9390
--name DependencyAgentLinux \
94-
--publisher Microsoft.Azure.Monitoring.DependencyAgent \
95-
--version 9.5 \
9691
--enable-auto-upgrade false
9792
```
9893

9994
## Next steps
10095

10196
- You can deploy, manage, and remove VM extensions using the [Azure CLI](manage-vm-extensions-cli.md), [PowerShell](manage-vm-extensions-powershell.md), or [Azure Resource Manager templates](manage-vm-extensions-template.md).
10297

103-
- Troubleshooting information can be found in the [Troubleshoot VM extensions guide](troubleshoot-vm-extensions.md).
98+
- Troubleshooting information can be found in the [Troubleshoot VM extensions guide](troubleshoot-vm-extensions.md).

0 commit comments

Comments
 (0)