Wiki-Quellcode von Jobs

Version 50.1 von jklein am 2025/05/09 09:07

Zeige letzte Bearbeiter
1 {{aagon.floatingbox/}}
2
3 Das Job Management ermöglicht Ihnen ein reibungsloses Managen von Aufgaben für die Clients und den Server.
4
5 Mit Jobs können einmalige oder wiederkehrende Aufgaben über den Server an verwaltbare Clients verteilt werden. Ein Job besteht dabei grundlegend aus 2 Teilen: Zum einen aus der Aufgabe selbst, zum anderen aus der Startbedingung. Zudem können Jobs einzeln oder in einer [[(% style="color:#3173b5" %)Job Collection>>doc:ACMP.68.ACMP-Solutions.Jobs.Job Collections.WebHome]](%%) angelegt und ausgeführt werden.
6
7 {{aagon.infobox}}
8 Jobs können, unabhängig von der Betriebssystemfamilie, ausschließlich auf verwalteten Clients ausgeführt werden. Diese Clients sind entsprechend über die Client-Icons [[image:Ico_ClientTypeService.png||height="24" width="24"]] [[image:Ico_ClientType_Linux_Managed.png||height="24" width="24"]][[image:Ico_ClientType_MacOs_Managed.png||height="24" width="24"]]gekennzeichnet.
9 {{/aagon.infobox}}
10
11 = Arten von Jobs =
12
13 Die Aufgabe eines Jobs ist grundlegend von seiner Art abhängig. Seit ACMP 6.8 wird zudem bei der Betriebssystemfamilie der Clients unterschieden, auf denen der Job ausgeführt werden soll. Daher gibt es Jobs für Clients mit Windows-Betriebssystemfamilie und Jobs für Clients mit Unix-Betriebssystemfamilie.
14
15 == Windows-Jobs ==
16
17 Bei Windows-Jobs können Sie zwischen folgenden Job-Arten wählen: Client Command, Job Collections, System Jobs, Managed Software und Windows Update Collections.
18
19 == Unix Jobs ==
20
21 Bei Unix-Jobs können Sie derzeit ausschließlich Unix Scripts als Jobs ausführen.
22
23 {{aagon.infobox}}
24 Beachten Sie, dass für die Ausführung von Unix Jobs eine funktionierende SICS-Verbindung benötigt wird. Weitere Informationen dazu finden Sie im Abschnitt __[[Unix Scripts>>doc:ACMP.68.ACMP-Solutions.Desktop Automation.Unix Scripts.WebHome]]__.
25 {{/aagon.infobox}}
26
27 = Ausführungen von Jobs =
28
29 Sie haben die Möglichkeit, Jobs entweder einmalig manuell oder wiederkehrend, in einem von Ihnen bestimmten Turnus, zu starten. Für beide Varianten legen Sie vorab Startbedingungen fest, zu wann der Job ausgeführt werden soll.
30
31 {{aagon.infobox}}
32 Beachten Sie, dass die Ausführung von Jobs einer Gruppe sequenziell verlaufen. D.h., wenn Sie mehrere Client Command-Jobs anlegen, werden diese nacheinander ausgeführt. Haben Sie jedoch einen Client Command-Job und einen System Job gestartet, können diese nicht sequenziell, sondern parallel ausgeführt werden. Beide Jobs stammen aus einer anderen Job-Gruppe.
33 {{/aagon.infobox}}
34
35 == Einen manuellen Job ausführen ==
36
37 Ein manueller Job wird immer nur einmalig ausgeführt. Um einen Job manuell zu starten, müssen Sie zuerst eine Abfrage durchführen und die Clients auswählen, auf denen der Job ausgeführt werden soll. Beachten Sie dabei, dass die Job-Ausführung immer nur für eine Betriebssystemfamilie möglich ist. Für ggf. ausgewählte Clients einer anderen Betriebssystemfamilie wird der Job übersprungen.
38
39 1. Wählen Sie die Clients aus, auf denen der Job einmalig ausgeführt werden soll.
40 1. Klicken Sie in der Ribbonleiste abhängig von der Betriebssystemfamilie der ausgewählten Clients entweder auf Windows-//Jobs ausführen //oder auf //Unix-Jobs ausführen.//
41 1. Wähle Sie im sich öffnenden Wizard die Art des Jobs aus (Client Command, Job Collections, System Jobs, Managed Software, Windows Update Collections oder Unix Scripts).
42 1. Führen Sie in der Ordneransicht einen Doppelklick auf jeden Job aus, der ausgeführt werden soll. Alternativ können Sie die Jobs auch per Drag-and-Drop in den rechten Fensterbereich ziehen.
43 1. Konfigurieren Sie ggf. die Parameter-Einstellungen für die ausgewählten Jobs.
44 1. Passen Sie bei mehreren Jobs über die Pfeile im rechten Fensterbereich ggf. die Reihenfolge an, in der die Jobs ausgeführt werden sollen.
45 1. Wählen Sie ggf. den Verteilungsring aus, der für die ausgewählten Jobs verwendet werden soll.
46 1. Klicken Sie auf den Button //Weiter >.//
47 1. Legen Sie bei Bedarf individuelle Startbedingungen für die Ausführung fest.
48 1. Klicken Sie auf den Button //Ausführen.//
49
50 {{aagon.infobox}}
51 Das Console Skript eines Client Commands wird nur beim Pushen eines Jobs ausgeführt. Hier wird es mit den Rechten, mit dem die ACMPConsole.exe gestartet wurde, ausgeführt. Die Ausführung erfolgt dabei auf der Console, die das Command angestoßen hat. Es wird erst das Console-Skript ausgeführt und nur, wenn dies erfolgreich durchgelaufen ist, wird dann auch das Client-Skript ausgeführt. Der Verbindungsaufbau zu den Clients erfolgt vom ACMP Server aus.
52 {{/aagon.infobox}}
53
54 [[Manuelle Ausführung von Jobs>>image:Jobs_Manuelle Ausführung.png||alt="Manuelle Ausführung von Jobs"]]
55
56 == Einen Container-Job ausführen ==
57
58 Einem Container wird ein Job bzw. eine ganze Job Collection angehängt, welche entweder wiederkehrend oder einmalig auf dem ACMP Agenten gestartet wird.
59
60 Sollte der Server den Client nicht erreichen, holt der Client sich die ihm zugewiesenen Jobs. Sollte der Client ausgeschaltet sein, wird dieser zu einem späteren Zeitpunkt beim Start des ACMP Agent Dienstes ausgeführt.
61
62 Im Gegensatz zum gepushten Job wird beim Container-Job kein Console Skript ausgeführt.
63
64 Sie können einem Container eine Job Collection über //Container > einen bestimmten Container aussuchen > Jobs// hinzufügen. Dem Container, dem Sie einen Job bzw. eine Job Collection anhängen wollen, selektieren Sie über einen Doppelklick. Es öffnet sich ein Wizard, in dem Sie die Art des Jobs (Client Command, Job Collections, Manueller Agent-Job, System Jobs, Managed Software, Windows Update Collections) auswählen können. Führen Sie in der Ordneransicht einen Doppelklick auf jeden Job aus, der ausgeführt werden soll. Die Jobs können Sie auch per Drag-and-Drop in den rechten Fensterbereich ziehen. Sie können dabei entscheiden, ob Sie nur einen Job, mehrere hintereinander oder eine ganze vorab erstellte Job Collection ausführen wollen. Die Reihenfolge der Jobs können nachträglich über die Pfeile in der rechten Leiste geändert werden.
65
66 Wenn Sie einen Client Command oder Managed Software-Job ausführen, können dafür [[(% style="color:#3173b5" %)Parameter>>doc:||anchor="HParameterfFCrClientCommandJobseinstellen"]](%%) eingestellt werden.
67
68 {{figure}}
69 [[image:Container Jobs.PNG||data-xwiki-image-style-alignment="center"]]
70
71 {{figureCaption}}
72 Parameter für Client Command Job einstellen
73 {{/figureCaption}}
74 {{/figure}}
75
76 Mit einem Klick auf //Weiter// gelangen Sie zur nächsten Seite des Wizards, bei der Sie die Startbedingungen für die Ausführung festlegen können. Wenn Sie keine Startbedingungen festlegen wollen, können Sie die Ausführung der Jobs mit einem Klick auf //Ausführen// starten. Die Ausführung betrifft alle Clients, die dem ausgewählten Container zugewiesen sind.
77
78 == Parameter für Client Command Jobs einstellen ==
79
80 Führen Sie einen CC Job aus, so haben Sie zusätzlich die Möglichkeit, Parameterwerte zu editieren. Jedes CC verfügt über die Parameter, die Sie nach Ihrem Bedarf anpassen können. Die Parameter-Einstellungen beziehen sich nur auf das ausgewählte CC.
81
82 {{figure}}
83 [[image:Feste Parameter.PNG||data-xwiki-image-style-alignment="center"]]
84
85 {{figureCaption}}
86 Feste Parameterwerte des CC-Jobs
87 {{/figureCaption}}
88 {{/figure}}
89
90 Dabei handelt es sich um folgende Werte:
91
92 **//Console Skript ausführen//**
93
94 Ein CC kann sowohl benutzerdefinierte Parameter als auch ein Console Skript besitzen. Dabei kann es sein, dass die CC Projektvariable neben dem Command //Transfer content from console to client// des Console Skripts auch durch die Parameter befüllt werden.
95
96 {{aagon.infobox}}
97 In diesem Fall überschreibt das Console Skript die Parameterwerte!
98 {{/aagon.infobox}}
99
100 Haken Sie die Checkbox //Console Skript// //ausführen// an, wenn das Console Skript die benutzerdefinierten Parameter in jedem Fall überschreiben sollen.
101
102 **//Logmethode//**
103
104 Bei der Ausführung eines CCs können erweiterte Logs im Jobmonitor eingesehen werden. Mit dieser Einstellung können Sie aus unterschiedlichen Optionen die gewünschte Logmethode festlegen, die dann bei der Ausführung gespeichert werden:
105
106 |//Verhalten des Client Commands als Standardeinstellung übernehmen//|Es wird bei der Jobausführung immer die im CC eingestellte Logmethode genutzt. Diese Einstellung ist standardmäßig aktiviert.
107 |//Erweitertes Log nie speichern//|Das erweiterte Log wird bei der Jobausführung nie gespeichert.
108 |//Erweitertes Log nur im Fehlerfall speichern//|Das erweiterte Log wird nur im Falle eines gefundenen Fehlers während der Jobsausführung gespeichert.
109 |//Erweitertes Log immer speichern//|Das erweiterte Log wird immer gespeichert, unabhängig, ob ein Fehler während der Jobausführung aufgetreten ist oder nicht.
110
111 == **Parameter für Managed Software Jobs einstellen** ==
112
113 Wenn Sie einen Managed Software-Job ausführen lassen wollen, dann geben Sie auch diesem Job Parameter hinzu. Jedes Softwarepaket verfügt über individuelle Parameter, die Sie nach Ihrem Bedarf anpassen können. Die individuellen Parameter beziehen sich nur auf das dazugehörige Softwarepaket und werden auf alle verfügbaren Versionen angewendet.
114
115 {{figure}}
116 [[image:Parameter MSW.PNG||data-xwiki-image-style-alignment="center"]]
117
118 {{figureCaption}}
119 Feste und variable Parameterwerte des MSW-Jobs
120 {{/figureCaption}}
121 {{/figure}}
122
123 Dabei handelt es sich um folgende Werte:
124
125 **//Aktion//**
126
127 Mithilfe dieser Einstellungen entscheiden Sie, welche Aktion als Parameter an die ausgewählte Managed Software gegeben wird:
128
129 |//Installieren oder updaten//|Bei der Jobausführung wird die ausgewählte Managed Software entweder erstmals installiert oder, falls eine Installation bereits vorhanden ist, geupdated.
130 |//Nur vorhandene Installationen updaten//|Bei der Jobausführung werden ausschließlich Updates von bereits vorhandenen Installationen durchgeführt.
131 |//Erneut installieren//|Die installierte Managed Software-Version wird deinstalliert und im Anschluss die aktuellere Version neu installiert. Falls keine Version der Software installiert ist, werden keine Änderungen vorgenommen.
132 |Deinstallieren|Die ausgewählte Managed Software wird deinstalliert.
133
134 **//Logmethode//**
135
136 Bei der Ausführung einer Managed Software können erweiterte Logs im Jobmonitor eingesehen werden. Mit dieser Einstellung können Sie aus unterschiedlichen Optionen die gewünschte Logmethode festlegen, die dann bei der Ausführung gespeichert werden:
137
138 |//Erweitertes Log nie speichern//|Das erweiterte Log wird bei der Jobausführung nie gespeichert.
139 |//Erweitertes Log nur im Fehlerfall speichern//|Das erweiterte Log wird nur im Falle eines gefundenen Fehlers während der Jobsausführung gespeichert.
140 |//Erweitertes Log immer speichern//|Das erweiterte Log wird immer gespeichert, unabhängig, ob ein Fehler während der Jobausführung aufgetreten ist oder nicht.
141
142 {{aagon.infobox}}
143 Beachten Sie, dass die Parameter der MSW nur die beiden oben beschriebenen festen Parameter besitzt und ggf. weitere variable Parameter eingestellt werden können. Diese variieren jedoch und sind von der Managed Software abhängig.
144 {{/aagon.infobox}}
145
146 = **Startbedingungen** =
147
148 Die Startbedingungen geben an, zu wann der Job ausgeführt werden soll. Bei einigen Bedingungen können Sie konkrete Datumsangaben machen, bei wiederum anderen können Sie die bestimmten Handlungen während der Arbeit am Dienst definieren.
149
150 Geben Sie zunächst an, ob der Task aktiv oder inaktiv sein soll. Setzen Sie entsprechend den Haken in der Checkbox //Aktiviert//, wenn Sie die Startbedingungen ändern wollen.
151
152 Ergänzend zu den aktivierten Startbedingungen können Sie auch die// Netzwerkverbindungsoptionen// definieren. Mithilfe der// Netzwerkverbindungsoptionen// können Sie zudem festlegen, ob der Scanner getaktete Verbindungen berücksichtigt und den Scanner damit nicht startet. Suchen Sie sich anschließend die gewünschte Startbedingung aus, nach der der Scanner oder die Wartung erfolgen soll.
153
154 {{aagon.infobox}}
155 Einmalig auszuführende Jobs können nicht für die Startbedingungen //Bestimmte Zeit//, //Sobald wie möglich// und //Startintervall// eingestellt werden.
156 {{/aagon.infobox}}
157
158 |**Startbedingung**|**Erklärung**
159 |Anmeldung|- Die Bedingung wird ausgeführt, sobald sich ein Benutzer am System oder Terminalserver anmeldet.(((
160 * Beispiel: Der Benutzer meldet sich am Computer an.
161 )))
162 |Bestimmte Zeit|- Die Bedingung wird täglich zu einer bestimmten Zeit ausgeführt, die Sie festlegen können.
163 |Bestimmtes Datum|- Sie können den Scanner nur zu einem bestimmten Datum laufen lassen, indem Sie eine Datumsangabe machen.
164 |Datumsintervall|- Bei der Ausführung können dynamisch kalkulierte Zeitpunkte definiert werden.(((
165 * Beispiel: Der erste Tag im Monat.
166 )))
167 |Herunterfahren|- Die Startbedingung wird ausgeführt, wenn der Client heruntergefahren wird. Dazu wird zunächst der Benutzer abgemeldet und erst dann im Anschluss werden die Jobs ausgeführt.(((
168 * Besonderheit: Commands, die im Benutzerkontext laufen, werden nicht ausgeführt (z.B. alle Befehle der Kategorie Dialogs, sowie Lock manual input, Unlock manual input, Get idle time, Lock workstation, Get/Set default printer und If user is (not) in group).
169 )))
170 |Letzter Tag jeden Monats (veraltet)|- Der Scanner wird am letzten Tag jeden Monats ausgeführt.(((
171 * Bitte beachten Sie, dass es sich dabei um eine veraltete Startbedingung handelt. Wir empfehlen Ihnen dagegen die Einstellung "Datumsintervall" zu nutzen.
172 )))
173 |Sobald wie möglich|- Mit der Einstellung wird der Task sobald wie möglich ausgeführt.
174 - Hinweis: Beachten Sie, dass diese Startbedingung eine einmalige Ausführung impliziert!
175 |Start des Agenten| - Die Ausführung wird beim Start des ACMP Agenten durchgeführt (manuell über die Diensteverwaltung oder den Neustart des Rechners).Beispiel: Der Computer wird neu gestartet.
176 |Startzeit|- Die Ausführung beginnt mit dem Startzeitpunkt, welches Sie angeben können. Sie können zusätzlich ein Enddatum festlegen, wodurch bei Erreichen des Datums keine automatische Aktualisierung der Daten erfolgt.
177 |Startintervall|- Innerhalb der Startbedingung können Sie ein Intervall definieren (Minuten, Stunden, Tage), wann der Task immer beginnen soll.
178 - Hinweis: Beachten Sie, dass das Startverhalten von zufälligen Zeitfenstern nur bei der Intervalleinstellung "Tage" verfügbar ist.
179 |Tag der Woche|- Die Ausführung wird gestartet, wenn Sie einen oder mehrere Tage der Woche angeben. Zusätzlich besteht die Option, dass jeder n-te Tag eines Monats berücksichtigt werden soll.
180 |Tag des Monats|- Die Bedingung wird an allen von Ihnen angegebenen Tagen im Monat ausgeführt. Die Ausführung wird nur in Monaten mit den ausgewählten Tagen ausgeführt.
181 |Zeitfenster|- Es kann ein konkretes Zeitfenster mit einer Start- und Enduhrzeit festgelegt werden.
182
183 Speichern Sie zum Schluss Ihre Änderungen, damit die Scanner oder Wartungsaufgaben unter den neuen Startbedingungen starten können.
184
185 == **Besonderes Verhalten der Startbedingungen** ==
186
187 {{aagon.infobox}}
188 Bitte beachten Sie ein besonderes Verhalten bei der Option „Zeitfenster“. Sollten Sie dieses in Kombination mit den Startbedingungen „Tag der Woche“, „Tag des Monats“ oder „Bestimmtes Datum“ verwenden und sich das Zeitfenster über einen Tag hinausstreckt (z.B. 22:00 Uhr – 02:00 Uhr), so würde der Client Task nur an diesem bestimmten Datum ausgeführt. Dies gilt auch dann, wenn das Zeitfenster sich noch bis in den nächsten Tag erstreckt. Überprüfen Sie deshalb zunächst immer das Datum und erst anschließend das Zeitfenster. Wenn Sie also beispielsweise einen Scanner nur abends ausführen wollen, würde dieser bis 23:59 Uhr laufen, aber nicht bis zum eigentlichen Ende des festgelegten Zeitfensters.
189 {{/aagon.infobox}}
190
191 {{aagon.infobox}}
192 In den Startbedingungen „Startintervall“ und „Zeitfenster“ gibt es die Option „An einem zufälligen Zeitpunkt innerhalb des Zeitfensters starten“. Wir empfehlen Ihnen diese Startbedingung zu nutzen. Dadurch wird gewährleistet, dass die Scan-Daten zeitlich versetzt zum Server gesendet werden. Bei vielen gleichzeitig gesendeten Scan-Daten kann der Import unter Umständen nur zeitverzögert durchgeführt werden.
193 {{/aagon.infobox}}
194
195
196 == Verarbeitung von kombinierten Startbedingungen ==
197
198 Je nachdem welche Startbedingung Sie ausgewählt haben, ist auch eine Kombination aus mehreren Bedingungen möglich. Diese Startbedingungen werden dabei jeweils nacheinander ausgewertet und verarbeitet. Das bedeutet: Aufeinander aufbauende bzw. folgende Startbedingungen können nur jeweils abgearbeitet werden, wenn die vorherige Bedingung zutrifft. Erst dann wird die nachfolgende Bedingung überprüft.
199
200 {{box}}
201 **Beispiel:** Wählen Sie im Wizard die Startbedingung „Startzeit“ aus und klicken Sie auf //Weiter >//. Geben Sie ein Startdatum an (z.B. 21.11.2024 um 12:00 Uhr). Wählen Sie nun aus dem Bereich //Kombiniere mit //die Bedingung „Zeitfenster“ aus und geben Sie dort auf der rechten Seite an, wann das Zeitfenster sein soll (hier beispielsweise zwischen 12:00 und 15:00 Uhr). Soll noch sichergestellt werden, dass der Computer für den Job aufgeweckt wird, aktivieren Sie die gleichnamige Checkbox.
202 {{/box}}
203
204 Die Bedingungsbeschreibung lautet nun „Ab 21.11.2024 12:00 zwischen 12:00 und 15:00 und wecke 10 Minuten zuvor.“ Da hier die Startzeit vor Beginn des Zeitfensters ist, würde die Bedingung erst am 22.11.2024 anlaufen, da sie durch das Aufwecken des Computers 10 Minuten vorgezogen wurde und damit nicht mehr in die Bedingung passt. 
205
206 [[Kombinierte Startbedingungen>>image:ACMP.68.ACMP-Solutions.Desktop Automation.Client Commands.Jobs ausführen.WebHome@68_Startbedingung_Kombination verschiedener Startbedingungen_845.png||alt="67_Startbedingung_Kombination verschiedener Startbedingungen_845.png"]]
207
208 In der Abfolge wird zunächst die „Startzeit“-Bedingung ausgewertet. Erst, wenn diese erfüllt ist, wird die „Zeitfenster“-Bedingung geprüft. Die zusätzlich ausgewählte Option //Computer für Job aufwecken //(sowie alle nicht ausgewählten Optionen in der Abbildung) gehören immer zu der jeweiligen Bedingung („Zeitfenster“) und beziehen sich nicht auf die gesamte Bedingung.
209
210 {{aagon.infobox}}
211 Auch eine Kombination aus den Startbedingungen „Startzeit“ und „Bestimmte Zeit“ würde sich gleich verhalten, wie im oberen Beispiel. Auch hier würden die Startbedingungen nacheinander ausgewertet werden und nur dann greifen, wenn die vorherige Startbedingung erfüllt wäre.
212 {{/aagon.infobox}}
213
214 == Geplante Serveraufgaben ==
215
216 Die [[geplanten Serveraufgaben>>doc:ACMP.68.ACMP-Solutions.System.Einstellungen.ACMP Server.WebHome||anchor="HGeplanteServeraufgaben"]], die Sie unter //System > Einstellungen > ACMP Server// einstellen und starten können, sind ebenfalls Jobs. Diese Jobs betreffen allerdings nur den ACMP Server und basieren ausschließlich auf wiederkehrenden Startbedingungen.
217
218
219 == Ausführungen von Jobs kontrollieren ==
220
221 Nachdem Sie Ihre Jobs gestartet haben, können Sie diese im [[Jobmonitor>>doc:ACMP.68.Arbeiten mit der ACMP Console.Aufbau der Console.Ribbonleiste.Monitore.WebHome||anchor="HJobmonitor"]] einsehen. Sie erhalten Informationen darüber, welche Jobs auf den Clients anstehen, bereits erfolgreich gelaufen oder fehlgeschlagen sind.
222 Sie können zusätzlich auch alle Jobs, die von einem oder mehreren Clients noch durchgeführt, bereits erfolgreich durchgeführt oder fehlgeschlagen sind aus Clientsicht im [[Clientmonitor>>doc:ACMP.68.Arbeiten mit der ACMP Console.Aufbau der Console.Ribbonleiste.Monitore.WebHome||anchor="HClientmonitor"]] einsehen.
223 Die Ausführungen der Serverjobs können Sie im [[Servermonitor>>doc:ACMP.68.Arbeiten mit der ACMP Console.Aufbau der Console.Ribbonleiste.Monitore.WebHome||anchor="HServermonitor"]] kontrollieren.
© Aagon GmbH 2025
Besuchen Sie unsere Aagon-Community