Wiki source code of Wartungszeitfenster

Last modified by Steffi F on 2025/12/12 08:19

version	line-number	content
4.1	1	{{aagon.floatingbox/}}
	2
46.1	3	= General information about Maintenance Windows =
4.1	4
46.1	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.
4.1	6
46.1	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.
4.1	8
46.1	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
4.1	10
46.1	11	maintenance time windows, these jobs will not be executed (anymore).
4.1	12
46.1	13	= Create a maintenance window profile =
4.1	14
46.1	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.
4.1	16
46.1	17	To create a new profile, click //Add// in the ribbon bar.
	18
4.1	19	{{figure}}
46.1	20	[[image:Wizard 1. Seite.png\|\|alt="1760702589189-278.png"]]
4.1	21
46.1	22	Creating an initial maintenance window profile
4.1	23	{{/figure}}
	24
46.1	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.
26.1	27
	28	{{aagon.infobox}}
46.1	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.
26.1	30	{{/aagon.infobox}}
	31
46.1	32	Confirm with //Continuing//.
26.1	33
46.1	34	On the next page, specify the period during which maintenance is to take place.
26.1	35
	36	{{figure}}
46.1	37	[[image:Wizard 2. Seite.png\|\|alt="1760702720715-117.png"]]
26.1	38
46.1	39	Set time window
26.1	40	{{/figure}}
	41
46.1	42	You can control the calendar and settings using the button bar or select a calendar day and make the desired settings there.
26.1	43
	44	(% style="width:771px" %)
	45	\|(% style="width:97px" %)(((
	46	[[image:1760702821290-563.png]]
	47	)))\|(% style="width:670px" %)(((
46.1	48	Add a one-time scheduled time slot to the selected calendar day.
26.1	49	)))
	50	\|(% style="width:97px" %)(((
	51	[[image:1760702821292-838.png]]
	52	)))\|(% style="width:670px" %)(((
46.1	53	Add a recurrence to the selected calendar day.
26.1	54	)))
	55	\|(% style="width:97px" %)(((
	56	[[image:1760702821293-650.png]]
	57	)))\|(% style="width:670px" %)(((
46.1	58	Edit the time window.
26.1	59	)))
	60	\|(% style="width:97px" %)(((
	61	[[image:1760702821293-148.png]]
	62	)))\|(% style="width:670px" %)(((
46.1	63	Delete the time slot.
26.1	64	)))
	65	\|(% style="width:97px" %)(((
	66	[[image:1760702821294-247.png]]
	67	)))\|(% style="width:670px" %)(((
46.1	68	Goes forward or back one calendar day/month/year.
26.1	69	)))
	70	\|(% style="width:97px" %)(((
	71	[[image:1760702821296-984.png]]
	72	)))\|(% style="width:670px" %)(((
46.1	73	Go to today's day on the calendar.
26.1	74	)))
	75	\|(% style="width:97px" %)(((
	76	[[image:1760702821296-843.png]]
	77	)))\|(% style="width:670px" %)(((
46.1	78	Goes to a specific day in the calendar.
26.1	79	)))
	80	\|(% style="width:97px" %)(((
	81	[[image:1760702821297-463.png]]
	82	)))\|(% style="width:670px" %)(((
46.1	83	The calendar is displayed as a weekly view.
26.1	84	)))
	85	\|(% style="width:97px" %)(((
	86	[[image:1760702821298-817.png]]
	87	)))\|(% style="width:670px" %)(((
46.1	88	The calendar is displayed in a monthly view.
26.1	89	)))
	90	\|(% style="width:97px" %)(((
	91	[[image:1760702821298-355.png]]
	92	)))\|(% style="width:670px" %)(((
46.1	93	The calendar is displayed as an annual view.
26.1	94	)))
	95	\|(% style="width:97px" %)(((
	96	[[image:1760702821298-889.png]]
	97	)))\|(% style="width:670px" %)(((
46.1	98	The calendar is displayed as an event view.
26.1	99	)))
	100
46.1	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:
26.1	102
	103	{{figure}}
4.1	104
26.1	105
46.1	106	[[image:wiederholen.png\|\|alt="1760702956735-494.png"]]
26.1	107
46.1	108	Add a scheduled time slot
26.1	109	{{/figure}}
	110
46.1	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.
26.1	112
46.1	113	If you decide to turn the appointment into a series, you can also click //Make Recurring// and configure continuing settings there.
26.1	114
46.1	115	Then click //OK// if you want to apply the configuration you have configured.
26.1	116
46.1	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:
26.1	118
	119	{{figure}}
	120
	121
40.1	122	[[image:täglich.png]]
26.1	123
46.1	124	Add a recurring time slot
26.1	125	{{/figure}}
	126
46.1	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.
26.1	128
46.1	129	In the “Recurrence pattern” section, you can configure the frequency of the recurrences.
26.1	130
46.1	131	Finally, under “Range of recurrence,” you can set the period over which the series should extend.
26.1	132
46.1	133	Then click “OK” if you want to apply the configured configuration.
26.1	134
46.1	135	You will then see the newly set time slots in the calendar view.
26.1	136
	137	{{figure}}
	138
	139
46.1	140	[[image:wizard 3. Seite.png\|\|alt="1760703284081-382.png"]]
26.1	141
46.1	142	Example of a time slot with recurrence
26.1	143	{{/figure}}
	144
46.1	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.
26.1	146
46.1	147	If you click //Continuing//, you can configure access for groups and individual users on the next page. Then click //Done//.
26.1	148
46.1	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.
26.1	150
	151	{{figure}}
46.1	152	[[image:Time frames.png\|\|alt="1760703417740-406.png"]]
26.1	153
46.1	154	The scheduled maintenance windows
26.1	155	{{/figure}}
	156
46.1	157	= Linking profiles to containers =
26.1	158
46.1	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.
26.1	160
	161	{{aagon.infobox}}
46.1	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!
26.1	163	{{/aagon.infobox}}
	164
30.1	165	{{aagon.versionierungsbox}}
46.1	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
30.1	167	{{/aagon.versionierungsbox}}
	168
46.1	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.
26.1	170
	171	{{figure}}
	172	[[image:1760703607804-734.png]]
	173
46.1	174	The maintenance time windows set in containers
26.1	175	{{/figure}}
	176
46.1	177	You can also use the ribbon bar to remove the profile from the container or edit it if necessary.
26.1	178
	179	{{aagon.infobox}}
46.1	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.
26.1	181	{{/aagon.infobox}}
	182
46.1	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.
26.1	184
	185	{{figure}}
	186	[[image:1760703723579-523.png]]
	187
46.1	188	container with and without maintenance time profiles
26.1	189	{{/figure}}
	190
	191	{{aagon.infobox}}
46.1	192	Saving a maintenance window profile after its assignment to a container-associated client may take some time.
26.1	193	{{/aagon.infobox}}
	194
46.1	195	= Maintenance windows and jobs =
26.1	196
46.1	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]].
26.1	199
	200	{{aagon.infobox}}
46.1	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.
26.1	202	{{/aagon.infobox}}
	203
46.1	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:
26.1	205
46.1	206	1. The job should execute outside the maintenance window.
26.1	207
	208	{{aagon.infobox}}
46.1	209	This option is only available if you have been given permission to ignore maintenance windows.
26.1	210	{{/aagon.infobox}}
	211
46.1	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]].
26.1	215
	216