Skip to content

Commit f63cc9d

Browse files
authored
Merge pull request #271574 from ApnaLakshay/Troubleshooting-issues-updated
Changed structure of Troubleshoot document. Updated overview page
2 parents 48d8257 + 14502f3 commit f63cc9d

File tree

2 files changed

+99
-51
lines changed

2 files changed

+99
-51
lines changed

articles/virtual-machines/maintenance-configurations.md

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ Maintenance Configurations gives you the ability to control and manage updates f
2020
2121
## Scopes
2222

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:
2424

2525
| Scope | Support Resources |
2626
|----------|----------------------------|
@@ -30,11 +30,11 @@ Maintenance Configurations currently supports three (3) scopes: Host, OS image,
3030

3131
### Host
3232

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:
3434

3535
- Schedules can be set anytime within 35 days. After 35 days, updates are automatically applied.
3636
- 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.
3838

3939
[Learn more about Azure Dedicated Hosts](dedicated-hosts.md)
4040

@@ -47,8 +47,7 @@ Using this scope with maintenance configurations lets you decide when to apply u
4747
- A minimum of 5 hours is required for the maintenance window.
4848

4949
### 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:
5251

5352
- [Patch orchestration](automatic-vm-guest-patching.md#patch-orchestration-modes) for virtual machines need to be set to AutomaticByPlatform
5453

@@ -57,27 +56,29 @@ This scope is integrated with [Update Manager](../update-center/overview.md), wh
5756
- The upper maintenance window is 3 hours 55 mins.
5857
- A minimum of 1 hour and 30 minutes is required for the maintenance window.
5958
- The value of **Repeat** should be at least 6 hours.
60-
- The start time for a schedule should be at least 10 minutes after the schedule's creation time.
59+
- The start time for a schedule should be at least 15 minutes after the schedule's creation time.
6160

6261
>[!NOTE]
6362
> 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.**
6463
> 2. The count of characters of Resource Group name along with Maintenance Configuration name should be less than 128 characters
6564
66-
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.
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.
6766

6867
To learn more about this topic, checkout [Update Manager and scheduled patching](../update-center/scheduled-patching.md)
6968

7069
> [!IMPORTANT]
7170
> If you move a resource to a different resource group or subscription, then scheduled patching for the resource stops working as this scenario is currently unsupported by the system. The team is working to provide this capability but in the meantime, as a workaround, for the resource you want to move (in static scope)
71+
>
7272
> 1. You need to remove the assignment of it
7373
> 2. Move the resource to a different resource group or subscription
7474
> 3. Recreate the assignment of it
75+
>
7576
> 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.
7677
> 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.
7778
7879
## Shut Down Machines
7980

80-
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).
8182

8283
## Management options
8384

@@ -117,4 +118,5 @@ The following are the Dynamic Scope recommended limits for **each dynamic scope*
117118

118119
## Next steps
119120

120-
To learn more, see [Maintenance and updates](maintenance-and-updates.md).
121+
To troubleshoot issues, see [Troubleshoot Maintenance Configurations](troubleshoot-maintenance-configurations.md)
122+
To learn more, see [Maintenance and updates](maintenance-and-updates.md)

0 commit comments

Comments
 (0)