Vorheriges Thema: remove – Entfernen von Images von Boot-ServernNächstes Thema: jobcontainer – Jobcontainer-Befehle


install - configure - activate - uninstall – Generieren und Ausführen von Jobs in Jobcontainern/Verteilungen

Die Befehle werden seitens des Enterprise-Managers oder des Domänen-Managers verwendet, um einen Installations-, Konfigurations-, Aktivierungs- oder Deinstallationsjob in einem Jobcontainer zu generieren und auszuführen.

Auf dem Enterprise-Manager wird dieser Jobcontainer einer Verteilung zugewiesen.

Dieser Befehl hat auf dem Domänen-Manager das folgende Format:

{install|configure|activate|uninstall}
item=Elementname
version=Elementversion 
procedure=Prozedurname
[installedWith=Installationsprozedur]}
{ { computer=Computername} }
|{{compgrp=Computergruppenname 
| ccompgrp=(Computergruppenname.Domänenname)}}}
[sep=Trennzeichen]
[cname=Name]
{nolinkage|transaction|synchronized}
[rollback=y|n]
[cascade=y|n]
[unsealed]
after={exacttime|boottime} 
[globalTime=y|n] 
[deliveryTime=JJJJ-MM-TT HH:MM] 
[atTime=JJJJ-MM-TT HH:MM]
[promptUser[={y|n}]] 
[allowCancel[={y|n}]] 
[execTimedOut[={y|n}]]
[prompt=Tage.Stunden] 
[{preaction={none|reboot|logoff}|bootbefore}]
[{postaction={none|reboot|logoff|rebootAtEnd|logoffAtEnd|shutdownAtEnd}|bootafter}]
[{jobTimeOut=Tage.Stunden | timeout=Stunden}]
[offline[={y|n}]] 
[runAtShutdown[={y|n}]]
[preventLogon[={y|n}]] 
[resolveQuery[={y|n}]] 
[calendername=Lieferungskalender]
[nocalendar[={y|n}]]
[stagingServer[={y|n}]] 
[parameters=Benutzerparameter]
jcPriority={1-10}
[reinstall[={y|n}]]
[userJobMessage]
[userMessage]

Dieser Befehl hat auf dem Enterprise-Manager das folgende Format:

{install|configure|activate|uninstall}
item=Elementname
version=Elementversion 
procedure=Prozedurname
[installedWith=Installationsprozedur]}
|{{compgrp=Computergruppenname 
| ccompgrp=(Computergruppenname.Domänenname)}}}
[sep=Trennzeichen]
after={exacttime|boottime} 
[globalTime=y|n] 
{{area=Bereichsname} | {domain=Domänenname} | toAllAreas}
[deliveryTime=JJJJ-MM-TT HH:MM] 
[atTime=JJJJ-MM-TT HH:MM]
cname=[Name]
{nolinkage|transaction|synchronized}
[rollback=y|n]
[cascade=y|n]
[sendTime=JJJJ-MM-TT HH:MM] 
[haltTime=JJJJ-MM-TT HH:MM]
[promptUser[={y|n}]] 
[allowCancel[={y|n}]] 
[execTimedOut[={y|n}]]
[prompt=Tage.Stunden] 
[{preaction={none|reboot|logoff}|bootbefore}]
[{postaction={none|reboot|logoff|rebootAtEnd|logoffAtEnd|shutdownAtEnd}|bootafter}]
[{jobTimeOut=Tage.Stunden | timeout=Stunden}]
[offline[={y|n}]] 
[runAtShutdown[={y|n}]]
[preventLogon[={y|n}]] 
[resolveQuery[={y|n}]] 
[calendername=Lieferungskalender]
[nocalendar[={y|n}]]
[stagingServer[={y|n}]] 
[parameters=Benutzerparameter]
[jcPriority={1,...,10}]
[distPriority={1,...,10}]	
[reinstall[={y|n}]]
[userJobMessage]
[userMessage]
activate

Aktiviert einen Job für das angegebene Element. Der verknüpfte Task der angegebenen Prozedur muss den Typ "activate" besitzen.

after

Startzeit der Prozedur im Zielsystem.

Folgende Werte sind gültig:

exacttime

Die Prozedur wird sofort nach Erreichen von atTime gestartet.

boottime

Die Prozedur wird erst nach dem nächsten Neustart nach dem Ablauf von atTime ausgeführt.

allowCancel

Wenn "allowCancel" oder "allowCancel =y" angegeben ist, kann der Benutzer die Ausführung des Jobs abbrechen.
Bei Angabe von "allowCancel =n" ist dies dem Benutzer nicht möglich.

Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert der zugehörigen Prozedur verwendet.

area

Gibt Folgendes an: Name einer CA ITCM-Domäne als Ziel für die Verteilung.

