Vorheriges Thema: assignGroupToTarget – Zuordnen von Gruppen zu einem ZielNächstes Thema: createGroup – Erstellen einer Gruppe


Beispiel

Die über den Befehl angegebenen Attribute werden standardmäßig für alle generierten Jobs verwendet. Die auszuführende Prozedur ist bei Softwaregruppen im Gegensatz zu Prozedurgruppen nicht festgelegt. Der Befehl wählt die standardmäßige Installationsroutine der Produkte für die Jobs als Standard für die Softwaregruppen-Produkte aus. Sie können alle diese Standardeinstellungen überschreiben, indem Sie in der Prozedurdatei weitere Angaben machen.

Angenommen, es ist eine Prozedurdatei definiert. Es wird für jeden Eintrag einer Prozedurgruppe überprüft, ob die Prozedur und das Produkt auch in der angegebenen Prozedurdatei enthalten sind. Ist dies nicht der Fall, werden die Standardeinstellungen für den Befehl zur Generierung des Jobs verwendet. Anderenfalls überschreiben die Angaben des ersten passenden Prozedurdatei-Eintrags die Standardwerte, und diese geänderten Attribute werden bei der Generierung des Jobs verwendet. Die Jobs werden in der Reihenfolge ausgeführt, in der die Prozeduren in der Gruppe angeordnet sind.

Angenommen, Sie verfügen über einen Domänen-Manager sowie die folgende Prozedurgruppe, und Sie führen folgenden Befehl aus:

pg:
........Prozedur:........configure_001
................Produkt........test_001
................Version........1.0
........Prozedur:........activate_002
................Produkt........test_002
................Version........1.1

cadsmcmd swlibrary action=assignGroupToTarget name=pg computer=tar01 after=exacttime prompUser allowCancel Parameters="-xon xf -rs" procedures=c:\temp\procFile.txt

Angenommen, "c:\temp\procFile.txt" hat den folgenden Inhalt:

Item=test_002 version=1.1 procedure=activate_002 task=activate after=boottime allowCancel=n GlobalTime=y Parameters="" 

Es werden zwei Jobs generiert. Der erste betrifft "configure_001", und die Attribute des Befehls werden als Standardwerte des Befehls verwendet, also "after=exacttime", "promptUser", "cancelAllow" und "Parameters="-xon xf -rs"". Der zweite generierte Job betrifft activate_002. In diesem Fall werden ebenfalls die Standardwerte des Befehls verwendet, manche von diesen werden jedoch durch den entsprechenden Prozedurdatei-Eintrag überschrieben. Das Ergebnis ist ein Job mit den Attributen "after=boottime", "promptUser" und "GlobalTime". "allowCancel" ist nicht eingestellt und Parameters ist leer.

Bei Softwaregruppen wird nur überprüft, ob das Produkt mit einem Eintrag in der Prozedurdatei übereinstimmt. Der erste gefundene Eintrag wird verwendet. Die angegebene Prozedur für den passenden Eintrag und die angegebenen Parameter überschreiben die Standardwerte, und diese geänderten Attribute werden zur Generierung des Jobs verwendet.

Angenommen, Sie verfügen über einen Domänen-Manager sowie die folgende Softwaregruppe, und Sie führen folgenden Befehl aus:

swg:
........Produkt:........test_011
................Version........2.1
................Standardinstallationsprozedur........inst_011
........Produkt:........test_012
................Version........2.2
................Standardinstallationsprozedur........inst_012

cadsmcmd swlibrary action=assignGroupToTarget name=swg computer=tar01 after=exacttime prompUser allowCancel Parameters="-xon xf -rs" preaction=logoff procedures=c:\temp\procFile.txt

Angenommen, "c:\temp\procFile.txt" hat den folgenden Inhalt:

Item=test_012 version=2.2 procedure=activate_012 task=activate after=boottime allowCancel=n GlobalTime=y Parameters="-cleanUp" 
Item=test_011 version=2.0 procedure=activate_011 task=activate allowCancel=n GlobalTime=y Parameters="-format" 

Es werden zwei Jobs generiert. Der erste ist für das Produkt test_011 in Version 2.1 und ist ein Installationsjob, der die Standardprozedur inst_011 verwendet. Der Job wird nur mit den Standardbefehlen generiert, da es keinen entsprechenden Eintrag in der Datei "Prozeduren" gibt, obwohl das Produkt test_011 in der Datei aufgeführt wird, allerdings in einer anderen Version. Daher wird der Job mit den Attributen "fter=exacttime", "promptUser", "allowCancel" und "Parameters="-xon xf -rs"" generiert.

