Wiki source code of Wartungszeitfenster
Last modified by Sabrina V. on 2025/12/09 10:16
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{aagon.floatingbox/}} | ||
| 2 | |||
| 3 | = General information about Maintenance Windows = | ||
| 4 | |||
| 5 | Maintenance windows are fixed periods during which systems, applications, or services are scheduled for maintenance, updates, or repairs. If no maintenance windows are defined, unexpected disruptions or failures may occur if maintenance is performed during working time. | ||
| 6 | |||
| 7 | With the help of maintenance windows, ACMP now offers you the option of centrally creating time profiles for maintenance work, thereby preventing work on clients outside of the maintenance windows. Defining start and end times, general calendar days, and one-time or recurring time windows enables the predictable and transparent management of maintenance work. | ||
| 8 | |||
| 9 | The maintenance profiles you create can then be linked to the clients in the containers. You can execute the jobs as usual via your existing containers. However, if you have jobs that are not within the | ||
| 10 | |||
| 11 | maintenance time windows, these jobs will not be executed (anymore). | ||
| 12 | |||
| 13 | = Create a maintenance window profile = | ||
| 14 | |||
| 15 | To assign maintenance periods to selected clients, first create a maintenance window profile. To do this, navigate to Client Management > Maintenance Window in the ACMP Console. This area is where all maintenance window-related tasks are performed. Here you can view existing profiles, create new profiles, edit existing profiles, and delete obsolete ones. | ||
| 16 | |||
| 17 | To create a new profile, click //Add// in the ribbon bar. | ||
| 18 | |||
| 19 | {{figure}} | ||
| 20 | [[image:1760702589189-278.png]] | ||
| 21 | |||
| 22 | Creating an initial maintenance window profile | ||
| 23 | {{/figure}} | ||
| 24 | |||
| 25 | A wizard opens where you can give the profile a name, specify a destination folder for the profile, and optionally add a continuing description. | ||
| 26 | If multi tenancy is enabled in ACMP, you can also specify whether the profile is global or assigned to a single ACMP client. | ||
| 27 | |||
| 28 | {{aagon.infobox}} | ||
| 29 | A maintenance window profile can apply globally and thus be used by all clients, or it can be assigned to a maximum of one tenant and then only be used by clients of that tenant. | ||
| 30 | {{/aagon.infobox}} | ||
| 31 | |||
| 32 | Confirm with //Continuing//. | ||
| 33 | |||
| 34 | On the next page, specify the period during which maintenance is to take place. | ||
| 35 | |||
| 36 | {{figure}} | ||
| 37 | [[image:1760702720715-117.png]] | ||
| 38 | |||
| 39 | Set time window | ||
| 40 | {{/figure}} | ||
| 41 | |||
| 42 | You can control the calendar and settings using the button bar or select a calendar day and make the desired settings there. | ||
| 43 | |||
| 44 | (% style="width:771px" %) | ||
| 45 | |(% style="width:97px" %)((( | ||
| 46 | [[image:1760702821290-563.png]] | ||
| 47 | )))|(% style="width:670px" %)((( | ||
| 48 | Add a one-time scheduled time slot to the selected calendar day. | ||
| 49 | ))) | ||
| 50 | |(% style="width:97px" %)((( | ||
| 51 | [[image:1760702821292-838.png]] | ||
| 52 | )))|(% style="width:670px" %)((( | ||
| 53 | Add a recurrence to the selected calendar day. | ||
| 54 | ))) | ||
| 55 | |(% style="width:97px" %)((( | ||
| 56 | [[image:1760702821293-650.png]] | ||
| 57 | )))|(% style="width:670px" %)((( | ||
| 58 | Edit the time window. | ||
| 59 | ))) | ||
| 60 | |(% style="width:97px" %)((( | ||
| 61 | [[image:1760702821293-148.png]] | ||
| 62 | )))|(% style="width:670px" %)((( | ||
| 63 | Delete the time slot. | ||
| 64 | ))) | ||
| 65 | |(% style="width:97px" %)((( | ||
| 66 | [[image:1760702821294-247.png]] | ||
| 67 | )))|(% style="width:670px" %)((( | ||
| 68 | Goes forward or back one calendar day/month/year. | ||
| 69 | ))) | ||
| 70 | |(% style="width:97px" %)((( | ||
| 71 | [[image:1760702821296-984.png]] | ||
| 72 | )))|(% style="width:670px" %)((( | ||
| 73 | Go to today's day on the calendar. | ||
| 74 | ))) | ||
| 75 | |(% style="width:97px" %)((( | ||
| 76 | [[image:1760702821296-843.png]] | ||
| 77 | )))|(% style="width:670px" %)((( | ||
| 78 | Goes to a specific day in the calendar. | ||
| 79 | ))) | ||
| 80 | |(% style="width:97px" %)((( | ||
| 81 | [[image:1760702821297-463.png]] | ||
| 82 | )))|(% style="width:670px" %)((( | ||
| 83 | The calendar is displayed as a weekly view. | ||
| 84 | ))) | ||
| 85 | |(% style="width:97px" %)((( | ||
| 86 | [[image:1760702821298-817.png]] | ||
| 87 | )))|(% style="width:670px" %)((( | ||
| 88 | The calendar is displayed in a monthly view. | ||
| 89 | ))) | ||
| 90 | |(% style="width:97px" %)((( | ||
| 91 | [[image:1760702821298-355.png]] | ||
| 92 | )))|(% style="width:670px" %)((( | ||
| 93 | The calendar is displayed as an annual view. | ||
| 94 | ))) | ||
| 95 | |(% style="width:97px" %)((( | ||
| 96 | [[image:1760702821298-889.png]] | ||
| 97 | )))|(% style="width:670px" %)((( | ||
| 98 | The calendar is displayed as an event view. | ||
| 99 | ))) | ||
| 100 | |||
| 101 | To create an appointment for a maintenance time slot, either click using a double-click on a day in the calendar or select a day and then click on . The following window will open: | ||
| 102 | |||
| 103 | {{figure}} | ||
| 104 | |||
| 105 | |||
| 106 | [[image:1760702956735-494.png]] | ||
| 107 | |||
| 108 | Add a scheduled time slot | ||
| 109 | {{/figure}} | ||
| 110 | |||
| 111 | Here you can give the appointment a name and specify the start and end times. If you do not want to specify a specific time but want to schedule the entire day for maintenance, you can click the //All Day// checkbox. | ||
| 112 | |||
| 113 | If you decide to turn the appointment into a series, you can also click //Make Recurring// and configure continuing settings there. | ||
| 114 | |||
| 115 | Then click //OK// if you want to apply the configuration you have configured. | ||
| 116 | |||
| 117 | If you want to create a series of appointments for maintenance, click [[image:1760703028559-388.png]] to set recurring appointments. The following window will open: | ||
| 118 | |||
| 119 | {{figure}} | ||
| 120 | |||
| 121 | |||
| 122 | [[image:1760703113873-796.png]] | ||
| 123 | |||
| 124 | Add a recurring time slot | ||
| 125 | {{/figure}} | ||
| 126 | |||
| 127 | Here you can set the start and end times individually under //Event time//. The duration always starts from the start time and customizes the end time according to the selected duration. | ||
| 128 | |||
| 129 | In the “Recurrence pattern” section, you can configure the frequency of the recurrences. | ||
| 130 | |||
| 131 | Finally, under “Range of recurrence,” you can set the period over which the series should extend. | ||
| 132 | |||
| 133 | Then click “OK” if you want to apply the configured configuration. | ||
| 134 | |||
| 135 | You will then see the newly set time slots in the calendar view. | ||
| 136 | |||
| 137 | {{figure}} | ||
| 138 | |||
| 139 | |||
| 140 | [[image:1760703284081-382.png]] | ||
| 141 | |||
| 142 | Example of a time slot with recurrence | ||
| 143 | {{/figure}} | ||
| 144 | |||
| 145 | Then click //Done// here as well if you want to leave the time slots as they are and do not want to set any continuing group and user accesses. | ||
| 146 | |||
| 147 | If you click //Continuing//, you can configure access for groups and individual users on the next page. Then click //Done//. | ||
| 148 | |||
| 149 | The newly created profile and its time frames will then appear in the workspace. The //General// tab contains settings for the name, the set maintenance periods, and the client settings. In the //Time Frames// tab, the set periods are displayed again in the calendar view. | ||
| 150 | |||
| 151 | {{figure}} | ||
| 152 | [[image:1760703417740-406.png]] | ||
| 153 | |||
| 154 | The scheduled maintenance windows | ||
| 155 | {{/figure}} | ||
| 156 | |||
| 157 | = Linking profiles to containers = | ||
| 158 | |||
| 159 | To assign a maintenance window profile to a client, this should be done via a container. All clients that are assigned to the container and linked to a maintenance profile will then receive this profile. The current maintenance window profile is loaded each time the ACMP agent is started and when the job scanner is executed. | ||
| 160 | |||
| 161 | {{aagon.infobox}} | ||
| 162 | Please note that a client's maintenance window depends on its container affiliation. It is not possible to perform a direct mapping of a maintenance window profile to a client! | ||
| 163 | {{/aagon.infobox}} | ||
| 164 | |||
| 165 | {{aagon.versionierungsbox}} | ||
| 166 | Please note that the assignment of a maintenance window profile to containers with [[Unix Agents>>doc:ACMP.69.Arbeiten mit der ACMP Console.Clients erfassen.Unix Agent installieren.WebHome]] (version 1.12) is only possible in full from AESB version 1.11.2 onwards | ||
| 167 | {{/aagon.versionierungsbox}} | ||
| 168 | |||
| 169 | Navigate to //Client Management > Containers//. Either select an existing container or create a new one. In the workspace, open the //Maintenance Window// tab. There you can assign a profile either by clicking //Click to assign a maintenance profile// or by using the //Assign// ribbon bar. After the assignment of a maintenance profile, the calendar view appears with the set time windows. | ||
| 170 | |||
| 171 | {{figure}} | ||
| 172 | [[image:1760703607804-734.png]] | ||
| 173 | |||
| 174 | The maintenance time windows set in containers | ||
| 175 | {{/figure}} | ||
| 176 | |||
| 177 | You can also use the ribbon bar to remove the profile from the container or edit it if necessary. | ||
| 178 | |||
| 179 | {{aagon.infobox}} | ||
| 180 | If you have created a subcontainer, the corresponding profile of the main container is automatically inherited. However, if you want to interrupt this inheritance, you can do so via the ribbon bar in the Inheritance > Cancel section and assign a different maintenance window profile to the container if necessary. | ||
| 181 | {{/aagon.infobox}} | ||
| 182 | |||
| 183 | In the container overview, you can finally identify the type of container by the icon [[image:1760703656038-167.png]], which containers have been assigned a maintenance window profile and which have not. | ||
| 184 | |||
| 185 | {{figure}} | ||
| 186 | [[image:1760703723579-523.png]] | ||
| 187 | |||
| 188 | container with and without maintenance time profiles | ||
| 189 | {{/figure}} | ||
| 190 | |||
| 191 | {{aagon.infobox}} | ||
| 192 | Saving a maintenance window profile after its assignment to a container-associated client may take some time. | ||
| 193 | {{/aagon.infobox}} | ||
| 194 | |||
| 195 | = Maintenance windows and jobs = | ||
| 196 | |||
| 197 | To ensure that maintenance tasks can be performed within a specified maintenance window, jobs or, if necessary, a job collection must be added to a container. These can then only be processed during the maintenance window. | ||
| 198 | You can read about the general definition and execution of jobs in the chapter [[Jobs>>doc:ACMP.69.ACMP-Solutions.Jobs.WebHome]]. | ||
| 199 | |||
| 200 | {{aagon.infobox}} | ||
| 201 | A job that takes a maintenance period into account can no longer be started if it is outside the maintenance period. However, a job that takes a maintenance period into account will execute a job that has already been started, even if the end of the maintenance window has been exceeded. However, any continuing pending jobs will no longer be started. | ||
| 202 | {{/aagon.infobox}} | ||
| 203 | |||
| 204 | In addition to container jobs, jobs can also be created that are pushed for one-time and short-term execution. If the job is pushed to a client that has a maintenance profile assigned to it and is not in a valid maintenance window, the administrator can decide when the job should execute: | ||
| 205 | |||
| 206 | 1. The job should execute outside the maintenance window. | ||
| 207 | |||
| 208 | {{aagon.infobox}} | ||
| 209 | This option is only available if you have been given permission to ignore maintenance windows. | ||
| 210 | {{/aagon.infobox}} | ||
| 211 | |||
| 212 | 2. The job should execute in the next maintenance window. | ||
| 213 | 3. The push process for the job should be canceled. | ||
| 214 | Regardless of the type of job, all jobs that have been scheduled outside of a maintenance window can be viewed in the [[Jobmonitor>>doc:ACMP.69.Arbeiten mit der ACMP Console.Aufbau der Console.Ribbonleiste.Monitore.WebHome]]. | ||
| 215 | |||
| 216 |