Dieser Parameter kann mehrfach angegeben werden, um eine Liste von CA ITCM-Domänen zu adressieren.

(nur Enterprise-Manager).

atTime

Gibt Folgendes an: Gibt das Datum und die Uhrzeit an, an dem bzw. zu der die Aktion gestartet wird.

Das Datum wird im ISO-Format "JJJJ-MM-TT HH:MM" angegeben.

calendarname

Gibt Folgendes an: Name des Kalenders, der die Zeit steuert, während der die Evaluierung ausgeführt werden kann.

cascade

Wenn "cascade" oder "cascade=y" angeben ist, wird die Jobverknüpfung des Containers in "Auflösen von Abhängigkeiten in Überlappungsinstallationen" geändert.
Wenn "cascade=n" angegeben ist, wird die Jobverknüpfung in "Keine Auflösung" geändert.

cname

Gibt Folgendes an: optionaler eindeutiger Name eines Jobcontainers.

Wenn bereits ein Jobcontainer/eine Verteilung mit dem angegebenen Namen vorhanden ist, wird ein Fehler ausgegeben.
Wenn "cname" nicht angegeben ist, wird ein generischer Name erzeugt.

Hinweise:
Auf dem Domänen-Manager:
Wenn bereits ein Jobcontainer mit dem angegebenen Namen vorhanden und nicht versiegelt ist, wird der generierte Job diesem Container zugewiesen. Wenn der Container bereits versiegelt ist, wird ein Fehler ausgegeben.
Wenn noch kein Jobcontainer mit dem angegebenen Namen vorhanden ist, wird er entsprechend der angegebenen Jobverknüpfungsoptionen erstellt.
Wenn "cname" nicht angegeben ist, wird ein generischer Name erzeugt.

Auf dem Enterprise-Manager:
"cname" wird verwendet, um die Verteilung und den zugehörigen Jobcontainer zu benennen. Es wird davon ausgegangen, dass beide nicht vorhanden sind, und sie werden erstellt. Der Jobcontainer wird entsprechend der angegebenen Jobverknüpfungsoptionen erstellt.
Wenn "cname" nicht angegeben ist, wird ein generischer Name erzeugt.

compgrp

Gibt Folgendes an: Name einer Computergruppe. Er wird vom Job hinzugefügt.

Der Parameter kann mehrfach angegeben werden , um eine Liste von Computergruppen zuzuweisen.

ccompgroup

Gibt die Computergruppe mit Gruppenname und Bereich an. Standardmäßig sind Name und Bereich durch einen Punkt (".") getrennt. Sie können jedoch mit der Option "sep" ein anderes Trennzeichen festlegen. Das Trennzeichen darf nicht als Teil der Namen verwendet werden.

Für den Gruppenbereich sind nur die folgenden Werte gültig:

lokal

Die Gruppe wird auf dem lokalen Domänen-Manager erstellt.

global

Die Gruppe wurde auf dem Enterprise-Manager erstellt und kann repliziert werden.

"ccompgrp" kann mit "compgrp" in einem Aufruf angegeben werden.

computer

Gibt Folgendes an: Name des Computers. Er wird vom Job hinzugefügt.

Der Parameter kann mehrfach angegeben werden , um eine Liste von Computern zuzuweisen.

(nur Domänen-Manager)

configure

Generiert einen Konfigurations-Job für das angegebene Element. Der verknüpfte Task der angegebenen Prozedur muss den Typ "configure" besitzen.

deliveryTime

Gibt Folgendes an: Startzeit der Lieferung vom Domänen-Manager.
Das Datum wird im ISO-Format "JJJJ-MM-TT HH:MM" angegeben.

distPriority

Gibt Folgendes an: Priorität, die der Verteilung zugewiesen wird.

Die angegebene Priorität muss numerisch sein, und der Wert muss größer oder gleich 1 und kleiner oder gleich 10 sein.

Wenn dieser Parameter nicht angegeben wird, wird von der Priorität 5 ausgegangen.

domain

Gibt Folgendes an: Name einer CA ITCM-Domänengruppe, an die die Verteilung zur Ausführung gesendet wird.

Dieser Parameter kann mehrfach angegeben werden, um eine Liste von CA ITCM-Domänengruppen zu adressieren.

(nur Enterprise-Manager)

execTimedOut

Wenn "execTimedOut" oder "execTimedOut=y" angegeben ist, wird die Ausführung des Jobs automatisch gestartet, wenn das Zeitlimit der Benutzereingabe erreicht wird.
Wenn "execTimedOut=n" angegeben ist, wird der Job nicht automatisch gestartet.

globalTime

Wenn "globalTime" oder "globalTime=y" angegeben ist, basieren die Zeitangaben auf der Zeit des Enterprise-Managers.

Wenn "globalTime=n" angegeben ist, basieren sie auf der Zeit des Domänen-Managers.