Der zweite Job wird für product test_012 für Version 2.2 generiert. Hier enthält die Prozedurdatei einen passenden Eintrag, daher werden die Standardwerte des Befehls mit denen des Eintrags aktualisiert. Der erstellte Job betrifft die Aktivierungsprozedur "activate_012" mit den Attributen "after=boottime", "promptUser", "GlobalTime", "preaction=logoff" und "Parameters="-cleanUp"". "allowCancel" ist nicht festgelegt.

Eine Softwaregruppe kann eine hierarchische Struktur aufweisen, d. h., sie enthält weitere Software- oder Prozedurgruppen. Dieser Befehl ist rekursiv, er evaluiert also auch die Untergruppen und generiert Jobs für deren Einträge. Bei der Verwendung hierarchischer Gruppenstrukturen müssen Sie darauf achten, dass die Produkte und Prozeduren in der Hierarchie nicht mehrfach vorkommen. Beispiel für eine Struktur:

swg: (Softwaregruppe)
........Produkt:........test_001
................Version........2.1
................Standardinstallationsprozedur........inst_001
........Produkt:........test_022
................Version........1.1/00
................Standardinstallationsprozedur........inst_022
swg_1: (Softwaregruppe)
........Produkt........test_010
................Version........1.0
................Standardinstallationsprozedur........inst_010
........Produkt:........test_001
................Version........2.1
................Standardinstallationsprozedur........inst_001
pg_11: (Prozedurgruppe)
........Prozedur:........configure_001
................Produkt........test_001
................Version........2.1
........Prozedur:........activate_022
................Produkt........test_022
................Version........1.1/00
pg_1: (Prozedurgruppe)
........Prozedur:........configure_022
................Produkt........test_022
................Version........1.1/00
........Prozedur:........activate_022
................Produkt........test_022
................Version........1.1/00

Wenn Sie den Befehl für diese Gruppe aufrufen, werden einige Warnungen ausgegeben, und einige Produkte und Prozeduren werden ignoriert. Dies stellt das Produkt test_001 in Version 2.1 in swg_1 zurück, da es schon auf der Ebene "swg" erscheint, ebenso wie die Prozedur activate_022 von product test_022 in Version 1.1/00 in pg_11, weil es bereits in pg_1 erscheint. Wenn eine "Prozeduren"-Datei mit dem Befehl codiert wird, werden die Prozedurgruppen zuerst auf entsprechende Einträge überprüft. Nachdem alle Vorgänge abgeschlossen wurden, werden die Softwaregruppen der Hierarchie mit den verbleibenden Einträgen der Prozedurdatei verglichen, also mit den Einträgen, die nicht bereits innerhalb von Prozedurgruppen verwendet wurden.

Angenommen, Sie verfügen über die oben dargestellte swg-Struktur und führen folgenden Befehl auf einem Domänen-Manager aus:

cadsmcmd swlibrary action=assignGroupToTarget name=swg computer=tar01 after=exacttime promptUser allowCancel Parameters="-xon xf -rs" procedures=c:\temp\procFile.txt

Angenommen, "c:\temp\procFile.txt" hat den folgenden Inhalt:

Item=test_001 version=2.1 procedure=configure_001 task=configure allowCancel=n Parameters="-init" preaction=reboot
Item=test_001 version=2.1 procedure=install_min task=install allowCancel=n Parameters="-x -y -z" preaction=logoff postaction=reboot
Item=test_022 version=1.1/00 procedure=configure_022 task=configure preaction=logoff Repeat noCalendar
Item=test_022 version=1.1/00 procedure=activate_022 task=activate preaction=logoff Repeat noCalendar

Hierdurch werden die folgenden Jobs mit den aufgeführten Attributen generiert:

test_001 2.1: install_min
task=install
after=exacttime
promptUser
Parameters="-x -y -z" 
preaction=log0ff
postaction=reboot
test_022 1.0/00:inst_002
task=install
after=exacttime
promptUser
allowCancel
Parameters="-xon xf -rs" 
test_022 1.0/00:configure_022 
task=configure
after=exacttime
preaction=logoff
promptUser
allowCancel
Wiederholen
noCalendar
Parameters="-xon xf -rs" 
test_022 1.0/00:activate_022 
task=activate
after=exacttime
preaction=logoff
promptUser
allowCancel
Wiederholen
noCalendar
Parameters="-xon xf -rs" 
test_010 1.0:inst_010
task=install
after=exacttime
promptUser
allowCancel
Parameters="-xon xf -rs" 
test_001 1.0/00:configure_001
task=configure
after=exacttime
promptUser
Parameters="-init" 
preaction=reboot

