Skip to content

Commit 513018a

Browse files
committed
Made changes to improve acrolinx score
1 parent 10688b2 commit 513018a

File tree

2 files changed

+13
-14
lines changed

2 files changed

+13
-14
lines changed

articles/virtual-machines/maintenance-configurations.md

Lines changed: 7 additions & 8 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

@@ -63,7 +62,7 @@ This scope is integrated with [Update Manager](../update-center/overview.md), wh
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-
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.
6766

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

@@ -77,9 +76,9 @@ To learn more about this topic, checkout [Update Manager and scheduled patching]
7776
> 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.
7877
> 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.
7978
80-
## Shut Down Machines
79+
## Shutdown Machines
8180

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).
8382

8483
## Management options
8584

articles/virtual-machines/troubleshoot-maintenance-configurations.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ Scheduled patching doesn't install the patches on the VMs and gives an error `Sh
2020

2121
#### Resolution
2222
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.
2424

2525
### Shutdown and Unresponsive VM when using `static` scope in Guest Maintenance
2626

@@ -61,7 +61,7 @@ In order to create a dynamic scope, user must have the permission at the subscri
6161
User initiated update stuck for long time and update is not progressing
6262

6363
#### 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.
6565

6666
### Dedicated host updates even after Maintenance Configuration is attached
6767

@@ -77,15 +77,15 @@ If a Dedicated Host is recreated with the same name, Maintenance Configuration s
7777
Install patch operation failed due to invalid classification type in Maintenance Configuration
7878

7979
#### 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.
8181

8282
### Schedule didn't trigger
8383

8484
#### Issue
8585
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.
8686

8787
#### 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.
8989

9090
### Unable to create dynamic scope (at Resource Group Level)
9191

@@ -125,15 +125,15 @@ This is a currently known limitation on the portal. The team is working on makin
125125
Maintenance Configuration executed again with the older trigger time, after the update
126126

127127
#### 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.
129129

130130
### Schedule timeout, waiting for an ongoing update to complete the resource
131131

132132
#### Issue
133133
Maintenance configuration timeout due to the host update window coinciding with the guest (VM) patching window
134134

135135
#### 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.
137137

138138
### Unimplemented APIs
139139

0 commit comments

Comments
 (0)