haltTime

Gibt Folgendes an: Datum und Uhrzeit, an dem bzw. zu der ein Verteilungsauftrag angehalten werden soll. Das Datum muss im ISO-Format "JJJJ-MM-TT HH:MM" angegeben werden.

install

Generiert einen Installations-Job für das angegebene Element. Der verknüpfte Task der angegebenen Prozedur muss den Typ "install" besitzen.

installedWith

Gibt Folgendes an: Name der Installationsprozedur, die zur Installation des angegebenen Elementes auf den Zielsystemen verwendet wurde.

Dieser Parameter muss für die Befehle "activate", "configure" und "uninstall" angegeben werden. Für den Befehl "install" ist der Parameter nicht von Bedeutung und wird ignoriert.

item

Gibt Folgendes an: Name des Elements, für das der Job generiert wird.

jcPriority

Gibt Folgendes an: Priorität des Jobcontainers.

Die angegebene Priorität muss numerisch sein, und der Wert muss größer oder gleich 1 und kleiner oder gleich 10 sein.

Wenn dieser Parameter nicht angegeben wird, wird von der Priorität 5 ausgegangen.

jobTimeOut=days.hours

Gibt Folgendes an: "jobTimeout" gibt den Ablaufzeitraum eines Jobs im Format "t.h" ein, wobei "t" für die Anzahl der Tage und "h" für die Anzahl der Stunden steht. Der Parameterbereich kann über den Manager definiert werden. Wenn der angegebene Wert den konfigurierten Maximalwert überschreitet, wird dieser Wert auf den Maximalwert gesetzt. Wenn der angegebene Wert den Mindestwert unterschreitet, wird der Mindestwert verwendet. Es wird keine Warnung angezeigt.
"jobTimeout" sollte nicht mit dem Parameter "timeout" angegeben werden, da dies zu Fehlern führt. Wenn kein Parameter angegeben wird, gilt die Standardeinstellung "7.0".

noCalendar

Wenn "noCalendar" angegeben ist, wird ein möglicherweise auf dem Zielcomputer vorhandener Kalender für die Jobausführung ignoriert.

noCascade

Die Jobverknüpfungsoption wird auf "Überlappung ignorieren" gesetzt.

Dieser Parameter ist nur zulässig, wenn "Transaktion" oder "synchronisiert" angegeben sind.

noLinkage

Führt den Job unabhängig von den anderen Jobs im Container aus.

offline

Wenn "offline" oder "offline=y" angegeben ist, wird die Verbindung zwischen dem Zielcomputer und dem Server für die Jobausführung getrennt und anschließend wiederhergestellt.
Wenn "offline=n" angegeben ist, wird die Verbindung nicht getrennt.

parameters

Gibt Folgendes an: Benutzerparameter für die Prozedur.
Mehrere Parameter müssen innerhalb von Anführungszeichen durch Leerzeichen getrennt werden.
Wenn eine leere Zeichenfolge eingegeben wird, werden keine Parameter mehr verwendet.

postaction

Gibt die notwendigen Aktionen an, die nach Abschluss der angegebenen Prozedur ausgeführt werden müssen. Folgende Werte sind gültig:

kein

Führt keine Folgeaktion aus.

reboot

Startet das System nach Abschluss der Prozedur neu.

logoff

Meldet den Benutzer nach Abschluss der Prozedur ab.

rebootAtEnd

Startet das System nach Abschluss aller Jobs dieses Containers neu.

logoffAtEnd

Meldet den Benutzer nach Abschluss aller Jobs dieses Containers ab.

shutdownAtEnd

Fährt den Zielcomputer nach Abschluss der Jobs herunter.

preaction

Gibt an, dass notwendige Aktionen ausgeführt werden müssen, bevor die angegebene Prozedur startet. Folgende Werte sind gültig:

kein

Führt keine vorangestellte Aktion aus.

reboot

Startet das System vor dem Start der Prozedur neu.

logoff

Meldet den Benutzer vor dem Start der Prozedur ab.

preventLogon

Wenn "preventLogon" oder "preventLogon=y" angegeben ist, werden Anmeldeversuche von Benutzern während der Ausführung des Jobs zurückgewiesen. Wenn ein Benutzer bereits angemeldet ist, wird die Ausführung des Jobs verzögert, bis sich der Benutzer abgemeldet hat.
Wenn "preventLogon=n" angegeben ist, wird der Anmeldeversuch nicht zurückgewiesen.

Prozedur

Gibt Folgendes an: Name einer Prozedur, die ausgeführt werden soll.

prompt=days.hours

Gibt Folgendes an: Zeitspanne, in der der Benutzer zum Starten des Jobs aufgefordert wird.

Der Zeitraum wird im Format "t.h" angegeben. Dabei steht "t" für Tage und "h" für Stunden.