test_001 für Version 2.1 in swg_1 sowie activate_022 für test_022 und version 1.1/00 in pg_11 werden ignoriert.

Die Einträge der Prozedurdatei müssen das folgende Format aufweisen:

item=Element 
version=Version 
procedure=Prozedur-Task={install|configure|activate|uninstall}
[deliverytime="JJJJ-MM-TT hh:mm" ] 
[attime="JJJJ-MM-TT hh:mm" ]
[after={exacttime|boottime}] [calendarname=deliverycalendar]
[preaction={none|reboot|logoff}]
[postaction={none|reboot|logoff|rebootAtEnd|logoffAtEnd}]
[promptUser={y|n}] 
[allowCancel={y|n}] 
[execTimedOut={y|n}] 
[prompt=Tage.Stunden]
[offline={y|n}] 
[RunAtShutdown={y|n}] 
[PreventLogon={y|n}] 
[GlobalTime={y|n}] 
[nocalendar={y|n}]
[ResolveQuery={y|n}] 
[Parameters=Benutzerparameter]
[repeat={y|n}] 
[stagingserver={y|n}]
[JobTimeout=t.h]

item

Name des Gruppenelements, mit dem dieser Eintrag verbunden ist.

Version

Version des Gruppenelements, mit dem dieser Eintrag verbunden ist.

Prozedur

Gibt die durchzuführende Elementprozedur an.

task

Gibt den Prozedurentyp an. Die folgenden Typen sind zulässig:

install

Die Prozedur installiert das Element.

configure

Die Prozedur konfiguriert das Element.

activate

Die Prozedur aktiviert das Element.

uninstall

Die Prozedur deinstalliert das Element.

Bei fehlender Angabe des Parameters wird "install" angenommen.

Die Parameter "item", "version", "procedure" und "task" müssen in jeder Zeile als erste Parameter angegeben werden, und die Angabe muss in der Reihenfolge wie in der oben dargestellten Syntaxdefinition erfolgen. Die verbleibenden Parameter können in beliebiger Reihenfolge angegeben werden.

Die Bedeutungen der anderen Parameter entsprechen den zuvor dargestellten Befehlsparametern. Wenn y eingegeben wird, wird der Parameter festgelegt, andernfalls nicht. Für nicht festgelegte Parameter wird die Standard-Parametereinstellung jeden Befehls verwendet.

Angenommen, Sie verfügen über die Softwaregruppe "swg_1", die an die durch "group q_grp" angegebenen Ziele verteilt werden soll. "swg_1" hat den folgenden Inhalt und die folgende Struktur:

cadsmcmd swlibrary action=listswg name=swg_1
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus

Verbindung mit dem Manager "Standard-Manager" als Benutzer "<Standardbenutzer>" wird hergestellt...OK.
Manager: myManager
Domäne: myDomain
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM AM

-------------------------------------------------------------------------------
Mitglieder der Prozedurgruppe "swg_1" auflisten 
-------------------------------------------------------------------------------
InstallActivateConfigureUninstall 1 <Generic>, <Regular>, 3(0), schbe05, 
Beendigungscode weitergeben, der als ein Benutzerparameter zurückgegeben werden sollte.
TransferComplexDirectoryStructure 1 <Generic>, <Regular>, 329(0), QA Mch schir03, 
SD-Paket mit komplexer Verzeichnisstruktur.

SDCMD<A000000>: OK

Angenommen, die Anforderungen für den zu verwendenden Jobcontainer lauten wie folgt:

Für alle generierten Jobs gelten die folgenden Standardwerte:

Die individuellen Anforderungen für Jobs und Elemente lauten wie folgt:

Zur Verteilung und Ausführung der entsprechenden Jobs wird der Befehl "assignGroupToTarget" verwendet. Da einige Jobs über individuelle Anforderungen verfügen, müssen diese in einer Prozedurdatei beschrieben sein. Diese Prozedurdatei hat den folgenden Inhalt:

item=tstbase version=1.0 procedure=remdir task=configure postaction=reboot
item=tstbase version=1.0 procedure=remdir task=configure postaction=reboot
item=tstbase version=1.0 procedure=inst task=install preaction=logoff preventLogon

Geben Sie den folgenden Befehl ein, um einen Jobcontainer mit dem standardmäßigen Namen zu erstellen, ihn mit den erforderlichen Jobs zu füllen und ihn zur Ausführung zu planen:

cadsmcmd swlibrary action=assignGroupToTarget name=swg_1 compgrp=q_grp transaction rollback deliveryTime="2005-06-30 13:00" atTime="2005-07-05 01:00" after=exacttime resolveQuery procedures=c:\temp\proc.usd
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.

