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/virtual-machines/maintenance-configurations.md
+7-8Lines changed: 7 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -20,7 +20,7 @@ Maintenance Configurations gives you the ability to control and manage updates f
20
20
21
21
## Scopes
22
22
23
-
Maintenance Configurations currently supports three (3) scopes: Host, OS image, and Guest. While each scope allows scheduling and managing updates, the major difference lies in the resource they each support. This section outlines the details on the various scopes and their supported types:
23
+
Maintenance Configurations currently support three (3) scopes: Host, OS image, and Guest. While each scope allows scheduling and managing updates, the major difference lies in the resource they each support. This section outlines the details on the various scopes and their supported types:
24
24
25
25
| Scope | Support Resources |
26
26
|----------|----------------------------|
@@ -30,11 +30,11 @@ Maintenance Configurations currently supports three (3) scopes: Host, OS image,
30
30
31
31
### Host
32
32
33
-
With this scope, you can manage platform updates that do not require a reboot on your *isolated VMs*, *isolated Virtual Machine Scale Set instances* and *dedicated hosts*. Some features and limitations unique to the host scope are:
33
+
With this scope, you can manage platform updates that don't require a reboot on your *isolated VMs*, *isolated Virtual Machine Scale Set instances* and *dedicated hosts*. Some features and limitations unique to the host scope are:
34
34
35
35
- Schedules can be set anytime within 35 days. After 35 days, updates are automatically applied.
36
36
- A minimum of a 2 hour maintenance window is required for this scope.
37
-
- Rack level maintenance is not currently supported.
37
+
- Rack level maintenance isn't currently supported.
38
38
39
39
[Learn more about Azure Dedicated Hosts](dedicated-hosts.md)
40
40
@@ -47,8 +47,7 @@ Using this scope with maintenance configurations lets you decide when to apply u
47
47
- A minimum of 5 hours is required for the maintenance window.
48
48
49
49
### Guest
50
-
51
-
This scope is integrated with [Update Manager](../update-center/overview.md), which allows you to save recurring deployment schedules to install updates for your Windows Server and Linux machines in Azure, in on-premises environments, and in other cloud environments connected using Azure Arc-enabled servers. Some features and limitations unique to this scope include:
50
+
This scope integrates with [Update Manager](../update-center/overview.md). It allows you to save recurring deployment schedules to install updates for your Windows Server and Linux machines in Azure, in on-premises environments, and in other cloud environments connected using Azure Arc-enabled servers. Some features and limitations unique to this scope include:
52
51
53
52
-[Patch orchestration](automatic-vm-guest-patching.md#patch-orchestration-modes) for virtual machines need to be set to AutomaticByPlatform
54
53
@@ -63,7 +62,7 @@ This scope is integrated with [Update Manager](../update-center/overview.md), wh
63
62
> 1. The minimum maintenance window has been increased from 1 hour 10 minutes to 1 hour 30 minutes, while the minimum repeat value has been set to 6 hours for new schedules. **Please note that your existing schedules will not get impacted; however, we strongly recommend updating existing schedules to include these new changes.**
64
63
> 2. The count of characters of Resource Group name along with Maintenance Configuration name should be less than 128 characters
65
64
66
-
Maintenance Configuration provides two scheduled patching modes for In-guest VMs: Static Mode and [Dynamic Scope](../update-manager/dynamic-scope-overview.md) Mode. By default, the system operates in Static Mode if no Dynamic Scope Mode is configured. To schedule or modify the maintenance configuration in either mode, a buffer of 15 minutes prior to the scheduled patch time is required. For instance, if the patch is scheduled for 3PM, all modifications, including adding or removing VMs, altering the dynamic scope etc., should be finalized by 2:45PM.
65
+
Maintenance Configuration provides two scheduled patching modes for In-guest VMs: Static Mode and [Dynamic Scope](../update-manager/dynamic-scope-overview.md) Mode. By default, the system operates in Static Mode if no Dynamic Scope Mode is configured. To schedule or modify the maintenance configuration in either mode, a buffer of 15 minutes before the scheduled patch time is required. For instance, if we schedule the patch for 3 PM, all modifications, including adding or removing VMs, altering the dynamic scope, etc., should finalize before 2:45 PM.
67
66
68
67
To learn more about this topic, checkout [Update Manager and scheduled patching](../update-center/scheduled-patching.md)
69
68
@@ -77,9 +76,9 @@ To learn more about this topic, checkout [Update Manager and scheduled patching]
77
76
> In the dynamic scope, the steps are similar, but after removing the assignment in step 1, you simply need to initiate or wait for the next scheduled run. This action prompts the system to completely remove the assignment, enabling you to proceed with steps 2 and 3.
78
77
> If you forget/miss any one of the above mentioned steps, you can reassign the resource to original assignment and repeat the steps again sequentially.
79
78
80
-
## Shut Down Machines
79
+
## Shutdown Machines
81
80
82
-
We are unable to apply maintenance updates to any shut down machines. You need to ensure that your machine is turned on at least 15 minutes before a scheduled update or your update may not be applied. If your machine is in a shutdown state at the time of your scheduled update, it may appear that the maintenance configuration has been disassociated on the Azure portal, and this is only a display issue that the team is currently working to fix it. The maintenance configuration has not been completely disassociated and you can check it via CLI using [check configuration](maintenance-configurations-cli.md#check-configuration).
81
+
We're unable to apply maintenance updates to any shutdown machines. You need to ensure that your machine is turned on at least 15 minutes before a scheduled update or your update may not be applied. If your machine is in a shutdown state at the time of your scheduled update, it may appear that the maintenance configuration has been disassociated on the Azure portal. This is only a display issue that the team is currently working to fix it. The maintenance configuration hasn't been disassociated and you can check it via CLI using [check configuration](maintenance-configurations-cli.md#check-configuration).
Copy file name to clipboardExpand all lines: articles/virtual-machines/troubleshoot-maintenance-configurations.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -20,7 +20,7 @@ Scheduled patching doesn't install the patches on the VMs and gives an error `Sh
20
20
21
21
#### Resolution
22
22
It takes 12 hours to complete the cleanup process for the maintenance configuration assignment so make sure to keep the buffer of 12 hours before recreating the VM with the same name.
23
-
If a new VM is recreated with the same name before the cleanup, Maintenance Configuration service will be unable to trigger the schedule.
23
+
If a new VM is recreated with the same name before the cleanup, Maintenance Configuration service is unable to trigger the schedule.
24
24
25
25
### Shutdown and Unresponsive VM when using `static` scope in Guest Maintenance
26
26
@@ -61,7 +61,7 @@ In order to create a dynamic scope, user must have the permission at the subscri
61
61
User initiated update stuck for long time and update is not progressing
62
62
63
63
#### Resolution
64
-
If a resource is redeployed to a different cluster, and a pending update request is created using the old cluster value, the request becomes stuck indefinitely. If the status of the apply update operation is closed/not found, then retry after 120 hours. If the issue persist, contact the support team for further mitigation.
64
+
If a resource is redeployed to a different cluster, and a pending update request is created using the old cluster value, the request becomes stuck indefinitely. If the status of the apply update operation is closed/not found, then retry after 120 hours. If the issue persists, contact the support team for further mitigation.
65
65
66
66
### Dedicated host updates even after Maintenance Configuration is attached
67
67
@@ -77,15 +77,15 @@ If a Dedicated Host is recreated with the same name, Maintenance Configuration s
77
77
Install patch operation failed due to invalid classification type in Maintenance Configuration
78
78
79
79
#### Resolution
80
-
Due to a previous bug, the system patch operation couldn't perform validation, and an invalid classification type was found in the Maintenance Configuration. The bug has been fixed and deployed. To address this issue, customers can update the Maintenance Configuration and set the correct classification type.
80
+
Due to a previous bug, the system patch operation couldn't perform validation, and an invalid classification type was found in the Maintenance Configuration. The bug is fixed and deployed. To address this issue, customers can update the Maintenance Configuration and set the correct classification type.
81
81
82
82
### Schedule didn't trigger
83
83
84
84
#### Issue
85
85
If a resource has two maintenance configurations with the same trigger time and an install patch configuration, and both are assigned to the same VM/resource, only one maintenance configuration triggers.
86
86
87
87
#### Resolution
88
-
Please modify the start time of one of the maintenance configurations to mitigate the issue. It's a known system limitation due to which Maintenance Configuration is unable to identify which maintenance configuration triggers. The team is working on solving this limitation.
88
+
Modify the start time of one of the maintenance configurations to mitigate the issue. It's a known system limitation due to which Maintenance Configuration is unable to identify which maintenance configuration triggers. The team is working on solving this limitation.
89
89
90
90
### Unable to create dynamic scope (at Resource Group Level)
91
91
@@ -125,15 +125,15 @@ This is a currently known limitation on the portal. The team is working on makin
125
125
Maintenance Configuration executed again with the older trigger time, after the update
126
126
127
127
#### Resolution
128
-
There's a known issue in Maintenance Schedule related to the caching of old maintenance policies. If an old policy is cached and the new policy processing is moved to a new instance, the old machine may trigger the schedule with the outdated start time. It's recommended to update the Maintenance Configuration at least 1 hour before. If the issue persists, reach out to support team for further assistance.
128
+
There's a known issue in Maintenance Schedule related to the caching of old maintenance policies. If an old policy is cached, and a new instance moves the new policy processing, the old machine may trigger the schedule with the outdated start time. We recommend to update the Maintenance Configuration at least 1 hour before. If the issue persists, reach out to support team for further assistance.
129
129
130
130
### Schedule timeout, waiting for an ongoing update to complete the resource
131
131
132
132
#### Issue
133
133
Maintenance configuration timeout due to the host update window coinciding with the guest (VM) patching window
134
134
135
135
#### Resolution
136
-
In rare cases if platform catchup host update window happens to coincide with the guest (VM) patching window and if the guest patching window don't get sufficient time to execute after host update then the system would show **Schedule timeout, waiting for an ongoing update to complete the resource** error since only a single update is allowed by the platform at a time.
136
+
In rare cases if platform catchup host update window happens to coincide with the guest (VM) patching window and if the guest patching window doesn't get sufficient time to execute after host update then the system would show **Schedule timeout, waiting for an ongoing update to complete the resource** error since only a single update is allowed by the platform at a time.
0 commit comments