Der Bereich dieses Parameters reicht von drei Stunden bis zu sieben Tagen (von 0.3 bis 7.0). Wenn der angegebene Wert unter dem gültigen Mindestwert liegt, wird er durch den Mindestwert ersetzt. Wenn der angegebene Wert den gültigen Maximalwert übersteigt, wird er durch den Maximalwert ersetzt. Es wird keine Warnung angezeigt.

promptUser

Wenn "promptUser" oder "promptUser=j" angegeben ist, wird der Benutzer zur Ausführung des Jobs aufgefordert.

Wenn "promptUser=n" eingegeben wird, wird der Benutzer nicht aufgefordert.

reinstall

Optionaler Parameter. Standard: "reinstall=n"

Wenn "reinstall" oder "reinstall=y" codiert ist, wird ein ggf. vorhandener zum Auftrag gehöriger Installationsdatensatz entfernt, bevor der Job durch den Domänen-Manager ausgewertet wird.

Wenn "reinstall=n" codiert ist, bleiben solche Datensätze bestehen.

Hinweis: Die Option "reinstall" ist nur für die Aktion "install" gültig, nicht für die Aktionen "configure", "activate" und "uninstall".

resolveQuery

Wertet vor Erstellung des Jobs eine möglicherweise vorhandene Abfragegruppe aus.

Rollback

Setzt die Jobverknüpfungsoption auf "Transaktion aktivieren".

runAtShutdown

Wenn "runAtShutdown" oder "runAtShutdown=y" angegeben ist, wird die Ausführung des Jobs erst beim Herunterfahren gestartet.
Wenn "runAtShutdown=n" angegeben ist, wird die Ausführung des Jobs auch zu beliebigen anderen Zeitpunkten gestartet.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert der zugehörigen Prozedur verwendet.
Dieser Parameter wird nur für Unix-Ziele verwendet.

sendTime

Gibt Folgendes an: Zeit, um die zugeordnete Verteilung an die angegebenen Domänen-Manager zu senden. Das Datum muss im ISO-Format "JJJJ-MM-TT HH:MM" angegeben werden. Wenn der Parameter nicht angegeben ist, werden das aktuelle Datum und die aktuelle Uhrzeit verwendet.

sep

Gibt ein alternatives Trennzeichen für die Option "ccompgroup" an. Das Trennzeichen darf nicht Teil des Gruppennamencodes für die "ccompgroup"-Optionen sein.

stagingServer

Liefert das zugehörige Produkt auch an die Staging-Bibliotheken der Scalability-Server der Zielcomputer.

Dieser Parameter bezieht sich nur auf Prozeduren des Aufgabentyps "install".

synchronisiert

Die Jobverknüpfungsoption wird auf "Synchronisierte Jobausführung" gesetzt.

timeout

Gibt Folgendes an: "timeout" gibt den Ablaufzeitraum eines Jobs im Format "h" ein, wobei "h" für die Anzahl der Stunden steht. Der Parameterbereich kann über den Manager definiert werden. Wenn der angegebene Wert den konfigurierten Maximalwert überschreitet, wird dieser Wert auf den Maximalwert gesetzt. Wenn der angegebene Wert den Mindestwert unterschreitet, wird der Mindestwert verwendet. Es wird keine Warnung angezeigt.
Der Parameter "timeout" sollte nicht mit dem Parameter "jobTimeout" angegeben werden, da dies zu Fehlern führt. Wenn kein Parameter angegeben wird, gilt die Standardeinstellung "168".

toAllAreas

Wenn dieser Parameter angegeben ist, wird die zugehörige Verteilung an alle CA ITCM-Domänen gesendet, die beim Enterprise-Manager registriert sind.

Transaktion

Die Jobverknüpfungsoption wird auf "Batch-Jobausführung" gesetzt.

uninstall

Generiert einen Deinstallations-Job für das angegebene Element. Der verknüpfte Task der angegebenen Prozedur muss den Typ "uninstall" besitzen.

unsealed

Der adressierte Jobcontainer bleibt unversiegelt, nachdem der generierte Job erfolgreich erstellt wurde.

Version

Gibt Folgendes an: Version des Elements, für das der Job generiert wird.

userJobMessage

Gibt die benutzerdefinierte Administratormeldung für einen Job in einem Jobcontainer an.

userMessage

Gibt die benutzerdefinierte Administratormeldung für einen Jobcontainer an.

Die Parameter "allowCancel", "execTimedOut" und "prompt" sind gültig, wenn die Option "promptUser" bereits festgelegt wurde oder mit Hilfe des Parameters "promptUser" von diesem Befehl festgelegt wird.
Wenn weder die Option "promptUser" eines Jobs noch der Parameter "promptUser" des Befehls festgelegt wird, werden diese Parameter ignoriert.
Es wird keine Warnung angezeigt.