Verbindung zu Manager "wwwww01b" als Benutzer "<Standardbenutzer>" wird hergestellt...OK.

Ein Container mit dem Namen q_grp [04/11/02 10:44:10.093] wurde erstellt.
Gruppe swg_1 evaluieren
Gruppe swg_1/pg_1 evaluieren
Prozedurdatei c:\temp\proc.usd evaluieren
Job "tstbase 1.0:inst" generieren: OK.
Job "DMS Editor 6.01.0000:Lokale Installation" generieren: OK.
Job "tstbase 1.0:remdir" generieren: OK.
Job "tstbase 1.0:setdir" generieren: OK.
Job "tstkpk01 1.0:inst" generieren: OK.

SDCMD<A000000>: OK

Mit Hilfe des folgenden Befehls wird der generierte Jobcontainer angezeigt:

cadsmcmd jobContainer action=showAttr name="q_grp [04/11/02 10:44:10.093]" 
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.

Verbindung zu Manager "wwwww01b" als Benutzer "<Standardbenutzer>" wird hergestellt...OK.

-------------------------------------------------------------------------------
Attribute von Jobcontainer "q_grp [04/11/02 10:44:10.093]" anzeigen 
-------------------------------------------------------------------------------
Jobcontainername.....................: q_grp [04/11/02 10:44:10.093]
Jobcontainer-Eigenschaften...............: 28
.........................................Transaktion
.........................................Bei Fehler Rollback der vorangegangenen Jobs
.........................................Überlappende Installation
Versiegelt.................................: Ja
Erstellt am.............................: 2005-04-11 10:45
Geändert am.............................: 2005-04-11 10:45
Anzahl der enthaltenen Objekte............: 5
Jobcontainerstatus....................: wartet
.........................................3 - Jobs wartend
.........................................0 - Jobs aktiv
.........................................2 - Jobs OK
.........................................0 - Jobs fehlgeschlagen

Jobname................................: tstbase 1.0:inst
..Gesamtstatus......................: WAITING
.........................................2 - Jobziele wartend
.........................................0 - Jobziele aktiv
.........................................0 - Jobziele OK
.........................................0 - Jobziele fehlgeschlagen
..Jobauftragsnummer.....................: 0
..Erstellt am...........................: 2005-06-30 13:00
..Aktivieren am..........................: 2005-07-05 01:00
..Statusmeldung.......................: OK
..Ziel...............................: KKKKK01B
....Task...............................: install
....Jobstatus..........................: WAITING
....Task...............................: install
....Gestartet am.........................: 2005-07-05 01:00
....Abgeschlossen am.......................: 2005-04-11 10:45
....Erstellt am.........................: 2005-04-11 10:45
....Gesendete Daten (in %).........:
....Statusmeldung.....................: OK
....Angefordert von.........................: KKKKK01
....Typ...............................: obligatorisch
....Kommentar............................:
..Ziel...............................: KKKKK01C
....Task...............................: install
....Jobstatus..........................: WAITING
....Task...............................: install
....Gestartet am.........................: 2005-07-05 01:00
....Abgeschlossen am.......................: 2005-04-11 10:45
....Erstellt am.........................: 2005-04-11 10:45
....Gesendete Daten (in %).........:
....Statusmeldung.....................: OK
....Angefordert von.........................: KKKKK01
....Typ...............................: obligatorisch
....Kommentar............................:

Jobname................................: DMS Editor 6.01.0000:Lokale Installation
..Gesamtstatus......................: WAITING
.........................................2 - Jobziele wartend
.........................................0 - Jobziele aktiv
.........................................0 - Jobziele OK
.........................................0 - Jobziele fehlgeschlagen
..Jobauftragsnummer.....................: 1
..Erstellt am...........................: 2005-06-30 13:00
..Aktivieren am..........................: 2005-07-05 01:00
..Statusmeldung.......................: OK
..Ziel...............................: KKKKK01B
....Task...............................: install
....Jobstatus..........................: WAITING
....Task...............................: install
....Gestartet am.........................: 2005-07-05 01:00
....Abgeschlossen am.......................: 2005-04-11 10:45
....Erstellt am.........................: 2005-04-11 10:45
....Gesendete Daten (in %).........:
....Statusmeldung.....................: OK
....Angefordert von.........................: KKKKK01
....Typ...............................: obligatorisch
....Kommentar............................:
..Ziel...............................: KKKKK01C
....Task...............................: install
....Jobstatus..........................: WAITING
....Task...............................: install
....Gestartet am.........................: 2005-07-05 01:00
....Abgeschlossen am.......................: 2005-04-11 10:45
....Erstellt am.........................: 2005-04-11 10:45
....Gesendete Daten (in %).........:
....Statusmeldung.....................: OK
....Angefordert von.........................: KKKKK01
....Typ...............................: obligatorisch
....Kommentar............................:

