You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/azure-arc/servers/manage-automatic-vm-extension-upgrade.md
+12-17Lines changed: 12 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -20,7 +20,7 @@ Automatic Extension Upgrade (preview) is available for Azure Arc-enabled servers
20
20
21
21
## How does Automatic Extension Upgrade work?
22
22
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.
24
24
25
25
A failed extension update is automatically retried. A retry is attempted every few days automatically without user intervention.
26
26
@@ -32,8 +32,7 @@ For a group of Arc-enabled servers undergoing an update, the Azure platform will
32
32
33
33
**Across regions:**
34
34
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.
37
36
38
37
**Within a region:**
39
38
@@ -44,37 +43,35 @@ For a group of Arc-enabled servers undergoing an update, the Azure platform will
44
43
45
44
Automatic Extension Upgrade (preview) supports the following extensions (and more are added periodically):
46
45
47
-
- Dependency agent – Linux and Windows
48
46
- Azure Monitor Agent - Linux and Windows
49
47
- Azure Security agent - Linux and Windows
48
+
- Dependency agent – Linux and Windows
50
49
- Key Vault Extension - Linux only
51
-
- Log Analytics agent - Linux only
50
+
- Log Analytics agent (OMS agent) - Linux only
52
51
53
52
## Enabling Automatic Extension Upgrade (preview)
54
53
55
54
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.
56
55
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.
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:
70
67
71
68
```azurecli
72
69
az connectedmachine extension list --resource-group resourceGroupName --machine-name machineName --query "[].{Name:name, AutoUpgrade:properties.enableAutoUpgrade}" --output table
73
70
```
74
71
75
72
## Extension upgrades with multiple extensions
76
73
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.
78
75
79
76
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.
80
77
@@ -84,20 +81,18 @@ To disable Automatic Extension Upgrade (preview) for an extension, you must ensu
84
81
85
82
### Using the Azure CLI
86
83
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.
- 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).
102
97
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