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/update-manager/pre-post-scripts-overview.md
+12-11Lines changed: 12 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
title: An overview of pre and post events (preview) in your Azure Update Manager
3
3
description: This article provides an overview on pre and post events (preview) and its requirements.
4
4
ms.service: azure-update-manager
5
-
ms.date: 05/28/2024
5
+
ms.date: 06/11/2024
6
6
ms.topic: conceptual
7
7
author: SnehaSudhir
8
8
ms.author: sudhirsneha
@@ -28,7 +28,7 @@ The following are the scenarios where you can define pre and post events:
28
28
|Notification email | Send a notification alert before patching is triggered. |
29
29
|Stop services | To stop services like Gateway services, NPExServices, SQL services etc.|
30
30
31
-
#### [Post Event](#tab/postevent)
31
+
#### [Post Events](#tab/postevent)
32
32
33
33
|**Scenario**|**Description**|
34
34
|----------|-------------|
@@ -47,8 +47,8 @@ For a given schedule, you have the option to include a pre-event, post-event, or
47
47
1.**Pre-event** - Tasks that run before the schedule maintenance window begins. For example - Turn on the machines prior to patching.
48
48
1.**Cancellation** - In this step, you can initiate the cancellation of the schedule run. Some scenarios where you might choose to cancel a schedule run include pre-event failures or pre-event didn't complete execution.
49
49
50
-
> [!NOTE]
51
-
> You must initiate cancellation as part of the pre-event; Azure Update Manager or maintenance configuration will not automatically cancel the schedule. If you fail to cancel, the schedule run will proceed with installing updates during the user-defined maintenance window.
50
+
> [!NOTE]
51
+
> You must initiate cancellation as part of the pre-event; Azure Update Manager or maintenance configuration will not automatically cancel the schedule. If you fail to cancel, the schedule run will proceed with installing updates during the user-defined maintenance window.
52
52
53
53
1.**Updates installation** - Updates are installed as part of the user-defined schedule maintenance window.
54
54
1.**Post-event** - The post-event runs immediately after updates are installed. It occurs either within the maintenance window if update installation is complete and there's window left or outside the window if the maintenance window has ended. For example: Turn off the VMs post completion of the patching.
@@ -61,7 +61,7 @@ For more information on how to create schedule maintenance configurations, see [
61
61
62
62
Azure Update Manager uses [Event Grid](../event-grid/overview.md) to create and manage pre and post events on scheduled maintenance configurations. In Event Grid, you can choose from event handlers such as Azure Webhooks, Azure Functions etc., to trigger your pre and post activity.
63
63
64
-
:::image type="content" source="./media/pre-post-scripts-overview/overview.png" alt-text="Screenshot that shows the sequence of execution for a schedule with pre and post." lightbox="./media/pre-post-scripts-overview/overview.png":::
64
+
:::image type="content" source="./media/pre-post-scripts-overview/overview.png" alt-text="Screenshot that shows the sequence of execution for a schedule with pre and post." lightbox="./media/pre-post-scripts-overview/overview.png":::
65
65
66
66
> [!NOTE]
67
67
> If you're using pre and post events in Azure Automation Update management and plan to move to Azure Update Manager, we recommend that you use Azure Webhooks linked to Automation Runbooks. [Learn more](tutorial-webhooks-using-runbooks.md).
@@ -76,14 +76,15 @@ We recommend you to go through the following table to understand the timeline of
76
76
77
77
For example, if a maintenance schedule is set to start at **3:00 PM**, with the maintenance window of 3 hours and 55 minutes for **Guest** maintenance scope, The schedule has one pre-event and one post-event following are the details:
78
78
79
+
79
80
|**Time**|**Details**|
80
81
|----------|-------------|
81
-
| 2:19 PM | Since the schedule run starts at 3:00 PM, you can modify the machines or scopes 40 mins before the start time (i.e) at 2:19 PM. </br> **Note** This applies if you're creating a new schedule or editing an existing schedule with a pre-event.
82
-
| 2:20 PM - 2:30 PM | Since the pre-event gets triggered at least 30 mins prior, it can get triggered anytime between 2:20 PM to 2:30 PM. |
83
-
| 2:30 PM - 2:50 PM | The pre-event runs from 2:30 PM to 2:50 PM. The pre-event must complete the tasks by 2:50 PM. </br> **Note** If you have more than one pre-event configured, all the events must run within 20 minutes. In case of multiple pre-events, all of them will execute independently of each other. You can customize as per your needs by defining the logic in the pre-events. For example, if you want 2 pre-events to run sequentially, you can include a delayed start time in your 2nd pre-event’s logic. </br> If the pre-event continues to run beyond 20 mins or fails, you can choose to cancel the schedule run otherwise the patch installation proceeds irrespective of the pre-event run status.|
84
-
| 2:50 PM | The latest time that can invoke the cancellation API is 2:50 PM. **Note** If cancellation API fails to get invoked or hasn't been set up, the patch installation proceeds to run.|
85
-
| 3:00 PM | The schedule run is triggered at 3:00 PM |
86
-
| 6:55 PM | - At 6:55 PM, the schedule completes installing the updates during the 3 hours 55-mins maintenance window. </br> The post event triggers at 6:55 PM once the updates are installed. </br> **Note** If you have defined a shorter maintenance window of 2 hours, the post maintenance event will trigger after 2 hours and if the update installation is completed before the stipulated time of 2 hours (i.e) 1 hours 50 mins, the post event will start immediately.
82
+
| 2:19 PM | Since the schedule run starts at 3:00 PM, you can modify the machines or scopes 40 mins before the start time (i.e) at 2:19 PM. </br> **Note** This applies if you're creating a new schedule or editing an existing schedule with a pre-event.
83
+
| 2:20 PM - 2:30 PM | Since the pre-event gets triggered at least 30 mins prior, it can get triggered anytime between 2:20 PM to 2:30 PM. |
84
+
| 2:30 PM - 2:50 PM | The pre-event runs from 2:30 PM to 2:50 PM. The pre-event must complete the tasks by 2:50 PM. </br> **Note** If you have more than one pre-event configured, all the events must run within 20 minutes. In case of multiple pre-events, all of them will execute independently of each other. You can customize as per your needs by defining the logic in the pre-events. For example, if you want 2 pre-events to run sequentially, you can include a delayed start time in your 2nd pre-event’s logic. </br> If the pre-event continues to run beyond 20 mins or fails, you can choose to cancel the schedule run otherwise the patch installation proceeds irrespective of the pre-event run status.|
85
+
| 2:50 PM | The latest time that can invoke the cancellation API is 2:50 PM. **Note** If cancellation API fails to get invoked or hasn't been set up, the patch installation proceeds to run.|
86
+
| 3:00 PM | The schedule run is triggered at 3:00 PM |
87
+
| 6:55 PM | - At 6:55 PM, the schedule completes installing the updates during the 3 hours 55-mins maintenance window. </br> The post event triggers at 6:55 PM once the updates are installed. </br> **Note** If you have defined a shorter maintenance window of 2 hours, the post maintenance event will trigger after 2 hours and if the update installation is completed before the stipulated time of 2 hours (i.e) 1 hours 50 mins, the post event will start immediately.
87
88
88
89
We recommend that you're watchful of the following:
89
90
- If you're creating a new schedule or editing an existing schedule with a pre event, you need at least 40 minutes prior to the start of maintenance window (3:00 PM in the above example) for the pre event to run otherwise it will lead to auto-cancellation of the current scheduled run.
0 commit comments