Jobname................................: tstbase 1.0:remdir
..Gesamtstatus......................: unbekannt (9)
.........................................0 - Jobziele wartend
.........................................0 - Jobziele aktiv
.........................................0 - Jobziele OK
.........................................0 - Jobziele fehlgeschlagen
..Jobauftragsnummer.....................: 2
..Erstellt am...........................: 2005-06-30 13:00
..Aktivieren am..........................: 2005-07-05 01:00
..Statusmeldung.......................: Warnung bei Einrichtung des Jobs. Keine Zielinstal
.........................................+ lationen während der Evaluierung gefunden.

Jobname................................: tstbase 1.0:setdir
..Gesamtstatus......................: unbekannt (9)
.........................................0 - Jobziele wartend
.........................................0 - Jobziele aktiv
.........................................0 - Jobziele OK
.........................................0 - Jobziele fehlgeschlagen
..Jobauftragsnummer.....................: 3
..Erstellt am...........................: 2005-06-30 13:00
..Aktivieren am..........................: 2005-07-05 01:00
..Statusmeldung.......................: Warnung bei Einrichtung des Jobs. Keine Zielinstal
.........................................+ lationen während der Evaluierung gefunden.

Jobname................................: tstkpk01 1.0:inst
..Gesamtstatus......................: WAITING
.........................................2 - Jobziele wartend
.........................................0 - Jobziele aktiv
.........................................0 - Jobziele OK
.........................................0 - Jobziele fehlgeschlagen
..Jobauftragsnummer.....................: 4
..Erstellt am...........................: 2005-06-30 13:00
..Aktivieren am..........................: 2005-07-05 01:00
..Statusmeldung.......................: OK
..Ziel...............................: KKKKK01B
....Task...............................: install
....Jobstatus..........................: WAITING
....Task...............................: install
....Gestartet am.........................: 2005-07-05 01:00
....Abgeschlossen am.......................: 2005-04-11 10:45
....Erstellt am.........................: 2005-04-11 10:45
....Gesendete Daten (in %).........:
....Statusmeldung.....................: OK
....Angefordert von.........................: KKKKK01
....Typ...............................: obligatorisch
....Kommentar............................:
..Ziel...............................: KKKKK01C
....Task...............................: install
....Jobstatus..........................: WAITING
....Task...............................: install
....Gestartet am.........................: 2005-07-05 01:00
....Abgeschlossen am.......................: 2005-04-11 10:45
....Erstellt am.........................: 2005-04-11 10:45
....Gesendete Daten (in %).........:
....Statusmeldung.....................: OK
....Angefordert von.........................: KKKKK01
....Typ...............................: obligatorisch
....Kommentar............................:


SDCMD<A000000>: OK

Mit dem folgenden Befehl können Sie die Attribute eines speziellen Jobs dieses Containers anzeigen:

cadsmcmd jobContainer action=showAttrJobs name=" q_grp [04/11/02 10:44:10.093]"jobName=" tstbase 1.0:inst" 
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.

Verbindung zu Manager "wwwww01b" als Benutzer "<Standardbenutzer>" wird hergestellt...OK.

-------------------------------------------------------------------------------
Liste der Attribute von Job "q_grp [04/11/02 10:44:10.093]" aus Container "tstbase 1.0:inst" 
-------------------------------------------------------------------------------
Jobname................................: tstbase 1.0:inst
Software...............................: tstbase 1.0
Prozedur................................: inst
Liefern am.............................: 2005-06-30 13:00
Aktivieren am............................: 2005-07-05 01:00
Statusmeldung...........................: OK
Gesamtstatus........................: WAITING
.........................................2 - Jobziele wartend
.........................................0 - Jobziele aktiv
.........................................0 - Jobziele OK
.........................................0 - Jobziele fehlgeschlagen
Jobtask................................: install
Aktion davor                           : Benutzer abmelden
Folgeaktion.............................: Keine Aktion
Benutzer-Eingabeaufforderung..: Nein
Merkmal-Flags.........................:
.........................................Benutzeranmeldung während Jobausführung verhindern
.........................................Lokale Zeit/exakt
.........................................Kalendergesteuert
.........................................Abfragegruppen auflösen
Lieferungskalender...................:
Benutzerparameter.....................:
Eingabeaufforderung während...: 1&#160;Tage, 0&#160;Stunden
Jobzeitlimit.............................: 7&#160;Tage, 0&#160;Stunden

SDCMD<A000000>: OK