CA IT Client Manager - CLI-Referenzhandbuch

Transcription

CA IT Client Manager - CLI-Referenzhandbuch
CA IT Client Manager
CLI-Referenzhandbuch
Version 12.8
Diese Dokumentation, die eingebettete Hilfesysteme und elektronisch verteilte Materialien beinhaltet (im Folgenden als
"Dokumentation" bezeichnet), dient ausschließlich zu Informationszwecken des Nutzers und kann von CA jederzeit geändert
oder zurückgenommen werden. Diese Dokumentation ist Eigentum von CA und darf ohne vorherige schriftliche Genehmigung
von CA weder vollständig noch auszugsweise kopiert, übertragen, vervielfältigt, veröffentlicht, geändert oder dupliziert werden.
Der Benutzer, der über eine Lizenz für das bzw. die in dieser Dokumentation berücksichtigten Software-Produkt(e) verfügt, ist
berechtigt, eine angemessene Anzahl an Kopien dieser Dokumentation zum eigenen innerbetrieblichen Gebrauch im
Zusammenhang mit der betreffenden Software auszudrucken, vorausgesetzt, dass jedes Exemplar diesen
Urheberrechtsvermerk und sonstige Hinweise von CA enthält.
Dieses Recht zum Drucken oder anderweitigen Anfertigen einer Kopie der Dokumentation beschränkt sich auf den Zeitraum der
vollen Wirksamkeit der Produktlizenz. Sollte die Lizenz aus irgendeinem Grund enden, bestätigt der Lizenznehmer gegenüber
CA schriftlich, dass alle Kopien oder Teilkopien der Dokumentation an CA zurückgegeben oder vernichtet worden sind.
SOWEIT NACH ANWENDBAREM RECHT ERLAUBT, STELLT CA DIESE DOKUMENTATION IM VORLIEGENDEN ZUSTAND OHNE
JEGLICHE GEWÄHRLEISTUNG ZUR VERFÜGUNG; DAZU GEHÖREN INSBESONDERE STILLSCHWEIGENDE GEWÄHRLEISTUNGEN
DER MARKTTAUGLICHKEIT, DER EIGNUNG FÜR EINEN BESTIMMTEN ZWECK UND DER NICHTVERLETZUNG VON RECHTEN. IN
KEINEM FALL HAFTET CA GEGENÜBER IHNEN ODER DRITTEN GEGENÜBER FÜR VERLUSTE ODER UNMITTELBARE ODER
MITTELBARE SCHÄDEN, DIE AUS DER NUTZUNG DIESER DOKUMENTATION ENTSTEHEN; DAZU GEHÖREN INSBESONDERE
ENTGANGENE GEWINNE, VERLORENGEGANGENE INVESTITIONEN, BETRIEBSUNTERBRECHUNG, VERLUST VON GOODWILL ODER
DATENVERLUST, SELBST WENN CA ÜBER DIE MÖGLICHKEIT DIESES VERLUSTES ODER SCHADENS INFORMIERT WURDE.
Die Verwendung aller in der Dokumentation aufgeführten Software-Produkte unterliegt den entsprechenden
Lizenzvereinbarungen, und diese werden durch die Bedingungen dieser rechtlichen Hinweise in keiner Weise verändert.
Diese Dokumentation wurde von CA hergestellt.
Zur Verfügung gestellt mit „Restricted Rights“ (eingeschränkten Rechten) geliefert. Die Verwendung, Duplizierung oder
Veröffentlichung durch die US-Regierung unterliegt den in FAR, Absätze 12.212, 52.227-14 und 52.227-19(c)(1) bis (2) und
DFARS, Absatz 252.227-7014(b)(3) festgelegten Einschränkungen, soweit anwendbar, oder deren Nachfolgebestimmungen.
Copyright © 2013 CA. Alle Rechte vorbehalten. Alle Markenzeichen, Markennamen, Dienstleistungsmarken und Logos, auf die
hier verwiesen wird, sind Eigentum der jeweiligen Unternehmen.
CA Technologies-Produktreferenzen
Diese Dokumentation bezieht sich auf die folgenden CA-Produkte:
■
CA Advantage® Data Transport® (CA Data Transport)
■
CA Asset Intelligence
■
CA Asset Portfolio Management (CA APM)
■
CA Common Services™
■
CA Desktop Migration Manager (CA DMM)
■
CA Embedded Entitlements Manager (CA EEM)
■
CA Network and Systems Management (CA NSM)
■
CA Patch Manager
■
CA Process Automation
■
CA Business Intelligence
■
CA Service Desk Manager
■
CA WorldView™
■
CleverPath™ Reporter
Technischer Support – Kontaktinformationen
Wenn Sie technische Unterstützung für dieses Produkt benötigen, wenden Sie sich an
den Technischen Support unter http://www.ca.com/worldwide. Dort finden Sie eine
Liste mit Standorten und Telefonnummern sowie Informationen zu den Bürozeiten.
Inhalt
Kapitel 1: Übersicht
9
Konventionen für dieses Tutorial ................................................................................................................................. 9
cadsmcmd ............................................................................................................................................................. 9
dmsweep ............................................................................................................................................................. 10
dsmPush .............................................................................................................................................................. 10
dsmpgm .............................................................................................................................................................. 11
Umgekehrter Schrägstrich (Windows) und normaler Schrägstrich (Linux) ................................................................ 11
Kapitel 2: CADSMCMD Befehlszeilenschnittstelle
13
Kompatibilität ............................................................................................................................................................. 13
Kapitel 3: cadsmcmd-Befehle
15
Befehlsklassifikation ............................................................................................................................................ 16
activate – Erstellen eines Aktivierungsjobs in einem Jobcontainer .................................................................... 18
area – Domänen-Management ........................................................................................................................... 19
aregsw – Automatisches Registrieren von Software .......................................................................................... 36
bootserver – Verwalten von OSIM-Boot-Servern ............................................................................................... 37
cancel – Abbrechen einer Verteilung .................................................................................................................. 41
comconf – Verwalten allgemeiner Konfigurationen ........................................................................................... 44
compgroup – Verwaltung von Computergruppen .............................................................................................. 68
configure – Erstellen eines Konfigurationsjobs in einem Jobcontainer .............................................................. 90
copyfetched – Kopieren abgerufener Elemente ................................................................................................. 90
dereg – Aufheben der Registrierung von Elementen .......................................................................................... 91
deregproc – Aufheben der Registrierung von Prozeduren ................................................................................. 91
distribution – Verteilungsbefehl ......................................................................................................................... 92
domain – Verwalten von Domänengruppen ....................................................................................................... 97
fetch – Abrufen von Elementen ........................................................................................................................ 109
halt – Anhalten einer aktiven Verteilung .......................................................................................................... 111
image – Verwalten von BS-Images .................................................................................................................... 112
install - configure - activate - uninstall – Generieren und Ausführen von Jobs in
Jobcontainern/Verteilungen ............................................................................................................................. 125
jobcontainer – Jobcontainer-Befehle ................................................................................................................ 136
managedcomputer – Verwalten von Computerkonfigurationen ..................................................................... 216
manager – Verwalten von DSM-Managern....................................................................................................... 219
progress – Prüfen des Verteilungsfortschritts .................................................................................................. 223
rdereg – Remote-Aufhebung der Registrierung von Elementen ...................................................................... 223
Inhalt 5
rderegproc – Remote-Aufhebung der Registrierung von Prozeduren .............................................................. 225
recover – Wiederherstellen fehlgeschlagener Installationen ........................................................................... 226
regproc - Registrieren von Prozeduren ............................................................................................................. 231
regsw - Registrieren von Software .................................................................................................................... 239
renew – Erneuern einer Verteilung................................................................................................................... 241
renewjob – Erneuern eines Jobs ....................................................................................................................... 243
resume – Wiederaufnehmen einer angehaltenen Verteilung .......................................................................... 246
rregproc – Remote-Registrierung von Prozeduren ........................................................................................... 247
rregsw – Remote-Registrierung von Software .................................................................................................. 249
scalabilityServer ................................................................................................................................................ 250
security .............................................................................................................................................................. 251
servergroup – Verwalten von Servergruppen ................................................................................................... 256
stagingserver – Befehle des Scalability-Servers ................................................................................................ 268
swlibrary – Softwarebibliotheksbefehle ........................................................................................................... 275
swpolicy – Befehle für Software-Richtlinien ..................................................................................................... 357
targetcomputer – Zielcomputer-Befehle .......................................................................................................... 405
templategroup – Softwarevorlagen-Befehle .................................................................................................... 460
terminate – Entfernen von Verteilungen aus der Enterprise-Datenbank ......................................................... 526
uninstall – Erstellen eines Deinstallationsjobs in einem Jobcontainer ............................................................. 526
Kapitel 4: Der Befehl "cadsmcmd"
527
lokal ................................................................................................................................................................... 529
batch ................................................................................................................................................................. 530
Pipe ................................................................................................................................................................... 532
Befehl ................................................................................................................................................................ 539
Detaillierter Modus ........................................................................................................................................... 541
loop ................................................................................................................................................................... 542
quit .................................................................................................................................................................... 542
Nichtprivilegierte Benutzer ............................................................................................................................... 542
login................................................................................................................................................................... 542
Die Option "trace" ............................................................................................................................................. 544
Schriftarten ....................................................................................................................................................... 545
Parameter ......................................................................................................................................................... 546
Längenbeschränkungen .................................................................................................................................... 546
Einschränkungen ............................................................................................................................................... 547
Verwenden von Filtern ...................................................................................................................................... 547
Kapitel 5: dmsweep-Befehle
551
dmsweep-Unterbefehle ........................................................................................................................................... 552
dmsweep help, dmsweep usage ....................................................................................................................... 552
dmsweep deploy ............................................................................................................................................... 553
6 CLI-Referenzhandbuch
dmsweep packages ........................................................................................................................................... 559
dmsweep scan ................................................................................................................................................... 562
dmsweep sspack ............................................................................................................................................... 566
dmsweep stage ................................................................................................................................................. 568
dmsweep version .............................................................................................................................................. 572
Verschlüsselte Kennwörter ...................................................................................................................................... 573
dmsweep - Datei mit Zielanmeldeinformationen .................................................................................................... 573
Syntax der Datei mit Anmeldeinformationen ................................................................................................... 574
Abkürzungen für dmsweep-Argumente ................................................................................................................... 576
dmdFtpUpload: FTP-Upload für DMPrimer .............................................................................................................. 577
Kapitel 6: Befehl "DSMPGM" - Steuern der Daemon-Prozesse unter Linux
und UNIX
579
Kapitel 7: Das Tool "dsmPush"
581
dsmPush -? - Syntax - ............................................................................................................................................... 582
Funktion "dsmPush check"....................................................................................................................................... 583
Skript "dsmPush copy": Pakete in Bibliotheken importieren ................................................................................... 583
Kombinationsmöglichkeiten der Parameter ..................................................................................................... 587
dsmPush-Beispiele ................................................................................................................................................... 587
Kapitel 8: intellisigcmd - Befehlszeilen-Tool
591
intellisigcmd export – Exportieren von Intellisigs .................................................................................................... 592
intellisigcmd import – Importieren von Intellisigs ................................................................................................... 593
intellisigcmd genuuid – Generieren von UUIDs ....................................................................................................... 594
Kapitel 9: MDB-Admin-Konsolen-CLI
595
MDB-Admin-Konsole ................................................................................................................................................ 595
Hinweise zum Exportieren und Importieren ..................................................................................................... 596
Exportieren und Importieren von Daten über MDB-Plattformen und -Versionen hinweg .............................. 596
Dateien und Ordner der MDB-Admin-Konsole ........................................................................................................ 597
Konfigurieren von Datenbankverbindungen ............................................................................................................ 598
Verwenden der MDB-Admin-Konsole ...................................................................................................................... 600
Befehlszeilenargumente ................................................................................................................................... 600
MDB-Admin-Konsolen-CLI ................................................................................................................................. 601
Fehlerbehebung ....................................................................................................................................................... 610
Fehlerprotokollierung ....................................................................................................................................... 610
Konfigurieren der Protokollierung .................................................................................................................... 611
Fehlermeldungen .............................................................................................................................................. 612
Inhalt 7
Anhang A: cadsmcmd-Meldungen
617
Rückgabecodes ......................................................................................................................................................... 618
BMS-Fehler ............................................................................................................................................................... 639
CSM-Fehler ............................................................................................................................................................... 643
Anhang B: Unterstützte MDB-Objekttypen
645
Anhang C: Regeln für den MDB-Objektvergleich
651
8 CLI-Referenzhandbuch
Kapitel 1: Übersicht
Das CLI-Referenzhandbuch enthält detaillierte Referenzinformationen für vier separate
CA ITCM-Befehlszeilenschnittstellen:
■
cadsmcmd
■
dmsweep
■
dsmpgm
■
dsmPush
Dieses Kapitel enthält folgende Themen:
Konventionen für dieses Tutorial (siehe Seite 9)
Umgekehrter Schrägstrich (Windows) und normaler Schrägstrich (Linux) (siehe Seite 11)
Konventionen für dieses Tutorial
Folgende Konventionen werden für jede Befehlszeilenschnittstelle verwendet:
cadsmcmd
item
cadsmcmd-Schlüsselwort oder Konstante
item
Variable
|
Alternative
{item}
Element kann ein Mal oder mehrfach verwendet werden
[item]
Element ist optional
Kapitel 1: Übersicht 9
Konventionen für dieses Tutorial
dmsweep
item
Schlüsselwort oder Konstante
<item>
Variable
|
Alternative
{item}
mindestens eines dieser Elemente muss angewender werden
[item]
Element ist optional
Hinweis: Die Wiederholung von Optionen wird nicht unterstützt. Die Wiederholung
von Argumenten wird nur für die Option ‘/ip’ unterstützt.
dsmPush
item
Schlüsselwort oder Konstante
<item>
Variable
|
Alternative
{item}
Element kann ein Mal oder mehrfach verwendet werden
[item]
Element ist optional
10 CLI-Referenzhandbuch
Umgekehrter Schrägstrich (Windows) und normaler Schrägstrich (Linux)
dsmpgm
item
Schlüsselwort oder Konstante
|
Alternative
{item}
Element kann ein Mal oder mehrfach verwendet werden
Umgekehrter Schrägstrich (Windows) und normaler
Schrägstrich (Linux)
Die Dokumentation verwendet umgekehrte Schrägstriche (\) für Windows-Umgebungen
und normale Schrägstriche (/) für Linux-Umgebungen.
Beachten Sie, dass für Linux implizit der normale Schrägstrich gilt, wenn in der
Dokumentation ein umgekehrter Schrägstrich erwähnt wird.
Beachten Sie, dass bei Linux ein Pfad, der mit / beginnt, der absolute Pfad ist und ein
Pfad, der mit ./ beginnt, ein relativer Pfad im Hinblick auf das aktuelle Verzeichnis ist.
Relative Pfade werden beispielsweise bei der Registrierung von Prozeduren mit
"cadsmcmd command regproc" verwendet. Wenn das aktuelle Verzeichnis
beispielsweise "/a/b/c" ist und Sie den Pfad "./tmp/d/datei1" für die Datei "datei1"
angeben, so ist der absolute Pfad für "datei1" "/a/b/c/tmp/d/datei1".
Kapitel 1: Übersicht 11
Kapitel 2: CADSMCMD
Befehlszeilenschnittstelle
Die Automation ist für die Fähigkeit zur Verwaltung komplexer Netzwerke von
entscheidender Bedeutung. Die Befehlszeilenschnittstelle CADSMCMD unterstützt die
Automation im Bereich von CA ITCM Common Object (CO), Common Configuration
(CCNF) und Software Delivery (SD), einschließlich BS-Installationsverwaltung (OSIM). Die
CLI bietet auf Shell oder Eingabeaufforderungen basierende Schnittstellen, die von den
Shell-Skripten oder Batch-Skripten zur Automation verwendet werden können.
Diese CLI wird auf Linux mit der Befehlszeilenkomponente und auf Windows mit dem
DSM-Explorer installiert.
Hinweis: CADSMCMD wird nur für Linux, nicht jedoch für andere UNIX-Derivate
bereitgestellt.
Dieses Kapitel enthält folgende Themen:
Kompatibilität (siehe Seite 13)
cadsmcmd-Befehle (siehe Seite 15)
Der Befehl "cadsmcmd" (siehe Seite 527)
Kompatibilität
Aufgrund wichtiger Veränderungen in CA ITCM Version 12.8 ist die CLI nicht zu 100% mit
ihren früheren Versionen kompatibel. Einige ihrer Befehle und Aktionen werden nicht
mehr verwendet. Sie werden in diesem Handbuch nicht mehr beschrieben. Wenn sie
aufgerufen werden, gibt die CLI eine Warnung zurück, die anzeigt, dass dieser Befehl
oder diese Aktion nicht mehr verwendet wird. Die Warnung wird als Meldung in stdout
geschrieben:
SDCMD<CMD000118>: Warnung: Funktion ist veraltet.
Der an das aufrufende Skript übergebene Rückgabecode lautet 0.
Kapitel 2: CADSMCMD Befehlszeilenschnittstelle 13
Kompatibilität
Die von einigen Befehlen oder Aktionen zurückgegebenen Informationen haben sich
aufgrund der in Version 12.8 verfügbaren Informationen geändert. Die Liste dieser
Befehle und Aktionen lautet:
■
targetComputer
■
compGroup
■
templateGroup
■
jobContainer
■
swLibrary
■
area
■
domain
Wenn das gesicherte Objekt aus der Sicherheitsklasse "SoftwarePackage" stammt,
müssen Sie den Namen und die Version im folgenden Format angeben:
«Name»|«Version».
Falls «Name» Leerzeichen enthält, müssen Sie «Name»|«Version» in Anführungszeichen
setzen:
"«Name»|«Version»".
Beispiel:
Name "Testpaket" und Version "1.0"
soname=Testpaket|1.0
Name "CA ITCM-Manager" und Version "12.0"
soname="CA ITCM-Manager|12.0"
14 CLI-Referenzhandbuch
Kapitel 3: cadsmcmd-Befehle
Dieses Kapitel enthält folgende Themen:
Befehlsklassifikation (siehe Seite 16)
activate – Erstellen eines Aktivierungsjobs in einem Jobcontainer (siehe Seite 18)
area – Domänen-Management (siehe Seite 19)
aregsw – Automatisches Registrieren von Software (siehe Seite 36)
bootserver – Verwalten von OSIM-Boot-Servern (siehe Seite 37)
cancel – Abbrechen einer Verteilung (siehe Seite 41)
comconf – Verwalten allgemeiner Konfigurationen (siehe Seite 44)
compgroup – Verwaltung von Computergruppen (siehe Seite 68)
configure – Erstellen eines Konfigurationsjobs in einem Jobcontainer (siehe Seite 90)
copyfetched – Kopieren abgerufener Elemente (siehe Seite 90)
dereg – Aufheben der Registrierung von Elementen (siehe Seite 91)
deregproc – Aufheben der Registrierung von Prozeduren (siehe Seite 91)
distribution – Verteilungsbefehl (siehe Seite 92)
domain – Verwalten von Domänengruppen (siehe Seite 97)
fetch – Abrufen von Elementen (siehe Seite 109)
halt – Anhalten einer aktiven Verteilung (siehe Seite 111)
image – Verwalten von BS-Images (siehe Seite 112)
install - configure - activate - uninstall – Generieren und Ausführen von Jobs in
Jobcontainern/Verteilungen (siehe Seite 125)
jobcontainer – Jobcontainer-Befehle (siehe Seite 136)
managedcomputer – Verwalten von Computerkonfigurationen (siehe Seite 216)
manager – Verwalten von DSM-Managern (siehe Seite 219)
progress – Prüfen des Verteilungsfortschritts (siehe Seite 223)
rdereg – Remote-Aufhebung der Registrierung von Elementen (siehe Seite 223)
rderegproc – Remote-Aufhebung der Registrierung von Prozeduren (siehe Seite 225)
recover – Wiederherstellen fehlgeschlagener Installationen (siehe Seite 226)
regproc - Registrieren von Prozeduren (siehe Seite 231)
regsw - Registrieren von Software (siehe Seite 239)
renew – Erneuern einer Verteilung (siehe Seite 241)
renewjob – Erneuern eines Jobs (siehe Seite 243)
resume – Wiederaufnehmen einer angehaltenen Verteilung (siehe Seite 246)
rregproc – Remote-Registrierung von Prozeduren (siehe Seite 247)
rregsw – Remote-Registrierung von Software (siehe Seite 249)
scalabilityServer (siehe Seite 250)
security (siehe Seite 251)
servergroup – Verwalten von Servergruppen (siehe Seite 256)
stagingserver – Befehle des Scalability-Servers (siehe Seite 268)
swlibrary – Softwarebibliotheksbefehle (siehe Seite 275)
swpolicy – Befehle für Software-Richtlinien (siehe Seite 357)
targetcomputer – Zielcomputer-Befehle (siehe Seite 405)
templategroup – Softwarevorlagen-Befehle (siehe Seite 460)
terminate – Entfernen von Verteilungen aus der Enterprise-Datenbank (siehe Seite 526)
uninstall – Erstellen eines Deinstallationsjobs in einem Jobcontainer (siehe Seite 526)
Kapitel 3: cadsmcmd-Befehle 15
Kompatibilität
Befehlsklassifikation
Der Bereich gültiger Befehle, den die CLI anbietet, ist abhängig von der Art des
Managers, mit dem sie verbunden ist, sowie von den von diesem Manager angebotenen
Dienstleistungen.
Dieser Abschnitt enthält die folgenden Themen:
Allgemeine Befehle (siehe Seite 16)
Domäne (siehe Seite 16)
Enterprise (siehe Seite 17)
Allgemeine Befehle
Folgende Befehle sind jederzeit verfügbar, unabhängig davon, mit welchem ManagerTyp die CLI verbunden ist (Domänen-Manager oder Enterprise-Manager) und welche
Dienste dieser Manager anbietet. Es handelt sich dabei um allgemeine Befehle. Dies
bedeutet aber nicht, dass alle möglichen Aktionen, die mit dem Befehl definiert sind, für
jeden Manager zur Verfügung stehen.
Befehl
Festlegung eingeschränkte Aktion
comConf
Nein
comgroup
Ja
servergroup
Nein
setdbcredentials
Nein
Domäne
Die folgenden Befehle sind auf einer Domäne verfügbar:
Befehl
Erforderliche Dienste beim
Manager
Eingeschränkte Aktion festgelegt
activate
SD
-
aregsw
SD
-
bootserver
SD, OSIM
-
Abbrechen
SD
-
compgroup
SD
Ja
Nein
configure
SD
-
dereg
SD
-
16 CLI-Referenzhandbuch
Kompatibilität
deregproc
SD
-
Image
SD, OSIM
Nein
install
SD
-
jobcontainer
SD
Nein
managedcomputer
-
Nein
manager
SD, OSIM
-
recover
SD
-
regproc
SD
-
regsw
SD
-
renewjob
SD
-
scalabilityServer
AM (00:00-12:00)
Nein
security
SD
-
stagingserver
SD
Nein
swlibrary
SD
Nein
swpolicy
SD
Nein
targetcomputer
SD/OSIM
Nein
templategroup
SD
Nein
uninstall
SD
-
Enterprise
Die folgenden Befehle sind für das Enterprise verfügbar:
Befehl
Erforderliche Dienste beim
Manager
Eingeschränkte Aktion festgelegt
activate
SD
-
area
SD
Ja
Nein
aregsw
SD
-
Abbrechen
SD
-
compgroup
SD
Ja
nur Festlegung Enterprise
configure
SD
-
copyfetched
SD
-
Kapitel 3: cadsmcmd-Befehle 17
Kompatibilität
Befehl
Erforderliche Dienste beim
Manager
Eingeschränkte Aktion festgelegt
delfetched
SD
* veraltet - verwenden Sie stattdessen
area action=removeFetchedItem (Siehe Definition
auf Seite 34)
*
dereg
SD
-
deregproc
SD
-
Verteilung
SD
Nein
domain
-
Nein
fetch
SD
-
halt
SD
-
install
SD
-
progress
SD
-
rdereg
SD
-
rderegproc
SD
-
regproc
SD
-
regsw
SD
-
renew
SD
-
resume
SD
-
rregproc
SD
-
rregsw
SD
-
swLibrary
SD
Nein
swpolicy
SD
Nein
templategroup
SD
nur Festlegung Enterprise
terminate
SD
-
uninstall
SD
-
activate – Erstellen eines Aktivierungsjobs in einem Jobcontainer
Weitere Informationen finden Sie unter dem Befehl "Install".
18 CLI-Referenzhandbuch
Kompatibilität
area – Domänen-Management
Aktionen im Enterprise:
{list (Siehe Definition auf Seite 20) | showattr (Siehe Definition auf Seite 23) |
listmembership (Siehe Definition auf Seite 22) | modify (Siehe Definition auf Seite 22) |
...listdistsw (Siehe Definition auf Seite 24) | removedistsw (Siehe Definition auf Seite 28)
| listfetcheditems (Siehe Definition auf Seite 29) |
...listfetcheditemfiles (Siehe Definition auf Seite 32) | removefetcheditem (Siehe
Definition auf Seite 34) |
...addtodomains (Siehe Definition auf Seite 35) | removefromdomains (Siehe Definition
auf Seite 36)}
:
Hinweis: Die Terminologie von CA IT Client Manager hat sich im Vergleich zu Unicenter
Software Delivery 4.0 geändert. Der SD-"Bereich" entspricht der CA ITCM-"Domäne",
während die SD-"Domäne" einer CA ITCM-Domänengruppe entspricht.
Dennoch haben sich aus Kompatibilitätsgründen die Namen für Terminologie, Befehl
und Parameter der CLI nicht geändert.
Um Mehrdeutigkeiten zu vermeiden, wird ein Bereich (eine Domäne in der Terminologie
von CA IT Client Manager) in den folgenden Abschnitten als "CA ITCM-Domäne" und
eine Domäne (eine Domänengruppe in der Terminologie von CA IT Client Manager) als
"CA ITCM-Domänengruppe" bezeichnet.
Die CA ITCM-Domänen werden vom Befehl "area" der CLI und die CA ITCMDomänengruppen vom Befehl "domain" der CLI verarbeitet.
Hinweis: Die folgenden Methoden können nur auf einem Enterprise-Manager
verwendet werden.
Dieser Abschnitt enthält die folgenden Themen:
Allgemeine Aktionen (siehe Seite 20)
Verwaltung verteilter Software (siehe Seite 24)
Verwaltung abgerufener Elemente (siehe Seite 29)
Verwaltung von Inhaltsbeziehungen (siehe Seite 35)
Kapitel 3: cadsmcmd-Befehle 19
Kompatibilität
Allgemeine Aktionen
Dieser Abschnitt enthält die folgenden Themen:
list – Auflisten des Bereichs (siehe Seite 20)
listMembership – Auflisten von Domänengruppen mit der Domäne (siehe Seite 22)
modify – Ändern der Domänenattribute (siehe Seite 22)
showAttr – Anzeigen der Domänenattribute (siehe Seite 23)
list – Auflisten des Bereichs
Diese Aktion listet alle CA ITCM-Domänen auf. Um die Menge der angezeigten
Informationen einzuschränken, kann ein Filter festgelegt werden.
Diese Aktion hat das folgende Format:
area action=list
[{filter=Filter |filterfile=Dateiname}]
filter
Gibt Folgendes an: Ausdruck, um die Anzahl der aufgelisteten Informationen
einzuschränken.
Die folgenden Attribute können zur Erstellung elementarer Filterausdrücke
verwendet werden:
Attribut
Typ
Bereich
Zeichenfolge
Hostname
Zeichenfolge
Registriert am
Zeichenfolge
Zuletzt geändert
am
Zeichenfolge
Kommentar
Zeichenfolge
Version
Zeichenfolge
filterfile
Gibt Folgendes an: Name der Datei, die die Filterbefehle enthält.
Die Befehle der Datei werden auf die gleiche Weise festgelegt wie im Parameter
"Filter". Die Kapazität der Datei wird jedoch durch die Kapazität des den Befehl
ausführenden Systems begrenzt.
Dieser Abschnitt enthält die folgenden Themen:
Beispiel: Anzeigen von allen Bereichen (siehe Seite 21)
Allgemeine Aktionen (siehe Seite 20)
20 CLI-Referenzhandbuch
Kompatibilität
Beispiel: Anzeigen von allen Bereichen
Geben Sie den folgenden Befehl ein, um alle Bereiche aufzulisten:
cadsmcmd area action=list
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
Verbindung zu Manager "<Standard-Manager>" als Benutzer "<Standardbenutzer>" wird
hergestellt... OK.
Manager: myManager
Domäne: myDomain
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
------------------------------------------------------------------------------Liste der Bereiche
------------------------------------------------------------------------------area 1
area 2
area4test
WWWWW01B
Anzahl der aufgelisteten Elemente.................: 4
Anzahl der gelesenen Elemente...................: 4
SDCMD<A000000>: OK
Geben Sie den folgenden Befehl ein, um mit Hilfe von Filtern die Bereiche aufzuführen,
deren Hostname mit dem Buchstaben "W" beginnt:
cadsmcmd area action=list filter="Host name=W*"
Das Ergebnis wird wie folgt angezeigt:
------------------------------------------------------------------------------Liste der Bereiche
------------------------------------------------------------------------------WWWWW01B
Anzahl der aufgelisteten Elemente
Anzahl der gelesenen Elemente
: 1
: 4
SDCMD<A000000>: OK
Kapitel 3: cadsmcmd-Befehle 21
Kompatibilität
listMembership – Auflisten von Domänengruppen mit der Domäne
Diese Aktion listet die CA ITCM-Domänengruppen auf, die die angegebene CA ITCMDomäne enthalten.
Diese Aktion hat das folgende Format:
area action=listMembership name=Bereichsname
Name
Gibt Folgendes an: Name einer CA ITCM-Domäne. Ihre Mitgliedschaft in Domänen
wird aufgelistet.
Beispiel: Auflisten der Mitgliedschaft in Domänen
Geben Sie den folgenden Befehl ein, um alle Domänen aufzulisten, denen der Bereich
"andrea doria" zugewiesen wurde:
cadsmcmd area action=listMembership name="andrea doria"
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Verbindung zu Manager "<Standard-Manager>" als Benutzer "<Standardbenutzer>" wird
hergestellt... OK.
------------------------------------------------------------------------------Liste der Domänen mit dem Bereich "andrea doria"
------------------------------------------------------------------------------test.dom
SDCMD<A000000>: OK
modify – Ändern der Domänenattribute
Diese Aktion ändert Attribute einer CA ITCM-Domäne.
Diese Aktion hat das folgende Format:
area action=modify
name=Bereichsname
[newName=neuer Bereichsname]
[hostname=Hostname]
[comment=Kommentar]
22 CLI-Referenzhandbuch
Kompatibilität
Name
Gibt Folgendes an: Name einer CA ITCM-Domäne. Dieser wird geändert.
newName
Gibt Folgendes an: Neuer Name der CA ITCM-Domäne.
hostname
Gibt Folgendes an: Hostname der CA ITCM-Domäne.
comment
Gibt an: einen Kommentar.
Wenn eine leere Zeichenfolge eingegeben wird, wird der Eintrag gelöscht.
Hinweis: Wenn ein Parameter nicht codiert wird, bleiben die entsprechenden Attribute
unverändert.
Beispiel: Ändern von Bereichsattributen
Angenommen, der Bereich "area4test" soll geändert werden. Der Bereich soll in "andrea
doria" umbenannt werden. Mit Hilfe des folgenden Befehls wird der Bereich geändert:
cadsmcmd area action=modify name=area4test newName="andrea doria"
showAttr – Anzeigen der Domänenattribute
Diese Aktion listet die Attribute einer CA ITCM-Domäne auf.
Diese Aktion hat das folgende Format:
area action=showattr name=Bereichsname
Name
Gibt Folgendes an: Name einer CA ITCM-Domäne. Ihre Attribute werden aufgelistet.
Beispiel: Anzeigen der Attribute eines Bereichs
Geben Sie den folgenden Befehl ein, um alle Attribute des Bereichs "area4test"
aufzulisten:
cadsmcmd area action=showattr name=area4test
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
Kapitel 3: cadsmcmd-Befehle 23
Kompatibilität
Verbindung zu Manager "<Standard-Manager>" als Benutzer "<Standardbenutzer>" wird
hergestellt... OK.
------------------------------------------------------------------------------Attribute des Bereichs "area4test"
------------------------------------------------------------------------------Bereich: area4test
Hostname...............................: area4test.john_doe.com
Registriert am..........................: 2005-04-16 11:48
Zuletzt geändert am.......................: 2005-04-16 11:48
Standort...............................: zenith
Administrator..........................: john doe
Telefon................................: hein.bloed@john_doe.com
Adresse................................: Hauptstr.
Kommentar.............................:
Installation
..Version..............................: 0
SDCMD<A000000>: OK
Verwaltung verteilter Software
Dieser Abschnitt enthält die folgenden Themen:
listDistSW – Auflisten verteilter Softwareprodukte (siehe Seite 24)
removeDisSW – Entfernen verteilter Softwareprodukte (siehe Seite 28)
listDistSW – Auflisten verteilter Softwareprodukte
Diese Aktion listet alle Softwareprodukte auf, die an eine CA ITCM-Domäne verteilt
werden. Wenn Sie die Informationsmenge begrenzen möchten, können Sie Filter
verwenden.
Diese Aktion hat das folgende Format:
area action=listDistSW name=Bereichsname
[{filter=Filter |filterfile=Dateiname}]
24 CLI-Referenzhandbuch
Kompatibilität
Name
Gibt Folgendes an: Name einer CA ITCM-Domäne. Für sie wird die verteilte
Software aufgelistet.
filter
Gibt Folgendes an: Ausdruck, um die Anzahl der aufgelisteten Informationen
einzuschränken.
Die folgenden Attribute können zur Erstellung elementarer Filterausdrücke
verwendet werden:
Attribut
Typ
Elementname
Zeichenfolge
Elementversion
Zeichenfolge
filterfile
Gibt Folgendes an: Name der Datei, die die Filterbefehle enthält.
Die Befehle der Datei werden auf die gleiche Weise festgelegt wie im Parameter
"Filter". Die Kapazität der Datei wird jedoch durch die Kapazität des den Befehl
ausführenden Systems begrenzt.
Beispiel:
Geben Sie den folgenden Befehl ein, um Informationen zu im Bereich "WWWWW01B"
verteilter Software der Version 1.0, die mit "tst" beginnt, abzurufen:
cadsmcmd area action=listDistSW name=WWWWW01B filter="(Item name=tst* && Item
version=1.0)"
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Verbindung zu Manager "<Standard-Manager>" als Benutzer "<Standardbenutzer>" wird
hergestellt... OK.
Kapitel 3: cadsmcmd-Befehle 25
Kompatibilität
------------------------------------------------------------------------------Liste der verteilten Software des Bereichs "WWWWW01B"
------------------------------------------------------------------------------Elementname..........................: tstbase
..Elementversion.........................: 1.0
..Verteilt am.......................: 2005-04-15 09:33
..Installationen......................:
....EAdm...............................: 0
....LAdm...............................: 2
....SWD................................: 0
..Verteilte Prozeduren..................:
....Prozedurname........................: inst
......Task.............................: install
......Verteilt am...................: 2005-04-15 09:33
....Prozedurname........................: remdir
......Task.............................: configure
......Verteilt am...................: 2005-04-15 09:33
....Prozedurname........................: setdir
......Task.............................: configure
......Verteilt am...................: 2005-04-15 09:33
....Prozedurname........................: uninst
......Task.............................: uninstall
......Verteilt am...................: 2005-04-15 09:33
Elementname..........................: tstkpk01
..Elementversion.........................: 1.0
..Verteilt am.......................: 2005-04-15 09:33
..Installationen......................:
....EAdm...............................: 0
....LAdm...............................: 0
....SWD................................: 0
..Verteilte Prozeduren..................:
....Prozedurname........................: act
......Task.............................: activate
......Verteilt am...................: 2005-04-15 09:33
....Prozedurname........................: actCrash
......Task.............................: activate
......Verteilt am...................: 2005-04-15 09:33
....Prozedurname........................: conf
26 CLI-Referenzhandbuch
Kompatibilität
......Task.............................: configure
......Verteilt am...................: 2005-04-15 09:33
....Prozedurname........................: confCrash
......Task.............................: configure
......Verteilt am...................: 2005-04-15 09:33
....Prozedurname........................: inst
......Task.............................: install
......Verteilt am...................: 2005-04-15 09:33
....Prozedurname........................: instCrash
......Task.............................: install
......Verteilt am...................: 2005-04-15 09:33
....Prozedurname........................: instCrashAlways
......Task.............................: install
......Verteilt am...................: 2005-04-15 09:33
....Prozedurname........................: uninst
......Task.............................: uninstall
......Verteilt am...................: 2005-04-15 09:33
....Prozedurname........................: uninstCrash
......Task.............................: uninstall
......Verteilt am...................: 2005-04-15 09:33
Elementname..........................: tstkpk02
..Elementversion.........................: 1.0
..Verteilt am.......................: 2005-04-15 09:33
..Installationen......................:
....EAdm...............................: 0
....LAdm...............................: 2
....SWD................................: 0
..Verteilte Prozeduren..................:
....Prozedurname........................: act
......Task.............................: activate
......Verteilt am...................: 2005-04-15 09:33
....Prozedurname........................: conf
......Task.............................: configure
......Verteilt am...................: 2005-04-15 09:33
....Prozedurname........................: inst
......Task.............................: install
......Verteilt am...................: 2005-04-15 09:33
....Prozedurname........................: instCrash
......Task.............................: install
......Verteilt am...................: 2005-04-15 09:33
....Prozedurname........................: uninst
......Task.............................: uninstall
......Verteilt am...................: 2005-04-15 09:33
Kapitel 3: cadsmcmd-Befehle 27
Kompatibilität
Elementname..........................: tstkpk03
..Elementversion.........................: 1.0
..Verteilt am.......................: 2005-04-15 09:33
..Installationen......................:
....EAdm...............................: 0
....LAdm...............................: 2
....SWD................................: 0
..Verteilte Prozeduren..................:
....Prozedurname........................: act
......Task.............................: activate
......Verteilt am...................: 2005-04-15 09:33
....Prozedurname........................: conf
......Task.............................: configure
......Verteilt am...................: 2005-04-15 09:33
....Prozedurname........................: inst
......Task.............................: install
......Verteilt am...................: 2005-04-15 09:33
....Prozedurname........................: uninst
......Task.............................: uninstall
......Verteilt am...................: 2005-04-15 09:33
Anzahl der aufgelisteten Elemente.................: 4
Anzahl der gelesenen Elemente...................: 11
SDCMD<A000000>: OK
EAdm
Software wurde vom Enterprise-Administrator angefordert.
LAdm
Software wurde vom Domänenadministrator angefordert.
SWD
Software wurde vom Software Detector gefunden.
removeDisSW – Entfernen verteilter Softwareprodukte
Diese Aktion entfernt verteilte Software aus der Liste der verteilten Software einer CA
ITCM-Domäne.
Dies bedeutet nicht, dass die Software aus der Softwarebibliothek des zugehörigen
Domänen-Managers entfernt wird.
Diese Aktion hat das folgende Format:
area action=removeDistSW
name=Bereichsname
item=Elementname
version=Elementversion
28 CLI-Referenzhandbuch
Kompatibilität
Name
Gibt Folgendes an: Name einer CA ITCM-Domäne.
item
Gibt Folgendes an: Name des Elements. Dieses wird entfernt.
Version
Gibt Folgendes an: Version des Elements.
Beispiel
Geben Sie den folgenden Befehl ein, um die Software "tstkpk03" Version 1.0 von der
Liste der verteilten Software des Bereichs "WWWWW01B" zu entfernen:
cadsmcmd area action=removeDistSW name=WWWWW01B item=tstkpk03 version=1.0
Verwaltung abgerufener Elemente
Dieser Abschnitt enthält die folgenden Themen:
listFetchedItems – Auflisten abgerufener Elemente (siehe Seite 29)
listFetchedItemFiles – Auflisten von Dateien abgerufener Elemente (siehe Seite 32)
removeFetchedItem – Abgerufenes Element entfernen (siehe Seite 34)
listFetchedItems – Auflisten abgerufener Elemente
Diese Aktion listet alle abgerufenen Elemente einer CA ITCM-Domäne auf. Wenn Sie die
Informationsmenge begrenzen möchten, können Sie Filter verwenden.
Diese Aktion hat das folgende Format:
area action=listFetchedItems name=Bereichsname
[{filter=Filter |filterfile=Dateiname}]
Name
Gibt Folgendes an: Name einer CA ITCM-Domäne. Ihre abgerufenen Elemente
werden aufgelistet.
filter
Gibt Folgendes an: Ausdruck, um die Anzahl der aufgelisteten Informationen
einzuschränken
Die folgenden Attribute können zur Erstellung elementarer Filterausdrücke
verwendet werden:
Attribut
Typ
Elementname
Zeichenfolge
Status
[noch nicht] kopiert
Kapitel 3: cadsmcmd-Befehle 29
Kompatibilität
Attribut
Typ
Abgerufen am
Zeichenfolge
Pfad abrufen
Zeichenfolge
Kommentar
Zeichenfolge
filterfile
Gibt Folgendes an: Name der Datei, die die Filterbefehle enthält.
Die Befehle der Datei werden auf die gleiche Weise festgelegt wie im Parameter
"Filter". Die Kapazität der Datei wird jedoch durch die Kapazität des den Befehl
ausführenden Systems begrenzt.
Beispiel:
Geben Sie folgenden Befehl ein, um eine Liste aller abgerufenen Elemente des Bereichs
"WWWWW01B" zu erhalten:
cadsmcmd area action=listFetchedItems name=WWWWW01B
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Verbindung zu Manager "<Standard-Manager>" als Benutzer "<Standardbenutzer>" wird
hergestellt... OK.
------------------------------------------------------------------------------Liste der abgerufenen Elemente von Bereich "WWWWW01B"
------------------------------------------------------------------------------Elementname..............................: fetch 1 base
..Status...............................: noch nicht kopiert
..Abgerufen am...........................: 2005-04-16 15:53
..Pfad abrufen........................: h:\save_sw_library\file_1\*
..Kommentar...........................:
Elementname..............................: fetch 1 reginfo
..Status...............................: noch nicht kopiert
..Abgerufen am...........................: 2005-04-16 15:53
..Pfad abrufen........................: h:\save_sw_library\file_1\reginfo\*
..Kommentar...........................:
30 CLI-Referenzhandbuch
Kompatibilität
Elementname..............................: fetch 2 base
..Status...............................: noch nicht kopiert
..Abgerufen am...........................: 2005-04-16 15:53
..Pfad abrufen........................: h:\save_sw_library\file_2\*
..Kommentar...........................:
Elementname..............................: fetch 2 reginfo
..Status...............................: noch nicht kopiert
..Abgerufen am...........................: 2005-04-16 15:53
..Pfad abrufen........................: h:\save_sw_library\file_2\reginfo\*
..Kommentar...........................:
Elementname..........................: fetch_weu1
..Status...............................: noch nicht kopiert
..Abgerufen am...........................: 2005-04-16 15:27
..Pfad abrufen........................: g:\tstool\tstbase\*
..Kommentar...........................:
Anzahl der aufgelisteten Elemente.................: 5
Anzahl der gelesenen Elemente...................: 5
SDCMD<A000000>: OK
Geben Sie den folgenden Befehl ein, um eine Liste aller abgerufenen Elemente des
Bereichs "WWWWW01B" abzurufen, deren Name mit "fetch 1" beginnt:
cadsmcmd area action=listFetchedItems name=WWWWW01B filter="Item name=fetch 1*"
Das Ergebnis wird wie folgt angezeigt:
Elementname..............................: fetch 1 base
..Status...............................: noch nicht kopiert
..Abgerufen am...........................: 2005-04-16 15:53
..Pfad abrufen........................: h:\save_sw_library\file_1\*
..Kommentar...........................:
Elementname..............................: fetch 1 reginfo
..Status...............................: noch nicht kopiert
..Abgerufen am...........................: 2005-04-16 15:53
..Pfad abrufen........................: h:\save_sw_library\file_1\reginfo\*
..Kommentar...........................:
Anzahl der aufgelisteten Elemente.................: 2
Anzahl der gelesenen Elemente...................: 5
Kapitel 3: cadsmcmd-Befehle 31
Kompatibilität
listFetchedItemFiles – Auflisten von Dateien abgerufener Elemente
Diese Aktion listet die abgerufenen Dateien von einem abgerufenen Element der
angegebenen CA ITCM-Domäne auf. Wenn Sie die Informationsmenge begrenzen
möchten, können Sie Filter verwenden.
Diese Aktion hat das folgende Format:
area action=listFetchedItemFiles
name=Bereichsname
item=Elementname
[{filter=Filter |filterfile=Dateiname}]
[sizeinkb]
Name
Gibt Folgendes an: Name einer CA ITCM-Domäne Die Dateien ihrer abgerufenen
Elemente werden aufgelistet.
Item
Gibt Folgendes an: Name des Elements. Seine abgerufenen Dateien werden
aufgelistet.
filter
Gibt Folgendes an: Ausdruck, um die Anzahl der aufgelisteten Informationen
einzuschränken. (Liste der abgerufenen Elemente)
Die folgenden Attribute können zur Erstellung elementarer Filterausdrücke
verwendet werden:
Attribut
Typ
Dateiname
Zeichenfolge
Dateigröße
long
Dateiformat
{directory|file}
Zuletzt geändert am
Zeichenfolge
Dateiattribute
[R][H][S][D][A][N][T][W][X][C]
R
READONLY
N
HIDDEN
S
SYSTEM
D
DIRECTORY
A
ARCHIVE
N
NORMAL
T
TEMPORARY
32 CLI-Referenzhandbuch
Kompatibilität
Attribut
Typ
W
ATOMIC_WRITE
X
XACTION_WRITE
C
COMPRESSED
filterfile
Gibt Folgendes an: Name der Datei, die die Filterbefehle enthält.
Die Befehle der Datei werden auf die gleiche Weise festgelegt wie im Parameter
"Filter". Die Kapazität der Datei wird jedoch durch die Kapazität des den Befehl
ausführenden Systems begrenzt.
sizeinkb
(Optional) Wenn das Sizeinkb-Argument kodiert wird, wird die Größe der
fetcheditemfiles in Kilobytes angegeben.
Standard: Bytes
Beispiel
Geben Sie den folgenden Befehl ein, um Informationen zu den Dateien des abgerufenen
Elements "fetch 2 base" des Bereichs "WWWWW01B" abzurufen:
cadsmcmd area action=listFetchedItemFiles name=WWWWW01B item="fetch 2 base"
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Verbindung zu Manager "<Standard-Manager>" als Benutzer "<Standardbenutzer>" wird
hergestellt... OK.
------------------------------------------------------------------------------Dateiliste des abgerufenen Elements "fetch 2 base" von Bereich "WWWWW01B"
------------------------------------------------------------------------------Dateiname.............................: actions.sxp
..Dateigröße............................: 260
..Dateityp.............................: file
..Zuletzt geändert am.....................: 2005-03-27 16:00
..Dateiattribute......................: H
Dateiname.............................: check.sxp
..Dateigröße............................: 166
..Dateityp.............................: file
..Zuletzt geändert am.....................: 2005-03-27 16:00
..Dateiattribute......................: H
Kapitel 3: cadsmcmd-Befehle 33
Kompatibilität
Dateiname.............................: info.sxp
..Dateigröße............................: 431
..Dateityp.............................: file
..Zuletzt geändert am.....................: 2005-03-27 16:00
..Dateiattribute......................: H
Anzahl der aufgelisteten Elemente.................: 3
Anzahl der gelesenen Elemente...................: 3
SDCMD<A000000>: OK
Geben Sie den folgenden Befehl ein, um mit Hilfe von Filtern Informationen zur Datei
"info.sxp" des abgerufenen Elements "fetch 2 base" des Bereichs "WWWWW01B"
abzurufen:
cadsmcmd area action=listFetchedItemFiles name=WWWWW01B item="fetch 2 base"
filter="File name=info.sxp"
Die folgende Ausgabe wird zurückgegeben:
Dateiname.............................: info.sxp
..Dateigröße............................: 431
..Dateityp.............................: file
..Zuletzt geändert am.....................: 2005-03-27 16:00
..Dateiattribute......................: H
Anzahl der aufgelisteten Elemente.................: 1
Anzahl der gelesenen Elemente...................: 3
SDCMD<A000000>: OK
removeFetchedItem – Abgerufenes Element entfernen
Diese Aktion entfernt ein abgerufenes Element aus der Liste der abgerufenen Elemente
der CA ITCM-Domäne.
Diese Aktion hat das folgende Format:
area action=removeFetchedItem
name=Bereichsname
item=Elementname
Name
Gibt Folgendes an: Name einer CA ITCM-Domäne, aus der das abgerufene Element
entfernt wird.
Item
Gibt Folgendes an: Name des Elements, das entfernt werden soll.
34 CLI-Referenzhandbuch
Kompatibilität
Beispiel:
Geben Sie den folgenden Befehl ein, um das Element "fetch 2 base" von der Liste der
abgerufenen Elemente des Bereichs "WWWWW01B" zu entfernen:
cadsmcmd area action=removeFetchedItem name=WWWWW01B item="fetch 2 base"
Verwaltung von Inhaltsbeziehungen
Dieser Abschnitt enthält die folgenden Themen:
addToDomains – Hinzufügen von Domänengruppen zu Domänengruppen (siehe Seite
35)
removeFromDomains – Entfernen von Domänengruppen aus Domänengruppen (siehe
Seite 36)
addToDomains – Hinzufügen von Domänengruppen zu Domänengruppen
Diese Aktion fügt eine CA ITCM-Domäne zu einer Liste von CA ITCM-Domänengruppen
hinzu.
Diese Aktion hat das folgende Format:
area action=addToDomains
name=Bereichsname
{domain=Domänenname}
Name
Gibt Folgendes an: Name einer CA ITCM-Domäne.
Sie wird zu einer oder mehreren CA ITCM-Domänengruppen hinzugefügt.
domain
Gibt Folgendes an: Name einer CA ITCM-Domänengruppe.
Der Parameter kann mehrfach angegeben werden , um eine Liste mit CA ITCMDomänengruppen zuzuweisen.
Die CA ITCM-Domänengruppe muss existieren.
Beispiel:
Geben Sie den folgenden Befehl ein, um den Bereich "WWWWW01B" der Domäne
"prod.dom" hinzuzufügen:
cadsmcmd area action=addToDomains name=WWWWW01B domain=prod.dom
Kapitel 3: cadsmcmd-Befehle 35
Kompatibilität
removeFromDomains – Entfernen von Domänengruppen aus Domänengruppen
Diese Aktion entfernt eine CA ITCM-Domäne aus einer oder mehreren CA ITCMDomänengruppen.
Dies bedeutet nicht, dass die CA ITCM-Domäne gelöscht wird. Alle anderen
Inhaltsbeziehungen bleiben unverändert.
Diese Aktion hat das folgende Format:
area action=removeFromDomains
name=Bereichsname
{domain=Domänenname}
Name
Gibt Folgendes an: Name einer CA ITCM-Domäne. Sie wird aus mehreren CA ITCMDomänengruppen entfernt.
domain
Gibt Folgendes an: Name einer CA ITCM-Domänengruppe. Aus ihr wird die CA
ITCM-Domäne entfernt.
Der Parameter kann mehrfach angegeben werden , um die CA ITCM-Domäne aus
einer Liste von CA ITCM-Domänengruppen zu entfernen.
Beispiel:
Geben Sie den folgenden Befehl ein, um den Bereich "WWWWW01B" aus der Domäne
"prod.dom" zu entfernen:
cadsmcmd area action=removeFromDomains name=WWWWW01B domain=prod.dom
aregsw – Automatisches Registrieren von Software
Mit Hilfe des Befehls aregsw haben Sie die folgenden Möglichkeiten:
36 CLI-Referenzhandbuch
■
Sie können ein neues Softwareprogramm registrieren, das bereits im
Standardformat gepackt ist (beispielsweise Software, die zuvor aus der
Softwarebibliothek exportiert wurde).
■
Sie können eine neue Programmversion registrieren, die auf einer bereits in der
Bibliothek registrierten Programmversion basiert, und die bereits im
Standardformat gepackt ist.
Kompatibilität
Dieser Befehl hat das folgende Format:
aregsw reginfo=Reginfo
path=Quellpfad
[basedonitem=baseproduct basedonversion=baseversion]
reginfo
Gibt das Verzeichnis im System an, in dem sich das Unterverzeichnis für die
Registrierungsinformationen befindet.
path
Gibt das Verzeichnis im System an, in dem sich ein Image des registrierten Elements
befindet.
basedonitem
Gibt Folgendes an: Produktname des ursprünglichen Elements, auf dem das neue
Element basiert.
basedonversion
Gibt Folgendes an: Version des Basisprodukts.
Beispiel:
Das folgende Beispiel erläutert, wie Software, die sich im Unterverzeichnis "swtest2"
befindet, von einem Linux-Server aus automatisch registriert werden kann. Die
Registrierungsinformationen, die sich in "/test/swtest1" befinden, werden zur
Durchführung der automatischen Registrierung verwendet:
cadsmcmd aregsw reginfo=/test/swtest1 path=/test/swtest2
bootserver – Verwalten von OSIM-Boot-Servern
Dieser Abschnitt enthält die folgenden Themen:
assignTargets – Zuweisen von Zielen zu einem Boot-Server (siehe Seite 38)
list – Auflisten der Boot-Server (siehe Seite 39)
listImages – Auflisten von Images auf Boot-Server (siehe Seite 39)
listTargets – Auflisten von beim Boot-Server registrierten Zielen (siehe Seite 40)
Kapitel 3: cadsmcmd-Befehle 37
Kompatibilität
assignTargets – Zuweisen von Zielen zu einem Boot-Server
assignTargets weist die angegebenen Systeme dem angegebenen Boot-Server zu. Die
angesprochenen Systeme müssen bei OSIM als nicht verwaltete oder verwaltete
Computer registriert werden.
Die Syntax der Aktion lautet folgendermaßen:
bootServer
action=assignTargets
name=Boot-Server-Name
{computer=Zielname|MACaddresses=MAC-Adresse}
computer
Gibt den Namen eines von OSIM verwalteten Systems an, das dem durch die Option
"name" festgelegten Boot-Server zugewiesen ist. Wenn das System bereits einem
anderen Boot-Server zugewiesen ist, wird diese Zuweisung ungültig, und sie wird
entfernt. Die Option kann mehrfach codiert werden, um eine Liste anzugeben.
Name
Gibt den Namen des Boot-Servers an, dem die angegebene Liste von Zielen
zugewiesen wird.
MACaddresses
Gibt die MAC-Adresse eines nicht von OSIM verwalteten, jedoch registrierten
Systems an, das dem durch die Option "name" festgelegten Boot-Server
zugewiesen ist. Wenn das System bereits einem anderen Boot-Server zugewiesen
ist, wird diese Zuweisung ungültig, und sie wird entfernt. Die Option kann mehrfach
codiert werden, um eine Liste anzugeben.
38 CLI-Referenzhandbuch
Kompatibilität
list – Auflisten der Boot-Server
Diese Aktion listet die bei der Domänendatenbank registrierten Boot-Server auf.
Die Syntax der Aktion lautet folgendermaßen:
bootServer
action=list
Das folgende Beispiel veranschaulicht die Ausgabe des Befehls:
-----------------------------------------------------------------Liste der Boot-Server
-----------------------------------------------------------------Boot-Server-Name.........................: «Name von Boot-Server 1»
..Status.................................: {Aktiv | Keine Antwort}
[..ADS-Server verbunden...................: «ADS-Server-Name»
..ADS-Server-Verbindungsstatus...........: «aktiv | antwortet nicht»]
•
•
•
Boot-Server-Name.........................: «Name von Boot-Server n»
..Status.................................: {Aktiv | Keine Antwort}
..[..ADS-Server verbunden.................: «ADS-Server-Name»
..ADS-Server-Verbindungsstatus...........: «aktiv | antwortet nicht»]
listImages – Auflisten von Images auf Boot-Server
Diese Aktion listet für einen bei der Domänendatenbank registrierten Boot-Server die
auf diesem Boot-Server verfügbaren Boot- und BS-Images auf.
Die Syntax der Aktion lautet folgendermaßen:
bootServer
action=listImages
name=Boot-Server-Name
Kapitel 3: cadsmcmd-Befehle 39
Kompatibilität
Name
Name eines Boot-Servers. Für diesen Server wird eine Liste von verfügbaren Images
angegeben.
Das folgende Beispiel veranschaulicht die Ausgabe des Befehls:
-----------------------------------------------------------------Liste.der.verfügbaren.Images.auf.<Boot-Server-Name>
-----------------------------------------------------------------Boot-Server-Name..................:.«Name.von.Boot-Server.1»
..Image-Name......................:.«Name.von.Image.1»
{....Status........................:.gefunden.|
....Image-Typ.........................:.«Image-Typ»}
..........•
..........•
..........•
..Image-Name......................:.«Name.von.Image.m»
{....Status........................:.gefunden.|
....Image-Typ.........................:.«Image-Typ»}
listTargets – Auflisten von beim Boot-Server registrierten Zielen
Diese Aktion listet die beim angegebenen Boot-Server registrierten Ziele auf.
Die Syntax der Aktion lautet folgendermaßen:
bootServer
action=listTargets
name=Boot-Server-Name
[{managedOnly | unmanagedOnly | ADSOnly}]
Name
Gibt den Namen eines Boot-Servers an.
managedOnly
Optional. Wenn diese Option angegeben ist, werden nur von OSIM verwaltete
Systeme gemeldet.
unmanagedOnly
Optional. Wenn diese Option angegeben ist, werden nur von OSIM registrierte,
jedoch nicht verwaltete Systeme gemeldet.
ADSonly
Wenn diese Option angegeben ist, werden nur von ADS verwaltete Systeme
aufgelistet.
Hinweis: Wenn keine der Optionen "managedOnly", "unmanagedOnly" und "ADSonly"
codiert ist, werden die Systeme nicht danach gefiltert, ob sie OSIM-verwaltet oder nicht
OSIM-verwaltet sind.
40 CLI-Referenzhandbuch
Kompatibilität
Der Befehl gibt auf stdout eine Ausgabeliste mit dem folgenden Format aus:
-----------------------------------------------------------------Auflisten von «Boot-Server-Name» zugewiesenen OSIM-Zielen
-----------------------------------------------------------------Zielname..............................: «Name von Ziel 1»
..MACAddress.............................: «MAC-Adresse»
..Status.................................: {OSIM-verwaltet («Status» |
...........................................OSIM nicht verwaltet | ADS-verwaltet}
•
•
•
Zielname..............................: «Name von Ziel n»
..MACAddress.............................: «MAC-Adresse»
..Status.................................: {OSIM-verwaltet («Status» |
...........................................OSIM nicht verwaltet | ADS-verwaltet}
cancel – Abbrechen einer Verteilung
Aus einem Enterprise-Manager, verwenden Sie den Befehl "cancel", um eine zuvor an
Domänen oder Domänengruppen gesendete Anweisung abzubrechen. Die Anweisung
kann nur abgebrochen werden, wenn sie noch nicht gestartet wurde, erfolgreich
beendet wurde oder fehlgeschlagen ist.
Aus einem Domänen-Manager können Sie den Befehl "cancel" auf einen vorhandenen
Job anwenden, unabhängig von seinem Status. Wenn jedoch ein aktiver Job
abgebrochen wird, der auf einem Zielcomputer gestartet wurde, wird dieser auf dem
Domänen-Manager vorübergehend als Job registriert, der auf den Zielcomputern
fehlgeschlagen ist, auf denen er vor dem Abbruch installiert war. Der tatsächliche
Jobstatus für jeden dieser Computer wird auf dem Domänen-Manager registriert, wenn
der Job abgeschlossen wird.
Dieser Befehl hat das folgende Format:
Im Enterprise:
cancel item=Elementname
version=Versionsname
procedure=Prozedurname
task={install | activate | configure | uninstall}
installedwith=Prozedurname
{compgrp=Computergruppenname}
{domain=Domänenname | area=Bereichsname }
cname=[Name]
Kapitel 3: cadsmcmd-Befehle 41
Kompatibilität
Auf der Domäne:
cancel item=Elementname
version=Versionsname
procedure=Prozedurname
task={install | activate | configure | uninstall}
installedwith=Prozedurname
{compgrp=Computergruppenname |
computer=Computername }
area
Gibt Folgendes an: Name einer CA ITCM-Domäne.
Dieser Parameter kann mehrfach angegeben werden, um eine Liste von CA ITCMDomänen weiterzugeben.
cname
Gibt Folgendes an: optionaler eindeutiger Name eines Jobcontainers / Verteilung.
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.
compgrp
Gibt Folgendes an: Name einer Computergruppe, die von dem Job zu adressieren
ist. Der Parameter kann mehrfach angegeben werden, um eine Liste von
Computergruppen zuzuweisen.
computer
Gibt Folgendes an: Name des Computers.
Der Parameter kann mehrfach angegeben werden, um eine Liste von Computern
zuzuweisen.
domain
Gibt Folgendes an: Name einer CA ITCM-Domänengruppe.
Der Parameter kann mehrfach angegeben werden, um eine Liste von CA ITCMDomänengruppen weiterzugeben.
42 CLI-Referenzhandbuch
Kompatibilität
installedWith
Gibt Folgendes an: Name der Installationsprozedur, auf die in dem zu entfernenden
Job verwiesen wird.
Dieser Parameter ist auch dann erforderlich, wenn es sich bei der abzubrechenden
Prozedur um diese Installationsprozedur handelt. Geben Sie in diesem Fall die
Installationsprozedur mit "installedWith" erneut ein.
item
Gibt Folgendes an: Name des Elements, auf das im abzubrechenden Job verwiesen
wird.
Prozedur
Gibt den Namen einer Elementprozedur an, auf die im abzubrechenden Job
verwiesen wird.
task
Gibt Folgendes an: Typ des von der Elementprozedur auszuführenden Tasks.
install
Installationsprozedur
activate
Aktivierungsprozedur
configure
Konfigurationsprozedur
uninstall
Deinstallationsprozedur
Version
Gibt Folgendes an: Version des Elements, auf das im abzubrechenden Job
verwiesen wird.
Beispiel
Im Befehlsmodus folgt auf "cadsmcmd" der Befehl "cancel" mit entsprechenden
Parametern.
cadsmcmd cancel item="Software TestC" version=0.46 installedwith=Install2
procedure=ConfigureC task=configure compgrp=SDCommandTest
area=N_LOCAL_SRV area=N_LOCAL_SRV_02 cname=TestCont7
Kapitel 3: cadsmcmd-Befehle 43
Kompatibilität
comconf – Verwalten allgemeiner Konfigurationen
Der Befehl "comConf" ermöglicht die Verwaltung allgemeiner Konfigurationen. Darin
enthalten sind die Verwaltung von Richtlinien und Konfigurationen.
Dieser Abschnitt enthält die folgenden Themen:
Richtlinien (siehe Seite 44)
Parameter (siehe Seite 54)
Konfigurationen (siehe Seite 56)
Richtlinien
Dieser Abschnitt enthält die folgenden Themen:
createPolicy – Erstellen einer Richtlinie (siehe Seite 44)
deletePolicy – Löschen von Richtlinien (siehe Seite 46)
sealPolicy – Versiegeln von Richtlinien (siehe Seite 46)
showPolicy – Anzeigen detaillierter Informationen einer Richtlinie (siehe Seite 47)
unsealPolicy – Aufheben von Richtlinienversiegelungen (siehe Seite 53)
createPolicy – Erstellen einer Richtlinie
Diese Aktion erstellt eine Richtlinie.
Diese Aktion hat das folgende Format:
comconf action=createPolicy
[name=Richtlinienname]
pType=Richtlinientyp
[comment=Kommentar]
[{configuration=ID}]
Name
Gibt Folgendes an: Name der Richtlinie, der erstellt werden soll.
pType
Gibt Folgendes an: Typ der Richtlinie, der erstellt werden soll.
Folgende Werte sind gültig:
COMPUTER
Gibt Folgendes an: Richtlinie für Computer und Computergruppen
44 CLI-Referenzhandbuch
Kompatibilität
IndividualComputer
Gibt Folgendes an: Angepasste Computereinstellungen
comment
Gibt an: Kommentar zur oder eine Beschreibung der Richtlinie
configuration
Gibt Folgendes an: UUID einer Konfiguration, der die erstellte Richtlinie zugewiesen
wird.
Wenn "configuration" nicht angegeben ist, wird die Richtlinie keiner Konfiguration
zugewiesen.
Dieser Parameter ist obligatorisch für Richtlinien des Typs "IndividualComputers".
Im Fall eines Erfolgs bleibt die Richtlinie unversiegelt, und die Aktion stellt die ID des
erstellten Richtlinienobjekts als Standardausgabe in folgender Form dar:
ID:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Beispiel:
Beim Erstellen einer Richtlinie vom Typ "computer" namens "myPolicy" muss der
folgende Befehl aufgerufen werden:
cadsmcmd comConf action=createPolicy name=myPolicy pType=computer
comment=”myContainer”
Die Ausgabe dieses Befehls lautet wie folgt:
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
Verbindung zu Manager "<Standardmanager>" als Benutzer "<Standardbenutzer>" wird
hergestellt ...OK.
Manager: myDomMgr.ca.com
Domäne: myDomMgr
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
ID:1EED60D7-2CF9-11DB-A2C8-8DB9D78218A7
SDCMD<A000000>: OK
comconf action=createPolicy
[name=Richtlinienname]
pType=Richtlinientyp
[comment=Kommentar]
[{configuration=ID}]
Kapitel 3: cadsmcmd-Befehle 45
Kompatibilität
deletePolicy – Löschen von Richtlinien
Diese Aktion löscht Richtlinien.
Diese Aktion hat das folgende Format:
comconf action=deletePolicy
{policies=(Richtlinienname, Richtlinientyp)}...
Richtlinien
Gibt die zu löschenden Richtlinien nach Namen und Typ der Richtlinie an.
Gültiger Typangaben sind:
Computer
Gibt Folgendes an: Richtlinie für Computer und Computergruppen
IndividualComputer
Gibt Folgendes an: Angepasste Computereinstellungen
Dieser Parameter kann mehrfach angegeben werden, um mehrere Richtlinien in
einem einzigen Aufruf zu löschen.
Beispiel:
Geben Sie Folgendes ein, um die Computerrichtlinien "myPolicy" und "mgrPolicy" zu
löschen:
cadsmcmd comConf action=deletePolicy policies=(myPolicy,computer)
policies=(mgrPolicy,computer)
sealPolicy – Versiegeln von Richtlinien
Diese Aktion versiegelt Richtlinien.
Diese Aktion hat das folgende Format:
comconf action=sealPolicy
{policies=(Richtlinienname, Richtlinientyp)}...
46 CLI-Referenzhandbuch
Kompatibilität
Richtlinien
Gibt die zu versiegelnden Richtlinien nach Name und Typ der Richtlinie an.
Gültiger Typangaben sind:
Computer
Gibt Folgendes an: Richtlinie für Computer und Computergruppen
IndividualComputer
Gibt Folgendes an: Angepasste Computereinstellungen
Dieser Parameter kann mehrfach angegeben werden, um mehrere Richtlinien in
einem einzigen Aufruf zu versiegeln.
Beispiel:
Geben Sie Folgendes ein, um die Computerrichtlinien "myPolicy" und "mgrPolicy" zu
versiegeln:
cadsmcmd comConf action=sealPolicy policies=(myPolicy,computer)
policies=(mgrPolicy,computer)
showPolicy – Anzeigen detaillierter Informationen einer Richtlinie
Diese Aktion zeigt detaillierte Informationen zur angegebenen Richtlinie an.
Diese Aktion hat das folgende Format:
comconf action=showPolicy
[name=Richtlinienname]
[pType=Richtlinientyp]
[DETAILED [DESC]][MEMOF]
Name
Gibt Folgendes an: Name der Richtlinie, deren detaillierte Informationen aufgelistet
werden. Dieser Name kann Platzhalter enthalten. In diesem Fall werden die
Informationen dazu für alle Richtlinien aufgelistet, deren Namen mit dem Muster
übereinstimmen.
Wenn dieser Parameter nicht angegeben wird, wird die Standardrichtlinie
aufgelistet.
pType
Gibt Folgendes an: Typ der Richtlinie, die aufgelistet werden soll.
Wenn dieser Parameter nicht angegeben wird, wird keine Prüfung des Typs für die
Liste durchgeführt.
Kapitel 3: cadsmcmd-Befehle 47
Kompatibilität
Folgende Werte sind gültig:
Computer
Gibt Folgendes an: Richtlinie für Computer und Computergruppen
IndividualComputer
Gibt Folgendes an: Angepasste Computereinstellungen
ReportedComputer
Gibt Folgendes an: Berichtete Computerrichtlinie
DETAILED
"Parameterabschnitte" werden mit den Richtlinien aufgelistet.Nur, wenn dieser
Parameter angegeben wird.
DESC
Der Parameterinformationen werden mit dem Parameter aufgelistet. Wenn dieser
Parameter nicht angegeben wird, werden die Parameterinformationen ausgelassen.
MEMOF
Mit den Richtlinien werden die Konfigurationen aufgelistet, deren Mitglied die
Richtlinie ist.
Wenn dieser Parameter nicht angegeben wird, werden keine
Konfigurationsinformationen angezeigt.
Beispiel:
Für die Richtlinie "enableUserProfiles" sollten grundlegende Informationen aufgeführt
werden. Hierfür kann Folgendes aufgerufen werden:
cadsmcmd comConf action=showPolicy name=enableUserProfiles pType=computer
Die zurückgegebenen Informationen sehen wie folgt aus:
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
48 CLI-Referenzhandbuch
Kompatibilität
Verbindung zu Manager "<Standardmanager>" als Benutzer "<Standardbenutzer>" wird
hergestellt ...OK.
Manager: myDomMgr.ca.com
Domäne: myDomMgr
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
------------------------------------------------------------------------------Richtlinien anzeigen
------------------------------------------------------------------------------Richtlinienname........................: enableUserProfiles
..Typ
: COMPUTER
..Kommentar...........................:
..Status...............................: sealed
Anzahl der aufgelisteten Richtlinien: 1
SDCMD<A000000>: OK
Hinweis: Der Name eines Abschnitts ist der absolute Abschnittspfad, der im
Stammverzeichnis der Richtlinie im Format
"/section_1/section_2/section_3" beginnt.
Der Abschnittsname kann auch in der Spalte "Interner Name" des Unicenter CA ITCMExplorers angezeigt werden.
Rufen Sie den folgenden Befehl auf, wenn detaillierte Informationen erforderlich sind:
cadsmcmd comConf action=showPolicy name=enableUserProfiles
pType=computer detailed
Die Informationen können folgendermaßen angezeigt werden:
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
Kapitel 3: cadsmcmd-Befehle 49
Kompatibilität
Verbindung zu Manager "<Standardmanager>" als Benutzer "<Standardbenutzer>" wird
hergestellt ...OK.
Manager: myDomMgr.ca.com
Domäne: myDomMgr
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
------------------------------------------------------------------------------Richtlinien anzeigen
------------------------------------------------------------------------------Richtlinienname........................: enableUserProfiles
..Typ
: COMPUTER
..Kommentar...........................:
..Status...............................: sealed
..Parameterabschnitte
....Parameterabschnittsname
: /itrm/agent/solutions/usd_agent
......ID................................: 8AC0F5E8-292F-11DB-979E-96A4044440CB
......Parameters
........Parametername...................: SupportedUnitTypes
..........ID
: 8ACCE1AA-292F-11DB-979E-96A4044440CB
..........Wert
: Computer ComputerUser
Anzahl der aufgelisteten Richtlinien: 1
SDCMD<A000000>: OK
Rufen Sie den folgenden Befehl auf, wenn darüber hinaus die Parameterbeschreibung
benötigt wird:
cadsmcmd comConf action=showPolicy name=enableUserProfiles
pType=computer detailed desc
Dies führt unter Umständen zur Ausgabe folgender Informationen:
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
50 CLI-Referenzhandbuch
Kompatibilität
Verbindung zu Manager "<Standardmanager>" als Benutzer "<Standardbenutzer>" wird
hergestellt ...OK.
Manager: myDomMgr.ca.com
Domäne: myDomMgr
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
------------------------------------------------------------------------------Richtlinien [DETAILED[DESC]] anzeigen
------------------------------------------------------------------------------Richtlinienname........................: enableUserProfiles
..Typ
: COMPUTER
..Kommentar...........................:
..Status...............................: sealed
..Parameterabschnitte
....Parameterabschnittsname
: /itrm/agent/solutions/usd_agent
......ID................................: 8AC0F5E8-292F-11DB-979E-96A4044440CB
......Parameters
........Parametername...................: SupportedUnitTypes
..........ID
: 8ACCE1AA-292F-11DB-979E-96A4044440CB
..........Wert
: Computer ComputerUser
..........Parameterinfoname.............: pi_SupportedUnitTypes
..........Attribute
............Attributname................: ppath
...............Wert....................: /itrm/agent/solutions/usd_agent/suppor
.........................................+ tedunittypes
............Attributname................: desc_ja
...............Wert....................:
............Attributname................: string2_ja
...............Wert....................:
............Attributname................: string1_ja
...............Wert....................:
............Attributname................: desc_fr
...............Wert....................: Les types d'unités pris en charge par
.........................................+ le module d'extension de l'agent.
............Attributname................: string2_fr
...............Wert....................: Ordinateur + profil utilisateur
............Attributname................: string1_fr
...............Wert....................: Ordinateur
............Attributname................: desc_de
...............Wert....................: Die vom Agenten-Plugin unterstützten Ein
.........................................+ heitstypen.
............Attributname................: string2_de
...............Wert....................: Computer + Benutzerprofil
............Attributname................: string1_de
...............Wert....................: Computer
............Attributname................: desc_en
Kapitel 3: cadsmcmd-Befehle 51
Kompatibilität
..............Wert....................: The types of units supported by the ag
.........................................+ ent plugin.
............Attributname................: string2_en
..............Wert....................: Computer + Benutzerprofil
............Attributname................: string2
...............Wert....................: Computer ComputerUser
............Attributname................: string1_en
...............Wert....................: Computer
............Attributname................: string1
...............Wert....................: Computer
............Attributname................: type
...............Wert....................: stringlist
Anzahl der aufgelisteten Richtlinien: 1
SDCMD<A000000>: OK
Wenn neben den grundlegenden Informationen noch weitere Informationen zu den
Konfigurationen der Richtlinie erforderlich sind, muss der folgende Befehl aufgerufen
werden:
cadsmcmd comConf action=showPolicy name=enableUserProfiles
pType=computer memof
Die folgenden Informationen können zurückgegeben werden:
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
52 CLI-Referenzhandbuch
Kompatibilität
Trace-Modus: Aus
Verbindung zu Manager "<Standardmanager>" als Benutzer "<Standardbenutzer>" wird
hergestellt ...OK.
Manager: myDomMgr.ca.com
Domäne: myDomMgr
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
------------------------------------------------------------------------------Richtlinien anzeigen
------------------------------------------------------------------------------Richtlinienname........................: enableUserProfiles
..Typ
: COMPUTER
..Kommentar...........................:
..Status...............................: sealed
..Mitglied von...........................: $AllComputer_update:1155623899
.....Ziel
: $AllComputer
Anzahl der aufgelisteten Richtlinien: 1
SDCMD<A000000>: OK
unsealPolicy – Aufheben von Richtlinienversiegelungen
Diese Aktion hebt die Versiegelung von Richtlinien auf.
Diese Aktion hat das folgende Format:
comconf action=unsealPolicy
{policies=(Richtlinienname, Richtlinientyp)}...
Richtlinien
Gibt die Richtlinien, deren Versiegelung aufzugeben ist, nach Typ und Name der
Richtlinie an.
Gültiger Typangaben sind:
Computer
Gibt Folgendes an: Richtlinie für Computer und Computergruppen
IndividualComputer
Gibt Folgendes an: Angepasste Computereinstellungen
Dieser Parameter kann mehrfach angegeben werden, um die Versiegelung
mehrerer Richtlinien in einem einzigen Aufruf aufzuheben.
Kapitel 3: cadsmcmd-Befehle 53
Kompatibilität
Beispiel:
Gehen Sie folgendermaßen vor, um die Versiegelung der Computerrichtlinien
"myPolicy" und "mgrPolicy" aufzuheben:
cadsmcmd comConf action=unsealPolicy policies=(myPolicy,computer)
policies=(mgrPolicy,computer)
Parameter
Dieser Abschnitt enthält die folgenden Themen:
setParm – Festlegen eines Parameters und Wertes (siehe Seite 54)
deleteParm – Löschen eines Parameters (siehe Seite 55)
setParm – Festlegen eines Parameters und Wertes
Diese Aktion ermöglicht das Einstellen eines Parameters und Wertes.
Diese Aktion hat das folgende Format:
comconf action=setParm
Name=Richtlinienname,
pType=Richtlinientyp
parmsec=Name für Parameterabschnitt
parameter=Parametername
value=Parameterwert
policy
Gibt Folgendes an: Name der Richtlinie, zu dem der Parameter gehört.
pType
Gibt Folgendes an: Typ der Richtlinie, zu dem der Parameter gehört.
parmsec
Gibt Folgendes an: Abschnitt "parameter", zu dem der Parameter gehört.
Der Abschnitt ist der absolute Abschnittspfad des Stammverzeichnisses der
Richtlinie im Format "/Abschnitt_1/Abschnitt_2/Abschnitt_3".
Die Abschnittsnamen können entweder der detaillierten Ausgabe der Aktion
"showPolicy (siehe Seite 47)" oder der Spalte "Interner Name" des CA ITCMExplorers entnommen werden.
Wenn der angegebene Abschnitt bei der angegebenen Richtlinie nicht vorhanden
ist, wird er erstellt, wenn der Abschnitt auch bei der Standardrichtlinie vorhanden
ist.
54 CLI-Referenzhandbuch
Kompatibilität
Parameter
Gibt Folgendes an: Name des Parameters, der eingestellt werden soll.
Wenn der Parameter nicht im angegebenen Parameterabschnitt, aber bei
derselben Auswahl der Standardrichtlinie verfügbar ist, wird er erstellt.
value
Neuer Wert des Parameters.
Beispiel:
Um Benutzerprofile mit dem SD-Agenten zu ermöglichen, muss Folgendes eingegeben
werden:
cadsmcmd comconf action=setParm name=myPol3 pType=Computer
parmsec=/itrm/agent/solutions/usd_agent parameter=SupportedUnitTypes
Value="Computer ComputerUser"
deleteParm – Löschen eines Parameters
Diese Aktion löscht einen Parameter.
Diese Aktion hat das folgende Format:
comconf action=deleteParm
name=Richtlinienname,pType=Richtlinientyp
parmsec=Name für Parameterabschnitt
parameter=Parametername
Name
Gibt Folgendes an: Name der Richtlinie, aus dem der Parameter entfernt wird.
pType
Gibt Folgendes an: Typ der Richtlinie, aus dem der Parameter entfernt wird.
parmsec
Gibt Folgendes an: Abschnitt "parameter", aus dem der Parameter entfernt wird.
Der Abschnitt ist der absolute Abschnittspfad des Stammverzeichnisses der
Richtlinie im Format "/Abschnitt_1/Abschnitt_2/Abschnitt_3".
Die Abschnittsnamen können entweder der detaillierten Ausgabe der Aktion
"showPolicy (siehe Seite 47)" oder der Spalte "Interner Name" des CA ITCMExplorers entnommen werden.
Parameter
Gibt Folgendes an: Name des Parameters, die entfernt werden sollen.
Kapitel 3: cadsmcmd-Befehle 55
Kompatibilität
Beispiel:
Um das Benutzerprofil für die Berichterstattung über den Agenten wieder zu
deaktivieren, rufen Sie den folgenden Befehl auf:
cadsmcmd comconf action=deleteParm name=myPol3 pType=Computer
parmsec=/itrm/agent/solutions/usd_agent parameter=SupportedUnitTypes
Konfigurationen
Dieser Abschnitt enthält die folgenden Themen:
activateConfig – Aktivieren einer geplanten Konfiguration (siehe Seite 56)
addPolicyToConfig – Hinzufügen von Richtlinien zur Konfiguration (siehe Seite 57)
cancelConfig – Abbrechen von geplanten Konfigurationen (siehe Seite 58)
createConfig – Erstellen einer Konfiguration (siehe Seite 59)
deleteConfig – Löschen einer Konfiguration (siehe Seite 60)
removePolicyFromConfig – Entfernen von Richtlinien aus Konfigurationen (siehe Seite
61)
showConfig – Anzeigen einer Konfiguration (siehe Seite 62)
activateConfig – Aktivieren einer geplanten Konfiguration
Diese Aktion aktiviert eine geplante Konfiguration für ihre Ziele. Die Aktion kehrt zurück,
sobald die Aktivierungsanweisung geplant wurde; sie wartet nicht, bis die Aktivierung
abgeschlossen wurde.
Diese Aktion hat das folgende Format:
comconf action=activateConfig
confId=Konfigurations-ID
[atTime=JJJJ-MM-TT HH:MM]
confId
Gibt die ID einer zu aktivierenden geplanten Konfiguration an.
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.
Hinweis: Damit Sie eine Konfiguration aktivieren können, müssen Sie alle mit dieser
Konfiguration verbundenen Richtlinien versiegeln. Anderenfalls schlägt die Aktivierung
mit folgendem Fehler fehl:
SDCMD<CMD000145>: CCNF API-Anforderung fehlgeschlagen: 7 - Objektstatus nicht
kompatibel.
56 CLI-Referenzhandbuch
Kompatibilität
Beispiel:
Um die Konfiguration "myConfig" am 16.&#160;August&#160;2007 um 11:35&#160;Uhr
aufzurufen, rufen Sie folgenden Befehl auf:
cadsmcmd comConf action=activateConfig
confId=AF2BB414-2D11-11DB-A2C8-8DB9D78218A7 attime="2007-08-16 11:35"
addPolicyToConfig – Hinzufügen von Richtlinien zur Konfiguration
Diese Aktion fügt der angegebenen Konfiguration Richtlinien hinzu.
Diese Aktion hat das folgende Format:
comconf action=addPolicyToConfig
confId=Konfigurations-ID
{{policies=(Richtlinienname, Richtlinientyp]}
confId
Gibt die ID einer Konfiguration an, der die vorhandenen angegebenen Richtlinien
hinzugefügt werden sollen.
ID der Konfiguration, der die vorhandenen angegebenen Richtlinien hinzugefügt
werden sollen.
Richtlinien
Gibt den Namen und die Typen der Richtlinien an, die der angegebenen
Konfigurationen zugeordnet werden sollen.
Die Aktion berichtet in stdout folgendermaßen über die erfolgreiche Ausführung und
das Fehlschlagen dieser Aktion für die entsprechende Konfiguration:
Konfiguration «Konfigurationsname», «Konfigurations-ID»
Hinzugefügte Richtlinie: «Richtlinienname», «Richtlinientyp», «Richtlinien-ID»
Fehlgeschlagene Richtlinie: «Richtlinienname», «Richtlinientyp», «RichtlinienID», «Fehlercode», «Fehlermeldung»
Kapitel 3: cadsmcmd-Befehle 57
Kompatibilität
Beispiel:
Um die Richtlinien "anotherPolicy" und "HideSystray" des Typs "computer" der
Konfiguration "myConfig" hinzuzufügen, rufen Sie folgenden Befehl auf:
cadsmcmd comConf action=addPolicyToConfig
confId=AF2BB414-2D11-11DB-A2C8-8DB9D78218A7
policies=(anotherPolicy,computer) policies=(HideSystray,computer)
Die mit dem Befehl "cadsmcmd" in "stdout" aufgezeichneten Informationen können wie
folgt aussehen:
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
Verbindung zu Manager "<Standardmanager>" als Benutzer "<Standardbenutzer>" wird
hergestellt ...OK.
Manager: myDomMgr.ca.com
Domäne: myDomMgr
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
Konfiguration myConfig, AF2BB414-2D11-11DB-A2C8-8DB9D78218A7.
Hinzugefügte Richtlinie: anotherPolicy, COMPUTER, 0C165644-2D16-11DB-A2C88DB9D78218A7
Hinzugefügte Richtlinie: HideSystray, COMPUTER, BBD3174E-2D06-11DB-A2C88DB9D78218A7
SDCMD<A000000>: OK
cancelConfig – Abbrechen von geplanten Konfigurationen
Diese Aktion bricht eine zeitlich geplante Konfiguration ab. Die Aktion ist nur erfolgreich,
wenn der Agent noch nicht mit der Aktivierung der Konfiguration begonnen hat.
Diese Aktion hat das folgende Format:
comconf action=cancelConfig
confId=Konfigurations-ID
[WAIT]
58 CLI-Referenzhandbuch
Kompatibilität
confId
Gibt die ID (UUID) der abzubrechenden zeitlich geplanten Konfiguration an.
WAIT
Wenn dieser Parameter angegeben wird, wartet die Aktion auf den Abschluss des
Auftrags, anderenfalls erfolgt die Ausgabe, nachdem der Auftrag gestartet wurde.
Hinweis: Wenn Sie "WAIT" festlegen, kann es einige Zeit bis zur Rückgabe der
Aktion dauern.
Beispiel:
Um die Konfiguration "myConfig" abzubrechen und die Fertigstellung abzuwarten, rufen
Sie einfach den folgenden Befehl auf:
cadsmcmd comConf action=cancelConfig
confId=AF2BB414-2D11-11DB-A2C8-8DB9D78218A7 wait
createConfig – Erstellen einer Konfiguration
Mit dieser Aktion kann eine Konfiguration erstellt werden.
Diese Aktion hat das folgende Format:
comconf action=createConfig
name=Konfigurationsname
target=Zielname
ttype=Zieltyp
{policies=(Richtlinienname, Richtlinientyp}...
Name
Gibt Folgendes an: Name der Konfiguration, der erstellt werden soll.
target
Gibt Folgendes an: Name eines bestehenden Ziels, das mit der Konfiguration
verknüpft werden soll.
ttype
Gibt an: Typ des Ziels.
Folgende Werte sind gültig:
Computer
Bei den Zielen handelt es sich um Computer.
Dieser Parameter wird nur auf Domänen-Managern unterstützt.
Gruppe
Bei den Zielen handelt es sich um Computergruppen.
Bei einer Nichtübereinstimmung des Typs wird ein Fehler gemeldet.
Kapitel 3: cadsmcmd-Befehle 59
Kompatibilität
Richtlinien
Gibt den Namen und die Typen der Richtlinien an, die den zu erstellenden
Konfigurationen zugeordnet werden.
Auf diese Weise können beispielsweise nur Richtlinien des Typs "computer"
hinzugefügt werden.
Die erstellte Konfiguration wird in stdout im folgenden Format aufgezeichnet:
Erstellte Konfiguration: <<Konfigurationsname>>, <<Konfigurations-ID>>
Beispiel
Um die Richtlinie "myPolicy" des Typs "computer" der Konfiguration "myConfig"
zuzuweisen und als Ziel die Computergruppe "myGroup" festzulegen, rufen Sie
folgenden Befehl auf:
cadsmcmd comConf action=createConfig name=myConfig target=myGroup ttype=group
policies=(myPolicy,computer)
Die in "stdout" aufgezeichneten Informationen können wie folgt aussehen:
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
Verbindung zu Manager "<Standardmanager>" als Benutzer "<Standardbenutzer>" wird
hergestellt ...OK.
Manager: myDomMgr.ca.com
Domäne: myDomMgr
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
Erstellte Konfiguration: myConfig,AF2BB414-2D11-11DB-A2C8-8DB9D78218A7.
SDCMD<A000000>: OK
deleteConfig – Löschen einer Konfiguration
Diese Aktion löscht die angegebene Konfiguration.
Folgendes Format wird verwendet:
comconf action=deleteConfiguration
confId=Konfigurations-ID}
confId
Gibt die ID der zu löschenden Konfiguration an.
60 CLI-Referenzhandbuch
Kompatibilität
Beispiel:
Um die Konfiguration "obsoleteConfig" mit der ID 844A8622-2D15-11DB-A2C88DB9D78218A7 zu löschen, rufen Sie folgenden Befehl auf:
cadsmcmd comConf action=deleteConfig confId=844A8622-2D15-11DB-A2C8-8DB9D78218A7
removePolicyFromConfig – Entfernen von Richtlinien aus Konfigurationen
Diese Aktion entfernt Richtlinien aus angegebenen Konfigurationen.
Diese Aktion hat das folgende Format:
comconf action=removePolicyFromConfig
confId=Konfigurations-ID
{{policies=(Richtlinienname, Richtlinientyp]}
confId
Gibt den Namen der ID einer Konfiguration an, aus der die angegebenen Richtlinien
entfernt werden.
Richtlinien
Namen und Typen der Richtlinien, die aus der angegebenen Konfiguration entfernt
werden sollen.
Die Aktion berichtet in stdout folgendermaßen über die erfolgreiche Ausführung und
das Fehlschlagen dieser Aktion für die entsprechende Konfiguration:
Konfiguration «Konfigurationsname», «Konfigurations-ID»
Entfernte Richtlinie: «Richtlinienname», «Richtlinientyp», «Richtlinien-ID»
Fehlgeschlagene Richtlinie: «Richtlinienname», «Richtlinientyp», «RichtlinienID», «Fehlercode», «Fehlermeldung»
Beispiel
Um die Richtlinien "anotherPolicy" und "HideSystray" des Typs "computer" aus der
Konfiguration "myConfig" zu entfernen, rufen Sie folgenden Befehl auf:
cadsmcmd comConf action=removePolicyFromConfig
confId=AF2BB414-2D11-11DB-A2C8-8DB9D78218A7
policies=(anotherPolicy,computer) policies=(HideSystray,computer)
Die mit dem Befehl "cadsmcmd" in "stdout" aufgezeichneten Informationen können wie
folgt aussehen:
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
Kapitel 3: cadsmcmd-Befehle 61
Kompatibilität
Verbindung zu Manager "<Standardmanager>" als Benutzer "<Standardbenutzer>" wird
hergestellt ...OK.
Manager: myDomMgr.ca.com
Domäne: myDomMgr
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
Konfiguration myConfig, AF2BB414-2D11-11DB-A2C8-8DB9D78218A7.
Entfernte Richtlinie: anotherPolicy, COMPUTER,0C165644-2D16-11DB-A2C88DB9D78218A7
Entfernte Richtlinie: HideSystray, COMPUTER,BBD3174E-2D06-11DB-A2C8-8DB9D78218A7
SDCMD<A000000>: OK
showConfig – Anzeigen einer Konfiguration
Diese Aktion zeigt die Inhalte der angegebenen Konfiguration an.
Folgendes Format wird verwendet:
comconf action=showConfig
[{targets=(Zielname, Zieltyp)}...]
[status=Konfigurationsstatus]
[{errors=Fehlercode}]
[DETAILED[ DESC]]
targets
Namen und Typen der Ziele, an die sich die aufzulistenden Konfigurationen richten
müssen.
Gültige Typen sind "Computer" und "Gruppe". Der erste Typ ist nur für DomänenManager gültig.
Wenn der Parameter nicht angegeben wird, werden die Konfigurationen
unabhängig von ihrem Ziel aufgelistet.
status
Gibt Folgendes an: Status der Konfigurationen.
Zulässige Statuswerte sind:
Geplant
Geplante Konfiguration
Geplant
Für die Aktivierung geplanten Konfiguration
62 CLI-Referenzhandbuch
Kompatibilität
InProgress
Aktivierung in Bearbeitung
Aktiv
Konfiguration ist aktiv
Abbrechen
Aktuelle Konfiguration wird abgebrochen
Fehler
Während des Aktivierungsprozesses ist ein Fehler aufgetreten.
Wenn kein Parameter angegeben wird, werden die Konfigurationen unabhängig
von ihrem Status aufgelistet.
Fehler
Während des Aktivierungsprozesses ist ein Fehler aufgetreten.
Wenn kein Parameter angegeben wird, werden die Konfigurationen unabhängig
von jedem Fehlercode aufgelistet.
DETAILED
Wenn dieser Parameter angegeben ist, werden die Konfigurationen mit Richtlinie
und Informationen zu angepassten Einstellungen aufgelistet, anderenfalls nicht.
DESC
Wenn dieser Parameter angegeben ist, werden die Informationen zur
Parameterbeschreibung aufgelistet, anderenfalls nicht.
Beispiel:
Um eine Liste aller Konfigurationen abzurufen, rufen Sie den folgenden Befehl auf:
cadsmcmd comConf action=showConfig
Das Ergebnis in "stdout" kann wie folgt aussehen:
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
Kapitel 3: cadsmcmd-Befehle 63
Kompatibilität
Verbindung zu Manager "<Standardmanager>" als Benutzer "<Standardbenutzer>" wird
hergestellt ...OK.
Manager: myDomMgr.ca.com
Domäne: myDomMgr
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
------------------------------------------------------------------------------Konfiguration anzeigen:
------------------------------------------------------------------------------Konfigurationsname
: $AllComputer_update:1155623899
..ID...........................: A3D1923B-2C28-11DB-935A-B86845DDDD44
..Ziel...............................: $AllComputer
....Typ...............................: GROUP
....ID.........................: 466FC48C-A62A-403F-A811-A1CD7081663D
..Status...............................: active
..Aktivierungsdatum......................: 2006-08-15 08:38
Konfigurationsname
: 677-lab-pimpel_update:1155623902
..ID...........................: A5A4DF22-2C28-11DB-935A-B86845DDDD44
..Ziel...............................: 677-lab-schge2s
....Typ...............................: COMPUTER
....ID.........................: 8348785D-9148-4ED2-B2F8-EA25082DABB3
..Status...............................: active
..Aktivierungsdatum......................: 2006-08-15 08:38
Konfigurationsname
: pampel_update:1155623902
..ID...........................: A5BA544C-2C28-11DB-935A-B86845DDDD44
..Ziel...............................: knikl01z
....Typ...............................: COMPUTER
....ID.........................: 89E84AE7-4DD9-470D-86AF-152264A50FD7
..Status...............................: active
..Aktivierungsdatum......................: 2006-08-15 08:38
Konfigurationsname
: myConfig
..ID...........................: AF2BB414-2D11-11DB-A2C8-8DB9D78218A7
..Ziel...............................: myGroup
....Typ...............................: GROUP
....ID.........................: E8E36096-3503-453A-90BD-40B3208548E2
..Status...............................: planned
Anzahl der aufgelisteten Konfigurationen: 4
SDCMD<A000000>: OK
Wenn nur die geplanten Konfigurationen aufgeführt werden sollen, geben Sie den
folgenden Befehl ein:
cadsmcmd comConf action=showConfig status=planned
Dies führt unter Umständen zu folgender Ausgabe:
64 CLI-Referenzhandbuch
Kompatibilität
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
Verbindung zu Manager "<Standardmanager>" als Benutzer "<Standardbenutzer>" wird
hergestellt ...OK.
Manager: myDomMgr.ca.com
Domäne: myDomMgr
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
------------------------------------------------------------------------------Konfiguration anzeigen:
..status......= planned
------------------------------------------------------------------------------Konfigurationsname
: myConfig
..ID...........................: AF2BB414-2D11-11DB-A2C8-8DB9D78218A7
..Ziel...............................: myGroup
....Typ...............................: GROUP
....ID.........................: E8E36096-3503-453A-90BD-40B3208548E2
..Status...............................: planned
Anzahl der aufgelisteten Konfigurationen: 1
SDCMD<A000000>: OK
Um detaillierte Informationen abzurufen, rufen Sie den folgenden Befehl auf:
cadsmcmd comConf action=showConfig status=planned detailed
Dies führt unter Umständen zu folgender Ausgabe:
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
Verbindung zu Manager "<Standardmanager>" als Benutzer "<Standardbenutzer>" wird
hergestellt ...OK.
Manager: myDomMgr.ca.com
Domäne: myDomMgr
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
Kapitel 3: cadsmcmd-Befehle 65
Kompatibilität
------------------------------------------------------------------------------Konfiguration anzeigen:
..status......= planned
. [DETAILED]
------------------------------------------------------------------------------Konfigurationsname
: myConfig
..ID...........................: AF2BB414-2D11-11DB-A2C8-8DB9D78218A7
..Ziel...............................: myGroup
....Typ...............................: GROUP
....ID.........................: E8E36096-3503-453A-90BD-40B3208548E2
..Status...............................: planned
..Angepasste Einstellungen
..Richtlinien
....Richtlinienname........................: myPolicy
....Typ...............................: COMPUTER
....Kommentar............................: e.g.
....Status.............................: unsealed
Parameterabschnitte
......Name für Parameterabschnitt...........: /itrm/agent/solutions/usd_agent
........ID.....................: 1AD0030A-2D0D-11DB-A2C8-8DB9D78218A7
........Parameter
..........Parametername...............: SupportedUnitTypes
............ID.................: D2B1604A-2D0D-11DB-A2C8-8DB9D78218A7
............Wert......................: Computer ComputerUser
Anzahl der aufgelisteten Konfigurationen: 1
SDCMD<A000000>: OK
Damit Parameterbeschreibungen angegeben werden, rufen Sie folgenden Befehl auf:
cadsmcmd comConf action=showConfig status=planned detailed desc
Dies führt unter Umständen zu folgender Ausgabe:
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
66 CLI-Referenzhandbuch
Kompatibilität
Verbindung zu Manager "<Standardmanager>" als Benutzer "<Standardbenutzer>" wird
hergestellt ...OK.
Manager: myDomMgr.ca.com
Domäne: myDomMgr
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
------------------------------------------------------------------------------Konfiguration anzeigen:
..status......= planned
. [DETAILED[ DESC]]
------------------------------------------------------------------------------Konfigurationsname
: myConfig
..ID...........................: AF2BB414-2D11-11DB-A2C8-8DB9D78218A7
..Ziel...............................: myGroup
....Typ...............................: GROUP
....ID.........................: E8E36096-3503-453A-90BD-40B3208548E2
..Status...............................: planned
..Angepasste Einstellungen
..Richtlinien
....Richtlinienname........................: myPolicy
....Typ...............................: COMPUTER
....Kommentar............................: e.g.
....Status.............................: unsealed
Parameterabschnitte
......Name für Parameterabschnitt...........: /itrm/agent/solutions/usd_agent
........ID.....................: 1AD0030A-2D0D-11DB-A2C8-8DB9D78218A7
........Parameter
..........Parametername...............: SupportedUnitTypes
............ID.................: D2B1604A-2D0D-11DB-A2C8-8DB9D78218A7
............Wert......................: Computer ComputerUser
............Parameterinfoname........: pi_SupportedUnitTypes
............Attribute
..............Attributname...........: ppath
................Wert..................: /itrm/agent/solutions/usd_agent/suppor
.........................................+ tedunittypes
..............Attributname...........: desc_ja
................Wert..................:
Kapitel 3: cadsmcmd-Befehle 67
Kompatibilität
..............Attributname...........: string2_ja
................Wert..................:
..............Attributname...........: string1_ja
................Wert..................:
..............Attributname...........: desc_fr
................Wert..................: Les types d'unités pris en charge par
.........................................+ le module d'extension de l'agent.
..............Attributname...........: string2_fr
................Wert..................: Ordinateur + profil utilisateur
..............Attributname...........: string1_fr
................Wert..................: Ordinateur
..............Attributname...........: desc_de
................Wert..................: Die vom Agenten-Plugin unterstützten Ein
.........................................+ heitstypen.
..............Attributname...........: string2_de
................Wert..................: Computer + Benutzerprofil
..............Attributname...........: string1_de
................Wert..................: Computer
..............Attributname...........: desc_en
................Wert..................: The types of units supported by the ag
.........................................+ ent plugin.
..............Attributname...........: string2_en
................Value..................: Computer + Benutzerprofil
..............Attributname...........: string2
................Wert..................: Computer ComputerUser
..............Attributname...........: string1_en
................Wert..................: Computer
..............Attributname...........: string1
................Wert..................: Computer
..............Attributname...........: type
................Wert..................: stringlist
Anzahl der aufgelisteten Konfigurationen: 1
SDCMD<A000000>: OK
compgroup – Verwaltung von Computergruppen
Eine Computergruppe (CompGroup) ist eine Sammlung von Zielcomputern. Alle
Methoden von CompGroup sind sowohl auf dem Domänen-Manager als auch auf dem
Enterprise-Manager verfügbar, solange nichts anderes angegeben wird.
Dieser Abschnitt enthält die folgenden Themen:
Allgemeine Gruppenverwaltung (siehe Seite 69)
Mitgliedschaftsverwaltung (siehe Seite 81)
Hierarchieverwaltung (siehe Seite 86)
68 CLI-Referenzhandbuch
Kompatibilität
Allgemeine Gruppenverwaltung
Dieser Abschnitt enthält die folgenden Themen:
create – Erstellen von Computergruppen oder Abfragegruppen (siehe Seite 69)
delete – Löschen einer Computergruppe (siehe Seite 71)
cadsmcmd.compgroup.deletewithwarn (siehe Seite 71)
list – Auflisten von Computergruppen (siehe Seite 72)
listMembership – Auflisten der Mitgliedschaft von Computergruppen (siehe Seite 73)
listSWP – Auflisten von mit der Computergruppe verknüpften Software-Richtlinien
(siehe Seite 74)
modify – Bearbeiten von Computergruppen (siehe Seite 75)
setDownloadMethod – Festlegen der Download-Methode einer Computergruppe (siehe
Seite 77)
showAttr – Anzeigen von Attributen von Computergruppen (siehe Seite 78)
create – Erstellen von Computergruppen oder Abfragegruppen
Mit dieser Aktion können Sie Computer- und Abfragegruppen erstellen.
Folgendes Format wird verwendet:
compgroup action=create
name=Gruppenname
[superGroup=Name der übergeordneten Gruppe]
[comment=Kommentar]
[{{queryName=Abfrage |sdQuery=Abfrage }
[engineName=Engine-Name
[enginePeriod=Engine-Evaluierungshäufigkeit]] |
[{computer=Zielcomputer} | addall}]
[InheritPerms[={y|n}]]
addall
Alle beim Erstellen vorhandenen SD-Zielcomputer werden der Gruppe hinzugefügt.
comment
Gibt an: Ein Kommentar zu der zu erstellenden Gruppe.
computer
Gibt den Namen des SD-Zielcomputers, eines Benutzerprofils oder eines DockingGeräts an, der bzw. das zur Gruppe hinzugefügt werden soll.
Der Parameter kann mehrfach angegeben werden , um der Gruppe mehrere
Objekte hinzuzufügen.
Kapitel 3: cadsmcmd-Befehle 69
Kompatibilität
engineName
Gibt den Namen einer Engine an, die die Gruppenevaluierung verarbeitet.
Fehlt diese Angabe, kann die Evaluierung durch eine beliebige Engine verarbeitet
werden.
Dieser Parameter ist nur gültig, wenn "queryName" oder "sdQuery" angegeben ist.
enginePeriod
Gibt den Zeitraum (in Minuten) an, in dem die Engine die Gruppe neu evaluiert.
Wenn "engineName" angegeben ist, der Befehlsparameter "enginePeriod" jedoch
fehlt, wird ein Standardwert von 1 Minute angenommen.
Dieser Parameter ist nur zulässig, wenn "engineName" angegeben ist.
inheritPerms
Dieser Parameter gibt an, ob die erstellte Gruppe Sicherheitsberechtigungen
übernimmt.
Wenn "InheritPerms" oder "InheritPerms=y" codiert ist, gibt die angegebene
Gruppe Berechtigungen an ihre Mitglieder weiter und wird zu einer
Sicherheitsgruppe.
Wenn "InheritPerms=n" codiert ist, gibt die angegebene Gruppe keine
Berechtigungen an ihre Mitglieder weiter und ist daher keine Sicherheitsgruppe.
Standard: InheritPerms=y .
Name
Gibt den Namen der zu erstellenden Computergruppe an.
queryName
Gibt Folgendes an: Name der für die Evaluierung der Gruppe verwendeten Abfrage.
sdQuery
Gibt Folgendes an: Die für die Evaluierung der Gruppe verwendete Legacy-Abfrage.
Die Abfrage muss mit SD 4.0 SP1 kompatibel sein.
superGroup
Gibt Folgendes an: Name einer vorhandenen Computergruppe, in der die fragliche
Gruppe als Untergruppe erstellt wird. Wenn dieser Parameter nicht angegeben
wird, wird die Gruppe im Systemordner "Computer und Benutzer" erstellt.
70 CLI-Referenzhandbuch
Kompatibilität
Beispiel:
Es soll eine Computergruppe erstellt werden:
■
Die Gruppe soll "LA" heißen.
■
Sie soll dynamisch alle Zielcomputer erfassen, deren Namen mit "LA" beginnt.
■
Die Gruppe soll alle sechs Stunden aktualisiert werden.
■
Die Gruppe soll zunächst keine Untergruppe einer anderen Gruppe sein.
Eine solche Gruppe können Sie mit dem folgenden Befehl erstellen:
compGroup action=create name=LA SdQuery="Target.Name MATCHES 'LA.*'"
EnginePeriod=360
delete – Löschen einer Computergruppe
Mit dieser Aktion können Sie Computergruppen löschen.
Diese Aktion hat das folgende Format:
compgroup action=delete name=Gruppenname
Name
Gibt Folgendes an: Name einer Computergruppe, das gelöscht werden soll.
Beispiel:
Um die Gruppe "qg" zu löschen, geben Sie den folgenden Befehl ein:
cadsmcmd compgroup action=delete name=qg
cadsmcmd.compgroup.deletewithwarn
Mit dieser Aktion können Sie Computergruppen löschen.
Diese Aktion ermöglicht es, Computergruppen zu löschen und dabei Warnungen über
mögliche Verknüpfungen mit Software-Richtlinien oder Kataloggruppen anzuzeigen.
Diese Aktion hat das folgende Format:
compgroup action=deletewithwarn name=group_name
Name
Gibt den Namen der Computergruppe an, die gelöscht werden soll.
Kapitel 3: cadsmcmd-Befehle 71
Kompatibilität
cadsmcmd.example.compgroup.deletewithwarm
Um die Gruppe "qg" inklusive Warnung zu löschen, geben Sie folgenden Befehl ein:
cadsmcmd compgroup action=deletewithwarn name= qg
Hinweis: Wenn die Computergruppe im Enterprise-Manager gelöscht wird, wird die
Abhängigkeitsüberprüfung nur im Enterprise-Manager vorgenommen, und nicht im
Domänen-Manager, wo die Gruppe repliziert wird. Die Replikation entfernt im
Hintergrund alle Verknüpfungen mit Software-Kataloggruppen, deaktiviert alle
Software-Richtlinien und entfernt die Verknüpfung der Gruppe, bevor die replizierte
Gruppe gelöscht wird.
list – Auflisten von Computergruppen
Mit dieser Aktion können Sie alle Computergruppen, einschließlich der Abfragegruppen
und Softwarevorlagen, auflisten.
Diese Aktion hat das folgende Format:
compgroup action=list
{filter=Filter|filterfile=Dateiname}
filter
Gibt Folgendes an: Ausdruck, um die Anzahl der aufgelisteten Informationen
einzuschränken
Computergruppenname
Zeichenfolge
Gruppentyp
{Group | Query[/Template] group
| Template group}
Bereich
Zeichenfolge
Kommentar
Zeichenfolge
Erstellungsdatum
Datum
Erstellungszeit
Uhrzeit
Änderungsdatum
Datum
Änderungszeitpunkt
Uhrzeit
Abfrage
Zeichenfolge
nur Abfragegruppen
filterfile
Gibt Folgendes an: Name der Datei, die die Filterbefehle enthält.
Die Befehle der Datei werden auf die gleiche Weise festgelegt wie im Parameter
"Filter". Die Kapazität der Datei wird jedoch durch die Kapazität des den Befehl
ausführenden Systems begrenzt.
72 CLI-Referenzhandbuch
Kompatibilität
Beispiel:
Angenommen, Sie benötigen eine Liste aller lokalen Gruppen, die über eine Abfrage
bestimmt werden. Mit dem folgenden Befehl generieren Sie diese Liste auf einem
Domänen-Manager:
cadsmcmd compgroup action=list filter="(Group type=Group && Scope=local)"
------------------------------------------------------------------------------Liste von Computergruppen
Filter: (Group type=Group && Scope=local)
------------------------------------------------------------------------------cg_1:(Group, local)
cg_2:(Group, local)
Anzahl der angezeigten Objekte: 2
Anzahl der gelesenen Objekte: 2
SDCMD<A000000>: OK
listMembership – Auflisten der Mitgliedschaft von Computergruppen
Mit dieser Aktion können Sie Computergruppen auflisten, in denen eine
Computergruppe als Untergruppe vorhanden ist.
Diese Aktion hat das folgende Format:
compgroup action=listMembership name=Gruppenname
[groupScope={global | local}]
Name
Gibt Folgendes an: Name einer Computergruppe, deren Mitgliedschaften
aufgelistet werden.
groupScope
Gibt den Bereich der definierten Gruppe an. Für diese Option sind folgende Werte
gültig:
Global
Bei der Gruppe handelt es sich um eine globale, auf einem Enterprise-Manager
erstellte Gruppe. Sie kann auf einem Domänen-Manager repliziert werden.
Lokal
Gibt eine auf dem mit "CADSMCMD" verbundenen Domänen-Manager erstellte
lokale Gruppe an.
Wenn "groupScope" nicht angegeben ist, versucht der Befehl "CADSMCMD"
zunächst, die Gruppe als lokale Gruppe zu bestimmen. Sollte dies fehlschlagen, wird
versucht, die Gruppe als globale Gruppe zu bestimmen.
Kapitel 3: cadsmcmd-Befehle 73
Kompatibilität
Beispiel:
Um eine Liste der Gruppen anzuzeigen, denen die Gruppe "cg_2" angehört, geben Sie
den folgenden Befehl ein:
cadsmcmd compgroup action=listMembership name=cg_2
Die folgenden Informationen werden bereitgestellt:
----------------------------------------------------------------------------"cg_2" ist Mitglied der folgenden Gruppen
----------------------------------------------------------------------------cg_1 (Gruppe, Betriebsbereit, 28.01.05 09:57)
cg_x (Gruppe, Betriebsbereit, 28.01.05 10:56)
listSWP – Auflisten von mit der Computergruppe verknüpften Software-Richtlinien
Diese Aktion listet alle Software-Richtlinien auf, die derzeit mit der angegebenen
Computergruppe verknüpft sind.
Die Syntax der Aktion lautet folgendermaßen:
compgroup
action=listSWP
name=Computergruppenname
[groupScope={local|global}]
[separator=Trennzeichen]
Name
Name der Computergruppe, für die alle mit ihr verknüpften Software-Richtlinien
aufgelistet sind.
groupScope
Diese Option legt den Typ der Computergruppe fest. Folgende Werte sind gültig:
«nicht angegeben»
Wenn eine lokal erstellte Software-Richtlinie des angeforderten Namens
vorhanden ist, wird diese verwendet. Falls nicht, wird eine von einem
Enterprise-Manager verteilte Richtlinie gesucht. Letzteres ist nur auf DomänenManagern zulässig.
distributed
Die angegebene Software-Richtlinie muss auf dem Enterprise-Manager erstellt
und an den angegebenen Manager verteilt worden sein.
lokal
Die angegebene Softwarerichtlinie muss lokal erstellt worden sein.
Hinweis: Enterprise-Manager unterstützen nur Software-Richtlinien vom Typ
"lokal".
74 CLI-Referenzhandbuch
Kompatibilität
Trennzeichen
Das Trennzeichen ist ein Zeichen, das zum Trennen der verschiedenen
Ausgabefelder in den Zeilen der Auflistungen verwendet wird. Das standardmäßige
Trennzeichen ist ":" (Doppelpunkt).
Das Format der Ausgabe mit dem Standardtrennzeichen sieht folgendermaßen aus:
---------------------------------------------------------------Liste der mit «Gruppenname» mit dem Bereich «Gruppenbereich» verknüpften
Software-Richtlinien
Short
---------------------------------------------------------------«Richtlinie_1 Name»:«Richtlinie_1 Typ»:[un]sealed
•
•
•
«Richtlinie_n Name»:«Richtlinie_n Typ»:[un]sealed
modify – Bearbeiten von Computergruppen
Mit dieser Aktion können Sie Computergruppen bearbeiten.
Diese Aktion hat das folgende Format:
compgroup action=modify
name=Gruppenname
[newName=neuer Name]
[comment=Kommentar]
[{queryName=Abfrage |sdQuery=sdquery|noQuery}]
[engineName=Engine-Name
[enginePeriod=Engine-Evaluierungshäufigkeit]]
[InheritPerms[={y|n}]]
comment
Gibt an: Ein Kommentar .
Hinweis: Geben Sie eine leere Zeichenfolge ein (""), um einen vorhandenen
Kommentar zu löschen.
engineName
Gibt den Namen einer Engine an, die die Gruppenevaluierung verarbeitet. Bei
Angabe einer leeren Zeichenfolge kann die Abfrage von einer beliebigen Engine
verarbeitet werden.
Wenn der Gruppe derzeit keine Abfrage zugewiesen ist, wird eine Warnung
angezeigt, und der Parameter wird ignoriert.
Kapitel 3: cadsmcmd-Befehle 75
Kompatibilität
enginePeriod
Gibt den Zeitraum in Minuten an, in dem die Engine die Gruppe neu evaluiert.
Wenn dieser Parameter nicht angegeben wird, wird von einem Zeitraum von 1
Minute ausgegangen.
Wenn der Gruppe zurzeit keine Abfrage zugewiesen und keine bestimmte Engine
für die Verarbeitung der Evaluierung angegeben ist, wird eine Warnung ausgegeben
und der Parameter wird ignoriert.
inheritPerms
Dieser optionale Parameter gibt an, ob die geänderte Gruppe eine
Sicherheitsgruppe ist.
Wenn "InheritPerms=n" codiert ist, gibt die angegebene Gruppe keine
Berechtigungen an ihre Mitglieder weiter und ist daher keine Sicherheitsgruppe
mehr.
Wenn "InheritPerms" oder "InheritPerms=y" codiert ist, gibt die angegebene
Gruppe Berechtigungen an ihre Mitglieder weiter und wird daher zu einer
Sicherheitsgruppe.
Wenn der Parameter nicht codiert ist, werden die BerechtigungsübernahmeEinstellungen der Gruppe nicht geändert.
Name
Gibt Folgendes an: Name einer Computergruppe, der geändert werden soll.
newName
Gibt Folgendes an: Neuer Name der Computergruppe.
noQuery
Eine eventuell angegebene Abfrage wird gelöscht.
query
Gibt an, dass die Vorlage ebenfalls eine Abfragegruppe ist. Die angegebene Abfrage
muss eine USD 4.0 SP1-Legacy-Abfrage sein.
queryName
Gibt Folgendes an: Name der für die Evaluierung der Gruppe verwendeten Abfrage.
sdQuery
Gibt Folgendes an: Die für die Evaluierung der Gruppe verwendete Legacy-Abfrage.
Die Abfrage muss mit SD 4.0 SP1 kompatibel sein.
Hinweis: Durch nicht angegebene Parameter bleiben die entsprechenden Attribute
unverändert.
76 CLI-Referenzhandbuch
Kompatibilität
Beispiel:
Angenommen, die Gruppe "LA" soll bearbeitet werden.
■
Der Name der Gruppe soll in "LA District" geändert werden.
■
Die Gruppe soll nun alle zwei Stunden aktualisiert werden.
Diese Änderungen werden mit Hilfe des folgenden Befehls durchgeführt:
cadsmcmd compGroup action=modify name=LA newName="LA District"
EvaluationPeriod=120
setDownloadMethod – Festlegen der Download-Methode einer Computergruppe
Mit dieser Aktion können Sie die Download-Methode von einer oder mehreren
Computergruppen festlegen.
Diese Aktion hat das folgende Format:
compGroup
action= setDownloadMethod
[sep=Trennzeichen]
{[{compgrp=Computergruppenname}]
| [{ccompgrp=Computergruppenname]}
downloadMethod={NOS|NOSLESS|DTS}
sep
Dieser Parameter gibt ein Trennzeichen mit einem Byte zum Trennen eines
Gruppennamens vom Bereich der Gruppe an. Das Trennzeichen darf nicht Teil eines
Gruppennamens sein, der mit dem Befehl angegeben wird. Der Standardwert ist ein
Punkt (.).
compgrp
Name einer von dieser Aktion angesprochenen Computergruppe. Der Parameter
kann mehrfach codiert werden, um eine Liste von Gruppen anzugeben. CADSMCMD
versucht, die mit diesem Parameter angegebenen Gruppen als lokale Gruppen zu
finden. Wenn keine derartige Gruppe vorhanden ist, versucht es, sie als globale
Gruppe zu finden.
Bei dieser Aktion muss mindestens ein compgrp- oder ccompgrp-Parameter codiert
werden.
Kapitel 3: cadsmcmd-Befehle 77
Kompatibilität
ccompgrp
Name und Typ einer von dieser Aktion angesprochenen Gruppe. Die übergebenen
Informationen besitzen die folgende Syntax:
(Gruppenname Trennzeichen {local|global})
Das Trennzeichen ist standardmäßig ein Punkt (.), diese Einstellung kann jedoch mit
dem Parameter "sep" geändert werden. Wenn "local" codiert ist, wird die Gruppe
als eine Gruppe betrachtet, die auf dem lokalen Domänen-Manager erstellt wurde.
Wenn "global" codiert ist, wird davon ausgegangen, dass die Gruppe aus einem
Enterprise-Manager repliziert wurde.
Bei dieser Aktion muss mindestens ein compgrp- oder ccompgrp-Parameter codiert
werden.
downloadMethod
Gibt die Download-Methode an, auf die die Mitglieder der Gruppen umgestellt
werden. Wählen Sie eine der folgenden Optionen aus:
NOS
"Intern - NOS"
NOSLESS
"Intern - ohne NOS"
DTS
"DTS - ohne NOS"
Die Aktion wird nur mit Domänen-Managern ausgeführt, auf denen SD installiert ist.
showAttr – Anzeigen von Attributen von Computergruppen
Mit dieser Aktion können Sie die Attribute von Computergruppen auflisten.
Diese Aktion hat das folgende Format:
compgroup action=showattr
name=Gruppenname
[groupScope={global | local}]
78 CLI-Referenzhandbuch
Kompatibilität
name
Gibt Folgendes an: Name einer Computergruppe, deren Attribute aufgelistet sind.
groupScope
Gibt den Bereich der definierten Gruppe an. Für diese Option sind folgende Werte
gültig:
Global
Bei der Gruppe handelt es sich um eine globale, auf einem Enterprise-Manager
erstellte Gruppe. Sie kann auf einem Domänen-Manager repliziert werden.
Lokal
Gibt eine auf dem mit "CADSMCMD" verbundenen Domänen-Manager erstellte
lokale Gruppe an.
Wenn "groupScope" nicht angegeben ist, versucht der Befehl "CADSMCMD"
zunächst, die Gruppe als lokale Gruppe zu bestimmen. Sollte dies fehlschlagen, wird
versucht, die Gruppe als globale Gruppe zu bestimmen.
Hinweis: Für eine Vorlagengruppe ist die Methode der Aktion showattr (Siehe Definition
auf Seite 482) der Vorlagengruppe zugeordnet.
Beispiel:
Um die Attribute einer Computergruppe anzuzeigen, rufen Sie den folgenden Befehl auf:
cadsmcmd compgroup action=showAttr name=cg
Ausgabe
Standardgruppen
Für eine Standard-Computergruppe, beispielsweise "cg_1", lautet die Ausgabe wie folgt:
----------------------------------------------------------------------------Attribute der Computergruppe "cg_1"
----------------------------------------------------------------------------Name der Computergruppe....................: cg_1
Gruppentyp............................: Gruppe
Bereich..................................: Lokal
Status..................................: Betriebsbereit
Kommentar.............................:
Sicherheitstyp...........................: Sicherheitsgruppe
Erstellungsdatum..........................: 2005-01-28
Erstellungszeitpunkt..........................: 09:57
Änderungsdatum............................: 2005-01-28
Änderungszeitpunkt............................: 09:57
Kapitel 3: cadsmcmd-Befehle 79
Kompatibilität
Abfragegruppen
Für eine Abfragegruppe, beispielsweise "qg", lautet die Ausgabe wie folgt:
----------------------------------------------------------------------------Attribute der Computergruppe "qg"
----------------------------------------------------------------------------Name der Computergruppe....................: qg
Gruppentyp............................: Abfragegruppe
Bereich..................................: Lokal
Status..................................: Betriebsbereit
Kommentar.............................:
Sicherheitstyp...........................: Sicherheitsgruppe
Erstellungsdatum..........................: 2005-01-21
Erstellungszeitpunkt..........................: 16:06
Änderungsdatum............................: 2005-01-21
Änderungszeitpunkt............................: 16:06
Abfrage..................................: USD_qg [01/21/05 16:06:56.588]
Engine-Name............................: <Alle Engines>
Engine-Zeitraum (Minuten)................: 60
Softwarevorlagen
Hinweis: Für eine Vorlagengruppe ist die Methode der Aktion showattr (Siehe Definition
auf Seite 482) der Vorlagengruppe zugeordnet.
Beispiel:
Um die Attribute einer Computergruppe anzuzeigen, rufen Sie den folgenden Befehl auf:
cadsmcmd compgroup action=showAttr name=cg
Ausgabe
Standardgruppen
Für eine Standard-Computergruppe, beispielsweise "cg_1", lautet die Ausgabe wie folgt:
----------------------------------------------------------------------------Attribute der Computergruppe "cg_1"
----------------------------------------------------------------------------Name der Computergruppe....................: cg_1
Gruppentyp............................: Gruppe
Bereich..................................: Lokal
Status..................................: Betriebsbereit
Kommentar.............................:
Erstellungsdatum..........................: 2005-01-28
Erstellungszeitpunkt..........................: 09:57
Änderungsdatum............................: 2005-01-28
Änderungszeitpunkt............................: 09:57
80 CLI-Referenzhandbuch
Kompatibilität
Abfragegruppen
Für eine Abfragegruppe, beispielsweise "qg", lautet die Ausgabe wie folgt:
----------------------------------------------------------------------------Attribute der Computergruppe "qg"
----------------------------------------------------------------------------Name der Computergruppe....................: qg
Gruppentyp............................: Abfragegruppe
Bereich..................................: Lokal
Status..................................: Betriebsbereit
Kommentar.............................:
Erstellungsdatum..........................: 2005-01-21
Erstellungszeitpunkt..........................: 16:06
Änderungsdatum............................: 2005-01-21
Änderungszeitpunkt............................: 16:06
Abfrage..................................: USD_qg [01/21/05 16:06:56.588]
Engine-Name............................: <Alle Engines>
Engine-Zeitraum (Minuten)................: 60
Softwarevorlagen
Hinweis: Für eine Vorlagengruppe ist die Methode der Aktion showattr (Siehe Definition
auf Seite 482) der Vorlagengruppe zugeordnet.
Mitgliedschaftsverwaltung
Die folgenden Methoden dieses Kapitels können nur auf dem Domänen-Manager
verwendet werden.
Dieser Abschnitt enthält die folgenden Themen:
add – Hinzufügen eines Computers zu einer Computergruppe (siehe Seite 81)
listmem – Auflisten der Mitglieder einer Computergruppe (siehe Seite 82)
remove – Entfernen eines Computers aus einer Computergruppe (siehe Seite 83)
listFailedJobs – Auflisten fehlgeschlagener Jobs einer Computergruppe (siehe Seite 84)
listJobs – Auflisten von Informationen zu vorhandenen, mit Gruppenmitgliedern
verknüpften Jobs (siehe Seite 85)
add – Hinzufügen eines Computers zu einer Computergruppe
Mit dieser Aktion können Sie der Computergruppe Computer hinzufügen.
Diese Aktion hat das folgende Format:
compgroup action=add
name=Gruppenname
{{computer=Computername} | addall}
Kapitel 3: cadsmcmd-Befehle 81
Kompatibilität
addall
Alle beim Erstellen vorhandenen SD-Zielcomputer werden der Gruppe hinzugefügt.
computer
Dieser Parameter gibt den Namen eines SD-Zielcomputers, eines Benutzerprofils
oder eines Docking-Geräts an, das zur Gruppe hinzugefügt werden soll.
Der Parameter kann mehrfach codiert werden, um mehrere Objekte zur Gruppe
hinzuzufügen.
Name
Gibt Folgendes an: Name einer Computergruppe, der die Computer hinzugefügt
werden.
Beispiel:
Geben Sie den folgenden Befehl ein, um die Computer "HOHOH01A" und "KEKEK01A"
der Gruppe "cg_1" hinzuzufügen:
cadsmcmd compgroup action=add name=cg_1 computer=HOHOH01A computer=KEKEK01A
Hinweis: Wenn "cg_1" mit einer Abfrage verknüpft ist, schlägt dieser Vorgang fehl. Sie
können die Liste der einer Abfragegruppe zugewiesenen Computer nur ändern, indem
Sie die Abfrage ändern oder erneut evaluieren.
listmem – Auflisten der Mitglieder einer Computergruppe
Mit dieser Aktion können Sie die Mitglieder einer Gruppe auflisten.
Folgendes Format wird verwendet:
compgroup action=listMem
name=Gruppenname
[groupScope={global | local}]
Name
Gibt Folgendes an: Name einer Computergruppe
groupScope
Gibt den Bereich der definierten Computergruppe an. Für diese Option sind
folgende Werte gültig:
Global
Bei der Gruppe handelt es sich um eine globale, auf einem Enterprise-Manager
erstellte Gruppe. Sie kann auf einem Domänen-Manager repliziert werden.
82 CLI-Referenzhandbuch
Kompatibilität
Lokal
Lokaler Bereich (Domäne)
Wenn "groupScope" nicht angegeben ist, versucht der Befehl "CADSMCMD"
zunächst, die Gruppe als lokale Gruppe zu bestimmen. Sollte dies fehlschlagen, wird
versucht, die Gruppe als globale Gruppe zu bestimmen.
Die folgende Liste wird ausgegeben:
----------------------------------------------------------------------------Mitglieder der Computergruppe "(<Gruppenname>, <Gruppenbereich>)"
----------------------------------------------------------------------------<group member>
<group member>
<group member>
...
Beispiel:
Geben Sie den folgenden Befehl ein, um die Liste der Mitglieder von Gruppe "cg_1"
abzurufen:
cadsmcmd compgroup action=listMem name=cg_1
Die Ausgabe lautet folgendermaßen:
----------------------------------------------------------------------------Mitglieder der Computergruppe "(cg_1, local)"
----------------------------------------------------------------------------GRRGGRRGC
GRGRGRGRU02
HOHOH01A
HOHOH01B
KEKEK01A
KUKUK01A
KUKUK01B
WAUWA01
remove – Entfernen eines Computers aus einer Computergruppe
Wenn Sie mit einem Domänen-Manager verbunden sind, können Sie ein Mitglied aus
einer Computergruppe entfernen, indem Sie den Computer löschen oder die
Verknüpfung aufheben.
Diese Aktion hat das folgende Format:
compgroup action=remove
name=Gruppenname
{computer=Computername}
Kapitel 3: cadsmcmd-Befehle 83
Kompatibilität
Name
Gibt Folgendes an: Name einer Computergruppe, aus der Mitglieder entfernt
werden sollen.
computer
Dieser Parameter gibt den Namen eines SD-Zielcomputers, eines Benutzerprofils
oder eines Docking-Geräts an, das aus der Gruppe entfernt werden soll.
Der Parameter kann mehrfach codiert werden, um mehrere Objekte aus der
Gruppe zu entfernen.
Beispiel:
Geben Sie den folgenden Befehl ein, um die Computer "HOHOH01A" und "KEKEK01A"
aus der Gruppe "cg_1" zu löschen:
cadsmcmd compgroup action=remove name=cg_1 computer=HOHOH01A computer=KEKEK01A
Hinweis: Wenn "cg_1" mit einer Abfrage verknüpft ist, schlägt dieser Vorgang fehl. Sie
können die Liste der einer Abfragegruppe zugewiesenen Computer nur ändern, indem
Sie die Abfrage ändern oder erneut evaluieren.
listFailedJobs – Auflisten fehlgeschlagener Jobs einer Computergruppe
Diese Aktion listet detaillierte Informationen zu fehlgeschlagenen Jobs auf, die mit den
Mitgliedern dieser Gruppe verknüpft sind.
Diese Aktion ist nur für Domänen-Manager zulässig.
Diese Aktion hat das folgende Format:
compgroup action=listFailedJobs
name=Computergruppenname
[groupScope={global | local}]
Name
Gibt den Namen einer vorhandenen Computergruppe an. Informationen zu
vorhandenen fehlgeschlagenen Jobs, die mit den Gruppenmitgliedern verknüpft
sind, werden aufgelistet.
Der Name kann Datenbank-Platzhalter enthalten, z. B.
"%" für eine beliebige, sogar leere Zeichenfolge
"_" für ein beliebiges einzelnes Zeichen.
groupScope
Gibt den Bereich der definierten Gruppe an. Für diese Option sind folgende Werte
gültig:
84 CLI-Referenzhandbuch
Kompatibilität
Global
Bei der Gruppe handelt es sich um eine globale, auf einem Enterprise-Manager
erstellte Gruppe. Sie kann auf einem Domänen-Manager repliziert werden.
Lokal
Gibt eine auf dem mit "CADSMCMD" verbundenen Domänen-Manager erstellte
lokale Gruppe an.
Wenn "groupScope" nicht angegeben ist, wird nicht überprüft, ob es sich bei den
Gruppen um lokale oder globale Gruppen handelt.
Die zurückgegebenen Informationen sind auf dieselbe Weise formatiert wie bei der
Aktion listJobs (Siehe Definition auf Seite 85) von "compgroup".
listJobs – Auflisten von Informationen zu vorhandenen, mit Gruppenmitgliedern verknüpften
Jobs
Diese Aktion listet detaillierte Informationen zu vorhandenen Jobs auf, die mit den
Mitgliedern dieser Gruppe verknüpft sind.
Diese Aktion ist nur für Domänen-Manager zulässig.
Diese Aktion hat das folgende Format:
compgroup action=listJobs
name=Gruppenname
[groupScope={global | local}]
Name
Name einer vorhandenen Computergruppe Informationen zu vorhandenen
fehlgeschlagenen Jobs, die mit den Gruppenmitgliedern verknüpft sind, werden
aufgelistet.
Der Name kann Datenbank-Platzhalter enthalten, z. B.
"%" für eine beliebige, sogar leere Zeichenfolge
"_" für ein beliebiges einzelnes Zeichen.
groupScope
Gibt den Bereich der definierten Gruppe an. Für diese Option sind folgende Werte
gültig:
Kapitel 3: cadsmcmd-Befehle 85
Kompatibilität
Global
Bei der Gruppe handelt es sich um eine globale, auf einem Enterprise-Manager
erstellte Gruppe. Sie kann auf einem Domänen-Manager repliziert werden.
Lokal
Gibt eine auf dem mit "CADSMCMD" verbundenen Domänen-Manager erstellte
lokale Gruppe an.
Wenn "groupScope" nicht angegeben ist, wird nicht überprüft, ob es sich bei den
Gruppen um lokale oder globale Gruppen handelt.
Die abgerufenen Informationen werden folgendermaßen dargestellt:
----------------------------------------------------------------------------Liste der mit der Gruppe "Gruppenname" verknüpften Jobs
----------------------------------------------------------------------------Name der Computergruppe......: Gruppenname
..Ziel.................: Name des Zielcomputers
....Jobname.............: Jobname
....Job-ID.......: Computerjob-ID
....Elementname............: Elementname
....Elementversion.........: Elementversion
....Prozedurname.......: Prozedurname
....Task.................: task
....Benutzerparameter......: Benutzerparameter
....Jobstatus............: Jobstatus
....Fehlercode...........: Fehlercode
....Fehlermeldung........: Fehlermeldung
....Erstellungsdatum........: JJJJ-MM-TT
....Erstellungszeitpunkt........: HH:MM
....Aktivierungsdatum......: JJJJ-MM-TT
....Aktivierungszeit......: HH:MM
....Beendigungsdatum......: JJJJ-MM-TT
....Beendigungszeit......: HH:MM
Hierarchieverwaltung
Dieser Abschnitt enthält die folgenden Themen:
addSubgroups – Hinzufügen von Untergruppen zu Computergruppen (siehe Seite 87)
listSubgroups – Auflisten von Untergruppen (siehe Seite 87)
removeSubgroups – Entfernen von Untergruppen (siehe Seite 89)
86 CLI-Referenzhandbuch
Kompatibilität
addSubgroups – Hinzufügen von Untergruppen zu Computergruppen
Mit dieser Aktion können Sie einer Gruppe Untergruppen hinzufügen.
Diese Aktion hat das folgende Format:
compgroup action=addSubgroups
[name=Gruppenname]
{compgrp=Gruppenname}
Name
Gibt den Namen der Computergruppe an, der die angegebenen Computergruppen
von "compgrp" hinzugefügt werden.
Die Gruppe sollte nicht mit einer Abfrage verbunden sein.
Wenn dieser Parameter nicht angegeben wird, werden die Untergruppen in den
Container "Computer und Benutzer" kopiert.
compgrp
Gibt den Namen der hinzuzufügenden Computergruppe an.
Der Parameter kann mehrfach angegeben werden , um die Untergruppe einer Liste
von Computergruppen hinzuzufügen.
Hinweis: Die Gruppe, der die Computergruppen hinzugefügt werden, darf keine
Abfragegruppe sein.
Beispiel:
Angenommen, die Gruppen mit den Bezeichnungen "LA admin", "LA sales" und "LA rd"
sollen der Gruppe "LA District" hinzugefügt werden. Mit Hilfe des folgenden Befehls
werden diese Gruppen der übergeordneten Gruppe "LA District" als Untergruppen
zugewiesen:
cadsmcmd compGroup action=addSubgroups name="LA District" compgrp="LA admin"
compgrp="LA sales" compgrp="LA rd"
Die Gruppen "LA admin", "LA sales" und "LA rd" müssen übrigens zum Zeitpunkt des
Befehlsaufrufs definiert werden, anderenfalls wird aufgrund der fehlenden Untergruppe
ein Fehler ausgegeben.
listSubgroups – Auflisten von Untergruppen
Mit dieser Aktion können Sie die Untergruppen einer Gruppe auflisten.
Diese Aktion hat das folgende Format:
compgroup action=listSubgroups
[name=Gruppenname]
[groupScope={global | local}]
Kapitel 3: cadsmcmd-Befehle 87
Kompatibilität
Name
Gibt Folgendes an: Name einer Computergruppe, deren Untergruppen aufgelistet
werden.
Wenn dieser Parameter nicht angegeben wird, werden die Computergruppen des
Ordners "Computer und Benutzer" aufgelistet.
groupScope
Gibt den Bereich der definierten Gruppe an. Für diese Option sind folgende Werte
gültig:
Global
Bei der Gruppe handelt es sich um eine globale, auf einem Enterprise-Manager
erstellte Gruppe. Sie kann auf einem Domänen-Manager repliziert werden.
Lokal
Gibt eine auf dem mit "CADSMCMD" verbundenen Domänen-Manager erstellte
lokale Gruppe an.
Wenn "groupScope" nicht angegeben ist, versucht der Befehl "CADSMCMD"
zunächst, die Gruppe als lokale Gruppe zu bestimmen. Sollte dies fehlschlagen, wird
versucht, die Gruppe als globale Gruppe zu bestimmen.
Beispiel:
Geben Sie Folgendes ein, um alle mit der Gruppe "LA District" verbundenen
Untergruppen aufzulisten:
cadsmcmd compGroup action=listSubgroups name="LA District"
Die Ausgabeliste besitzt das folgende Format:
----------------------------------------------------------------------------Untergruppenliste der Computergruppe "LA District"
----------------------------------------------------------------------------LA admin:(Gruppe, Lokal)
LA sales:(Abfragegruppe, Lokal)
LA rd:(Vorlagengruppe, Lokal, 1)
LA pr:(Abfrage-/Vorlagengruppe, Lokal, 1)
Die Werte in der Zeile der Vorlagengruppe geben die Anzahl der Vorlagen an, die mit
den Gruppen verknüpft sind.
88 CLI-Referenzhandbuch
Kompatibilität
removeSubgroups – Entfernen von Untergruppen
Mit dieser Aktion können Sie Untergruppen aus einer Computergruppe entfernen.
Diese Aktion hat das folgende Format:
compgroup action=removeSubgroups
[name=Gruppenname]
{compgrp=Gruppenname}
Name
Gibt Folgendes an: Name einer Computergruppe, aus der die angegebenen
Computergruppen entfernt werden. Die Gruppe sollte nicht mit einer Abfrage
verbunden sein. Wenn dieser Parameter nicht angegeben wird, werden die
Untergruppen aus dem Ordner "Computer und Benutzergruppen" entfernt.
compgrp
Gibt Folgendes an: Name einer Computergruppe, die entfernt werden sollen.
Der Parameter kann mehrfach angegeben werden , um eine Liste von
Computergruppen zu entfernen.
Hinweise: "Entfernen" bedeutet nicht, dass alle Computergruppen des Parameters
"compgrp" gelöscht werden, lediglich ihre Verknüpfung mit der im Parameter "name"
angegebenen übergeordneten Gruppe wird entfernt.
Die von dem Parameter name angegebene Gruppe sollte keine Abfragegruppe sein.
Beispiel:
Angenommen, die Gruppen mit den Bezeichnungen "LA admin", "LA sales" und "LA rd"
sollen wieder aus der Gruppe "LA District" entfernt werden. Mit Hilfe des folgenden
Befehls werden diese Gruppen als Untergruppen aus der übergeordneten Gruppe "LA
District" entfernt:
cadsmcmd compGroup action=removeSubgroups name="LA District" compgrp="LA admin"
compgrp="LA sales" compgrp="LA rd"
Die Gruppen "LA admin", "LA sales" und "LA rd" werden durch den Befehl nicht aus der
Datenbank gelöscht, sondern lediglich aus der Gruppe "LA District" entfernt. Alle
anderen Inhaltsbeziehungen, neben den zuvor genannten, sind weiterhin vorhanden.
Kapitel 3: cadsmcmd-Befehle 89
Kompatibilität
Der Befehl meldet einen Fehler, wenn die aufzulösende Inhaltsbeziehung für eine der zu
entfernenden Untergruppen die einzige Inhaltsbeziehung ist. "LA admin" wird
beispielsweise lediglich als Untergruppe von "LA District" genannt, während die anderen
Untergruppen auch im Ordner "Computer- und Benutzergruppen" oder in anderen
Gruppen vorhanden sind. In diesem Fall werden alle Gruppen außer "LA admin"
gelöscht. Die Meldung "A001513 – Unzulässiger Vorgang für Computergruppe: Gruppe
muss mindestens eine übergeordnete Gruppe aufweisen" wird eingeblendet. Sie
können die Gruppe "LA admin" nur entfernen, indem Sie sie löschen (cadsmcmd
compGroup action=delete name="LA admin") oder einer anderen Gruppe als
Untergruppe zuweisen und anschließend aus "LA District" löschen.
configure – Erstellen eines Konfigurationsjobs in einem Jobcontainer
Weitere Informationen finden Sie unter dem Befehl "Install".
copyfetched – Kopieren abgerufener Elemente
Der Befehl "copyfetched" ist nur gültig, wenn er vom Enterprise-Manager ausgegeben
wird.
copyfetched wird verwendet, um auf Dateien zuzugreifen, die vom Domänen-Manager
auf den Enterprise-Manager abgerufen wurden. Diese abgerufenen Dateien werden in
einem Abrufbereich auf dem Enterprise-Manager gespeichert. Bevor auf die Dateien
zugegriffen werden kann, müssen sie an einen anderen Speicherort auf dem EnterpriseManager kopiert werden.
Dieser Befehl hat das folgende Format:
copyfetched area=Bereichsname
item=Name des abgerufenen Elements
path=enterprise_manager_Pfadname
area
Gibt Folgendes an: Name einer CA ITCM-Domäne, von der die Dateien abgerufen
wurden.
item
Gibt Folgendes an: Name des abgerufenen Elements. Dieser Elementname wurde
von der früheren Abrufoperation verwendet, die das Element abgerufen hat.
path
Gibt Folgendes an: Pfad zu den abzurufenden Elementen, in dem das abgerufene
Element platziert werden soll.
Wenn der Pfad noch nicht vorhanden ist, wird er erstellt.
90 CLI-Referenzhandbuch
Kompatibilität
Beispiel:
Im folgenden Beispiel wird "copyfetched" über einen Windows-Enterprise-Manager
ausgegeben. "Tested Software" wurde aus dem Bereich "Charolette" abgerufen und in
das Verzeichnis "C:\TEST\FETCHED1" auf dem Enterprise-Manager kopiert.
cadsmcmd copyfetched area=CHAROLETTE item=" Tested Software"path=c:\test\fetched1
dereg – Aufheben der Registrierung von Elementen
Dieser Befehl wird verwendet, um die Registrierung von Software in der EnterpriseBibliothek und der Domänen-Bibliothek aufzuheben bzw. um Software aus der
entsprechenden Bibliothek zu entfernen.
Dieser Befehl hat das folgende Format:
dereg
item=Elementname
version=Elementversion
item
Gibt Folgendes an: Name des Elements, dessen Registrierung aufgehoben wird.
Version
Gibt Folgendes an: Version des Elements, dessen Registrierung aufgehoben wird.
deregproc – Aufheben der Registrierung von Prozeduren
Verwenden Sie diesen Befehl, um die Registrierung einer mit einem Softwareprogramm
verbundenen Elementprozedur aufzuheben (Entfernung aus der Enterprise-Bibliothek
oder der Domänen-Bibliothek). Wenn das Produkt bereits versiegelt ist, darf die
Elementprozedur keine eingebettete Elementprozedur sein.
Dieser Befehl hat das folgende Format:
deregproc item=Elementname
version=Elementversion
procedure=Prozedurname
item
Gibt Folgendes an: Name des Elements, zu dem diese Prozedur gehört.
Version
Gibt Folgendes an: Version des Elements, zu dem diese Prozedur gehört.
Prozedur
Gibt Folgendes an: Name einer Prozedur. Ihre Registrierung wird aufgehoben.
Kapitel 3: cadsmcmd-Befehle 91
Kompatibilität
distribution – Verteilungsbefehl
Diese Aktion ist nur für Enterprise-Manager zulässig.
Dieser Abschnitt enthält die folgenden Themen:
delete – Löschen von Verteilungen (siehe Seite 92)
list – Auflisten von Verteilungen (siehe Seite 92)
setDistPriority – Festlegen der Verteilungspriorität (siehe Seite 93)
showAttr – Anzeigen von Attributen einer Verteilung (siehe Seite 93)
showOrderDetails – Anzeigen von Anweisungsdetails einer Verteilung (siehe Seite 94)
delete – Löschen von Verteilungen
Die betreffende Verteilung wird gelöscht.
Diese Aktion hat das folgende Format:
distribution action=delete
name=Verteilungsname
Name
Gibt Folgendes an: Name der Verteilung, das gelöscht werden soll.
list – Auflisten von Verteilungen
Durch diese Aktion wird die Liste der Verteilungen angezeigt. Die Liste enthält nur die
Verteilungen, für die der aufrufende Benutzer die Berechtigung zum Auflisten besitzt.
Die Liste enthält den Namen der Verteilung und (in runden Klammern) ihren Status.
Diese Aktion hat das folgende Format:
distribution action=list
Die folgenden Informationen werden ausgegeben:
------------------------------------------------------------------------------Verteilungsliste
------------------------------------------------------------------------------send prod (ok)
send instconf (ok)
remove prod (wird erstellt)
remote reg (ok)
multi (wartet)
------------------------------------------------------------------------------Anzahl der gefundenen Verteilungen: 5
Anzahl der angezeigten Verteilungen: 5
Die Liste enthält den Namen der Verteilung und in Klammern ihren Status.
92 CLI-Referenzhandbuch
Kompatibilität
setDistPriority – Festlegen der Verteilungspriorität
Mit dieser Aktion wird die Priorität der Verteilung geändert, unabhängig davon, ob die
angegebene Verteilung versiegelt ist oder nicht.
Diese Aktion hat das folgende Format:
distribution action=setDistPriority
name=Verteilungsname
[distPriority={1,...,10}]
Name
Gibt Folgendes an: Name der Verteilung, dessen Priorität geändert werden soll.
distPriority
Gibt Folgendes an: neue 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.
showAttr – Anzeigen von Attributen einer Verteilung
Diese Aktion zeigt die Attribute einer Verteilung an.
Diese Aktion hat das folgende Format:
distribution action=showattr name=Verteilungsname
Name
Gibt Folgendes an: Name der Verteilung, dessen Attribute angezeigt werden.
Die folgenden Informationen werden ausgegeben:
Geben Sie einen der oben angegebenen Befehle ein: Verteilung
{list | showattr | showorderdetails |
...delete | setdistpriority}........................: Anzeigen von Attributen
distribution name=<name>............................: DIST_ins_xxx003_def
------------------------------------------------------------------------------Attribute von Verteilung "DIST_ins_xxx003_def" anzeigen
------------------------------------------------------------------------------Verteilungspriorität..................: 5
Verteilungsstatus.....................: Fehler
Berechtigungsmaske........................: 13
.........................................Löschen zulässig
Kapitel 3: cadsmcmd-Befehle 93
Kompatibilität
.........................................Erneuerung zulässig
.........................................Wiederaufnahme zulässig
Erstellungsdatum..........................: 2006-08-16
Erstellungszeitpunkt..........................: 13:50
Verteilungsdatum.....................: 2006-08-16
Verteilungszeitpunkt......................: 13:50
Anhaltedatum..............................: 2006-08-16
Anhaltezeitpunkt..............................: 19:50
Anzahl der Standorte........................: 1
.........................................0 - Warten
.........................................0 - Aktiv
.........................................1 - Fehler
.........................................0 - OK
..Bereich.............................: xxx-yyy-zzz
....Speicherort.......................:
....Gesendete Daten (in %)..............: 100
....Verteilungsstatus.................: OK
....Auftragsstatus....................: Fehler
....Fehlgeschlagene Auftragsnummer................: 1
....Auftragsfehlercode...................: 301820
....Auftragsfehlermeldung................: Fehler beim Verteilungsstatus:
Auftragsnr.: 1
.........................................+..und die folgenden Aufträge konnten
nicht
.........................................+ ausgeführt werden. Grund:
Elementprozedur zugeordnetes
.........................................+ Element nicht gefunden, oder Element
.........................................+ wurde lokal registriert.
Aufträge.................................: 1
..Auftragsname:.......................: Reg Job Cnr:DIST_ins_xxx003_def
....Auftragsnummer.......................: 1
....Jobcontainer-Priorität.............: 5
....Jobs...............................: 1
......Jobname..........................: tstxxx_3_es 1.0:inst
........Jobauftragsnummer...............: 0
........Jobstatus.....................: WAITING
SDCMD<A000000>: OK
showOrderDetails – Anzeigen von Anweisungsdetails einer Verteilung
Diese Aktion zeigt die Auftragsdetails einer Verteilung an.
Diese Aktion hat das folgende Format:
distribution action=showorderdetails
name=Verteilungsname
ordername=Auftragsname
94 CLI-Referenzhandbuch
Kompatibilität
Name
Gibt Folgendes an: Name der Verteilung, deren Auftragsdetails angezeigt werden.
ordername
Gibt Folgendes an: Name des Auftrags.
Die folgenden Informationen werden ausgegeben:
Geben Sie einen der oben angegebenen Befehle ein: Verteilung
{list | showattr | showorderdetails |
...delete | setdistpriority}........................: showorderDetails
distribution name=<name>............................: kkkkk01k [16.08.2006
08:04:40]
ordername=<name>....................................: Reg Job Cnr:kkkkk01k
[16.08.2006 08:04:40]
------------------------------------------------------------------------------Details zum Auftrag "Reg Job Cnr:kkkkk01k [16.08.2006 08:04:40]"
........von Verteilung "kkkkk01k [16.08.2006 08:04:40]"
------------------------------------------------------------------------------..Auftragsname:.......................: Reg Job Cnr:kkkkk01k [16.08.2006 08:04
.........................................+ :40]
....Auftragsnummer.......................: 1
....Auftragseigenschaften...................: 1
.........................................Keine Verknüpfung
....Jobcontainer-Priorität.............: 5
....Jobs...............................: 1
......Jobname.........................: tstbase 1.0: inst
........Elementname.................: tstbase
........Elementversion...................: 1.0
........Elementtyp...................: SOFTWARE
........Prozedurname....................: inst
........Jobstatus.....................: WAITING
.........................................0 - Warten
.........................................0 - Aktiv
.........................................0 - OK
.........................................0 - Fehler
........Jobauftragsnummer...............: 0
........Erstellungsdatum..................: 2006-08-16
........Erstellungszeitpunkt..................: 08:05
........Lieferungsdatum..................: 2006-08-30
........Lieferungszeitpunkt..................: 08:04
........Aktivierungsdatum................: 2006-08-31
........Aktivierungszeitpunkt................: 08:04
Kapitel 3: cadsmcmd-Befehle 95
Kompatibilität
........Lieferungskalender............:
........Zeitlimit <Tage/Stunden>...........: 7 / 0
........Jobstart........................: Lokale Zeit/exakt
........Jobberechtigung.................: 2
.........................................Abbruch zulässig
........Aktion davor..................: Keine Aktion
........Aktion danach................: Keine Aktion
........Jobmaske.............: 4
.........................................Kalendergesteuert
........Benutzerparameter............:
........Jobausführungsmodus.............: 1
.........................................Ausführen
........Zeitlimit für Eingabeaufforderung <Tage/Stunden>....: 1 / 0
........Jobtask........................: 1 - install
SDCMD<A000000>: OK
Hinweis: Welche Informationen angezeigt werden, ist vom Anweisungstyp abhängig.
96 CLI-Referenzhandbuch
Kompatibilität
domain – Verwalten von Domänengruppen
Die Methoden in diesem Abschnitt sind nur mit dem Enterprise-Manager gültig.
Hinweis: Die Terminologie von CA IT Client Manager hat sich im Vergleich zu Unicenter
Software Delivery 4.0 geändert. Der SD-"Bereich" entspricht der CA ITCM-"Domäne",
während die SD-"Domäne" einer CA ITCM-Domänengruppe entspricht.
Dennoch haben sich aus Kompatibilitätsgründen die Namen für Terminologie, Befehl
und Parameter der CLI nicht geändert.
Um Mehrdeutigkeiten zu vermeiden, wird ein Bereich (eine Domäne in der Terminologie
von CA IT Client Manager) in den folgenden Abschnitten als "CA ITCM-Domäne" und
eine Domäne (eine Domänengruppe in der Terminologie von CA IT Client Manager) als
"CA ITCM-Domänengruppe" bezeichnet.
Die CA ITCM-Domänen werden vom Befehl "area" der CLI und die CA ITCMDomänengruppen vom Befehl "domain" der CLI verarbeitet.
Dieser Abschnitt enthält die folgenden Themen:
add – Hinzufügen von Domänen zu Domänengruppen (siehe Seite 97)
addSubDomains – Hinzufügen von Domänengruppen zu Domänengruppen (siehe Seite
98)
create – Erstellen von Domänen-Gruppen (siehe Seite 99)
delete – Löschen einer Domänengruppe (siehe Seite 101)
list – Auflisten von Domänen(unter)gruppen (siehe Seite 101)
listMembership – Auflisten von übergeordneten Domänengruppen (siehe Seite 104)
modify – Bearbeiten von Domänengruppenattributen (siehe Seite 105)
remove – Entfernen von Domänen aus Domänengruppen (siehe Seite 106)
removeSubdomains – Entfernen von Domänengruppen aus Domänengruppen (siehe
Seite 107)
add – Hinzufügen von Domänen zu Domänengruppen
Diese Aktion fügt einen, mehrere oder alle CA ITCM-Domänen zu einer angegebenen CA
ITCM-Domänengruppe hinzu.
Diese Aktion hat das folgende Format:
domain action=add
name=Domänenname
{area=Bereichsname | addall}
Kapitel 3: cadsmcmd-Befehle 97
Kompatibilität
Name
Gibt Folgendes an: Name einer CA ITCM-Domänengruppe, der die vom Parameter
"area" festgelegten CA ITCM-Domänen hinzugefügt werden.
area
Gibt Folgendes an: Name einer CA ITCM-Domäne, die der angegebenen CA ITCMDomänengruppe hinzugefügt werden soll.
Der Parameter kann mehrfach angegeben werden, um der Gruppe eine Liste von
CA ITCM-Domänen hinzuzufügen.
addall
Fügt der angegebenen CA ITCM-Domänengruppe alle registrierten CA ITCMDomänen hinzu.
Beispiel:
Um die Bereiche "area 1" und "area 2" der Domäne "dom f" hinzuzufügen, geben Sie
folgenden Befehl ein:
cadsmcmd domain action=add name="dom f" area="area 1" area="area 2"
Um alle definierten Bereiche der Domäne "dom f" hinzuzufügen, geben Sie folgenden
Befehl ein:
cadsmcmd domain action=add name="dom f" addall
addSubDomains – Hinzufügen von Domänengruppen zu Domänengruppen
Diese Aktion fügt der angegebenen CA ITCM-Domänengruppe CA ITCMDomänengruppen als CA ITCM-Domänengruppen hinzu.
Diese Aktion hat das folgende Format:
domain action=addSubdomains [name=Name der Domäne] {domain=Name der Domäne}
98 CLI-Referenzhandbuch
Kompatibilität
Name
Gibt Folgendes an: Name einer CA ITCM-Domänengruppe (muss bereits vorhanden
sein), der die CA ITCM-Domänengruppen hinzugefügt werden. Die Domäne muss
existieren.
Wenn dieser Parameter nicht angegeben wird, werden die CA ITCMDomänengruppen der obersten Ebene des Ordners "Domänen" hinzugefügt.
domain
Gibt Folgendes an: Name einer CA ITCM-Domänengruppe, die existieren muss und
zu einer CA ITCM-Domänenuntergruppe der mit dem Parameter "name"
angegebenen CA ITCM-Domänengruppe wird.
Der Parameter kann mehrfach angegeben werden , um eine Liste mit CA ITCMDomänengruppen hinzuzufügen.
Beispiel:
Angenommen, die Domäne "dom e" soll ebenfalls auf der obersten Ebene des Ordners
"Domänen" angezeigt werden. Mit dem folgenden Befehl wird die Domäne auf dieser
Ebene verknüpft:
cadsmcmd domain action=addSubdomains domain="dom e"
Angenommen, die Domänen "dom f" und "dom g" sollen der Domäne "dom e" als
Unterdomänen hinzugefügt werden. Mit dem folgenden Befehl werden diese Domänen
mit "dom e" verknüpft:
cadsmcmd domain action=addSubdomains name="dom e" domain="dom f" domain="dom g"
create – Erstellen von Domänen-Gruppen
Diese Aktion erstellt eine neue CA ITCM-Domänengruppe. Die CA ITCM-Domänengruppe
kann während der Erstellung mit CA ITCM-Domänen gefüllt werden.
Diese Aktion hat das folgende Format:
domain action=create name=Domänenname
[comment=Kommentar]
[{area=Bereichsname}|addAll]
[superDomain=Name der übergeordneten Domäne]
[InheritPerms[={y|n}]]
Kapitel 3: cadsmcmd-Befehle 99
Kompatibilität
Name
Gibt Folgendes an: Name einer CA ITCM-Domänengruppe. Diese wird erstellt.
comment
Gibt an: Ein Kommentar.
area
Gibt Folgendes an: Name einer CA ITCM-Domäne für die zu erstellende CA ITCMDomänengruppe.
Der Parameter kann mehrfach angegeben werden , um eine Liste mit CA ITCMDomänen hinzuzufügen.
Dieser Parameter sollte nicht verwendet werden, wenn "addAll" angegeben ist.
addAll
Hinzufügen aller registrierten CA ITCM-Domänen zu der zu erstellenden CA ITCMDomänengruppe.
Dieser Parameter sollte nicht verwendet werden, wenn der Parameter "area"
angegeben ist.
superDomain
Gibt Folgendes an: Name einer vorhandenen CA ITCM-Domänengruppe, die
möglicherweise andere CA ITCM-Domänengruppen enthält. . Die zu erstellende CA
ITCM-Domänengruppe wird zu einer Untergruppe dieser übergeordneten CA ITCMDomänengruppe.
Wenn dieser Parameter nicht angegeben wird, wird die CA ITCM-Domänengruppe
in den Ordner "Domänen" eingefügt.
inheritPerms
Dieser Parameter gibt an, ob die erstellte Gruppe Sicherheitsberechtigungen
übernimmt.
Wenn "InheritPerms" oder "InheritPerms=y" codiert ist, gibt die angegebene
Gruppe Berechtigungen an ihre Mitglieder weiter und wird zu einer
Sicherheitsgruppe.
Wenn "InheritPerms=n" codiert ist, gibt die angegebene Gruppe keine
Berechtigungen an ihre Mitglieder weiter und ist daher keine Sicherheitsgruppe.
Standard: InheritPerms=y .
Hinweis: Die Aktion "create" ermöglicht das Erstellen leerer CA ITCM-Domänengruppen,
d. h. weder "area" noch "addAll" müssen mit dem Befehl codiert werden. CA ITCMDomänen können später mit der Aktion "add (Siehe Definition auf Seite 97)" zugewiesen
werden.
100 CLI-Referenzhandbuch
Kompatibilität
Beispiel:
Angenommen, die Domäne "dom c" ist bereits vorhanden, und eine neue Domäne "dom
e" soll "dom c" als Unterdomäne hinzugefügt werden. Darüber hinaus sollen die
Bereiche "area 1" und "area 2" der Domäne "dom e" hinzugefügt werden. Mit dem
folgenden Befehl wird die Domäne "dom e" bereitgestellt:
cadsmcmd domain action=create name="dom e" area="area 1" area="area 2"
superDomain="dom c"
delete – Löschen einer Domänengruppe
Diese Aktion löscht eine CA ITCM-Domänengruppe.
Diese Aktion hat das folgende Format:
domain action=delete
name=Domänenname
Name
Gibt Folgendes an: Name einer CA ITCM-Domänengruppe, das gelöscht werden soll.
Beispiel:
Um die Domäne "dom z" zu löschen, geben Sie den folgenden Befehl ein:
cadsmcmd domain action=delete name="dom z"
list – Auflisten von Domänen(unter)gruppen
Diese Aktion zeigt eine Liste von CA ITCM-Domänen(unter)gruppen an.
Diese Aktion hat das folgende Format:
domain action=list [name=Domänenname] [recursive]
Name
Gibt Folgendes an: Name einer CA ITCM-Domänengruppe. Für diese Gruppe
werden alle CA ITCM-Domänen aufgelistet.
Wenn dieser Parameter nicht angegeben wird, werden die CA ITCMDomänengruppen aus dem obersten Ordner "Domänen" aufgelistet.
rekursiv
Die CA ITCM-Domänenuntergruppen, die in der CA ITCM-Domänengruppe des
Parameters "name" enthalten sind, werden rekursiv aufgelistet.
Kapitel 3: cadsmcmd-Befehle 101
Kompatibilität
Beispiel:
Um alle Domänen aufzulisten, geben Sie den folgenden Befehl ein:
cadsmcmd domain action=list recursive
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
Verbindung zu Manager "<Standard-Manager>" als Benutzer "<Standardbenutzer>" wird
hergestellt... OK.
Manager: myManager
Domäne: myDomain
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
------------------------------------------------------------------------------Liste der Domänen
------------------------------------------------------------------------------dom a (, Sicherheitsgruppe)
..dom b (, Sicherheitsgruppe)
....dom c (, Sicherheitsgruppe)
......dom d (, Sicherheitsgruppe)
......dom e (, Sicherheitsgruppe)
dom d (, Sicherheitsgruppe)
dom f (Kommentar, Sicherheitsgruppe)
dom g (und i2, Sicherheitsgruppe)
SDCMD<A000000>: OK
102 CLI-Referenzhandbuch
Kompatibilität
Beispiel:
Um alle Domänen auf der obersten Ebene, also im Ordner "Domänen" aufzulisten,
geben Sie folgenden Befehl ein:
cadsmcmd domain action=list
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Verbindung zu Manager "<Standardmanager>" als Benutzer "<Standardbenutzer>" wird
hergestellt ...OK.
------------------------------------------------------------------------------Liste der Domänen
------------------------------------------------------------------------------dom a (, Sicherheitsgruppe)
dom d (, Sicherheitsgruppe)
dom f (Kommentar, Sicherheitsgruppe)
dom g (und i2, Sicherheitsgruppe)
SDCMD<A000000>: OK
Beispiel:
Um alle Unterdomänen der Domäne "dom b" aufzulisten, geben Sie folgenden Befehl
ein:
cadsmcmd domain action=list name="dom b"
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Verbindung zu Manager "<Standardmanager>" als Benutzer "<Standardbenutzer>" wird
hergestellt ...OK.
------------------------------------------------------------------------------Liste der Domänen ("dom b")
------------------------------------------------------------------------------dom c (, Sicherheitsgruppe)
SDCMD<A000000>: OK
Kapitel 3: cadsmcmd-Befehle 103
Kompatibilität
Beispiel:
Um alle Unterdomänen der Domäne "dom b" rekursiv aufzulisten, geben Sie folgenden
Befehl ein:
cadsmcmd domain action=list name=" dom b" recursive
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Verbindung zu Manager "<Standardmanager>" als Benutzer "<Standardbenutzer>" wird
hergestellt ...OK.
------------------------------------------------------------------------------Liste der Domänen ("dom b")
------------------------------------------------------------------------------dom c (, Sicherheitsgruppe)
..dom d (, Sicherheitsgruppe)
..dom e (, Sicherheitsgruppe)
SDCMD<A000000>: OK
listMembership – Auflisten von übergeordneten Domänengruppen
Diese Aktion zeigt eine Liste von übergeordneten CA ITCM-Domänen an, die die
angegebene Domäne als CA ITCM-Domänenuntergruppe enthalten.
Diese Aktion hat das folgende Format:
domain action=listmembership name=Domänenname
Name
Gibt Folgendes an: Name einer CA ITCM-Domänengruppe, die existieren muss. Alle
übergeordneten CA ITCM-Gruppen, die diese Gruppe als Untergruppe enthalten,
werden aufgelistet.
104 CLI-Referenzhandbuch
Kompatibilität
Beispiel:
Um alle Domänen aufzulisten, die die Domäne "dom c" enthalten, geben Sie folgenden
Befehl ein:
cadsmcmd domain action=listMembership name=" dom c"
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
Verbindung zu Manager "<Standard-Manager>" als Benutzer "<Standardbenutzer>" wird
hergestellt... OK.
Manager: myManager
Domäne: myDomain
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
------------------------------------------------------------------------------" dom c" ist eine Unterdomäne der folgenden Domänen
------------------------------------------------------------------------------dom b
SDCMD<A000000>: OK
modify – Bearbeiten von Domänengruppenattributen
Diese Aktion bearbeitet die Attribute einer CA ITCM-Domänengruppe.
Diese Aktion hat das folgende Format:
domain action=modify name=Domänenname
[newName=neuer_Domänenname]
[InheritPerms[={y|n}]]
[comment=Kommentar]
Kapitel 3: cadsmcmd-Befehle 105
Kompatibilität
inheritPerms
Dieser optionale Parameter gibt an, ob die geänderte Gruppe eine
Sicherheitsgruppe ist.
Wenn "InheritPerms=n" codiert ist, gibt die angegebene Gruppe keine
Berechtigungen an ihre Mitglieder weiter und ist daher keine Sicherheitsgruppe
mehr.
Wenn "InheritPerms" oder "InheritPerms=y" codiert ist, gibt die angegebene
Gruppe Berechtigungen an ihre Mitglieder weiter und wird daher zu einer
Sicherheitsgruppe.
Wenn der Parameter nicht codiert ist, werden die BerechtigungsübernahmeEinstellungen der Gruppe nicht geändert.
Name
Gibt Folgendes an: Name einer CA ITCM-Domänengruppe, der geändert werden
soll.
newName
Gibt Folgendes an: Neuer Name der CA ITCM-Domänengruppe.
comment
Gibt an: Ein Kommentar.
Hinweis: Geben Sie eine leere Zeichenfolge ein (""), um einen vorhandenen
Kommentar zu löschen.
Beispiel:
Die Domäne "dom g" soll auf folgende Weise geändert werden:
■
Der neue Name der Domäne ist "dom z".
■
Der Kommentar lautet "I've been modified"
Diese Änderungen werden mit Hilfe des folgenden Befehls durchgeführt:
cadsmcmd domain action=modify name="dom g" newName="dom z" comment="I've been
modified"
remove – Entfernen von Domänen aus Domänengruppen
Diese Aktion entfernt eine oder mehrere Domänen aus einer angegebenen CA ITCMDomänengruppe.
Diese Aktion hat das folgende Format:
domain action=remove name=Domänenname
{area=Bereichsname}
106 CLI-Referenzhandbuch
Kompatibilität
Name
Gibt Folgendes an: Name einer CA ITCM-Domänengruppe, aus der die vom
Parameter "area" festgelegten CA ITCM-Domänen entfernt werden.
area
Gibt Folgendes an: Name einer CA ITCM-Domäne, die aus der angegebenen CA
ITCM-Domänengruppe entfernt wird.
Der Parameter kann mehrfach angegeben werden, um eine Liste von CA ITCMDomänen aus der Gruppe zu entfernen.
Beispiel:
Um die Bereiche "area 3" und "area 4" aus der Domäne "dom f" zu entfernen, geben Sie
folgenden Befehl ein:
cadsmcmd domain action=remove name="dom f" area="area 3" area="area 4"
removeSubdomains – Entfernen von Domänengruppen aus Domänengruppen
Diese Aktion entfernt CA ITCM-Domänengruppen als CA ITCM-Domänengruppen aus
der angegebenen CA ITCM-Domänengruppe.
Diese Aktion hat das folgende Format:
domain action=removeSubdomains [name=Domänenname}]
{domain=Domänenname}
Name
Gibt Folgendes an: Name einer CA ITCM-Domänengruppe, die vorhanden sein muss
und aus der die CA ITCM-Domänenuntergruppen entfernt werden.
Wenn dieser Parameter nicht angegeben wird, werden die CA ITCMDomänenuntergruppen aus dem obersten Ordner "Domänen" entfernt.
Kapitel 3: cadsmcmd-Befehle 107
Kompatibilität
domain
Gibt Folgendes an: Name einer CA ITCM-Domänengruppe, die vorhanden sein muss
und die als CA ITCM-Domänenuntergruppe aus der im Parameter "name"
festgelegten CA ITCM-Domänengruppe entfernt wird.
Der Parameter kann mehrfach angegeben werden , um eine Liste mit CA ITCMDomänenuntergruppen zu entfernen.
Hinweis: Eine Liste zu entfernen, bedeutet nicht zwangsläufig, dass die zu entfernende
CA ITCM-Domänenuntergruppe gelöscht wird. Sie wird lediglich aus einer Liste von CA
ITCM-Domänenuntergruppen entfernt, die der angegebenen übergeordneten CA ITCMDomänengruppe zugeordnet sind.
Wenn eine CA ITCM-Domänenuntergruppe "A" aus einer CA ITCM-Domänengruppe "B"
entfernt wird, und wenn "B" die einzige übergeordnete Gruppe ist, die "A" enthält, dann
schlägt das Entfernen fehl. "B" kann nur gelöscht werden.
Beispiel 1:
Angenommen, die Domänen "dom f" und "dom g" sollen als Unterdomänen aus der
Domäne "dom e"entfernt werden. Mit dem folgenden Befehl wird die Verknüpfung
dieser Domänen mit "dom e" entfernt:
cadsmcmd domain action=removeSubdomains name="dom e" domain="dom f" domain="dom
g"
Beispiel 2:
Angenommen, die Domäne "dom e" soll ebenfalls von der obersten Ebene, also aus
dem Ordner "Domänen", entfernt werden. Mit dem folgenden Befehl wird die
Verknüpfung der Domäne mit dieser Ebene entfernt:
cadsmcmd domain action=removeSubdomains domain="dom e"
108 CLI-Referenzhandbuch
Kompatibilität
fetch – Abrufen von Elementen
Der Befehl "fetch" ist nur auf dem Enterprise-Manager zulässig.
Verwenden Sie den Befehl "fetch", um Dateien von einem CA ITCM-Domänen-Manager
oder einer Gruppe von CA ITCM-Domänen-Managern abzurufen, und speichern Sie ihn
im Abrufbereich des Enterprise-Managers.
Diese Aktion hat das folgende Format:
fetch item=Element [comment=Kommentar]
path=Pfadname
{{area=Bereichsname} | {domain=Domänenname} | toAllAreas}
[cname=Name]
[sendTime=JJJJ-MM-TT HH:MM]
[haltTime=JJJJ-MM-TT HH:MM]
area
Gibt den Namen einer CA ITCM-Domäne an, von der die Elemente abgerufen
werden.
Dieser Parameter kann mehrfach angegeben werden, um eine Liste von CA ITCMDomänen zu adressieren.
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.
comment
Gibt an: Ein Kommentar mit einer Beschreibung der abgerufenen Elemente.
domain
Gibt Folgendes an: Name von einer oder mehreren CA ITCM-Domänengruppen, von
denen die Elemente abgerufen werden
Dieser Parameter kann mehrfach angegeben werden, um eine Liste von CA ITCMDomänengruppen zu adressieren.
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.
Kapitel 3: cadsmcmd-Befehle 109
Kompatibilität
item
Gibt Folgendes an: Name des Elementse, die von den Ziel-CA ITCM-DomänenManagern abgerufen werden sollen.
path
Gibt Folgendes an: Pfad zu den abzurufenden Elementen
Der angegebene Pfadname ist der, der auf den Ziel-CA ITCM-Domänen-Managern
angegeben ist.
Er muss gemäß Konventionen des Betriebssystems angegeben werden.
Wenn Sie Daten von einem CA ITCM-Domänen-Manager abrufen, verwendet der
Befehl "fetch" den Parameter "path", um anzugeben, was von dem DomänenManager abgerufen werden soll.
Zur Vereinfachung der Verwendung kann der Pfad vom System oder dem Benutzer
definierte Umgebungsvariablen oder die Konfigurationsdateien von SD enthalten.
(Detaillierte Informationen finden Sie in der DSM Explorer-Hilfe).
In SD müssen diese Umgebungsvariablen in Prozentzeichen "%" eingeschlossen
sein.
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.
toAllAreas
Wenn dieser Parameter angegeben ist, wird die zugehörige Verteilung an alle CA
ITCM-Domänen gesendet, die beim Enterprise-Manager registriert sind.
Verwendung des %-Zeichens
Angenommen, sowohl auf dem Enterprise-Manager als auch auf dem DomänenManager ist die Umgebungsvariable "%SAMPLES%" definiert. Auf dem Enterprise-Server
verweist sie jedoch auf "C:\Stichproben", während sie auf dem Domänen-Manager auf
"G:\Beispiele" verweist.
Es sollen alle Textdateien abgerufen werden. Wenn Sie an der Windows-Befehlseingabe
den folgenden Befehl eingeben
cadsmcmd fetch item=sample path=%SAMPLE%\*.txt area=domain_manager
führt dies zu einem Fehler oder zu unerwarteten Ergebnissen. Da "SAMPLES" auf dem
Enterprise-Manager definiert ist, wird die Variable von der Eingabeaufforderung
aufgelöst und "cadsmcmd" mit dem folgenden Pfadparameter gestartet:
path=C:\Stichproben\*.txt
110 CLI-Referenzhandbuch
Kompatibilität
Um die Auflösung der Variable durch die Windows-Eingabeaufforderung zu verhindern,
muss das Prozentzeichen von der Interpretation durch die Befehlseingabe
ausgeschlossen werden. Stellen Sie dem Prozentzeichen zu diesem Zweck ein CaretZeichen "^" voran.
Somit werden in dem folgenden Aufruf alle Parameter unverändert durch die
Eingabeaufforderung an "cadsmcmd" weitergeleitet, und die Umgebungsvariable
"SAMPLES" wird auf der Site des Domänen-Managers aufgelöst:
cadsmcmd fetch item=samples path=^%SAMPLES^%\*.txt area=domain_manager
Beispiel
Im folgenden Beispiel wird erläutert, wie der Befehl "fetch" zum Abrufen von "Software
TestC" von einem Windows-Domänen-Manager verwendet werden kann.
cadsmcmd fetch item="Software TestC" comment="Fetches Software TestC"
path=c:\test\swtest3 area=N_LOCAL_SRV cname=TestCont8
sendtime="2006-03-07 22:15" halttime="2006-03-08 03:30"
Das folgende fetch-Beispiel ist identisch mit dem vorherigen, mit dem Unterschied, das
Umgebungsvariablen verwendet werden, um den Pfad anzugeben.
cadsmcmd fetch item="Software TestC" comment="Fetches Software TestC"
path=%FETCHSW%\*.exe area=N_LOCAL_SRV cname=FetchContainer
sendtime="2006-03-07 22:15" halttime="2006-03-08 03:30"
halt – Anhalten einer aktiven Verteilung
Der Befehl "halt" ist nur gültig, wenn er von der Befehlszeile des Enterprise-Managers
ausgegeben wird.
halt wird verwendet, um eine aktive Verteilung anzuhalten. Die Verteilung kann später
gelöscht oder wiederaufgenommen werden.
Dieser Befehl hat das folgende Format:
halt name=Jobcontainername
Name
Gibt Folgendes an: Name des Jobcontainers, der angehalten werden soll.
Kapitel 3: cadsmcmd-Befehle 111
Kompatibilität
Beispiel:
Beispiel für Anhalten:
cadsmcmd halt name=Testcont11
Um den Status der Anhalteanforderung anzuzeigen, geben Sie folgenden Befehl ein:
cadsmcmd progress name=TestCont11
Durch diesen Befehl wird ein Status ausgegeben, der folgendem ähnelt:
Verteilungsname: TestCont11, Status - Wird angehalten.
SendDateTime: 2003/03/05 17:41, InstallDateTime: 2003/03/05 17:41,
HaltDateTime: 2003/03/05 17:42
Gesamtzahl der Bereiche: 2, Warten: 0, Aktiv: 1, mit Fehler: 0, OK: 1.
Bereich: N_LOCAL_SRV at Downtown 100 % gesendet. Status - Aktiv.
Bereich: N_LOCAL_SRV_02 at Rural Area 0 % gesendet. Status - Aktiv.
SDCMD<A000000>: OK
image – Verwalten von BS-Images
Dieser Abschnitt enthält die folgenden Themen:
assignToTargets – Zuweisen von BS-Images zu Zielen (siehe Seite 112)
delete – Löschen von Images aus der OSIM-Datenbank (siehe Seite 114)
list – Auflisten der beim OSIM-Manager registrierten Images (siehe Seite 115)
listDeployed – Auflisten von Boot-Servern, auf denen ein OSIM-Image bereitgestellt
wurde (siehe Seite 116)
listConfigs – Auflisten von Zielen und Konfigurationen eines BS-Images (siehe Seite 117)
modify – Ändern des OSIM-Images (siehe Seite 118)
deploy – Bereitstellen von OSIM-Images auf Boot-Servern (siehe Seite 119)
remove – Entfernen von OSIM-Images von Boot-Servern (siehe Seite 122)
assignToTargets – Zuweisen von BS-Images zu Zielen
Diese Aktion weist das angegebene Image einer Liste von Zielen zu und erstellt für die
Ziele neue geplante Konfigurationen mit diesem Image oder ändert die möglicherweise
bereits vorhandenen Konfigurationen.
Die Syntax der Aktion lautet folgendermaßen:
image
action=assignToTargets
name=Image-Name
{computer={Name_des_OSIM-Ziels} |
compgrp={Computergruppenname} |
ccompgrp={Computergruppenname Trennzeichen Bereich}}
112 CLI-Referenzhandbuch
Kompatibilität
Name
Gibt den Namen eines Images an, das an den angegebenen Zielen installiert werden
soll.
computer
Gibt den Namen der OSIM-Ziele an, an denen das angegebene Bild installiert
werden kann. Diese Option kann mehrfach angegeben werden, um eine Liste von
Zielen anzusprechen. Die Option darf nicht zusammen mit den Optionen "compgrp"
oder "ccompgrp" codiert werden.
compgrp
Gibt den Namen einer Computergruppe an, deren Mitglieder, die von OSIM
verwaltete Systeme sind, als Ziele für das angegebene Image verwendet werden.
Diese Option kann mehrfach angegeben werden, um eine Liste von Gruppen
anzusprechen. Die Option darf nicht mit der Option "computer" codiert werden.
ccompgrp
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.
Diese Option kann mehrfach angegeben werden, um eine Liste von Gruppen
anzusprechen.
Die Option darf nicht mit der Option "computer" codiert werden.
scope
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.
sep
Gibt ein alternatives Trennzeichen für die Option "ccompgrp" an. Das Trennzeichen
darf nicht Teil des mit den ccompgrp-Optionen codierten Gruppennamens sein.
Hinweis: Nur registrierte Images können Zielen zugewiesen werden. Wenn ein Image
gefunden wird, wird nur der Fehler BMSAPI_IMAGE_DETECTED - "Das Image wurde
gefunden, ist aber nicht registriert" für dieses Image gemeldet.
Kapitel 3: cadsmcmd-Befehle 113
Kompatibilität
delete – Löschen von Images aus der OSIM-Datenbank
Diese Aktion löscht die angegebenen Images und auch die ggf. vorhandenen
zugehörigen SD-Pakete aus der OSIM-Datenbank.
Die Syntax der Aktion lautet folgendermaßen:
image
action=delete
{[images=Image-ID,...]}
[sep=Trennzeichen]
Bilder
Gibt den Namen eines Images an, das aus der OSIM-Datenbank gelöscht werden
soll. Wenn das Image aus OSIM entfernt wird, wird eine ggf. vorhandene SDRegistrierung des zugehörigen Pakets ebenfalls gelöscht. Die Option kann mehrfach
codiert werden, um eine Liste anzugeben.
Die Image-ID besitzt die folgende Struktur:
{«Image-Name» | («Image-Name»«Trennzeichen»{bootImage | osImage})}
Wenn weder bootImage noch osImage codiert ist, wird osImage angenommen. Das
Trennzeichen ist standardmäßig ein Punkt (.), es kann jedoch mit dem Argument
"sep" neu definiert werden. Das Trennzeichen darf in den Image-Namen nicht
vorkommen.
sep
Gibt ein alternatives Trennzeichen für die Image-IDs an. Das Trennzeichen darf nicht
Teil der Image-Namen sein.
Hinweis: Sie sollten Folgendes beachten:
■
Ein BS-Image wird nicht gelöscht, wenn es einer OSIM-Konfiguration zugewiesen ist.
Der Fehler BMSAPI_IMAGE_INUSE – "Das Image wird noch verwendet" wird
gemeldet. Verwenden Sie die Aktion "listConfigs", um zu ermitteln, in welchen
Konfigurationen es verwendet wird.
Boot-Images werden in jedem Fall gelöscht.
114 CLI-Referenzhandbuch
■
Der Löschvorgang prüft nicht, ob ein Image auf einem Boot-Server bereitgestellt
wurde. Wenn es bereitgestellt wurde, wird es später als gefunden gemeldet.
■
Zum Löschen eines Images benötigt der aktuelle Benutzer, der Eigentümer der
Sitzung ist, Löschberechtigungen für dieses Image.
Kompatibilität
list – Auflisten der beim OSIM-Manager registrierten Images
Die Aktion "list" erstellt eine Liste der Boot- und BS-Images, die derzeit beim OSIMManager registriert sind.
Die Syntax der Aktion lautet folgendermaßen:
image
action=list
[name=Image-Name]
[{bootImage | osImage}]
[detailed]
Name
Gibt einen Image-Namen an. Nur die Bilder, die dem angegebenen Namen
entsprechen, werden aufgelistet.
Wenn diese Option nicht codiert ist, wird keine Namensprüfung ausgeführt.
{bootImage | osImage}
Wenn bootImage codiert ist, müssen die gemeldeten Images Boot-Images sein,
wenn nur osImage codiert ist, müssen die gemeldeten Images BS-Images sein, und
wenn keine dieser Optionen codiert ist, werden beide Image-Typen gemeldet.
detailed
Wenn diese Option codiert ist, werden auch die Standardeinstellungen für die BootParameter aufgelistet.
Der Befehl gibt auf stdout eine Ausgabeliste mit dem folgenden Format aus:
-----------------------------------------------------------------[Detailed] Liste der Images [({bootImage|osImage})]
[Name: <Name>]
-----------------------------------------------------------------Image-Name....................: «Name von Image 1»
...Image-Typ.................: {Boot-Image | BS-Image («BS-Typ»)}
...Status.....................: (registriert | gefunden}
...Image-FIPS-Tauglichkeit......: (konform | nicht konform)
...SD-Paketname............: «SD-Paketname des Images»
...SD-Paketversion.........: «SD-Paketversion des Images»
...SD-Paketkommentar.........: «mit dem Paket gespeicherter Kommentar»
[...Gebietsschema....................: «Gebietsschema des Images»
...Batch-Datei.................: «Name der Batch-Datei»]
...Boot-Image-Typ unterstützen....: <<Boot-Image-Typ und Boot-Server-Modus
unterstützen>>
[...Parameter
......<Name von Parameter 1>.......: «Standardeinstellung für Parameter 1»
..........................
..........................
Kapitel 3: cadsmcmd-Befehle 115
Kompatibilität
..........................]
......<Name von Parameter m>........: «Standardeinstellung für Parameter m»
..........................
..........................
..........................]
Image-Name....................: «Name von Image n»
..........................
..........................
..........................
Die in Klammern stehenden Informationen sind nur für BS-Images verfügbar. Außerdem
werden die Informationen zu Parametern nur dann ausgegeben, wenn "detailed"
codiert ist. Wenn der Status "gefunden" lautet, werden alle nachfolgenden
Informationen übersprungen.
listDeployed – Auflisten von Boot-Servern, auf denen ein OSIM-Image bereitgestellt wurde
Diese Aktion erstellt eine Liste der Boot-Server, auf denen das angegebene Boot- oder
BS-Image bereitgestellt wurde.
Die Syntax der Aktion lautet folgendermaßen:
image
action=listDeployed
name=Name_eines_Images
[{bootImage | osImage}]
Name
Gibt den Namen eines Images an, für das alle Boot-Server aufgelistet werden, auf
denen es bereitgestellt wurde.
{bootImage | osImage}
Diese Optionen geben an, ob das betreffende Image ein Boot- oder ein BS-Image
ist. Wenn "bootImage" codiert ist, wird von einem Boot-Image ausgegangen.
Anderenfalls wird von einem BS-Image ausgegangen.
116 CLI-Referenzhandbuch
Kompatibilität
Die angegebene Liste besitzt das folgende Format:
----------------------------------------------------------Liste der Boot-Server, auf denen («Image-Name»,{boot|os}image) bereitgestellt
wurde
----------------------------------------------------------Image-Name......................................: «Image-Name»
..Image-Typ....................................: {Boot-Image | BS-Image}
..Status........................................: {registriert | gefunden}
..Boot-Server-Name..............................: «Name von Boot-Server 1»
.........
.........
.........
................................................: «Name von Boot-Server m»
.........
.........
.........
listConfigs – Auflisten von Zielen und Konfigurationen eines BS-Images
Diese Aktion erstellt eine Liste der Ziele, die dem angegebenen Image zugeordnet sind,
und deren Konfigurationen.
Die Syntax der Aktion lautet folgendermaßen:
image
action=listConfigs
name=Image-Name
Name
Diese Option gibt den Namen eines BS-Images an, für das alle Ziele und
Konfigurationen aufgelistet sind, mit denen das Image verknüpft ist.
Die angegebene Liste besitzt das folgende Format:
----------------------------------------------------------Liste der Konfigurationen
----------------------------------------------------------Image-Name..............................: «Name von BS-Image 1»
..Zielname...........................: «Name von OSIM-Ziel 1»
....Konfigurationstyp..................: {geplant | zeitgeplant |
..........................................aktuell}
[....Status ............................: {aktiviert|wird analysiert|
...........................................ausstehend|wird installiert|
...........................................Fehler|ausstehende abbrechen|
...........................................beendet}]
....•
Kapitel 3: cadsmcmd-Befehle 117
Kompatibilität
....•
....Konfigurationstyp..................: {geplant | zeitgeplant |
...........................................aktuell}
[...Status..............................: {aktiviert|wird analysiert|
...........................................ausstehend|wird installiert|
...........................................Fehler|ausstehende abbrechen|
...........................................beendet}]
..•
..•
..•
..Zielname...........................:«Name von OSIM-Ziel n»
....Konfigurationstyp..................: {geplant | zeitgeplant |
...........................................aktuell}
..•
..•
..•
Der Statusblock und das Fälligkeitsdatum werden nur dann ausgegeben, wenn der
Konfigurationstyp "zeitgeplant" ist.
modify – Ändern des OSIM-Images
Diese Aktion ändert die Standardeinstellungen eines Parameters für das angegebene
Image.
Die Syntax der Aktion lautet folgendermaßen:
image
action=modify
name=Image-Name
paramName=Parametername
paramValue=neue_Standardeinstellung
Name
Gibt den Namen des Images an, zu dem der Parameter gehört, dessen
Standardeinstellung geändert wird.
paramName
Gibt den Namen des Parameters an, dessen Standardeinstellung geändert wird.
Die Standardeinstellungen für die folgenden Parameter können nicht geändert
werden:
118 CLI-Referenzhandbuch
■
BatchFile
■
HostName
■
MACAddress
■
OSImage
Kompatibilität
paramValue
Gibt die neue Standardeinstellung an.
Hinweis: Sie sollten Folgendes beachten:
■
Eine Standardeinstellung kann nur geändert werden, solange das Image noch
keinem Zielsystem zugewiesen ist.
■
Der aktuelle Benutzer, der Eigentümer der Sitzung ist, benötigt
Änderungsberechtigungen für ein Image, um dessen Standardeinstellung zu ändern.
■
Sie können Einstellungen entfernen, indem Sie eine leere Zeichenfolge eingeben.
deploy – Bereitstellen von OSIM-Images auf Boot-Servern
Diese Aktion stellt die angegebenen Images auf den angegebenen Boot-Servern bereit.
Mit "cadsmcmd" werden SD-Installationsanforderungen erstellt, um die Images auf dem
Boot-Server bereitzustellen. Der verwendete Jobcontainer sowie die erstellten
Installationsanforderungen und deren Zuordnung zu den Images werden auf stdout
gemeldet.
Die Syntax der Aktion lautet folgendermaßen:
image
action=deploy
{images=Image-ID, ...}
[sep=Trennzeichen]
[procedure=Boot-Server-Prozedur der Bereitstellung durch Staging]
{bootServers=Boot-Server-Name, ...}
[cname=Name_des_verwendeten_Jobcontainers]
[{noLinkage | transaction [rollback] [noCascade]| synchronized [noCascade]}]
[jcPriotrity=Jobcontainer-Priorität]
[unsealed]
[atTime=JJJJ-MM-TT hh:mm]
[deliveryTime=JJJJ-MM-TT hh:mm]
[calendarName=Name_des_Lieferungskalenders]
Kapitel 3: cadsmcmd-Befehle 119
Kompatibilität
Bilder
Gibt den Namen eines Images an, das auf den angegebenen Boot-Servern
bereitgestellt werden soll. Die Option kann mehrfach codiert werden, um eine Liste
von Images anzugeben.
Die Image-ID besitzt die folgende Struktur:
{«Image-Name» |
(«Image-Name»«Trennzeichen»{bootImage | osImage})}
Wenn weder "bootImage" noch "osImage" codiert ist, wird "osImage"
angenommen.
Das Trennzeichen ist standardmäßig ein Punkt (.), es kann jedoch mit dem
Argument "sep" neu definiert werden. Das Trennzeichen darf in den Image-Namen
nicht vorkommen.
sep
Gibt ein alternatives Trennzeichen für die Image-IDs an. Das Trennzeichen darf nicht
Teil der Image-Namen sein.
Prozedur
Dieser Parameter gibt die von SD zur Installation des Images auf den angegebenen
Boot-Servern verwendete Prozedur an. Die Standardprozedur ist für BS-Images
"Zum Boot-Server hinzufügen" und für Boot-Images "Boot-Image erstellen".
bootServers
Gibt einen Boot-Server an, auf dem die Image-Liste bereitgestellt wird. Diese Option
kann mehrfach codiert werden, um eine Liste von Boot-Servern anzugeben.
cname
Diese Option gibt den Namen des Jobcontainers an, der zum Bereitstellen der
erforderlichen Images durch Staging verwendet wird. Wenn der Container nicht
vorhanden ist, wird er gemäß den angegebenen Attributen erstellt. Wenn er bereits
vorhanden ist, muss seine Versiegelung aufgehoben werden, da bei der Ausführung
der Aktion anderenfalls ein Fehler auftritt. Die Attribute eines vorhandenen
Containers werden nicht geändert.
noLinkage
Das Ergebnis eines Jobs besitzt keine Auswirkungen auf die Ausführung der anderen
Jobs.
(Standard)
120 CLI-Referenzhandbuch
Kompatibilität
Transaktion
Die Jobs des Containers werden der Reihe nach verarbeitet. Sobald ein Job für ein
Ziel fehlschlägt, werden für dieses Ziel keine nachfolgenden Jobs des Containers
mehr verarbeitet.
synchronisiert
Die Jobs des Containers werden der Reihe nach verarbeitet. Sobald ein Job für ein
beliebiges Ziel fehlschlägt, werden für kein Ziel mehr nachfolgende Jobs des
Containers verarbeitet.
Rollback
Sobald ein Job des Containers fehlschlägt, wird für das betreffende Ziel für alle
verarbeiteten Jobs des Containers ein Rollback ausgeführt, soweit die Jobs dies
zulassen.
noCascade
Die Abhängigkeiten der Jobs werden während der Container-Evaluierung nicht
aufgelöst.
jcPriotrity
Gibt die Priorität des Jobcontainers an. 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.
unsealed
Der Jobcontainer bleibt unversiegelt, nachdem die generierten Jobs erfolgreich
erstellt wurden.
atTime
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. Wenn diese
Option nicht codiert ist, werden das aktuelle Datum und die aktuelle Uhrzeit
verwendet.
deliveryTime
Gibt die Startzeit der Lieferung vom Domänen-Manager an.
Das Datum wird im ISO-Format "JJJJ-MM-TT HH:MM" angegeben. Wenn diese
Option nicht codiert ist, werden das aktuelle Datum und die aktuelle Uhrzeit
verwendet.
calendarName
Gibt den Namen des Kalenders an, mit dem der Zeitraum bestimmt wird, in dem die
Evaluierung ausgeführt werden kann.
Kapitel 3: cadsmcmd-Befehle 121
Kompatibilität
Ausgabe
Der Befehl gibt auf stdout Folgendes aus:
The commandFollowing job container used for staging: "«Jobcontainername»"
«Image-Name 1» - "«Element 1»;«Version 1»;«Prozedur 1»": «Rückgabe-Code»
.........................
.........................
.........................
«Image-Name n» - "«Element n»;«Version n»;«Prozedur n»": «Rückgabe-Code»
Hinweis: Hierfür ist es erforderlich, dass das Image in SD und in OSIM registriert ist und
dass die OSIM-Registrierung korrekt auf die SD-Registrierung verweist. Wenn die
Referenz nicht gefunden wird oder ungültig ist, zeichnet die Funktion das Problem mit
der folgenden Meldung auf:
SDCMD<A000101> Software ist nicht vorhanden. (<<Produktname>> <<Produktversion>> - <Prozedur> - <Prozedurtyp>)
remove – Entfernen von OSIM-Images von Boot-Servern
Diese Aktion entfernt die angegebenen Images von den angegebenen Boot-Servern. Mit
"cadsmcmd" werden SD-Deinstallationsanforderungen erstellt, um die Images auf dem
Boot-Server zu löschen. Der verwendete Jobcontainer sowie die erstellten
Deinstallationsanforderungen und deren Zuordnung zu den Images werden auf stdout
gemeldet und ermöglichen die Überwachung des Löschfortschritts mit Hilfe von SDMethoden.
Die Syntax der Aktion lautet folgendermaßen:
image
action=remove
{images=Image-ID, ...}
[sep=Trennzeichen]
[procedure=Boot-Server-Prozedur der Bereitstellung durch Staging]
{bootServers=Boot-Server-Name, ...}
[cname=Name_des_verwendeten_Jobcontainers]
[{noLinkage | transaction [rollback] [noCascade]| synchronized [noCascade]}]
[jcPriotrity=Jobcontainer-Priorität]
[unsealed]
[atTime=JJJJ-MM-TT hh:mm]
[deliveryTime=JJJJ-MM-TT hh:mm]
[calendarName=Name_des_Lieferungskalenders]
122 CLI-Referenzhandbuch
Kompatibilität
Bilder
Gibt den Namen eines Images an, das von den angegebenen Boot-Servern entfernt
werden soll. Die Option kann mehrfach codiert werden, um eine Liste von Images
anzugeben.
Die Image-ID besitzt die folgende Struktur:
{«Image-Name» |
(«Image-Name»«Trennzeichen»{bootImage | osImage})}
Wenn weder "bootImage" noch "osImage" codiert ist, wird "osImage"
angenommen. Das Trennzeichen ist standardmäßig ein Punkt (.), es kann jedoch mit
dem Argument "sep" neu definiert werden. Das Trennzeichen darf in den ImageNamen nicht vorkommen.
sep
Gibt ein alternatives Trennzeichen für die Image-IDs an. Das Trennzeichen darf nicht
Teil der Image-Namen sein.
Prozedur
Dieser Parameter gibt die von SD zum Entfernen des Images von den angegebenen
Boot-Servern verwendete Prozedur an. Die Standardprozedur ist für BS-Images
"Remove from BootServer" und für Boot-Images "Remove Boot Image". Diese
Standardnamen sind nicht lokalisierbar.
bootServers
Gibt einen Boot-Server an, von dem die Image-Liste entfernt wird. Diese Option
kann mehrfach angegeben werden, um Listen von Boot-Servern zuzulassen.
cname
Diese Option gibt den Namen des Jobcontainers an, der zum Bereitstellen der
erforderlichen Images durch Staging verwendet wird. Wenn der Container nicht
vorhanden ist, wird er gemäß den angegebenen Attributen erstellt. Wenn er bereits
vorhanden ist, muss seine Versiegelung aufgehoben werden, da bei der Ausführung
der Aktion anderenfalls ein Fehler auftritt. Die Attribute eines vorhandenen
Containers werden nicht geändert.
noLinkage
Das Ergebnis eines Jobs besitzt keine Auswirkungen auf die Ausführung der anderen
Jobs.
(Standard)
Transaktion
Die Jobs des Containers werden der Reihe nach verarbeitet. Sobald ein Job für ein
Ziel fehlschlägt, werden für dieses Ziel keine nachfolgenden Jobs des Containers
mehr verarbeitet.
Kapitel 3: cadsmcmd-Befehle 123
Kompatibilität
synchronisiert
Die Jobs des Containers werden der Reihe nach verarbeitet. Sobald ein Job für ein
beliebiges Ziel fehlschlägt, werden für kein Ziel mehr nachfolgende Jobs des
Containers verarbeitet.
Rollback
Sobald ein Job des Containers fehlschlägt, wird für das betreffende Ziel für alle
verarbeiteten Jobs des Containers ein Rollback ausgeführt, soweit die Jobs dies
zulassen.
noCascade
Die Abhängigkeiten der Jobs werden während der Container-Evaluierung nicht
aufgelöst.
jcPriotrity
Gibt die Priorität des Jobcontainers an. 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.
unsealed
Der Jobcontainer bleibt unversiegelt, nachdem die generierten Jobs erfolgreich
erstellt wurden.
atTime
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. Wenn diese
Option nicht codiert ist, werden das aktuelle Datum und die aktuelle Uhrzeit
verwendet.
deliveryTime
Gibt die Startzeit der Lieferung vom Domänen-Manager an.
Das Datum wird im ISO-Format "JJJJ-MM-TT HH:MM" angegeben. Wenn diese
Option nicht codiert ist, werden das aktuelle Datum und die aktuelle Uhrzeit
verwendet.
calendarName
Gibt den Namen des Kalenders an, mit dem der Zeitraum bestimmt wird, in dem die
Evaluierung ausgeführt werden kann.
124 CLI-Referenzhandbuch
Kompatibilität
Ausgabe
Der Befehl gibt auf stdout Folgendes aus:
Following job container used for removing: "«Jobcontainername»"
«Image-Name 1» - "«Element 1»;«Version 1»;«Prozedur 1»": «Rückgabe-Code»
.........................
.........................
.........................
«Image-Name n» - "«Element n»;«Version n»;«Prozedur n»": «Rückgabe-Code»
Hinweis: Hierfür ist es erforderlich, dass das Image in SD und in OSIM registriert ist und
dass die OSIM-Registrierung korrekt auf die SD-Registrierung verweist. Wenn die
Referenz nicht gefunden wird oder ungültig ist, zeichnet die Funktion das Problem mit
der folgenden Meldung auf:
SDCMD<A000101> Software ist nicht vorhanden. (<<Produktname>> <<Produktversion>> - <Prozedur> - <Prozedurtyp>)
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}
Kapitel 3: cadsmcmd-Befehle 125
Kompatibilität
[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}|boota
fter}]
[{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]
126 CLI-Referenzhandbuch
Kompatibilität
[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}|boota
fter}]
[{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.
Kapitel 3: cadsmcmd-Befehle 127
Kompatibilität
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 ITCMDomä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.
128 CLI-Referenzhandbuch
Kompatibilität
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.
Kapitel 3: cadsmcmd-Befehle 129
Kompatibilität
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 ITCMDomä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änenManagers.
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.
130 CLI-Referenzhandbuch
Kompatibilität
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.
Kapitel 3: cadsmcmd-Befehle 131
Kompatibilität
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.
132 CLI-Referenzhandbuch
Kompatibilität
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.
Kapitel 3: cadsmcmd-Befehle 133
Kompatibilität
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 ScalabilityServer der Zielcomputer.
Dieser Parameter bezieht sich nur auf Prozeduren des Aufgabentyps "install".
134 CLI-Referenzhandbuch
Kompatibilität
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.
Kapitel 3: cadsmcmd-Befehle 135
Kompatibilität
jobcontainer – Jobcontainer-Befehle
Alle Methoden in diesem Kapitel können nur mit dem Domänen-Manager verwendet
werden.
Ein Jobcontainer ist eine Aufgabeneinheit, in der mehrere Jobs zu einer Gruppe
zusammengefasst und mit gemeinsamen Ausführungsattributen verknüpft sind.
Dieser Abschnitt enthält die folgenden Themen:
Allgemeine Jobcontainer-Befehle (siehe Seite 136)
Jobmanagement-Befehle (siehe Seite 164)
Allgemeine Jobcontainer-Befehle
Dieser Abschnitt enthält die folgenden Themen:
activate – Aktivieren des Jobcontainers (siehe Seite 136)
create – Erstellen eines Jobcontainers (siehe Seite 137)
delete – Löschen von Jobcontainern (siehe Seite 138)
halt – Anhalten von Jobcontainern (siehe Seite 139)
list – Auflisten eines Jobcontainers (siehe Seite 139)
listFailed – Auflisten fehlgeschlagener Jobcontainer (siehe Seite 141)
listrenewals – Auflisten von Erneuerungen (siehe Seite 144)
modify – Bearbeiten von Jobcontainern (siehe Seite 145)
recover – Wiederherstellen von fehlgeschlagenen Jobs (siehe Seite 147)
renew – Erneuern von Jobcontainern (siehe Seite 153)
resume – Wiederaufnehmen abgebrochener Lieferungen des Jobcontainers (siehe Seite
159)
seal – Jobcontainer versiegeln (siehe Seite 159)
setJcPriority – Festlegen der Jobcontainer-Priorität (siehe Seite 160)
showAttr – Anzeigen der Attribute des Jobcontainers (siehe Seite 160)
unseal – Aufheben der Versiegelung eines Jobcontainers (siehe Seite 163)
activate – Aktivieren des Jobcontainers
Diese Aktion aktiviert den angegebenen Jobcontainer, der jedoch zuvor bereits evaluiert
worden sein muss.
Diese Aktion hat das folgende Format:
jobcontainer action=activate name=Jobcontainername
Name
Gibt Folgendes an: Name des Jobcontainers, das aktiviert werden soll.
136 CLI-Referenzhandbuch
Kompatibilität
Beispiel:
Angenommen, der Jobcontainer "myContainer" ist versiegelt und evaluiert. Er kann nun
ausgeführt werden. Geben Sie den folgenden Befehl ein, um die Ausführung des
Containers zu planen:
cadsmcmd jobContainer action=activate name="myContainer"
create – Erstellen eines Jobcontainers
Dieser Befehl erstellt einen leeren Jobcontainer.
Dieser Befehl hat das folgende Format:
jobcontainer action=create name=Jobcontainername
[{noLinkage|{[transaction][rollback]|synchronized}
[noCascade]}]
[jcPriority={1,...,10}]
[userMessage]
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.
Name
Gibt Folgendes an: Name des Jobcontainers, der erstellt werden soll.
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.
Rollback
Setzt die Jobverknüpfungsoption auf "Transaktion aktivieren".
Kapitel 3: cadsmcmd-Befehle 137
Kompatibilität
synchronisiert
Die Jobverknüpfungsoption wird auf "Synchronisierte Jobausführung" gesetzt.
Transaktion
Die Jobverknüpfungsoption wird auf "Batch-Jobausführung" gesetzt.
userMessage
Gibt die benutzerdefinierte Administratormeldung für einen Jobcontainer an.
Hinweis:
Die Standardeinstellung für einen Jobcontainer ist (transaction,
norollback, cascade):
■
Transaction: Eine Batch-Job-Verarbeitung, bei der die Jobs in Folge verarbeitet
werden und bei Auftreten eines Fehlers die nachfolgenden Jobs nicht verarbeitet
werden.
■
Norollback: Im Fall eines Fehlers werden die bereits verarbeiteten Jobs nicht
automatisch rückgängig gemacht.
■
Cascade: Abhängigkeiten werden zu Installationsüberlappungen aufgelöst.
Beispiel:
Angenommen, es muss ein Jobcontainer mit dem Namen "4 sample" erstellt werden.
Der Container muss die folgenden Anforderungen erfüllen:
■
Die Jobs des Containers müssen auf dem Zielcomputer in der richtigen Reihenfolge
ausgeführt werden. Wenn ein Job auf einem Zielcomputer fehlschlägt, dürfen auf
diesem keine nachfolgenden Jobs des Containers ausgeführt werden, und bereits
abgeschlossene Jobs des Containers müssen zurückgesetzt werden.
■
Wenn der Job Abhängigkeiten aufweist, werden diese nicht aufgelöst. Es dürfen
keine Überlappungen entstehen.
Geben Sie den folgenden Befehl ein, um den Jobcontainer zu erstellen:
cadsmcmd jobContainer action=create name="4 sample" transaction rollback
nocascade
delete – Löschen von Jobcontainern
Mit dieser Aktion löschen Sie den angegebenen Jobcontainer.
Diese Aktion hat das folgende Format:
jobcontainer action=delete name=Jobcontainername
Name
Gibt Folgendes an: Name des Jobcontainers, das gelöscht werden soll.
138 CLI-Referenzhandbuch
Kompatibilität
Beispiel:
Angenommen, der Jobcontainer "myContainer" ist veraltet und soll gelöscht werden.
Geben Sie den folgenden Befehl ein, um den Container zu löschen:
cadsmcmd jobContainer action=delete name="myContainer"
halt – Anhalten von Jobcontainern
Diese Aktion schließt die Lieferungen des angegebenen Jobcontainers von der
Ausführung aus.
Diese Aktion hat das folgende Format:
jobcontainer action=halt name=Jobcontainername
Name
Gibt Folgendes an: Name des Jobcontainers, der angehalten werden soll.
Hinweis: Eine Lieferung ist eine Anweisung, die ein Produkt in der Softwarebibliothek
eines Scalability-Servers speichert.
Beispiel:
Angenommen, der aktivierte Jobcontainer "myContainer" enthält Anforderungen für
Lieferungen für Scalability-Server, es ist jedoch ein Problem aufgetreten, das ein
Aussetzen der Lieferung notwendig macht.
Geben Sie den folgenden Befehl ein, um die Ausführung der Lieferungen auszusetzen:
cadsmcmd jobContainer action=halt name="myContainer"
list – Auflisten eines Jobcontainers
Mit dieser Aktion listen Sie alle erforderlichen Jobcontainer auf. Die Liste unterstützt die
Funktion "erneuerter Status". Die erste Statusinformation eines Jobcontainers ist seine
primäre Statusinformation, und die zweite stammt vom "Erneuerungsstatus".
Diese Aktion hat das folgende Format:
jobcontainer action=list
[{filter=Filter |filterfile=Dateiname}]
Kapitel 3: cadsmcmd-Befehle 139
Kompatibilität
filter
Gibt Folgendes an: Ausdruck, um die Anzahl der aufgelisteten Informationen
einzuschränken
Die folgenden Attribute können zur Erstellung elementarer Filterausdrücke
verwendet werden:
Attribut
Typ
Jobcontainernam Zeichenfolge
e
JobcontainerStatus
{created | waiting | evaluating | cascading | building | in progress | successfully
completed | failed | terminating | successfully built | build completed with failures
| warning | halt in progress | halted}
Jobcontainer{created | waiting | evaluating | cascading | building | in progress | successfully
Erneuerungstatus completed | failed | terminating | successfully built | build completed with failures
| warning | halt in progress | halted}
filterfile
Gibt Folgendes an: Name der Datei, die die Filterbefehle enthält.
Die Befehle der Datei werden auf die gleiche Weise festgelegt wie im Parameter
"Filter". Die Kapazität der Datei wird jedoch durch die Kapazität des den Befehl
ausführenden Systems begrenzt.
140 CLI-Referenzhandbuch
Kompatibilität
Beispiel:
Cadsmcmd jobcontainer action=list
Die folgenden Informationen werden ausgegeben:
------------------------------------------------------------------------------Liste der Jobcontainer
------------------------------------------------------------------------------HHHHH01B [04.02.2003 15:50:26] (erfolgreich abgeschlossen)
SD-Scalability-Server [04.02.2003 15:42:39] (fehlgeschlagen) (Verarbeitung läuft)
------------------------------------------------------------------------------Anzahl der gefundenen Jobcontainer: 2
Anzahl der angezeigten Jobcontainer: 2
Geben Sie den folgenden Befehl ein, um die Jobcontainer aufzulisten, deren Namen mit
"HH" beginnt:
cadsmcmd jobcontainer action=list filter="Job container name=HH*"
Die folgenden Informationen werden ausgegeben:
------------------------------------------------------------------------------Liste der Jobcontainer
------------------------------------------------------------------------------HHHHH01B [04.02.2003 15:50:26] (erfolgreich abgeschlossen)
------------------------------------------------------------------------------Anzahl der gefundenen Jobcontainer: 2
Anzahl der angezeigten Jobcontainer: 1
SDCMD<A000000>: OK
listFailed – Auflisten fehlgeschlagener Jobcontainer
Diese Aktion listet alle angegebenen Jobcontainer mit dem Status "Fehlgeschlagen" auf.
Die erste Statusinformation, die für einen Jobcontainer angezeigt wird, ist seine primäre
Statusinformation, und die zweite stammt vom "Erneuerungsstatus".
Diese Aktion hat das folgende Format:
jobcontainer action=listfailed
name=Jobcontainername
[{filter=Filter |filterfile=Dateiname}]
Kapitel 3: cadsmcmd-Befehle 141
Kompatibilität
Name
Gibt Folgendes an: Name des Jobcontainers, der zu evaluieren ist.
filter
Gibt den Filter für die Eingrenzung der angezeigten Jobcontainer an.
Die Attribute zur Erstellung Atomic-Filterausdrücken werden im Abschnitt list (siehe
Seite 139) aufgeführt.
filterfile
Gibt Folgendes an: Name der Datei, die die Filterbefehle enthält.
Die Befehle der Datei werden auf die gleiche Weise festgelegt wie im Parameter
"Filter". Die Kapazität der Datei wird jedoch durch die Kapazität des den Befehl
ausführenden Systems begrenzt..
142 CLI-Referenzhandbuch
Kompatibilität
Beispiel:
Geben Sie den folgenden Befehl ein, um die Liste der Container mit dem Status
"Fehlgeschlagen" anzuzeigen:
cadsmcmd jobContainer action=listFailed
Die folgenden Informationen werden ausgegeben:
------------------------------------------------------------------------------Liste der Jobcontainer
------------------------------------------------------------------------------jc_DeliveryTrace (fehlgeschlagen)
jc_DeliveryTrace_SS (fehlgeschlagen)
jc_ss_wwwww (fehlgeschlagen)
------------------------------------------------------------------------------Anzahl der gefundenen Jobcontainer:........4
Anzahl der angezeigten Jobcontainer:........3
SDCMD<A000000>: OK
Geben Sie den folgenden Befehl ein, um mit Hilfe von Filtern eine Liste der Container
mit dem Status "Fehlgeschlagen" anzuzeigen, deren Namen mit "jc_d*" beginnt:
cadsmcmd jobcontainer action=listfailed filter="Job container name=jc_D*"
Die folgenden Informationen werden ausgegeben:
------------------------------------------------------------------------------Liste der Jobcontainer
------------------------------------------------------------------------------jc_DeliveryTrace (fehlgeschlagen)
jc_DeliveryTrace_SS (fehlgeschlagen)
------------------------------------------------------------------------------Anzahl der gefundenen Jobcontainer:........4
Anzahl der angezeigten Jobcontainer:........2
SDCMD<A000000>: OK
Kapitel 3: cadsmcmd-Befehle 143
Kompatibilität
listrenewals – Auflisten von Erneuerungen
Mit Hilfe dieser Aktion können Sie die Erneuerungen eines Jobcontainers auflisten.
Diese Aktion hat das folgende Format:
jobContainer action=listRenewals
name=Jobcontainername
[{filter=Filter |filterfile=Dateiname}]
Name
Gibt Folgendes an: Name des Jobcontainers und die Erneuerungen, die aufgelistet
werden sollen.
filter
Gibt Folgendes an: Ausdruck, um die Anzahl der aufgelisteten Informationen
einzuschränken.
Die Attribute zur Erstellung Atomic-Filterausdrücken werden im Abschnitt list (siehe
Seite 139) aufgeführt.
filterfile
Gibt Folgendes an: Name der Datei, die die Filterbefehle enthält.
Die Befehle der Datei werden auf die gleiche Weise festgelegt wie im Parameter
"Filter". Die Kapazität der Datei wird jedoch durch die Kapazität des den Befehl
ausführenden Systems begrenzt..
144 CLI-Referenzhandbuch
Kompatibilität
Beispiel:
Geben Sie den folgenden Befehl ein, um alle mit dem Jobcontainer "myContainer"
verknüpften Erneuerungen aufzulisten:
cadsmcmd jobContainer action=listRenewals name="myContainer"
Die folgenden Informationen werden ausgegeben:
------------------------------------------------------------------------------Erneuerungsliste für Jobcontainer "myContainer"
------------------------------------------------------------------------------jcnto1 [12/15/2008 11:34:00 AM] (Verarbeitung läuft)
jcnto1 [12/16/2008 10:34:00 AM] (Verarbeitung läuft)
------------------------------------------------------------------------------Anzahl der gefundenen Jobcontainer: 2
Anzahl der angezeigten Jobcontainer: 2
SDCMD<A000000>: OK
Geben Sie den folgenden Befehl ein, um mit Hilfe von Filtern alle mit dem Jobcontainer
"jcnt01" verknüpften Erneuerungen aufzulisten:
cadsmcmd jobcontainer action=listrenewals name=jcnt01 filter="Job container
name=jcnt01[12/15*"
Die folgenden Informationen werden ausgegeben:
------------------------------------------------------------------------------Erneuerungsliste für Jobcontainer "jcnt01"
------------------------------------------------------------------------------jcnt01[12/15/2008 11:15:56 AM] (Fehlgeschlagen)
------------------------------------------------------------------------------Anzahl der gefundenen Jobcontainer: 2
Anzahl der angezeigten Jobcontainer: 1
SDCMD<A000000>: OK
modify – Bearbeiten von Jobcontainern
Mit dieser Aktion können Sie die Attribute eines vorhandenen, nicht versiegelten
Jobcontainers bearbeiten.
Dieser Befehl hat das folgende Format:
jobcontainer action=modify name=Jobcontainername
[newName=neuer_Jobcontainername]
[{nolinkage|transaction|synchronized}]
[rollback[={y|n}]]
[cascade[={y|n}]}]
[jcPriority={1,...,10}]
[userMessage]
Kapitel 3: cadsmcmd-Befehle 145
Kompatibilität
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.
jcPriority
Gibt Folgendes an: neue Priorität, die dem Jobcontainer 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 die Priorität nicht geändert.
Name
Gibt Folgendes an: Name des Jobcontainers, der geändert werden soll.
newName
Gibt Folgendes an: neuer Name des Jobcontainers.
noLinkage
Führt den Job unabhängig von den anderen Jobs im Container aus.
Rollback
Setzt die Jobverknüpfungsoption auf "Transaktion aktivieren".
synchronisiert
Die Jobverknüpfungsoption wird auf "Synchronisierte Jobausführung" gesetzt.
Transaktion
Die Jobverknüpfungsoption wird auf "Batch-Jobausführung" gesetzt.
userMessage
Ändert die benutzerdefinierte Administratormeldung eines Jobcontainers.
Hinweis: Um einen Jobcontainer zu ändern, heben Sie zunächst dessen Versiegelung
auf.
Wenn keiner der zugehörigen Parameter angegeben wird, bleiben die Attribute
unverändert.
146 CLI-Referenzhandbuch
Kompatibilität
Beispiel:
Angenommen, der Jobcontainer "4 sample" soll so geändert werden, dass keine
Verknüpfungen zwischen den Jobs mehr vorhanden sind. Außerdem soll der Name in
"myContainer" geändert werden. Diese Änderungen werden mit Hilfe des folgenden
Befehls durchgeführt:
cadsmcmd jobContainer action=modify name="4 sample" newName="myContainer"
nolinkage
recover – Wiederherstellen von fehlgeschlagenen Jobs
Dieser Befehl deinstalliert die fehlgeschlagenen Jobs eines angegebenen Containers und
bereinigt die Zielcomputer. Die Joboptionen des Wiederherstellungsjobs werden auf der
Grundlage der zugehörigen fehlgeschlagenen Jobs (entsprechend der Parameter und
ihrer codierten Werte) geändert. Optionen für die Parameter, die nicht kodiert werden,
bleiben für die Deinstallationsjobs unverändert.
Dieser Befehl hat das folgende Format:
jobcontainer action=recover name=Jobcontainername
[newName=neuer Containername]
[{transaction|synchronized|noLinkage}]
[rollback[={y|n}]]
[cascade[={y|n}]]
[deliveryTime=JJJJ-MM-TT HH:MM]
[atTime=JJJJ-MM-TT HH:MM]
[after={exacttime|boottime}]
[calendername=Lieferungskalender]
[preaction={reboot|logoff}]
[postaction={reboot|logoff|rebootAtEnd|logoffAtEnd|shutdownAtEnd}]
[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]
[jobTimeout=t.h]
[userMessage]
Kapitel 3: cadsmcmd-Befehle 147
Kompatibilität
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.
Dieser Parameter sollte nur angegeben werden, wenn "promptUser" bereits
aktiviert ist oder mit diesem Aufruf aktiviert wird. Anderenfalls wird diese
Einstellung ignoriert. Es wird keine Warnung angezeigt.
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.
Wenn der Parameter nicht angegeben ist, werden das aktuelle Datum und die
aktuelle Uhrzeit verwendet.
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.
148 CLI-Referenzhandbuch
Kompatibilität
deliveryTime
Gibt Folgendes an: Startzeit der Lieferung vom Domänen-Manager.
Das Datum wird im ISO-Format "JJJJ-MM-TT HH:MM" angegeben.
Wenn der Parameter nicht angegeben ist, werden das aktuelle Datum und die
aktuelle Uhrzeit verwendet.
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.
Dieser Parameter sollte nur angegeben werden, wenn "promptUser" bereits
aktiviert ist oder mit diesem Aufruf aktiviert wird. Anderenfalls wird diese
Einstellung ignoriert. Es wird keine Warnung angezeigt.
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änenManagers.
jobTimeOut
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".
Name
Gibt Folgendes an: Name des Jobcontainers, der wiederhergestellt werden soll.
newName
Gibt Folgendes an: neuer Name des Jobcontainers, der die wiederhergestellten Jobs
enthält.
Wenn dieser Parameter nicht angegeben wird, wird ein Standardcontainername
erzeugt, der folgende Form besitzt: "Recover[<Zeitstempel>] <Name des
wiederherzustellenden Containers>.
Kapitel 3: cadsmcmd-Befehle 149
Kompatibilität
noCalendar
Wenn "noCalendar" angegeben ist, wird ein möglicherweise auf dem Zielcomputer
vorhandener Kalender für die Jobausführung ignoriert.
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.
150 CLI-Referenzhandbuch
Kompatibilität
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.
prompt=d.h
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.
resolveQuery
Wertet vor Erstellung des Jobs eine möglicherweise vorhandene Abfragegruppe
aus.
Kapitel 3: cadsmcmd-Befehle 151
Kompatibilität
Rollback
Setzt die Jobverknüpfungsoption auf "Transaktion aktivieren".
Dieser Parameter sollte nur angegeben werden, wenn sich der Container bereits im
Modus Batch-Verarbeitung befindet oder durch diesen Befehl in diesen Modus
versetzt wird (Parameter "transaction").
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.
synchronisiert
Die Jobverknüpfungsoption wird auf "Synchronisierte Jobausführung" gesetzt.
Transaktion
Die Jobverknüpfungsoption wird auf "Batch-Jobausführung" gesetzt.
userMessage
Gibt die benutzerdefinierte Administratormeldung für einen Jobcontainer an.
Hinweis: Die erste "Deinstallationsprozedur" der entsprechenden Elemente wird
verwendet, um die Deinstallationsjobs für die Elemente zu generieren.
152 CLI-Referenzhandbuch
Kompatibilität
Beispiel:
Angenommen, die Verarbeitung des Jobcontainers "myContainer" ist abgeschlossen,
einige Jobs sind jedoch fehlgeschlagen. Die Probleme können nicht zeitnah behoben
werden. Aus diesem Grund sollten die verbleibenden Teile aus der fehlgeschlagenen
Ausführung auf den Zielsystemen entfernt werden. Damit die Systeme erfolgreich
wiederhergestellt werden können, müssen folgende Anforderungen erfüllt sein:
■
Der angemeldete Benutzer muss abgemeldet werden, damit die Jobs ausgeführt
werden können.
■
Während die Jobs ausgeführt werden, dürfen sich keine Benutzer bei den
Zielcomputern anmelden.
■
Nachdem der letzte Job erfolgreich abgeschlossen wurde, muss das System neu
gestartet werden.
■
Die Bereinigung erfolgt anhand der standardmäßigen Deinstallationsprozeduren.
Geben Sie den folgenden Befehl ein, um die Wiederherstellung der fehlgeschlagenen
Jobs zu planen:
cadsmcmd jobContainer action=recover name="myContainer" preaction=logoff
postaction=rebootAtEnd preventLogon
renew – Erneuern von Jobcontainern
Dieser Befehl erneuert einen fehlgeschlagenen Job des angegebenen Jobcontainers. Der
angegebene Parameter wird für alle erneuerten Jobs aktiviert. Die Joboptionen des
erneuerten Jobs werden auf der Grundlage der zugehörigen fehlgeschlagenen Jobs
(entsprechend der Parameter und ihrer codierten Werte) geändert. Optionen für die
Parameter, die nicht kodiert werden, bleiben unverändert.
Kapitel 3: cadsmcmd-Befehle 153
Kompatibilität
Dieser Befehl hat das folgende Format:
jobcontainer action=renew name=Jobcontainername
[newName=neuer Containername]
[deliverytime=JJJJ-MM-TT HH:MM ]
[attime=JJJJ-MM-TT HH:MM ]
[after={exacttime|boottime}]
[calendername=Lieferungskalender]
[preaction={none|reboot|logoff}]
[postaction={none|reboot|logoff|rebootAtEnd|logoffAtEnd|shutdownAtEnd}]
[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]
[jobTimeout=t.h]
[userMessage]
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.
Dieser Parameter sollte nur angegeben werden, wenn "promptUser" bereits
aktiviert ist oder mit diesem Aufruf aktiviert wird. Anderenfalls wird diese
Einstellung ignoriert. Es wird keine Warnung angezeigt.
154 CLI-Referenzhandbuch
Kompatibilität
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.
Wenn der Parameter nicht angegeben ist, werden das aktuelle Datum und die
aktuelle Uhrzeit verwendet.
calendarName
Gibt Folgendes an: Name des Kalenders, der die Zeit steuert, während der die
Evaluierung ausgeführt werden kann.
deliveryTime
Gibt Folgendes an: Startzeit der Lieferung vom Domänen-Manager.
Das Datum wird im ISO-Format "JJJJ-MM-TT HH:MM" angegeben.
Wenn der Parameter nicht angegeben ist, werden das aktuelle Datum und die
aktuelle Uhrzeit verwendet.
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.
Dieser Parameter sollte nur angegeben werden, wenn "promptUser" bereits
aktiviert ist oder mit diesem Aufruf aktiviert wird. Anderenfalls wird diese
Einstellung ignoriert. Es wird keine Warnung angezeigt.
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änenManagers.
jobTimeOut
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".
Kapitel 3: cadsmcmd-Befehle 155
Kompatibilität
Name
Gibt Folgendes an: Name des Jobcontainers, der erneuert werden soll, d. h. alle
seine fehlgeschlagenen Jobs werden erneuert.
newName
Gibt Folgendes an: neuer Name des Jobcontainers, der die erneuerten Jobs enthält.
Wenn dieser Parameter nicht angegeben wird, wird der alte Container verwendet.
noCalendar
Wenn "noCalendar" angegeben ist, wird ein möglicherweise auf dem Zielcomputer
vorhandener Kalender für die Jobausführung ignoriert.
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.
156 CLI-Referenzhandbuch
Kompatibilität
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.
prompt=d.h
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.
Dieser Parameter sollte nur angegeben werden, wenn "promptUser" bereits
aktiviert ist oder mit diesem Aufruf aktiviert wird. Anderenfalls wird diese
Einstellung ignoriert. 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.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert
der zugehörigen Prozedur verwendet.
Kapitel 3: cadsmcmd-Befehle 157
Kompatibilität
resolveQuery
Wertet vor Erstellung des Jobs eine möglicherweise vorhandene Abfragegruppe
aus.
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.
userMessage
Gibt die benutzerdefinierte Administratormeldung für einen erneuerten
Jobcontainer an.
Beispiel:
Angenommen, die Verarbeitung des Jobcontainers "myContainer" ist abgeschlossen,
einige Jobs sind jedoch fehlgeschlagen. Die Probleme wurden inzwischen behoben, aber
damit die Jobs erfolgreich neu geplant werden können, müssen folgende Anforderungen
erfüllt sein:
■
Der angemeldete Benutzer muss abgemeldet werden, damit die Jobs ausgeführt
werden können.
■
Während die Jobs ausgeführt werden, dürfen sich keine Benutzer bei den
Zielcomputern anmelden.
■
Nachdem der letzte Job erfolgreich abgeschlossen wurde, muss das System neu
gestartet werden.
Geben Sie den folgenden Befehl ein, um die fehlgeschlagenen Jobs neu zu planen:
cadsmcmd jobContainer action=renew name="myContainer" preaction=logoff
postaction=rebootAtEnd preventLogon
158 CLI-Referenzhandbuch
Kompatibilität
resume – Wiederaufnehmen abgebrochener Lieferungen des Jobcontainers
Diese Aktion nimmt die abgebrochenen Lieferungen des angegebenen Jobcontainers
wieder auf. Eine Lieferung ist eine Anweisung, die ein Produkt in der Staging-Bibliothek
eines Scalability-Servers speichert.
Diese Aktion hat das folgende Format:
jobcontainer action=resume name=Jobcontainername
Name
Gibt Folgendes an: Name des Jobcontainers, der wiederaufgenommen werden soll,
d. h. seine angehaltenen Lieferungen an Scalability-Server werden
wiederaufgenommen.
Beispiel:
Geben Sie den folgenden Befehl ein, um die Lieferungen des Jobcontainers
"myContainer" wiederaufzunehmen:
cadsmcmd jobContainer action=resume name="myContainer"
seal – Jobcontainer versiegeln
Diese Aktion versiegelt den angegebenen Jobcontainer.
Diese Aktion hat das folgende Format:
jobcontainer action=seal name=Jobcontainername [evaluate]
Name
Gibt Folgendes an: Name des Jobcontainers, die versiegelt werden soll.
evaluate
Der versiegelte Jobcontainer wird nur evaluiert, jedoch nicht aktiviert.
Wenn dieser Parameter nicht angegeben wird, wird der Container evaluiert und
aktiviert.
Wichtig! Der Befehl wird asynchron ausgeführt.
Beispiel:
Angenommen, der Jobcontainer "myContainer" ist gefüllt und soll versiegelt, jedoch
noch nicht zur Ausführung geplant werden. Sie versiegeln den Container mit dem
folgenden Befehl:
cadsmcmd jobContainer action=seal name="myContainer" evaluate
Kapitel 3: cadsmcmd-Befehle 159
Kompatibilität
setJcPriority – Festlegen der Jobcontainer-Priorität
Mit dieser Aktion wird die Priorität des Jobcontainers geändert, unabhängig davon, ob
er versiegelt ist.
Diese Aktion hat das folgende Format:
jobcontainer action=setJcPriority
name=Jobcontainername
jcPriority={1,...,10}
Name
Gibt Folgendes an: Name des Jobcontainers, dessen Priorität geändert werden soll.
jcPriority
Gibt Folgendes an: neue Priorität, die dem Jobcontainer zugewiesen wird.
Die angegebene Priorität muss numerisch sein, und der Wert muss größer oder
gleich 1 und kleiner oder gleich 10 sein.
showAttr – Anzeigen der Attribute des Jobcontainers
Diese Aktion zeigt alle Attribute eines ausgewählten Jobcontainers an.
Es gibt zwei Arten von Anzeigemöglichkeiten: (1) die Zielansicht (TV, target view), mit
einer zielorientierten Darstellung und (2) die Jobansicht mit einer joborientierten
Darstellung.
Diese Aktion hat das folgende Format:
jobcontainer action=showattr
name=Jobcontainername
[TV]
Name
Gibt Folgendes an: Name des Jobcontainers.
TV
Anpassung der Listenansicht:
Keine Angabe
Jobansicht
TV
Zielansicht
160 CLI-Referenzhandbuch
Kompatibilität
Beispiel:
Um die in der Beschreibung des Befehls "jobcontainer action=showattr" enthaltenen
Listen abzurufen, geben Sie folgenden Befehl für die joborientierte Anzeige ein:
cadsmcmd jobContainer action=showattr name="SD-Scalability-Server [04.02.2006
15:42:39]"
Die folgenden joborientierten Informationen werden ausgegeben:
------------------------------------------------------------------------------Attribute von Jobcontainer "SD-Scalability-Server [04.02.2005 15:42:39]" anzeigen
------------------------------------------------------------------------------Jobcontainername.....................: SD-Scalability-Server [04.02.2005
15:42:39]
Jobcontainer-Eigenschaften...............: 20
.........................................Transaktion
.........................................Überlappende Installation
Jobcontainer-Priorität:................: 5
Versiegelt.................................: Ja
Erstellt am.............................: 2006-02-04 15:42
Geändert am.............................: 2006-02-04 16:08
Anzahl der enthaltenen Objekte............: 1
Jobcontainerstatus....................: fehlgeschlagen
.........................................0 - Jobs wartend
.........................................0 - Jobs aktiv
.........................................0 - Jobs OK
.........................................1 - Jobs fehlgeschlagen
Jobcontainer-Erneuerungsstatus..............: In Bearbeitung
Jobname...............................: tstbase 1.0: Zu Bibliothek hinzufügen
..Gesamtstatus......................: ERROR
.........................................0 - Jobziele wartend
.........................................0 - Jobziele aktiv
.........................................0 - Jobziele OK
.........................................1 - Jobziele fehlgeschlagen
..Erneuerungsstatus...........................: INPROGRESS
Kapitel 3: cadsmcmd-Befehle 161
Kompatibilität
..Jobauftragsnummer.....................: 0
..Erstellt am...........................: 2006-02-04 15:42
..Aktivieren am..........................: 2006-02-04 15:42
..Statusmeldung.......................: OK
..Ziel...............................: KKKKK01A
....Task...............................: deliver
....Jobstatus..........................: DELIVERY_ERROR
....Erneuerungsstatus.........................: LIEFERUNG_ANGEFORDERT
....Task...............................: deliver
....Gestartet am.........................: 2006-02-04 15:42
....Abgeschlossen am.......................: 2006-02-04 15:46
....Erstellt am.........................: 2006-02-04 15:42
....Gesendete Daten (in %)..............: 100
....Statusmeldung.....................: DTS-Fehler: DTS-Übertragungsfehler: 447 E
E
.........................................+ (447) Externer Dateifil
.........................................+ ter <sddtaflt> konnte nicht aufgerufen
werden, interner Code=<0>, ext
.........................................+ erner Code=<4>, Fehlermeldung=<>.
....Angefordert von.........................: kkkkk01
....Typ...............................: obligatorisch
....Kommentar............................:
Zielorientierte Anzeige:
cadsmcmd jobContainer action=showattr name="SD-Scalability-Server [04.02.2006
15:42:39]" TV
Die folgenden zielorientierten Informationen werden ausgegeben:
------------------------------------------------------------------------------Attribute des Jobcontainers "SD scalability servers [04.02.2005 15:42:39]" (TV)
anzeigen
------------------------------------------------------------------------------Jobcontainername.....................: SD-Scalability-Server [04.02.2005
15:42:39]
Jobcontainer-Eigenschaften...............: 20
.........................................Transaktion
.........................................Überlappende Installation
Versiegelt.................................: Ja
Erstellt am.............................: 2006-02-04 15:42
Geändert am.............................: 2006-02-04 16:08
Anzahl der enthaltenen Objekte............: 1
Jobcontainerstatus....................: fehlgeschlagen
.........................................0 - Jobs wartend
.........................................0 - Jobs aktiv
.........................................0 - Jobs OK
.........................................1 - Jobs fehlgeschlagen
Jobcontainer-Erneuerungsstatus..............: In Bearbeitung
162 CLI-Referenzhandbuch
Kompatibilität
Ziel......................................: KKKKK01A
..Jobgesamtstatus...................: ERROR
.........................................0 - Jobziele wartend
.........................................0 - Jobziele aktiv
.........................................0 - Jobziele OK
.........................................1 - Jobziele fehlgeschlagen
..Erneuerungsstatus...........................: INPROGRESS
..Jobname.............................: tstbase 1.0: Zu Bibliothek hinzufügen
....Software...........................: tstbase 1.0
....Prozedur..........................: delivery proc
....Installationsprozedur..................: delivery proc
....Status..............................: DELIVERY_ERROR
....Erneuerungsstatus.........................: WIRD GELIEFERT
....Task...............................: deliver
....Gestartet am.........................: 2006-02-04 15:42
....Abgeschlossen am.......................: 2006-02-04 15:46
....Erstellt am.........................: 2006-02-04 15:42
....Gesendete Daten (in %)..............: 100
....Statusmeldung.....................: DTS-Fehler: DTS-Übertragungsfehler: 447 E
E
.........................................+ (447) Externer Dateifil
.........................................+ ter <sddtaflt> konnte nicht aufgerufen
werden, interner Code=<0>, ext
.........................................+ erner Code=<4>, Fehlermeldung=<>.
....Angefordert von.........................: kkkkk01
....Typ...............................: obligatorisch
....Kommentar............................:
unseal – Aufheben der Versiegelung eines Jobcontainers
Diese Aktion hebt die Versiegelung des angegebenen Jobcontainers auf.
Diese Aktion hat das folgende Format:
jobcontainer action=unseal name=Jobcontainername
Name
Gibt Folgendes an: Name des Jobcontainers, deren Versiegelung aufgehoben
werden soll.
Beispiel:
Angenommen, der Jobcontainer "myContainer" muss geändert werden, so dass seine
Versiegelung wieder aufgehoben werden muss. Geben Sie den folgenden Befehl ein, um
die Versiegelung des Containers aufzuheben:
cadsmcmd jobContainer action=unseal name="myContainer"
Kapitel 3: cadsmcmd-Befehle 163
Kompatibilität
Jobmanagement-Befehle
Dieser Abschnitt enthält die folgenden Themen:
addJob – Job zu Jobcontainer hinzufügen (siehe Seite 164)
addDelivery – Hinzufügen von Lieferungen zum Jobcontainer (siehe Seite 174)
addUndelivery – Hinzufügen von Rückrufen zum Jobcontainer (siehe Seite 177)
listJobs – Auflisten von Jobs (siehe Seite 179)
listFailedJobs – Auflisten fehlgeschlagener Jobs (siehe Seite 186)
modfiyJob – Bearbeiten von Jobs (siehe Seite 190)
recoverJob – Wiederherstellen von Jobs von fehlgeschlagenem Jobcontainer (siehe Seite
196)
removeJob – Entfernen von Jobs aus dem Jobcontainer (siehe Seite 203)
renewJob – Erneuern von Jobs (siehe Seite 204)
renewTarget – Erneuern fehlgeschlagener Jobs eines bestimmten Zielcomputers (siehe
Seite 210)
repositionJobs – Ändern der Position von Jobs im Jobcontainer (siehe Seite 211)
showAttrJobs – Anzeigen von Jobattributen (siehe Seite 211)
showJobDetails – Anzeigen von Jobdetails (siehe Seite 213)
addJob – Job zu Jobcontainer hinzufügen
Dieser Befehl fügt einem vorhandenen Jobcontainer einen Job hinzu. Sie dürfen den
Jobcontainer nicht versiegeln.
Dieser Befehl hat das folgende Format:
jobcontainer action=addjob
name=Jobcontainername
{item=Elementname version=Elementversion
procedure=Prozedurname
{[task=install]
|task={configure|activate|uninstall}
[installedWith=Installationsprozedur]}
| group=Gruppenname [procedures=Datei]}
{{{compgrp=Computergruppenname | ccompgrp=(Computergruppenname Trennzeichen
groupScope)}
[sep=Trennzeichen]
|{computer=Computername}}
[deliverytime=JJJJ-MM-TT HH:MM ]
[attime=JJJJ-MM-TT HH:MM ]
[{preaction={none|reboot|logoff}|bootbefore}]
[{postaction={none|reboot|logoff|rebootAtEnd|logoffAtEnd|shutdownAtEnd}|boota
fter}]
[promptUser[={y|n}]]
[allowCancel[={y|n}]]
[execTimedOut[={y|n}]]
[offline[={y|n}]]
164 CLI-Referenzhandbuch
Kompatibilität
[runAtShutdown[={y|n}]]
[preventLogon[={y|n}]]
after={exacttime|boottime}
[calendername=Lieferungskalender]
[globalTime=y|n]
[nocalendar[={y|n}]]
[resolveQuery[={y|n}]]
[stagingServer[={y|n}]]
[parameters=Benutzerparameter]
[prompt=Tage.Stunden]]
[jobTimeOut=Tage.Stunden]
[reinstall[={y|n}]]
[userJobMessage]
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 =j" 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.
Kapitel 3: cadsmcmd-Befehle 165
Kompatibilität
atTime
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.
Wenn der Parameter nicht angegeben ist, werden das aktuelle Datum und die
aktuelle Uhrzeit verwendet.
calendarname
Gibt den Namen des Kalenders an, mit dem der Zeitraum bestimmt wird, in dem die
Evaluierung ausgeführt werden kann.
ccompgrp
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.
compgrp
Gibt den Namen einer Gruppe von Computern an, auf denen das angegebene
Produkt verarbeitet wird.
Der Parameter kann mehrfach angegeben werden, um mehrere Computergruppen
zu bestimmen.
Der Parameter muss zusammen mit dem Computerparameter angegeben werden.
computer
Gibt den Namen des Computers an, auf dem das angegebene Produkt verarbeitet
wird.
Der Parameter kann mehrfach angegeben werden, um mehrere Computer zu
bestimmen.
Der Parameter muss zusammen mit dem Parameter "compgrp" angegeben werden.
deliveryTime
Gibt Folgendes an: Startzeit der Lieferung vom Domänen-Manager.
Das Datum wird im ISO-Format "JJJJ-MM-TT HH:MM" angegeben.
Wenn der Parameter nicht angegeben ist, werden das aktuelle Datum und die
aktuelle Uhrzeit verwendet.
166 CLI-Referenzhandbuch
Kompatibilität
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änenManagers.
Gruppe
Gibt den Namen einer Software oder Prozedurgruppe an, für die die Jobs generiert
werden.
Der Parameter muss zusammen mit dem Parameter "item" angegeben werden.
installedWith
Gibt den Namen der Installationsprozedur an.
Dieser Parameter ist obligatorisch für die Tasks "configure", "activate" und
"uninstall". Anderenfalls wird sie ignoriert.
item
Gibt den Namen des zu verarbeitenden Elements an.
Dieser Parameter muss zusammen mit dem Parameter "group" angegeben werden.
jobTimeOut
Gibt das Ablaufdatum des Jobs in Form eines Zeitraums an.
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.
Kapitel 3: cadsmcmd-Befehle 167
Kompatibilität
Name
Gibt den Namen des Jobcontainers an, dem der Job hinzugefügt wird.
noCalendar
Wenn "noCalendar" angegeben ist, wird ein möglicherweise auf dem Zielcomputer
vorhandener Kalender für die Jobausführung ignoriert.
offline
Wenn "offline" oder "offline=j" 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 die Benutzerparameter für die Prozedur an.
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 an, dass notwendige Aktionen ausgeführt werden müssen, nachdem die
angegebene Prozedur abgeschlossen wurde. 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.
168 CLI-Referenzhandbuch
Kompatibilität
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 den Namen einer Prozedur an.
Verfahren
Gibt den Namen der Datei an, die die für die Softwaregruppe verwendeten
Prozeduren und/oder die einzelnen Joboptionen für die Prozeduren (Software- und
Prozedurgruppen) definiert.
Informationen zum Inhalt dieser Prozedurdatei finden Sie unter "Format der
Prozedurdatei (siehe Seite 172)".
Kapitel 3: cadsmcmd-Befehle 169
Kompatibilität
prompt
Gibt die Zeitspanne an, 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
Optional. 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: Diese Option gilt nur für Installationsjobs. In allen anderen Fällen wird sie
ignoriert.
resolveQuery
Wertet vor Erstellung des Jobs eine möglicherweise vorhandene Abfragegruppe
aus.
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.
sep
Gibt ein alternatives Trennzeichen für die Option "ccompgroup" an. Das
Trennzeichen darf nicht Teil des Gruppennamencodes für die "ccompgroup"Optionen sein.
170 CLI-Referenzhandbuch
Kompatibilität
stagingServer
Liefert das zugehörige Produkt auch an die Staging-Bibliotheken der ScalabilityServer der Zielcomputer.
Dieser Parameter bezieht sich nur auf Prozeduren des Aufgabentyps "install".
task
Gibt den Typ des von der Elementprozedur auszuführenden Tasks an.
Die folgenden Typen sind zulässig:
activate
Die Prozedur aktiviert das Element.
configure
Die Prozedur konfiguriert das Element.
install
Die Prozedur installiert das Element.
uninstall
Die Prozedur deinstalliert das Element.
Bei fehlender Angabe des Parameters wird "install" angenommen.
Version
Gibt die Version des zu verarbeitenden Elements an.
userJobMessage
Gibt die benutzerdefinierte Administratormeldung für einen Job in einem
Jobcontainer an.
Hinweis: Sie sollten Folgendes beachten:
■
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
ist, werden diese Parameter ohne Warnung ignoriert.
■
Wenn "group" ohne Prozeduren angegeben wird und es sich bei dieser Gruppe um
eine Softwaregruppe handelt, werden Installationsjobs für die Gruppenmitglieder
generiert. Dabei wird die erste Installationsprozedur entsprechend der
Nummerierung der Mitglieder als Jobprozedur verwendet.
Kapitel 3: cadsmcmd-Befehle 171
Kompatibilität
Format der Prozedurdatei
Die Prozedurdatei besteht aus Einträgen mit der folgenden Syntax:
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=Lieferungskalender]
[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]
[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.
172 CLI-Referenzhandbuch
Kompatibilität
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 Bedeutung der anderen Parameter entspricht der Bedeutung der in "cadsmcmd
jobcontainer action=addjob" dargestellten Befehlsparameter.
Die Prozeduroptionen für eine Jobprozedur werden aus den Einstellungen in dieser Liste
übernommen.
Wenn für eine Prozedur im entsprechenden Listeneintrag keine Option angegeben
wurde, wird die Einstellung der Befehlsebene verwendet.
Ist sie nicht angegeben, wird sie den registrierten Prozeduroptionen entnommen.
Kapitel 3: cadsmcmd-Befehle 173
Kompatibilität
Beispiel:
Angenommen, Sie verfügen über den nicht versiegelten Jobcontainer "myContainer".
Das Element "prod 1" der Version 1.0 soll mit Hilfe der Installationsprozedur "inst" auf
KKKK01A und KKKK01B installiert werden. Die Benutzer der Zielcomputer müssen zur
Installation aufgefordert werden. Der Installationsauftrag muss im Jobcontainer
"myContainer" gespeichert werden.
Geben Sie den folgenden Befehl ein, um den gewünschten Job zu erhalten:
cadsmcmd jobContainer action=addJob name=myContainer item="prod 1" version=1.0
procedure=inst task=install computer=KKKK01A computer=KKKK01B promptUser
after=exacttime
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
Verbindung zu Manager "<Standard-Manager>" als Benutzer "<Standardbenutzer>" wird
hergestellt... OK.
Manager: myManager
Domäne: myDomain
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
Job "prod 1 1.0:inst" generieren OK.
SDCMD<A000000>: OK
addDelivery – Hinzufügen von Lieferungen zum Jobcontainer
Diese Aktion fügt dem angegebenen Jobcontainer einen Job hinzu, der die angegebenen
Softwareprodukte an die adressierten Scalability-Server liefert, d.&#160;h., er speichert
sie in den Softwarebibliotheken der Scalability-Server. Die Versiegelung des
entsprechenden Jobcontainers muss aufgehoben werden.
Diese Aktion hat das folgende Format:
jobcontainer action=addDelivery
name=Jobcontainername
{item=Elementname
version=Elementversion| group=Name der Softwaregruppe}
{{{compgrp=Computergruppenname | ccompgrp=(Computergruppenname Trennzeichen
Gruppenbereich)}
174 CLI-Referenzhandbuch
Kompatibilität
[sep=Trennzeichen]
|{computer=Computername}}
[calendar_name=Lieferungskalender]
[deliverytime=JJJJ-MM-TT HH:MM ]
[jobTimeOut=t.h]
calendarname
Gibt Folgendes an: Name des Kalenders, der die Zeit steuert, während der die
Evaluierung ausgeführt werden kann.
ccompgrp
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.
compgrp
Gibt Folgendes an: Name einer Servergruppe, auf dem das angegebene Produkt
verarbeitet wird.
Der Parameter kann mehrfach angegeben werden , um mehrere Servergruppen zu
adressieren.
Dieser Parameter darf nicht mit dem Parameter "computer" angegeben werden.
computer
Gibt Folgendes an: Name des Scalability-Servers, auf dem das angegebene Produkt
verarbeitet wird.
Der Parameter kann mehrfach angegeben werden , um mehrere Scalability-Server
zu adressieren.
Dieser Parameter muss mit dem Parameter "compgrp" angegeben werden.
Kapitel 3: cadsmcmd-Befehle 175
Kompatibilität
deliverytime
Gibt Folgendes an: Startzeit der Lieferung vom Domänen-Manager.
Das Datum wird im ISO-Format "JJJJ-MM-TT HH:MM" angegeben.
Wenn der Parameter nicht angegeben ist, werden das aktuelle Datum und die
aktuelle Uhrzeit verwendet.
Gruppe
Gibt Folgendes an: Name einer Softwaregruppe: Ihre Mitglieder werden an die
angegebenen Scalability-Server übermittelt.
Dieser Parameter sollte nicht mit dem Parameter "item" angegeben werden.
item
Gibt Folgendes an: Name des Elements, das verarbeitet werden soll.
Dieser Parameter sollte nicht mit dem Parameter "group" angegeben werden.
jobTimeOut
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".
Name
Gibt Folgendes an: Name des Jobcontainers, dem die Lieferung an die ScalabilityServer hinzugefügt wird.
sep
Gibt ein alternatives Trennzeichen für die Option "ccompgroup" an. Das
Trennzeichen darf nicht Teil des Gruppennamencodes für die "ccompgroup"Optionen sein.
Version
Gibt Folgendes an: Version des Elements, das verarbeitet werden soll.
176 CLI-Referenzhandbuch
Kompatibilität
Beispiel:
Angenommen, Sie verfügen über den nicht versiegelten Jobcontainer "myContainer".
Das Element "prod 2" der Version 1.0 soll an den Scalability-Server KKKKK01B geliefert
werden. Der Lieferauftrag muss im Jobcontainer "myContainer" gespeichert werden.
Geben Sie den folgenden Befehl ein, um den gewünschten Job zu erhalten:
cadsmcmd jobContainer action=addDelivery name="myContainer" item="prod 2"
version=1.0 computer=KKKKK01B
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
Verbindung zu Manager "<Standard-Manager>" als Benutzer "<Standardbenutzer>" wird
hergestellt... OK.
Manager: myManager
Domäne: myDomain
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
SDCMD<A000000>: OK
addUndelivery – Hinzufügen von Rückrufen zum Jobcontainer
Diese Aktion fügt dem angegebenen Jobcontainer einen Job hinzu, der die angegebenen
Softwareprodukte von den adressierten Scalability-Servern entfernt. Die Versiegelung
des entsprechenden Jobcontainers muss aufgehoben werden.
Diese Aktion hat das folgende Format:
jobcontainer action=addUnDelivery
name=Jobcontainername
{item=Elementname
version=Elementversion| group=Name der Softwaregruppe}
{{compgrp=Computergruppenname | ccompgrp=(Computergruppenname Trennzeichen
Gruppenbereich)}
[sep=Trennzeichen]
|{computer=Computername}}
[deliverytime=JJJJ-MM-TT HH:MM ]
[calendar_name=Lieferungskalender]
[jobTimeOut=t.h]
Kapitel 3: cadsmcmd-Befehle 177
Kompatibilität
calendarname
Gibt Folgendes an: Name des Kalenders, der die Zeit steuert, während der die
Evaluierung ausgeführt werden kann.
ccompgrp
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.
compgrp
Gibt Folgendes an: Name einer Servergruppe, auf dem das angegebene Produkt
verarbeitet wird.
Der Parameter kann mehrfach angegeben werden , um mehrere Servergruppen zu
adressieren.
Der Parameter darf nicht mit dem Parameter "computer" angegeben werden.
computer
Gibt Folgendes an: Name des Scalability-Servers, auf dem das angegebene Produkt
verarbeitet wird.
Der Parameter kann mehrfach angegeben werden , um mehrere Scalability-Server
zu adressieren.
Dieser Parameter muss mit dem Parameter "compgrp" angegeben werden.
deliverytime
Gibt Folgendes an: Startzeit der Lieferung vom Domänen-Manager.
Das Datum wird im ISO-Format "JJJJ-MM-TT HH:MM" angegeben.
178 CLI-Referenzhandbuch
Kompatibilität
Gruppe
Gibt Folgendes an: Name einer Softwaregruppe: Ihre Mitglieder werden von den
angegebenen Scalability-Servern entfernt.
Dieser Parameter sollte nicht mit dem Parameter "item" angegeben werden.
item
Gibt Folgendes an: Name des Elements, das verarbeitet werden soll.
Dieser Parameter darf nicht mit dem Parameter "group" angegeben werden.
jobTimeOut
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".
Name
Gibt Folgendes an: Name des Jobcontainers, dem der Rückruf an die ScalabilityServer hinzugefügt wird.
sep
Gibt ein alternatives Trennzeichen für die Option "ccompgroup" an. Das
Trennzeichen darf nicht Teil des Gruppennamencodes für die "ccompgroup"Optionen sein.
Version
Gibt Folgendes an: Version des Elements, das verarbeitet werden soll.
listJobs – Auflisten von Jobs
Diese Aktion listet alle Jobs des angegebenen Jobcontainers auf. Es kann ein Filter
verwendet werden, um die Anzahl der angezeigten Jobs einzuschränken.
Diese Aktion hat das folgende Format:
jobcontainer action=listJobs
name=Jobcontainername
[{filter=Filter|filterfile=Dateiname}]
[TV] | TV alt}
Kapitel 3: cadsmcmd-Befehle 179
Kompatibilität
alt
Bietet eine alternative, detailliertere Liste in der Zielansicht.
Eine alternative Liste wird nur auf der Grundlage des Namens und der Version des
Elements bereitgestellt.
Bei der Angabe dieses Parameters können der Wert des Elements und der
Parameter "version" datenbankgestützte Platzhalter enthalten, zum Beispiel
"%"
für eine beliebige, selbst leere Zeichenfolge
"_"
für ein beliebiges einzelnes Zeichen
Für Microsoft SQL Server haben die eckigen Klammern ("[","]") eine besondere
Bedeutung. Dies muss beim Codieren des Namens berücksichtigt werden.
Name
Gibt Folgendes an: Name des Jobcontainers, die aufgelistet werden soll.
filter
Gibt Folgendes an: Ausdruck, um die Anzahl der aufgelisteten Informationen
einzuschränken.
Attribut
Typ
Jobname
Zeichenfolge
Gesamtstatus
{ WAITING | INPROGRESS | OK | ERROR | BUILDING |
REMOVING | NOT_AVAILABLE | CREATED | OBSOLETE}
Software
Zeichenfolge
Prozedur
Zeichenfolge
Liefern am
DateTime
Aktivieren am
DateTime
Statusmeldung
Zeichenfolge
Jobstatus
{UNDEFINED | WAITING | DELIVERY_ORDERED |
DELIVERING | DELIVERY_OK | DELIVERY_ERROR |
ALREADY_DELIVERED | EXECUTION_ORDERED |
EXECUTING | EXECUTION_OK | EXECUTION_ERROR |
UNDELIVERY_ORDERED | UNDELIVERING |
UNDELIVERY_OK | UNDELIVERY_ERROR |
ALREADY_INSTALLED | MANIPULATION_NOT_ALLOWED}
Jobtask
{INSTALL | CONFIGURE | ACTIVATE | UNINSTALL | DELIVER
| UNDELIVER}
Aktion davor
{NO ACTION | REBOOT | LOGOFF}
180 CLI-Referenzhandbuch
Kompatibilität
Attribut
Typ
Folgeaktion
{NO ACTION | REBOOT | LOGOFF | REBOOT AFTER LAST
JOB | LOGOFF AFTER LAST JOB}
Lieferungskalender
Zeichenfolge
Benutzerparameter
Zeichenfolge
Die elementaren Attribute entsprechen denjenigen unter "showAttrJobs" oder
"showJobDetails".
filterfile
Name der Datei, die die Filterbefehle enthält.
Die Befehle der Datei werden auf die gleiche Weise festgelegt wie im Parameter
"Filter". Die Kapazität der Datei wird jedoch durch die Kapazität des den Befehl
ausführenden Systems begrenzt.
TV
Anpassung der Listenansicht:
Keine Angabe
Jobansicht
TV
Zielansicht
Beispiel:
Geben Sie den folgenden Befehl ein, um die Inhalte des Containers "e.g." aufzulisten:
cadsmcmd jobContainer action=listJobs name=e.g.
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.
Kapitel 3: cadsmcmd-Befehle 181
Kompatibilität
------------------------------------------------------------------------------Jobliste des Jobcontainers "e.g."
------------------------------------------------------------------------------Jobname...............................: prod 1 1.0:inst
..Task.................................: install
..Gesamtstatus......................: WAITING
..Jobauftragsnummer.....................: 1
Jobname...............................: prod 3 1.0:inst
..Task.................................: install
..Gesamtstatus......................: WAITING
..Jobauftragsnummer.....................: 2
Jobname................................: prod 2 1.0:delivery proc
..Task.................................: deliver
..Gesamtstatus......................: WAITING
..Jobauftragsnummer.....................: 3
------------------------------------------------------------------------------Anzahl der gelesenen Jobs: 3
Anzahl der aufgelisteten Jobs: 3
sdcmd<a000000>: OK
Die vorherige Liste wird angezeigt, wenn der Jobcontainer nicht versiegelt ist. Nach der
Versiegelung wird möglicherweise die folgende Liste angezeigt:
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.
------------------------------------------------------------------------------Jobliste des Jobcontainers "e.g."
------------------------------------------------------------------------------Jobname...............................: prod 1 1.0:inst
..Task.................................: install
..Gesamtstatus......................: OK
..Jobauftragsnummer.....................: 1
..Ziel...............................: KKKKK01A
....Jobstatus..........................: EXECUTION_OK
..Ziel...............................: KKKKK01B
....Jobstatus..........................: EXECUTION_OK
182 CLI-Referenzhandbuch
Kompatibilität
Jobname...............................: prod 3 1.0:inst
..Task.................................: install
..Gesamtstatus......................: ERROR
..Jobauftragsnummer.....................: 2
..Ziel...............................: KKKKK01A
....Jobstatus..........................: EXECUTION_OK
..Ziel...............................: KKKKK01B
....Jobstatus..........................: AUSFÜHRUNGSFEHLER
Jobname................................: prod 2 1.0:delivery proc
..Task.................................: deliver
..Gesamtstatus......................: OK
..Jobauftragsnummer.....................: 3
..Ziel...............................: KKKKK01B
....Jobstatus..........................: LIEFERUNG_OK
------------------------------------------------------------------------------Anzahl der gelesenen Jobs: 3
Anzahl der aufgelisteten Jobs: 3
sdcmd<a000000>: OK
Dies ist eine joborientierte Liste. Geben Sie den folgenden Befehl ein, um eine
zielorientierte Liste abzurufen:
cadsmcmd jobContainer action=listJobs name="e.g." TV
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.
------------------------------------------------------------------------------Jobliste des Jobcontainers "e.g." (TV)
------------------------------------------------------------------------------Ziel......................................: KKKKK01A
..Jobgesamtstatus...................: OK
..Jobname.............................: prod 1 1.0:inst
....Task...............................: install
....Jobstatus..........................: EXECUTION_OK
..Jobname.............................: prod 3 1.0:inst
....Task...............................: install
....Jobstatus..........................: EXECUTION_OK
Kapitel 3: cadsmcmd-Befehle 183
Kompatibilität
Ziel......................................: KKKKK01B
..Jobgesamtstatus...................: ERROR
..Jobname.............................: prod 1 1.0:inst
....Task...............................: install
....Jobstatus..........................: EXECUTION_OK
..Jobname.............................: prod 3 1.0:inst
....Task...............................: install
....Jobstatus..........................: AUSFÜHRUNGSFEHLER
..Jobname..............................: prod 2 1.0:delivery proc
....Task...............................: deliver
....Jobstatus..........................: LIEFERUNG_OK
------------------------------------------------------------------------------Anzahl der gelesenen Jobs: 5
Anzahl der aufgelisteten Jobs: 5
sdcmd<A000000>: OK
Bei Aufruf von
cadsmcmd jobContainer action=listJobs name="e.g." TV alt
kann folgende Liste zurückgegeben werden:
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
Verbindung zu Manager "<Standardmanager>" als Benutzer "<Standardbenutzer>" wird
hergestellt ...OK.
Manager: mgr_1
Domäne: mgr-1
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
184 CLI-Referenzhandbuch
Kompatibilität
------------------------------------------------------------------------------Jobliste der Elemente für Jobcontainer "e.g."
------------------------------------------------------------------------------Ziel......................................: KKKKK01
..Jobname.............................: prod 1 1.0:inst
..Job-ID................................: 27B1661D-ED2D-DB01-B402-000F1F7090E6
..Elementname........................: prod 1
..Elementversion.........................: 1.0
..Prozedurname..........................: inst
..Task.................................: install
..Benutzerparameter...................:
..Jobstatus............................: AUSFÜHRUNGSFEHLER
..Fehlercode...........................: 228001
..Fehlermeldung........................: 1
..Erstellungsdatum........................: 2006-08-17
..Erstellungszeitpunkt........................: 14:37
..Aktivierungsdatum......................: 2006-08-17
..Aktivierungszeitpunkt......................: 14:36
..Beendigungsdatum......................: 2006-08-17
..Beendigungszeit......................: 14:37
Geben Sie den folgenden Befehl ein, um die Jobs mit dem Gesamtstatus 'ok' aufzulisten:
cadsmcmd jobcontainer action=listjobs name=e.g. filter=”Overall state=OK”
Die folgende Liste wird zurückgegeben:
Jobname...............................: prod 1 1.0:inst
..Task.................................: install
..Gesamtstatus......................: OK
..Jobauftragsnummer.....................: 1
..Ziel...............................: KKKKK01A
....Jobstatus..........................: EXECUTION_OK
..Ziel...............................: KKKKK01B
....Jobstatus..........................: EXECUTION_OK
Jobname................................: prod 2 1.0:delivery proc
..Task.................................: deliver
..Gesamtstatus......................: OK
..Jobauftragsnummer.....................: 3
..Ziel...............................: KKKKK01B
....Jobstatus..........................: LIEFERUNG_OK
Anzahl der gelesenen Jobs: 3
Anzahl der aufgelisteten Jobs: 2
sdcmd<a000000>: OK
Kapitel 3: cadsmcmd-Befehle 185
Kompatibilität
listFailedJobs – Auflisten fehlgeschlagener Jobs
Diese Aktion listet alle fehlgeschlagenen Jobs des angegebenen Jobcontainers auf. Es
kann ein Filter verwendet werden, um die Anzahl der angezeigten fehlgeschlagenen
Jobs einzuschränken.
Diese Aktion hat das folgende Format:
jobcontainer action=listFailedJobs
name=Jobcontainername
[{filter=Filter|filterfile=Dateiname}]
[TV] | TV alt}
alt
Bietet eine alternative, detailliertere Liste in der Zielansicht.
Eine alternative Liste wird nur auf der Grundlage des Namens und der Version des
Elements bereitgestellt.
Bei der Angabe dieses Parameters können der Wert des Elements und der
Parameter "version" datenbankgestützte Platzhalter enthalten, zum Beispiel
"%"
für eine beliebige, selbst leere Zeichenfolge
"_"
für ein beliebiges einzelnes Zeichen
Für Microsoft SQL Server haben die eckigen Klammern ("[","]") eine besondere
Bedeutung. Dies muss beim Codieren des Namens berücksichtigt werden.
Name
Gibt Folgendes an: Name des Jobcontainers, der aufgelistet werden soll. Nur
fehlgeschlagene Jobs werden aufgelistet.
filter
Gibt Folgendes an: Ausdruck, um die Anzahl der aufgelisteten Informationen
einzuschränken.
Die Atomic-Ausdrücke zur Erstellung von Filterausdrücken entsprechen denjenigen
für "listjobs".
filterfile
Gibt Folgendes an: Name der Datei, die die Filterbefehle enthält.
Die Befehle der Datei werden auf die gleiche Weise festgelegt wie im Parameter
"Filter". Die Kapazität der Datei wird jedoch durch die Kapazität des den Befehl
ausführenden Systems begrenzt..
186 CLI-Referenzhandbuch
Kompatibilität
TV
Anpassung der Listenansicht:
Keine Angabe
Jobansicht
TV
Zielansicht
Die aufgelisteten Informationen besitzen das gleiche Format wie für "listJobs".
Beispiel:
Geben Sie den folgenden Befehl ein, um die fehlgeschlagenen Jobs des Containers
"myContainer" aufzulisten:
cadsmcmd jobContainer action=listFailedJobs name="myContainer"
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
Verbindung zu Manager "<Standard-Manager>" als Benutzer "<Standardbenutzer>" wird
hergestellt... OK.
Manager: myManager
Domäne: myDomain
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
Kapitel 3: cadsmcmd-Befehle 187
Kompatibilität
------------------------------------------------------------------------------Jobliste des Jobcontainers "myContainer"
------------------------------------------------------------------------------Jobname...............................: prod 2 1.0:inst
..Task.................................: install
..Gesamtstatus......................: ERROR
..Jobauftragsnummer.....................: 2
..Ziel...............................: KKKKK01A
....Jobstatus..........................: EXECUTION_OK
..Ziel...............................: KKKKK01B
....Jobstatus..........................: AUSFÜHRUNGSFEHLER
Jobname...............................: prod 3 1.0:inst
..Task.................................: configure
..Gesamtstatus......................: ERROR
..Jobauftragsnummer.....................: 3
..Ziel...............................: KKKKK01A
....Jobstatus..........................: AUSFÜHRUNGSFEHLER
..Ziel...............................: KKKKK01B
....Jobstatus..........................: AUSFÜHRUNGSFEHLER
------------------------------------------------------------------------------Anzahl der gelesenen Jobs: 2
Anzahl der aufgelisteten Jobs: 2
SDCMD<A000000>: OK
Geben Sie Folgendes ein, um eine zielorientierte Liste anzuzeigen:
cadsmcmd jobContainer action=listFailedJobs name=myContainer TV
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.
------------------------------------------------------------------------------Jobliste des Jobcontainers "myContainer" (TV)
------------------------------------------------------------------------------Ziel......................................: KKKKK01B
..Jobgesamtstatus...................: ERROR
..Jobname.............................: prod 3 1.0:inst
....Task...............................: install
....Jobstatus..........................: AUSFÜHRUNGSFEHLER
188 CLI-Referenzhandbuch
Kompatibilität
------------------------------------------------------------------------------Anzahl der gelesenen Jobs: 1
Anzahl der aufgelisteten Jobs: 1
SDCMD<A000000>: OK
Bei Aufruf von
cadsmcmd jobContainer action=listFailedJobs name=“e.g.“ TV alt
kann folgende Liste zurückgegeben werden:
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
Verbindung zu Manager "<Standardmanager>" als Benutzer "<Standardbenutzer>" wird
hergestellt ...OK.
Manager: mgr_1
Domäne: mgr-1
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
------------------------------------------------------------------------------Jobliste der Elemente für Jobcontainer "e.g."
------------------------------------------------------------------------------Ziel......................................: KKKKK01
..Jobname.............................: prod 1 1.0:inst
..Job-ID................................: 27B1661D-ED2D-DB01-B402-000F1F7090E6
..Elementname........................: prod 1
..Elementversion.........................: 1.0
..Prozedurname..........................: inst
..Task.................................: install
..Benutzerparameter...................:
..Jobstatus............................: AUSFÜHRUNGSFEHLER
..Fehlercode...........................: 228001
..Fehlermeldung........................: 1
..Erstellungsdatum........................: 2006-08-17
..Erstellungszeitpunkt........................: 14:37
..Aktivierungsdatum......................: 2006-08-17
..Aktivierungszeitpunkt......................: 14:36
..Beendigungsdatum......................: 2006-08-17
..Beendigungszeit......................: 14:37
Kapitel 3: cadsmcmd-Befehle 189
Kompatibilität
Geben Sie den folgenden Befehl ein, um mit Hilfe von Filtern die Jobs aufzulisten, die bei
der Installation fehlgeschlagen sind:
cadsmcmd jobContainer action=listFailedJobs name=myContainer filter=”Job
task=INSTALL”
Die folgende Ausgabe wird zurückgegeben:
------------------------------------------------------------------------------Jobliste des Jobcontainers "myContainer"
------------------------------------------------------------------------------Jobname...............................: prod 2 1.0:inst
..Task.................................: install
..Gesamtstatus......................: ERROR
..Jobauftragsnummer.....................: 2
..Ziel...............................: KKKKK01A
....Jobstatus..........................: EXECUTION_OK
..Ziel...............................: KKKKK01B
....Jobstatus..........................: AUSFÜHRUNGSFEHLER
------------------------------------------------------------------------------Anzahl der gelesenen Jobs: 2
Anzahl der aufgelisteten Jobs: 1
SDCMD<A000000>: OK
modfiyJob – Bearbeiten von Jobs
Mit diesem Befehl können Sie einen Job des angegebenen Jobcontainers ändern. Sie
müssen die Versiegelung des Jobcontainers aufheben.
Die Parameter werden mit Joboptionen verwendet. Wenn ein Parameter nicht codiert
wird, bleiben die entsprechenden Optionen unverändert. Sie müssen den Parameter
"stagingServer" mit Installations-Tasks codieren; sonst wird er einen Fehler verursachen.
Dieser Befehl hat das folgende Format:
jobcontainer action=modifyjob
name=Jobcontainername
jobName=Jobname [newJobName=neuer_Jobname]
[deliveryTime=JJJJ-MM-TT HH:MM]
190 CLI-Referenzhandbuch
Kompatibilität
[atTime=JJJJ-MM-TT HH:MM]
[after={exacttime|boottime}]
[calendername=Lieferungskalender]
[preaction={none|reboot|logoff}]
[postaction={none|reboot|logoff|rebootAtEnd|logoffAtEnd|shutdownAtEnd}]
[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}]]
[stagingServer[={y|n}]]
[parameters=Benutzerparameter]
[jobTimeout=t.h]
[reinstall[={y|n}]]
[userJobMessage]
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.
Dieser Parameter sollte nur angegeben werden, wenn "promptUser" bereits
aktiviert ist oder mit diesem Aufruf aktiviert wird. Anderenfalls wird diese
Einstellung ignoriert. Es wird keine Warnung angezeigt.
Kapitel 3: cadsmcmd-Befehle 191
Kompatibilität
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.
deliverytime
Gibt Folgendes an: Startzeit der Lieferung vom Domänen-Manager.
Das Datum wird im ISO-Format "JJJJ-MM-TT HH:MM" angegeben.
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.
Dieser Parameter sollte nur angegeben werden, wenn "promptUser" bereits
aktiviert ist oder mit diesem Aufruf aktiviert wird. Anderenfalls wird diese
Einstellung ignoriert. Es wird keine Warnung angezeigt.
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änenManagers.
jobName
Gibt Folgendes an: Name des Jobs , der geändert werden soll.
jobTimeOut
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".
Name
Gibt Folgendes an: Name des Jobcontainers, zu dem der zu ändernde Job gehört.
newJobName
Gibt Folgendes an: neuer Jobname.
192 CLI-Referenzhandbuch
Kompatibilität
noCalendar
Wenn "noCalendar" angegeben ist, wird ein möglicherweise auf dem Zielcomputer
vorhandener Kalender für die Jobausführung ignoriert.
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.
Kapitel 3: cadsmcmd-Befehle 193
Kompatibilität
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.
prompt=d.h
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.
Dieser Parameter sollte nur angegeben werden, wenn "promptUser" bereits
aktiviert ist oder mit diesem Aufruf aktiviert wird. Anderenfalls wird diese
Einstellung ignoriert. Es wird keine Warnung angezeigt.
194 CLI-Referenzhandbuch
Kompatibilität
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
Die Option "reinstall" ist optional und besitzt keinen Standardwert.
Wenn diese Option nicht codiert ist, werden die Neuinstallationseinstellungen für
die angesprochenen Jobs nicht geändert, anderenfalls werden sie der Codierung
entsprechend geändert.
Hinweis: Diese Option gilt nur für Installationsjobs. In allen anderen Fällen wird sie
ignoriert.
resolveQuery
Wertet vor Erstellung des Jobs eine möglicherweise vorhandene Abfragegruppe
aus.
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.
stagingServer
Liefert das zugehörige Produkt auch an die Staging-Bibliotheken der ScalabilityServer der Zielcomputer.
Dieser Parameter bezieht sich nur auf Prozeduren des Aufgabentyps "install".
Dieser Parameter sollte nur mit Prozeduren des Task-Typs "install" verwendet
werden. Anderenfalls wird ein Fehler ausgegeben.
userJobMessage
Ändert die benutzerdefinierte Administratormeldung eines Jobs in einem
Jobcontainer.
Beispiel:
Angenommen, der Container "myContainer" ist nicht versiegelt und der Job "prod 3
1.0:inst" soll so geändert werden, dass das Produkt automatisch an die Scalability-Server
geliefert werden soll, die mit den zugewiesenen Zielen verknüpft sind. Mit dem
folgenden Befehl wird der Job entsprechend dieser Anforderung geändert:
cadsmcmd jobContainer action=modifyJob name="myContainer" jobName="prod 3
1.0:inst" stagingServer=y
Kapitel 3: cadsmcmd-Befehle 195
Kompatibilität
recoverJob – Wiederherstellen von Jobs von fehlgeschlagenem Jobcontainer
Dieser Befehl stellt einen fehlgeschlagenen Job vom angegebenen Jobcontainer wieder
her, das heißt, er führt aus ein Deinstallationsprozedur durch, um die verbleibenden
Dateien des fehlgeschlagenen Jobs zu bereinigen.
Die Joboptionen der Wiederherstellungsjobs werden auf der Grundlage des
verwiesenen Jobs entsprechend der Parameter und ihrer codierten Werte geändert. Die
Optionen von nicht angegebenen Parametern werden für den wiederhergestellten Job
nicht geändert. Das gleiche gilt für die Optionen des wiederhergestellten Containers. Die
Standardeinstellungen werden dem Quellcontainer entnommen (Parameter "name").
Dieser Befehl hat das folgende Format:
jobcontainer action=recoverJob
name=Jobcontainername
jobName=Jobname
[newName=neuer Containername]
[newJobName=neuer_Jobname]
[procedure=Prozedurname]
[{transaction|synchronized|noLinkage}]
[rollback[={y|n}]]
[cascade[={y|n}]]
[deliveryTime=JJJJ-MM-TT HH:MM]
[atTime=JJJJ-MM-TT HH:MM]
[after={exacttime|boottime}]
[calendername=Lieferungskalender]
[preaction={none|reboot|logoff}]
[postaction={none|reboot|logoff|rebootAtEnd|logoffAtEnd|shutdownAtEnd}]
[promptUser[={y|n}]]
[allowCancel[={y|n}]]
[execTimedOut[={y|n}]]
[prompt=Tage.Stunden]
[offline[={y|n}]]
[runAtShutdown[={y|n}]]
196 CLI-Referenzhandbuch
Kompatibilität
[preventLogon[={y|n}]]
[globalTime[={y|n}]]
[nocalendar[={y|n}]]
[resolveQuery[={y|n}]]
[stagingServer[={y|n}]]
[parameters=Benutzerparameter]
[jobTimeout=t.h]
[userJobMessage]
[userMessage]
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.
Dieser Parameter sollte nur angegeben werden, wenn "promptUser" bereits
aktiviert ist oder mit diesem Aufruf aktiviert wird. Anderenfalls wird diese
Einstellung ignoriert. Es wird keine Warnung angezeigt.
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.
Wenn der Parameter nicht angegeben ist, werden das aktuelle Datum und die
aktuelle Uhrzeit verwendet.
calendarName
Gibt Folgendes an: Name des Kalenders, der die Zeit steuert, während der die
Evaluierung ausgeführt werden kann.
Kapitel 3: cadsmcmd-Befehle 197
Kompatibilität
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.
Dieser Parameter sollte nur angegeben werden, wenn sich der Container bereits im
Modus Batch-Verarbeitung befindet oder durch diesen Befehl in diesen Modus
versetzt wird (Parameter "transaction").
deliveryTime
Gibt Folgendes an: Startzeit der Lieferung vom Domänen-Manager.
Das Datum wird im ISO-Format "JJJJ-MM-TT HH:MM" angegeben.
Wenn der Parameter nicht angegeben ist, werden das aktuelle Datum und die
aktuelle Uhrzeit verwendet.
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.
Dieser Parameter sollte nur angegeben werden, wenn "promptUser" bereits
aktiviert ist oder mit diesem Aufruf aktiviert wird. Anderenfalls wird diese
Einstellung ignoriert. Es wird keine Warnung angezeigt.
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änenManagers.
198 CLI-Referenzhandbuch
Kompatibilität
jobName
Gibt Folgendes an: Name des Jobs , der wiederhergestellt werden soll.
Für alle fehlgeschlagenen Zielsysteme wird eine Prozedur "uninstall" zur
Bereinigung des Systems gestartet.
jobTimeOut
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".
Name
Gibt Folgendes an: Name des Jobcontainers, aus dem ein Job wiederhergestellt
wird.
newJobName
Gibt Folgendes an: neuer Jobname (Name des wiederhergestellten Jobs).
Wenn dieser Parameter nicht angegeben wird, wird ein Standardjobname der Form
"<Elementname> <Elementversion>:<Name der gewählten Deinstallationsprozedur>"
erzeugt.
newName
Gibt Folgendes an: neuer Name des Jobcontainers, der die wiederhergestellten Jobs
enthält.
Wenn dieser Parameter nicht angegeben wird, wird ein Standardcontainer der
Form
"Recover[<Zeitstempel>] <Name des wiederherzustellenden Jobs>
[<Zeitstempel>]"
erzeugt.
Kapitel 3: cadsmcmd-Befehle 199
Kompatibilität
noCalendar
Wenn "noCalendar" angegeben ist, wird ein möglicherweise auf dem Zielcomputer
vorhandener Kalender für die Jobausführung ignoriert.
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.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert
der zugehörigen Prozedur verwendet.
200 CLI-Referenzhandbuch
Kompatibilität
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.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert
der zugehörigen Prozedur verwendet.
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: Namen der durchzuführenden "Deinstallationsprozedur"
prompt=d.h
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.
Dieser Parameter sollte nur angegeben werden, wenn "promptUser" bereits
aktiviert ist oder mit diesem Aufruf aktiviert wird. Anderenfalls wird diese
Einstellung ignoriert. Es wird keine Warnung angezeigt.
Kapitel 3: cadsmcmd-Befehle 201
Kompatibilität
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.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert
der zugehörigen Prozedur verwendet.
resolveQuery
Wertet vor Erstellung des Jobs eine möglicherweise vorhandene Abfragegruppe
aus.
Rollback
Setzt die Jobverknüpfungsoption auf "Transaktion aktivieren".
Dieser Parameter sollte nur angegeben werden, wenn sich der Container bereits im
Modus Batch-Verarbeitung befindet oder durch diesen Befehl in diesen Modus
versetzt wird (Parameter "transaction").
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.
synchronisiert
Die Jobverknüpfungsoption wird auf "Synchronisierte Jobausführung" gesetzt.
Transaktion
Die Jobverknüpfungsoption wird auf "Batch-Jobausführung" gesetzt.
Dies ist die Standardeinstellung.
userJobMessage
Gibt die benutzerdefinierte Administratormeldung für einen Job in einem
Jobcontainer an.
userMessage
Gibt die benutzerdefinierte Administratormeldung für einen Jobcontainer an.
Hinweis: Die erste "Deinstallationsprozedur" der entsprechenden Elemente wird
verwendet, um die Deinstallationsjobs für die Elemente zu generieren.
202 CLI-Referenzhandbuch
Kompatibilität
Beispiel:
Angenommen, die Verarbeitung des Jobcontainers "myContainer" ist abgeschlossen,
einige Jobs sind jedoch fehlgeschlagen. Die Probleme können nicht zeitnah behoben
werden. Aus diesem Grund sollten die verbleibenden Teile aus der fehlgeschlagenen
Ausführung auf den Zielsystemen entfernt werden. Damit die Systeme erfolgreich
wiederhergestellt werden können, müssen folgende Anforderungen erfüllt sein:
■
Der angemeldete Benutzer muss abgemeldet werden, damit die Jobs ausgeführt
werden können.
■
Während die Jobs ausgeführt werden, dürfen sich keine Benutzer bei den
Zielcomputern anmelden.
■
Nachdem der letzte Job erfolgreich abgeschlossen wurde, muss das System neu
gestartet werden.
■
Die Bereinigung erfolgt anhand der standardmäßigen Deinstallationsprozeduren.
Geben Sie den folgenden Befehl ein, um die Wiederherstellung der fehlgeschlagenen
Jobs zu planen:
cadsmcmd jobContainer action=recover name="myContainer" preaction=logoff
postaction=rebootAtEnd preventLogon
removeJob – Entfernen von Jobs aus dem Jobcontainer
Diese Aktion entfernt einen Job aus einem Jobcontainer.
Diese Aktion hat das folgende Format:
jobcontainer action=removeJob
name=Jobcontainername
jobName=Jobname
Name
Gibt Folgendes an: Name des Jobcontainers, aus dem der Job entfernt wird.
jobName
Gibt Folgendes an: Name des Jobs , die entfernt werden sollen.
Beispiel:
Angenommen, der Jobcontainer "myContainer" ist noch immer nicht versiegelt und
enthält den Job "prod xy 99/aa:enable trace", der nicht mehr benötigt wird. Geben Sie
den folgenden Befehl ein, um diesen Job aus dem Container zu entfernen:
cadsmcmd jobContainer action=removeJob name="myContainer" jobName= job "prod xy
99/aa:enable trace"
Kapitel 3: cadsmcmd-Befehle 203
Kompatibilität
renewJob – Erneuern von Jobs
Dieser Befehl erneuert alle fehlgeschlagenen Jobs des angegebenen Jobcontainers. Die
Joboptionen für den erneuerten Job werden entsprechend den Parametern und ihren
codierten Werten geändert. Die Optionen von nicht codierten Parametern werden nicht
geändert.
Diese Aktion hat das folgende Format:
jobcontainer action=renewJob
name=Jobcontainername
jobName=Jobname
[newName=neuer Containername]
[newJobName=neuer_Jobname]
[deliveryTime=JJJJ-MM-TT HH:MM]
[atTime=JJJJ-MM-TT HH:MM]
[after={exacttime|boottime}]
[calendername=Lieferungskalender]
[preaction={none|reboot|logoff}]
[postaction={none|reboot|logoff|rebootAtEnd|logoffAtEnd|shutdownAtEnd}]
[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]
[jobTimeout=t.h]
[userJobMessage]
[userMessage]
204 CLI-Referenzhandbuch
Kompatibilität
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.
Dieser Parameter sollte nur angegeben werden, wenn "promptUser" bereits
aktiviert ist oder mit diesem Aufruf aktiviert wird. Anderenfalls wird diese
Einstellung ignoriert. Es wird keine Warnung angezeigt.
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.
Wenn der Parameter nicht angegeben ist, werden das aktuelle Datum und die
aktuelle Uhrzeit verwendet.
calendarname
Gibt Folgendes an: Name des Kalenders, der die Zeit steuert, während der die
Evaluierung ausgeführt werden kann.
deliveryname
Gibt Folgendes an: Startzeit der Lieferung vom Domänen-Manager.
Das Datum wird im ISO-Format "JJJJ-MM-TT HH:MM" angegeben.
Wenn der Parameter nicht angegeben ist, werden das aktuelle Datum und die
aktuelle Uhrzeit verwendet.
Kapitel 3: cadsmcmd-Befehle 205
Kompatibilität
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.
Dieser Parameter sollte nur angegeben werden, wenn "promptUser" bereits
aktiviert ist oder mit diesem Aufruf aktiviert wird. Anderenfalls wird diese
Einstellung ignoriert. Es wird keine Warnung angezeigt.
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änenManagers.
jobName
Gibt Folgendes an: Name des Jobs , die erneuert werden soll.
jobTimeOut
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".
Name
Gibt Folgendes an: Name des Jobcontainers, von dem ein fehlgeschlagener Job
erneuert wird.
newJobName
Gibt Folgendes an: neuer Jobname. Wenn dieser Parameter nicht angegeben wird,
wird der Jobname des zu erneuernden Jobs verwendet.
206 CLI-Referenzhandbuch
Kompatibilität
newName
Gibt Folgendes an: neuer Name des Jobcontainers, der den erneuerten Job enthält.
Wenn dieser Parameter nicht angegeben wird, wird ein Standardcontainer der
Form
<Jobname> [<Zeitstempel>]
erzeugt.
noCalendar
Wenn "noCalendar" angegeben ist, wird ein möglicherweise auf dem Zielcomputer
vorhandener Kalender für die Jobausführung ignoriert.
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.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert
der zugehörigen Prozedur verwendet.
Kapitel 3: cadsmcmd-Befehle 207
Kompatibilität
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.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert
der zugehörigen Prozedur verwendet.
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.
prompt=d.h
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.
Dieser Parameter sollte nur angegeben werden, wenn "promptUser" bereits
aktiviert ist oder mit diesem Aufruf aktiviert wird. Anderenfalls wird diese
Einstellung ignoriert. 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.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert
der zugehörigen Prozedur verwendet.
208 CLI-Referenzhandbuch
Kompatibilität
resolveQuery
Wertet vor Erstellung des Jobs eine möglicherweise vorhandene Abfragegruppe
aus.
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.
userJobMessage
Gibt die benutzerdefinierte Administratormeldung für einen erneuerten Job in
einem Jobcontainer an.
userMessage
Gibt die benutzerdefinierte Administratormeldung für einen Jobcontainer an.
Hinweis: Es können nur Jobs von Jobcontainern des Typs "noLinkage" als einzelne Jobs
erneuert werden. Bei allen anderen Jobcontainertypen kann nur der Container erneuert
werden.
Beispiel:
Angenommen, der Job "prod 3 1.0:inst" des Containers "myContainer" ist zwar
fehlgeschlagen, das Problem wurde jedoch mittlerweile gelöst. Deshalb muss der Job
erneuert werden. Der erneuerte Job muss die folgenden Anforderungen erfüllen:
■
Der erneuerte Job heißt "Erneuern 0".
■
Der erneuerte Job wird im Container "prod 3 1.0:inst" gespeichert.
■
Der Benutzer erhält vor der Ausführung eine Eingabeaufforderung.
■
Der Benutzer ist zum Abbruch des Jobs berechtigt.
Dieser Job wird mit Hilfe des folgenden Befehls erneuert:
cadsmcmd jobContainer action=renewJob name="myContainer" jobName="prod 3
1.0:inst" newName="prod 3 1.0:inst" newJobname=renew promptUser allowCancel
Kapitel 3: cadsmcmd-Befehle 209
Kompatibilität
renewTarget – Erneuern fehlgeschlagener Jobs eines bestimmten Zielcomputers
Diese Aktion erneuert alle fehlgeschlagenen Jobs eines Jobcontainers, der für diesen
Computer einen bestimmten Zielcomputer adressiert.
Diese Aktion hat das folgende Format:
jobcontainer action=renewTarget name=Jobcontainername
[newName=neuer Containername]
{computer=Computername}
[userMessage]
Name
Gibt Folgendes an: Name des Jobcontainers, von dem fehlgeschlagene Jobs
erneuert werden.
newName
Gibt Folgendes an: neuer Name des Jobcontainers für die erneuerten Jobs. Wenn
dieser Parameter nicht angegeben wird, wird der Name des ursprünglichen
Jobcontainers verwendet.
computer
Gibt Folgendes an: Name des Computers, auf dem erneuerbare Jobs des genannten
Jobcontainers erneuert werden.
Der Parameter kann mehrfach angegeben werden , um eine Liste von Zielen zu
adressieren.
userMessage
Gibt die benutzerdefinierte Administratormeldung für den erneuerten Jobcontainer
an.
Hinweis: Wenn der Jobcontainer den Typ "Synchronisierte Jobausführung" besitzt,
können keine einzelnen Ziele erneuert werden, sondern ausschließlich ganze
Jobcontainer.
Beispiel:
Angenommen, der Container "myContainer" ist aufgrund der Probleme auf dem System
"KKKKK01B" fehlgeschlagen, diese Probleme wurden jedoch mittlerweile gelöst. Aus
diesem Grund müssen die fehlgeschlagenen Jobs des Containers "myContainer" für
dieses Ziel erneuert werden. Der erneuerte Job muss die folgende Anforderung erfüllen:
■
Der erneuerte Job wird im Container "renew KKKKK01B" gespeichert.
Diese Erneuerung wird mit Hilfe des folgenden Befehls durchgeführt:
cadsmcmd jobContainer action=renewTarget name=myContainer newName="renew
KKKKK01B" computer=KKKKK01B
210 CLI-Referenzhandbuch
Kompatibilität
repositionJobs – Ändern der Position von Jobs im Jobcontainer
Diese Aktion ermöglicht die Neuanordnung eines Jobcontainers, indem einem Job des
Jobcontainers eine neue Nummer zugewiesen wird.
Diese Aktion hat das folgende Format:
jobContainer action=repositionJobs
name=Jobcontainername
cjobname=Jobname position=neue Position
Name
Gibt Folgendes an: Name des Jobcontainers, der umgruppiert werden soll.
jobName
Gibt Folgendes an: Name des Jobs , der neu angeordnet werden soll.
position
Gibt Folgendes an: neue Position des Jobs.
Die Position muss größer als null sein und sollte die Anzahl der vorhandenen Jobs
im Jobcontainer nicht überschreiten.
Hinweis: Die Versiegelung des Jobcontainers muss aufgehoben werden.
Beispiel:
Angenommen, der Job "prod 3 1.0:inst" ist der zweite Job des nicht versiegelten
Containers "myContainer". Aus Gründen der Integrität sollte er jedoch der erste Job
sein. Mit Hilfe des folgenden Befehls wird der Job an eine neue Position verschoben:
cadsmcmd jobContainer action=repositionJobs name=myContainer jobName="prod 3
1.0:inst" position=1
showAttrJobs – Anzeigen von Jobattributen
Diese Aktion listet die Attribute eines Jobs aus dem angegebenen Jobcontainer auf.
Diese Aktion hat das folgende Format:
jobcontainer action=showAttrJobs
name=Jobcontainername
jobName=Jobname
Name
Gibt Folgendes an: Name des Jobcontainers, dem der Job entnommen wird.
jobName
Gibt Folgendes an: Name des Jobs , die aufgelistet werden soll.
Kapitel 3: cadsmcmd-Befehle 211
Kompatibilität
Beispiel:
Geben Sie den folgenden Befehl ein, um alle mit dem Job "prod 3 1.0:inst" verknüpften
Attribute anzuzeigen:
cadsmcmd jobContainer action=showAttrJobs name="myContainer" jobName="prod 3
1.0:inst"
Die Ausgabe lautet folgendermaßen:
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 "prod 3 1.0:inst" aus Container "myContainer"
------------------------------------------------------------------------------Jobname...............................: prod 3 1.0:inst
Software...............................: prod 3 1.0
Prozedur................................: instCrash
Liefern am.............................: 20035-04-12 10:49
Aktivieren am............................: 2005-04-12 10:49
Statusmeldung...........................: OK
Gesamtstatus........................: ERROR
.........................................0 - Jobziele wartend
.........................................0 - Jobziele aktiv
.........................................1 - Jobziele OK
.........................................1 - Jobziele fehlgeschlagen
Jobtask................................: install
Aktion davor
: Keine Aktion
Folgeaktion.............................: Keine Aktion
Benutzer-Eingabeaufforderung..: Ja
Merkmal-Flags.........................:
.........................................Lokale Zeit/exakt
.........................................Kalendergesteuert
Lieferungskalender...................:
Benutzerparameter.....................:
Eingabeaufforderung während...: 1&#160;Tage, 0&#160;Stunden
Jobzeitlimit.............................: 7&#160;Tage, 0&#160;Stunden
sdcmd<A000000>: OK
212 CLI-Referenzhandbuch
Kompatibilität
showJobDetails – Anzeigen von Jobdetails
Diese Aktion zeigt die Jobdetails eines evaluierten Jobcontainers an.
Diese Aktion hat das folgende Format:
jobcontainer action=showjobdetails
name=Jobcontainername
jobname=Jobname
destination=Zielname
[task={install|uninstall|activate|configure|deliver|undeliver }]
Name
Gibt Folgendes an: Name des Jobcontainers.
jobname
Gibt Folgendes an: Name des Jobs , der zu evaluieren ist.
Der Job muss ein Mitglied des angegebenen Jobcontainers sein.
destination
Gibt Folgendes an: destination, das von dem zu evaluierenden Job adressiert wird.
task
Gibt Folgendes an: Task des Jobs, der zu evaluieren ist.
Folgende sind möglich:
install
Installationsprozedur
uninstall
Deinstallationsprozedur
activate
Aktivierungsprozedur
configure
Konfigurationsprozedur
deliver
Eine Übertragungsprozedur
undeliver
Eine Rückrufprozedur.
Kapitel 3: cadsmcmd-Befehle 213
Kompatibilität
Beispiel:
Geben Sie den folgenden Befehl ein, um detaillierte Informationen zu dem Job "prod 3
1.0:inst" abzurufen, der mit dem Ziel "KKKKK01B" verknüpft ist:
cadsmcmd jobContainer action=showJobDetails name="myContainer" jobName="prod 3
1.0:inst" destination=KKKKK01B
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
Verbindung zu Manager "<Standard-Manager>" als Benutzer "<Standardbenutzer>" wird
hergestellt... OK.
Manager: myManager
Domäne: myDomain
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
------------------------------------------------------------------------------Details für job "prod 3 1.0:inst" für
........."KKKKK01B" von "myContainer"
------------------------------------------------------------------------------Kommentar.............................:
Jobcontainer-Status...................: fehlgeschlagen
Jobcontainer-Eigenschaften...............: 9
.........................................Keine Verknüpfung
.........................................Bei Fehler Rollback der vorangegangenen
Jobs
Versiegelt.................................: Ja
Erstellungsdatum..........................: 2005-04-12
Erstellungszeitpunkt..........................: 08:30
Änderungsdatum............................: 2005-04-12
Änderungszeitpunkt............................: 12:16
Anzahl der enthaltenen Objekte............: 4
214 CLI-Referenzhandbuch
Kompatibilität
Jobname...............................: prod 3 1.0:inst
Gesamtstatus........................: ERROR
.........................................0 - Warten
.........................................0 - Aktiv
.........................................1 - OK
.........................................1 - Fehler
..Jobauftragsnummer.....................: 1
..Erstellungsdatum........................: 2005-04-12
..Erstellungszeitpunkt........................: 10:57
..Lieferungsdatum........................: 2003-04-12
..Lieferungszeitpunkt........................: 10:49
..Aktivierungsdatum......................: 2005-04-12
..Aktivierungszeitpunkt......................: 10:49
..Lieferungskalender.................:
..Zeitlimit <Tage/Stunden>.................: 7 / 0
..Jobstart..............................: Lokale Zeit/exakt
..Jobberechtigung.......................: 7
.........................................Erneuerung zulässig
.........................................Abbruch zulässig
.........................................Wiederherstellung zulässig
..Aktion davor.........................: Keine Aktion
..Aktion danach.......................: Keine Aktion
..Jobmaske...................: 134
.........................................Benutzer-Eingabeaufforderung
.........................................Kalendergesteuert
.........................................Für jede Evaluierung wiederholen
..Benutzerparameter...................:
..Jobausführungsmodus...................: 1
.........................................Ausführen
..Zeitlimit für Eingabeaufforderung <Tage/Stunden>..........: 1 / 0
..Jobtask..............................: 1 - install
..Zielsystem..............................: KKKKK01B
....Task...............................: 1
Kapitel 3: cadsmcmd-Befehle 215
Kompatibilität
.........................................install
....Prozedurname........................: inst
....Angefordert von.........................: KKKKK01
....Jobstatus..........................: AUSFÜHRUNGSFEHLER
....Fehlermeldung.......................: Beendigungscode 2 deutet auf mögliche
Fehler hin
....Fehlerursache........................: 228001
....Kommentar............................:
....Computer-Installationsprozedur.....: inst
....Aktivierungsdatum....................: 2005-04-12
....Aktivierungszeitpunkt....................: 10:49
....Erstellungsdatum......................: 2005-04-12
....Erstellungszeitpunkt......................: 12:16
....Beendigungsdatum....................: 2005-04-12
....Beendigungszeit....................: 12:16
....Gesendete Daten (in %)..............: 100
SDCMD<A000000>: OK
Hinweis: Wenn ein Neuinstallationsjob angegeben wird, enthält die Ausgabe einen
entsprechenden Eintrag (nach "Jobmaske"). Anderenfalls fehlt diese Zeile.
managedcomputer – Verwalten von Computerkonfigurationen
Verwenden Sie den Befehl "managedcomputer" zum Verwalten von
Computerkonfigurationen.
Dieser Befehl wird nur auf Domänen-Managern unterstützt.
Dieser Abschnitt enthält die folgenden Themen:
listConfigs – Auflisten von Computerkonfigurationen (siehe Seite 216)
reportCurrentConfig – Erstellen von Berichten zur aktuellen Computerkonfiguration
(siehe Seite 218)
requestConfigReport – Anfordern eines Konfigurationsberichts (siehe Seite 219)
listConfigs – Auflisten von Computerkonfigurationen
Die Aktion listet die verfügbaren Konfigurationen, die mit den angegebenen Computern
verknüpft sind, auf. Berichtskonfigurationen werden mit dieser Aktion nicht aufgelistet.
Diese Aktion hat das folgende Format:
managedcomputer action=listConfigs
name=Computername
[status=Konfigurationsstatus]
[DETAILED[ DESC]]
216 CLI-Referenzhandbuch
Kompatibilität
Name
Gibt Folgendes an: Name des Computers, dessen zugehörigen Konfigurationen
aufgelistet werden.
Dieser Name kann Platzhalter enthalten.
In diesem Fall werden die Konfigurationen für alle Computer aufgelistet, deren
Name mit dem Muster übereinstimmt.
status
Gibt Folgendes an: Status der Konfigurationen.
DETAILED
Informationen werden detailliert aufgelistet
Anderenfalls werden nur "ID", "Ziel", "Status" und "Aktivierungsdatum" mit der
Konfiguration aufgelistet.
DESC
Wenn dieser Parameter angegeben ist, werden die Informationen zur
Parameterbeschreibung aufgelistet, anderenfalls nicht.
Beispiel:
cadsmcmd managedcomputer action=listconfigs name=myComp DETAILED
Folgende Ausgabe wird zurückgegeben:
------------------------------------------------------------------------------Listenkonfigurationen von myComp[DETAILLIERT]
------------------------------------------------------------------------------Computername...........................: myComp
Konfigurationsname
: myComp_update:1132585401
..ID...........................: F492710E-5A9F-11DA-89FD-AB3891E877B6
..Ziel...............................: myComp
....Typ...............................: COMPUTER
....ID.........................: 7EF10641-43DC-4DFA-82B2-9D595F58081B
..Status...............................: active
..Aktivierungsdatum......................: 2006-11-21 16:03
..Angepasste Einstellungen
..Richtlinien
Kapitel 3: cadsmcmd-Befehle 217
Kompatibilität
Konfigurationsname.....................: myComp: API [2005/11/21 16:02:20 UTC]
..ID...........................: 31D27494-5AA8-11DA-89FD-AB3891E877B6
..Ziel...............................: myComp
....Typ...............................: COMPUTER
....ID.........................: 7EF10641-43DC-4DFA-82B2-9D595F58081B
..Status...............................: scheduled
..Angepasste Einstellungen
..Richtlinien
....Richtlinienname........................: myPol
....Typ...............................: COMPUTER
....Kommentar............................:
....Status.............................: sealed
Parameterabschnitte
......Name für Parameterabschnitt...........: /itrm/usd/Server
........ID.....................: 09625218-5AA8-11DA-89FD-AB3891E877B6
........Parameter
..........Parametername...............: WaitBetweenStageChecks
............ID.................: 0977C742-5AA8-11DA-89FD-AB3891E877B6
............Wert......................: 10
reportCurrentConfig – Erstellen von Berichten zur aktuellen Computerkonfiguration
Mit dieser Aktion können Berichte zur aktuellen Konfiguration der angegebenen
Computer auf.
Diese Aktion hat das folgende Format:
managedcomputer action=reportCurrentConfig
name=Computername
[DETAILED[ DESC]]
Name
Gibt Folgendes an: Name des Computers, dessen aktueller Konfigurationsbericht
aufgelistet werden soll. Der Computername kann Platzhalter enthalten. In diesem
Fall wird für alle Computer der Bericht aufgelistet, deren Name mit dem Muster
übereinstimmt.
DETAILED
Informationen werden detailliert aufgelistet Anderenfalls werden "Status" und
"Anforderungsdatum" oder "Um" für den angegebenen Computer aufgelistet.
DESC
Wenn dieser Parameter angegeben ist, werden die Informationen zur
Parameterbeschreibung aufgelistet, anderenfalls nicht.
218 CLI-Referenzhandbuch
Kompatibilität
Beispiel:
cadsmcmd managedcomputer action=reportcurrentconfig name=mycomp
Folgende Ausgabe wird zurückgegeben:
------------------------------------------------------------------------------Aktuelle Konfigurationsberichte für myComp auflisten
------------------------------------------------------------------------------Computername...........................: myComp
..Status...............................: empfangen
..Um...................................: 2006-11-21 15:51
Anzahl der Konfigurationen: 0
Anzahl der aufgelisteten Berichte: 1
requestConfigReport – Anfordern eines Konfigurationsberichts
Die Aktion fordert einen Konfigurationsbericht für einen angegebenen Computer an.
Diese Aktion hat das folgende Format:
managedcomputer action=requestConfigReport
name=Computername
[WAIT]
Name
Gibt Folgendes an: Den Namen des Computers, zu dessen aktueller Konfiguration
ein Bericht erstellt werden soll.
Der Name kann Platzhalter enthalten. In diesem Fall wird die Anforderung für alle
Objekte gestartet, deren Name dem angegebenen Muster entspricht.
WAIT
Wenn dieser Parameter angegeben wird, wartet die Aktion auf den Abschluss des
Auftrags, anderenfalls erfolgt die Ausgabe, nachdem der Auftrag gestartet wurde.
manager – Verwalten von DSM-Managern
Dieser Abschnitt enthält die folgenden Themen:
list – Auflisten von Managern (siehe Seite 220)
modify – Ändern von Manager-Attributen (siehe Seite 220)
showAttr – Anzeigen von Managerattributen (siehe Seite 221)
Kapitel 3: cadsmcmd-Befehle 219
Kompatibilität
list – Auflisten von Managern
Verwenden Sie diese Aktion, um die Attribute des Managers aufzulisten.
Diese Aktion hat das folgende Format:
manager action=list
Ausgabeformat:
Die angegebenen Informationen werden wie folgt formatiert:
---------------------------------------------------------------------Attribute des Managers "«Managername»"
---------------------------------------------------------------------Managername..:......«Name des Managers»
..Managertyp......:.......{domain|enterprise}
..Manager-Adresse...:.......«Manager-Adresse»
..Beschreibung: «Beschreibung des Managers»
..Name der Domänen-Datenbank.....:«Bezeichnung der Domänen-Datenbank»
•
•
•
Managername..:......«Name des Managers»
..Managertyp......:.......{domain|enterprise}
..Manager-Adresse...:.......«Manager-Adresse»
..Beschreibung: «Beschreibung des Managers»
..Name der Domänen-Datenbank.....:«Bezeichnung der Domänen-Datenbank»
modify – Ändern von Manager-Attributen
Verwenden Sie diese Aktion, um Attribute des Managers zu ändern.
Die Syntax für die Aktion lautet:
manager action=modify
[name=Managername]
[newName=neuer_Managername]
[comment=Beschreibung_für_Manager]
220 CLI-Referenzhandbuch
Kompatibilität
Name
Gibt den Namen des Managers an, dessen Attribute geändert werden.
Wenn diese Option nicht codiert ist, wird der Manager verwendet, mit dem
CADSMCMD derzeit eine Sitzung hat.
newName
Gibt einen neuen Namen für den Manager an.
comment
Gibt eine neue Beschreibung für den Manager an.
Hinweis: Der Manager muss sich in der Domäne befinden, auf der CADSMCMD derzeit
arbeitet.
showAttr – Anzeigen von Managerattributen
Verwenden Sie diese Aktion, um die Attribute des Managers aufzulisten.
Die Syntax für die Aktion lautet:
manager action=showAttr
[name=Managername
[domain=Domänenname]]
Name
Gibt den Namen des Managers an, dessen Attribute aufgelistet werden.
Wenn diese Option nicht codiert ist, wird der Manager verwendet, mit dem
CADSMCMD eine Sitzung hat.
domain
Name der Domäne, zu der der Manager gehört.
Kapitel 3: cadsmcmd-Befehle 221
Kompatibilität
Ausgabeformat:
Die aufgelisteten Informationen werden wie folgt formatiert:
---------------------------------------------------------------------Attribute des Managers "«Managername»"
---------------------------------------------------------------------Managername..:.....«Name des Managers»
..Managertyp......:......{domain|enterprise}
..Manager-Adresse...:......«Manager-Adresse»
..Beschreibung...:......«Beschreibung»
..Erstellt am..:.....«jjjj-mm-tt HH:MM:SS»
..Zuletzt geändert am..:......«jjjj-mm-tt HH:MM:SS»
..Name der Domänen-Datenbank.....:......«Datenbankname»
....Netzwerkadresse.:......«Name des Datenbankhosts»
....Instanz..:.....«Datenbankinstanz»
....Datenbanktyp...:......{MS SQL|Ingres|Oracle}
..Komponenten
....Name.....:......«Komponentenname»
......Version:......«Komponentenversion»
•
.......•
.......•
....Name.....:......«Komponentenname»
......Version:......«Komponentenversion»
[..Name der Enterprise-Datenbank.:.....«Bezeichnung der Enterprise-Datenbank»
....Adresse der Enterprise-Datenbank...:.....«Adresse der Enterprise-Datenbank»]
[..Name der Unterdomänen-Datenbank:......«Bezeichnung der Unterdomänen-Datenbank»
....Adresse der Unterdomänen-Datenbank...:......«Adresse der UnterdomänenDatenbank»
....•
....•
....•
..Name der Unterdomänen-Datenbank.:......«Bezeichnung der Unterdomänen-Datenbank»
....Adresse der Unterdomänen-Datenbank...:......«Adresse der UnterdomänenDatenbank»]
222 CLI-Referenzhandbuch
Kompatibilität
progress – Prüfen des Verteilungsfortschritts
Der Befehl "progress" wird verwendet, um den Status einer von einem der
Softwareverteilungsbefehle oder einem anderen SD-Benutzer ausgelösten Verteilung
zurückzugeben.
Der Befehl "progress" ist nur gültig, wenn er für einen Enterprise-Manager ausgegeben
wird.
Dieser Befehl hat das folgende Format:
progress name=Jobcontainername
Name
Gibt Folgendes an: Name des Jobcontainers, dessen Status überprüft werden soll.
rdereg – Remote-Aufhebung der Registrierung von Elementen
Verwenden Sie den Befehl "rdereg", um eine Anweisung zur Aufhebung der
Registrierung (Entfernung) von Softwareelementen aus der Softwarebibliothek auf
einem oder mehreren Domänen-Managern zu senden. Die Anweisung wird vom
Enterprise-Manager ausgegeben. Die Anweisung zur Aufhebung der Registrierung wird
vom Enterprise-Manager an die angegebenen CA ITCM-Domänen oder DomänenGruppen gesendet.
Dieser Befehl ist nur für Enterprise-Manager zulässig.
Folgendes Format wird verwendet:
rdereg item=Elementname
version=Versionsname
{{area=Bereichsname} | {domain=Domänenname} | toAllAreas}
[cname=Name]
[sendTime=JJJJ-MM-TT HH:MM]
[haltTime=JJJJ-MM-TT HH:MM]
Kapitel 3: cadsmcmd-Befehle 223
Kompatibilität
area
Gibt Folgendes an: Name einer CA ITCM-Domäne, in der die Registrierung des
Elementes aufgehoben werden soll.
Das Element kann mehrfach angegeben werden, um eine Liste von CA ITCMDomänen zu adressieren.
Das Element sollte nicht mit den Parametern "domain" oder "toAllAreas"
angegeben werden.
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.
domain
Gibt Folgendes an: Name einer CA ITCM-Domänengruppe, in der die Registrierung
des Elementes aufgehoben werden soll.
Der Parameter kann mehrfach angegeben werden, um eine Liste von CA ITCMDomänengruppen zu adressieren.
Der Parameter sollte nicht mit den Parametern "area" oder "toAllAreas" festgelegt
werden.
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.
item
Gibt Folgendes an: Name des Elements, dessen Registrierung aufgehoben oder das
aus mindestens einer lokalen Bibliothek entfernt werden soll.
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.
toAllAreas
Wenn dieser Parameter angegeben ist, wird die zugehörige Verteilung an alle CA
ITCM-Domänen gesendet, die beim Enterprise-Manager registriert sind.
Version
Gibt Folgendes an: Version des Elements, dessen Registrierung aufgehoben oder
das entfernt werden soll.
224 CLI-Referenzhandbuch
Kompatibilität
Beispiel:
cadsmcmd rdereg item="Software TestC" version=0.46
area=N_LOCAL_SRV area=N_LOCAL_SRV_02 area=WO_LOCAL_SRV cname=TestCont4
sendtime="2005-03-05 18:35" halttime="2005-03-04 23:30"
rderegproc – Remote-Aufhebung der Registrierung von Prozeduren
Verwenden Sie diesen Befehl, um eine Anweisung zur Aufhebung der Registrierung
(Entfernen aus der Bibliothek) einer mit einem Softwareprogramm verbundenen
Elementprozedur in der Bibliothek auf einem oder mehreren Domänen-Managern zu
senden. Die Elementprozedur darf keine eingebettete Elementprozedur sein.
Der Befehl ist nur für Enterprise-Manager zulässig.
Dieser Befehl hat das folgende Format:
rderegproc item=Elementname
version=Versionsname
procedure=Prozedurname
{{area=Bereichsname} | {domain=Domänenname} | toAllAreas}
[cname=Name]
[sendTime=JJJJ-MM-TT HH:MM]
[haltTime=JJJJ-MM-TT HH:MM]
area
Gibt Folgendes an: Name einer CA ITCM-Domäne, in der die Registrierung der
Prozedur aufgehoben werden soll.
Das Element kann mehrfach angegeben werden, um eine Liste von CA ITCMDomänen zu adressieren.
Das Element sollte nicht mit den Parametern "domain" oder "toAllAreas"
angegeben werden.
cname
Gibt Folgendes an: optionaler eindeutiger Name eines Jobcontainers, aus dem die
wiederherzustellenden Jobs entnommen werden.
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.
Kapitel 3: cadsmcmd-Befehle 225
Kompatibilität
domain
Gibt Folgendes an: Name einer CA ITCM-Domänengruppe, in der die Registrierung
der Prozedur aufgehoben werden soll.
Der Parameter kann mehrfach angegeben werden, um eine Liste von CA ITCMDomänengruppen zu adressieren.
Der Parameter sollte nicht mit den Parametern "area" oder "toAllAreas" festgelegt
werden.
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.
item
Gibt Folgendes an: Name des Elements, dessen Registrierung aufgehoben wird.
Prozedur
Gibt Folgendes an: Name einer Prozedur.
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.
toAllAreas
Wenn dieser Parameter angegeben ist, wird die zugehörige Verteilung an alle CA
ITCM-Domänen gesendet, die beim Enterprise-Manager registriert sind.
Version
Gibt Folgendes an: Version des Elements, dessen Registrierung aufgehoben wird.
Beispiel:
cadsmcmd rderegproc item="Software TestC" version=0.46 procedure=Install2
area=N_LOCAL_SRV area=N_LOCAL_SRV_02 area=WO_LOCAL_SRV cname=TestCont3
sendtime="2005-03-06 18:45" halttime="2005-03-06 23:30"
recover – Wiederherstellen fehlgeschlagener Installationen
Der Befehl stellt die fehlgeschlagenen Installationen wieder her. Der Befehl bereinigt
auch die fehlgeschlagenen Installationen.
Der Befehl "Wiederherstellen" ist nur auf den Domänen-Managern zulässig.
226 CLI-Referenzhandbuch
Kompatibilität
Dieser Befehl kann in einem der beiden folgenden Formate vorliegen:
recover {item=Elementname version=Versionsname
installedwith=Installationsprozedur
procedure=Name_der Deinstallationsprozedur
[{computer=Computername}}
[after={exacttime|boottime}]
[nocalendar[={y|n}]
[offline[={y|n}]]
[deliverytime="JJJJ-MM-TT hh:mm" ]
[attime="JJJJ-MM-TT hh:mm" ]
[promptUser[={y|n}]]
[bootbefore[={y|n}]
[bootafte[={y|n}]
[timeout=Stunden]
[calendername=Lieferausschlusskalender]
[runAtShutdown[={y|n}]
[userJobMessage]
[userMessage]
recover cname=Name
[item=Elementname
version=Versionsname
installedwith=Installationsprozedur
procedure=Name_der Deinstallationsprozedur
[after={exacttime|boottime}]
[globalTime[={y|n}]]
[nocalendar[={y|n}]
[offline[={y|n}]]
[deliverytime="JJJJ-MM-TT hh:mm" ]
[attime="JJJJ-MM-TT hh:mm" ]
[promptUser[={y|n}]]
[bootbefore[={y|n}]
[bootafte[={y|n}]
[timeout=Stunden]
[calendername=Lieferausschlusskalender]
[nopurge]
[runAtShutdown[={y|n}]
[userJobMessage]
[userMessage]
Kapitel 3: cadsmcmd-Befehle 227
Kompatibilität
after={exacttime | boottime }
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.
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.
bootafter
Gibt an, dass der Zielcomputer vor der Ausführung der Prozedur neu gestartet
werden muss.
bootbefore
Gibt an, dass der Zielcomputer nach Abschluss der Prozedur neu gestartet werden
muss.
calendarname
Gibt Folgendes an: Name eines Kalenders, der die Zeiträume angibt, in denen
Lieferungen ausgeschlossen sind.
cname
Gibt den Namen des Jobcontainers an, dem die wiederherzustellenden Jobs
entnommen werden.
computer
Gibt Folgendes an: Name des Computers.
228 CLI-Referenzhandbuch
Kompatibilität
deliveryTime
Gibt Folgendes an: Startzeit der Lieferung vom Domänen-Manager.
Das Datum wird im ISO-Format "JJJJ-MM-TT HH:MM" angegeben.
Wenn der Parameter nicht angegeben ist, wird das gegenwärtige Datum und die
gegenwärtige Uhrzeit verwendet.
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änenManagers.
installedWith
Gibt Folgendes an: Name der Installationsprozedur.
Dieser Parameter sollte nur zusammen mit dem Parameter "item" angegeben
werden.
item
Gibt Folgendes an: Name des Elements, das wiederhergestellt wird.
Dieser Parameter sollte nur mit den Parametern "version", "installedWith" und
"procedure" angegeben werden.
Wenn das Parameterelement nicht angegeben ist, werden alle wiederherstellbaren
Jobs des angegebenen Containers mit Hilfe der ersten Deinstallationsprozedur, die
einem wiederherzustellenden Element zugeordnet ist, wiederhergestellt.
noCalendar
Wenn "noCalendar" angegeben ist, wird ein möglicherweise auf dem Zielcomputer
vorhandener Kalender für die Jobausführung ignoriert.
nopurge
Der in "cname" angegebene Container wird beibehalten, wenn der Parameter
angegeben wird, andernfalls wird der Container gelöscht.
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.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert
der zugehörigen Prozedur verwendet.
Kapitel 3: cadsmcmd-Befehle 229
Kompatibilität
Prozedur
Gibt Folgendes an: Namen der durchzuführenden "Deinstallationsprozedur"
Dieser Parameter sollte nur mit dem Parameter "item" angegeben werden.
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.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert
der zugehörigen Prozedur verwendet.
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.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert
der zugehörigen Prozedur verwendet.
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".
Version
Gibt Folgendes an: Version des Elements, das wiederhergestellt wird.
Dieser Parameter sollte nur mit dem Parameter "item" angegeben werden.
userJobMessage
230 CLI-Referenzhandbuch
Kompatibilität
Gibt die benutzerdefinierte Administratormeldung für einen fehlgeschlagenen Job
in einem Jobcontainer an.
userMessage
Gibt die benutzerdefinierte Administratormeldung für einen Jobcontainer an.
Hinweis: In der "cname"-Variante des Befehls ist der Block mit den Parametern zur
installierten Elementversion optional. Wenn diese Parameter nicht angegeben werden,
werden alle wiederherstellbaren Jobs des Containers wiederhergestellt. Hierbei wird die
erste Prozedur der Liste mit Deinstallationsprozeduren verwendet, die den zugehörigen
Produkten zugewiesen sind.
Beispiel:
Im folgenden Beispiel wird erläutert, wie eine fehlgeschlagene Installation auf dem
Computer N_LOCAL_SRV mit dem Befehl "recover" über den Domänen-Manager
wiederhergestellt wird:
cadsmcmd recover item="Software TestC" version=0.49A
installedwith=Install2 procedure=UninstallC
computer=N_LOCAL_SRV after=exacttime
attime="2005-10-10 10:55" promptuser timeout=168
regproc - Registrieren von Prozeduren
Verwenden Sie den Befehl "regproc", um eine eingebettete oder eine zusätzliche
Elementprozedur bei einem vorhandenen Softwareprogramm zu registrieren. Die
Elementprozedur muss sich in einem Verzeichnis befinden, auf das der EnterpriseManager oder der Domänen-Manager zugreifen kann.
Die Syntax des Befehls lautet folgendermaßen:
cadsmcmd regproc
item=Elementname
version=Versionsname
task={install | activate | configure | uninstall}
procedure=Prozedurname
os=bs
type={executable | command | SWD | MSI | SXP | PKG | PIF | IPS | PALM |
WINCE| RPM | NOKIA}
[enduser]
[notRAC]]
[externalproc]
file=Dateiname
path=Pfadname
[parameters=Prozedurparameter]
[defaultProc][query=Abfragename][sep=Trennzeichen]
[comment=Kommentar]
[usedefaultMsg]
Kapitel 3: cadsmcmd-Befehle 231
Kompatibilität
comment
Gibt an: Ein Kommentar für die Prozedur.
defaultProc
Wenn diese Option codiert ist, wird die registrierte Prozedur die Standardprozedur
von allen Prozeduren desselben Typs.
enduser
(Optional) Gibt an, ob Prozedur kann von einem Endbenutzer mit Hilfe der KatalogGUI für die Ausführung festgelegt werden.
externalproc
(Optional) Gibt an, dass die im Parameter "procedure" angegebene Prozedur extern
ist (die Prozedur muss von dem jeweiligen Zielsystem zur Verfügung gestellt
werden).
file
Gibt Folgendes an: Name der Prozedurdatei.
item
Gibt Folgendes an: Name des Elements, mit dem diese Prozedur als zusätzliche
Elementprozedur verbunden ist.
notRAC
(Optional) Gibt an, dass die Prozedur bei einer Neuinstallation nach einem Absturz
nicht berücksichtigt werden soll.
232 CLI-Referenzhandbuch
Kompatibilität
os
Gibt Folgendes an: Betriebssystemtyp, den die Prozedur unterstützt.
Werte:
os={AIX|AIX_3.2_RS/6000|AIX_4.1_RS/6000
...|AIX_4.2_RS/6000|AIX_4.3_RS/6000
...|AIX_5.0_RS/6000|AIX_5.1_RS/6000
...|AIX_5.2_RS/6000|AIX_5.3_RS/6000
...|AIX_5.4_RS/6000|AIX_5.5_RS/6000
...|AIX_5.6_RS/6000|AIX_5.7_RS/6000
...|AIX_5.8_RS/6000|ANY|COMPAQ_TRU64_(DEC)
...|COMPAQ_TRU64_5.X_ALPHA
...|DEC_3.0_ALPHA|DEC_3.2_ALPHA
...|DEC_4.0_ALPHA|DGUX|DGUX_4.1_INTEL
...|DGUX_4.1_MC88|DGUX_4.2_INTEL
...|DOS|DRS/NX_7MP_SPARC|DRS/NX_7_SPARC
...|DRS/NX_SPARC|DYNIX|DYNIX_4.2.X_INTEL
...|DYNIX_4.4.X_INTEL|HPUX
...|HPUX_10|HPUX_10_700|HPUX_10_800
...|HPUX_11|HPUX_11I_V2|HPUX_11_700
...|HPUX_11_800|HPUX_11_IA64
...|HPUX_12|HPUX_12I_V2|HPUX_12_700
...|HPUX_12_800|HPUX_12_IA64
...|HPUX_9|HPUX_9_700|HPUX_9_800
...|IRIX|IRIX_6.2|IRIX_6.3
...|IRIX_6.4|IRIX_6.5|LINUX
...|LINUX_2.1_INTEL|LINUX_2.2_INTEL
...|LINUX_2.2_S/390|LINUX_2.3_INTEL
...|LINUX_2.3_S/390|LINUX_2.4_INTEL
...|LINUX_2.4_S/390|LINUX_2.5_INTEL
...|LINUX_2.5_S/390|LINUX_2.6_INTEL
...|LINUX_2.6_INTEL_64-BIT
...|LINUX_2.6_S/390|MACINTOSH
...|MACINTOSH_10.0_PPC|MACINTOSH_10.1_PPC
...|MACINTOSH_10.2_PPC|MACINTOSH_10.3_PPC
...|MACINTOSH_10.4_PPC|NCR_SST
...|NCR_SST_S4I_INTEL|NCR_SST_S4_INTEL
...|NCR_SV|NCR_SV_2X_INTEL
...|NCR_SV_3X_INTEL|NETWARE
...|NETWARE_3_INTEL|NETWARE_4_INTEL
...|NETWARE_5_INTEL|NETWARE_6_INTEL
...|NOKIA_ADMINSUITE|NOKIA_ADMINSUITE_1.0
...|OPENVMS|OPENVMS_5.5_VAX
...|OPENVMS_6.0_ALPHA|OPENVMS_6.0_VAX
...|OPENVMS_6.1_ALPHA|OPENVMS_6.1_VAX
...|OPENVMS_6.2_ALPHA|OPENVMS_6.2_VAX
...|OPENVMS_7.0_ALPHA|OPENVMS_7.0_VAX
...|OPENVMS_7.1_ALPHA|OPENVMS_7.1_VAX
...|OPENVMS_7.2_ALPHA|OPENVMS_7.2_VAX
Kapitel 3: cadsmcmd-Befehle 233
Kompatibilität
...|OS/2_16-BIT|OS/2_32-BIT
...|PALM_OS|SCO|SCO_3.2_V5_INTEL
...|SCO_5.2_V5_INTEL|SINIX
...|SINIX_5.42_R4000|SINIX_5.43_R4000
...|SINIX_5.44_R4000|SINIX_5.45_R4000
...|SOLARIS|SOLARIS_10_INTEL
...|SOLARIS_10_SPARC|SOLARIS_2.3_SPARC
...|SOLARIS_2.4_INTEL|SOLARIS_2.4_SPARC
...|SOLARIS_2.5_INTEL|SOLARIS_2.5_SPARC
...|SOLARIS_2.6_INTEL|SOLARIS_2.6_SPARC
...|SOLARIS_7_INTEL|SOLARIS_7_SPARC
...|SOLARIS_8_INTEL|SOLARIS_8_SPARC
...|SOLARIS_9_INTEL|SOLARIS_9_SPARC
...|SUNOS|SUNOS_4.1.4_SPARC
...|UNIX|UNIXWARE|UNIXWARE2.0_INTEL
...|UNIXWARE2.1_INTEL|UNIXWARE7.X_INTEL
...|WINDOWS_16-BIT|WINDOWS_32-BIT
...|WINDOWS_95|WINDOWS_98
...|WINDOWS_ME|WIN_2000|WIN_2000_INTEL
...|WIN_CE|WIN_CE_2.00_MIPS
...|WIN_CE_2.00_SH3|WIN_CE_2.01_MIPS
...|WIN_CE_2.01_SH3|WIN_CE_2.11_ARM
...|WIN_CE_2.11_MIPS|WIN_CE_2.11_SH3
...|WIN_CE_2.11_SH4|WIN_CE_3.00_ARM
...|WIN_CE_3.00_MIPS|WIN_CE_3.00_PPC2002_ARM
...|WIN_CE_3.00_SH3|WIN_CE_3.00_SH4
...|WIN_CE_4.20_MOBILE2003_ARM
...|WIN_LONGHORN_SERVER_INTEL
...|WIN_LONGHORN_SERVER_ITANIUM
...|WIN_LONGHORN_SERVER_X64
...|WIN_NT|WIN_NT_ALPHA|WIN_NT_INTEL
...|WIN_NT_MIPS|WIN_SERVER_2003
...|WIN_SERVER_2003_INTEL
...|WIN_SERVER_2003_ITANIUM
...|WIN_SERVER_2003_X64|WIN_VISTA_INTEL
...|WIN_VISTA_ITANIUM|WIN_VISTA_X64
...|WIN_XP|WIN_XP_INTEL|WIN_XP_ITANIUM
...|WIN_XP_X64}
Hinweis: Wenn Sie den Befehl "regproc" im detaillierten Modus ausführen, wird
eine Liste der Werte angezeigt, die für die von Ihnen verwendete Version gültig
sind.
parameters
Parameter, die bei der Ausführung an die Prozedur zu übergeben sind.
234 CLI-Referenzhandbuch
Kompatibilität
path
Gibt je nach Verwendung einen der folgenden drei Fälle an:
Interne Prozedur
Die Prozedur ist ein wesentlicher Bestandteil des Produktpakets. Daher wird
davon ausgegangen, dass der Pfad ein relativer Pfad vom Stammverzeichnis
des Produkts zur Prozedurdatei ist.
Wenn das Produkt beispielsweise von "c:\swtest1" geladen wurde (dem
Stammverzeichnis des Produkts) und sich die Prozeduren in "c:\swtest1\procs"
befinden, geben Sie "path=PROCS" ein, um die Prozedur zu suchen.
Wenn sich die Prozedur ebenfalls in "c:\swtest1" befindet, codieren Sie unter
Windows "path=\" und unter UNIX "path=./".
(Siehe auch: Umgekehrter Schrägstrich (Windows) und normaler Schrägstrich
(UNIX))
Hinzugefügte Prozedur
Die Prozedur ist kein wesentlicher Bestandteil des Pakets, jedoch auf dem
Manager verfügbar. Daher muss der Pfad der absolute Zugriffspfad für die
Prozedurdatei auf dem Manager sein.
Wenn das Produkt beispielsweise von "c:\swtest1" geladen wurde, sich die
Prozedur, die zugewiesen werden soll, aber in "d:\procpool" auf dem Manager
befindet, auf dem der Befehl aufgerufen wird, müssen Sie "d:\procpool"
eingeben.
externe Prozedur
Die Prozedur ist weder ein wesentlicher Bestandteil des Pakets, noch ist sie auf
dem Manager vorhanden, auf dem der Befehl aufgerufen wurde. Sie sollte
jedoch auf allen Computern verfügbar sein, auf denen sie später ausgeführt
wird.
Anschließend muss die Prozedur auf allen diesen Zielcomputern an der
gleichen Stelle gespeichert sein, um adressiert werden zu können.
Stellen Sie die Prozedur beispielsweise auf dem entsprechenden Zielcomputer
unter "c:\usd_supp\procs" bereit. Geben Sie anschließend
"path=c:\usd_supp\procs" ein.
Hinweis: Dieser Parameter ist nicht obligatorisch, wenn das Argument
"externalProc" angegeben ist. In diesem Fall werden die mit dem Argument
"file" übergebenen Informationen verwendet, um das Verfahren zu ermitteln,
das an den Zielsystemen aufzurufen ist.
Wenn das Argument "externalProc" nicht angegeben wird, dann bleibt dieser
Parameter obligatorisch.
Prozedur
Gibt Folgendes an: Name einer Prozedur. Diese wird registriert.
query
Kapitel 3: cadsmcmd-Befehle 235
Kompatibilität
Gibt den Namen einer vorhandenen Abfrage an, die die Voraussetzungen für die
Ausführung dieser Prozedur beschreibt. Wenn diese Option nicht codiert ist,
wurden keine Voraussetzungen festgelegt.
Die Syntax des Abfragenamens lautet wie folgt:
{query_name | (Abfragename Trennzeichen Domänenname)}
Der Domänenname gibt den Namen der Domäne an, auf der diese Abfrage erstellt
wurde. Das Trennzeichen trennt den Abfragenamen und den Domänennamen. Das
Trennzeichen wird mit dem Parameter "sep" definiert. Wenn nur der Abfragename
angegeben ist, wird die Mitgliedschaft der Abfrage bei einer Domäne nicht
überprüft.
sep
Gibt das für diese Aktion verwendete Trennzeichen an. Das standardmäßige
Trennzeichen ist der Punkt ".".
task
Gibt Folgendes an: Typ des von der Elementprozedur auszuführenden Tasks.
Installieren
Registriert Installationsprozedur
Aktivieren
Registriert Aktivierungsprozedur
Konfigurieren
Registriert Konfigurationsprozedur
Deinstallieren
Registriert Deinstallationsprozedur
236 CLI-Referenzhandbuch
Kompatibilität
type
Gibt Folgendes an: Prozedurtyp.
Gültige Werte sind:
executable
ausführbare Datei (EXE oder COM)
Befehl
Befehlsdatei (.cmd oder .bat)
swd
Software Detector-Skript
msi
Microsoft Windows Installer-Paketdatei
sxp
SD-Paketformat für Windows
pkg
SD-Paketformat für UNIX
pif
Product Interchange-Datei: SD-Paketformat für UNIX
rpm
Paketformat für Linux RedHat Package Manager
ips
CA ITCM-Skriptdatei mit der Erweiterung .ips
palm
PALM-Anwendungsdatei mit der Dateierweiterung .prc
wince
Windows&#160;CE-Cabinet-Datei mit der Dateierweiterung .cab
nokia
NOKIA 9210 Communicator-Datei
usedefaultMsg
(Optional) Wenn das usedefaultMsg-Argument codiert wird, wird der der
Elementprozedur zugeordnete Kommentar als die Benutzerjobmeldung verwendet.
Version
Gibt Folgendes an: Version des Elements.
Kapitel 3: cadsmcmd-Befehle 237
Kompatibilität
Beispiel:
Im folgenden Beispiel wird eine Prozedur über die Befehlszeile eines Windows-Servers
registriert, so dass sie für Anforderungen über den Katalog verfügbar ist. Da sich die
Prozedurdatei "install1.cmd" nicht im aktuellen Verzeichnis oder unter dem Systempfad,
sondern auf dem Zielsystem befindet, handelt es sich um eine externe Prozedur, und
der vollständige Pfad muss angegeben werden.
cadsmcmd regproc item="Software Test" version=0.45 task=install
procedure=Install os=WINDOWS_32-BIT type=command enduser externalproc
file=install.cmd path=c:\test\swtest1 comment="Install Proc 1"
Im folgenden Beispiel wird das Argument "externalProc" verwendet. Der Parameter
"path" wird nicht verwendet. Die mit der Prozedur "conf_ext" verknüpfte ausführbare
Datei sollte die Programmdatei "configure.exe" sein, die sich unter "c:\myProcs\Prod"
befindet.
regproc item=prod1 version=1.2/98 task=configure procedure=conf_ext os=WIN_NT
type=executable externalProc file=c:\myProcs\Prod1
Auch im nächsten Beispiel wird der Parameter "path" nicht verwendet. Bei der mit der
Prozedur "act_ext" verknüpften ausführbare Datei handelt es sich um die
Programmdatei "act.exe", die sich unter dem Pfad (%PATH%) des Zielsystems befindet.
regproc item=prod1 version=1.2/98 task=activate procedure=act_ext os=WIN_NT
type=executable externalProc file=c:\myProcs\Prod1\act.exe
Im folgenden Beispiel wird der Parameter "path" verwendet. Die mit der Prozedur
"inst_ext" verknüpfte ausführbare Datei sollte die Programmdatei "install.exe" sein, die
sich unter "c:\myProcs\Prod1" auf den Zielsystemen befindet.
regproc item=prod1 version=1.2/98 task=install procedure=inst_ext os=WIN_NT
type=executable externalProc file=install.exe path=c:\myProcs\Prod1
238 CLI-Referenzhandbuch
Kompatibilität
regsw - Registrieren von Software
Mit Hilfe des Befehls regsw haben Sie die folgenden Möglichkeiten:
■
Registrieren eines neuen Softwareprogramms
■
Registrieren einer neuen Programmversion, die auf einer bereits in der Bibliothek
registrierten Programmversion basiert
Dieser Befehl hat das folgende Format:
regsw
{item=Elementname
version=Elementversion
[basedonitem=baseproduct basedonversion=baseversion] path=sourcepath
[comment=Kommentar]
[supplier=Hersteller]
[procedures=Prozedurlistenname]}
[nochecksum]
basedonitem
Gibt Folgendes an: Produktname des ursprünglichen Elements, auf dem das neue
Element basiert.
basedonversion
Gibt Folgendes an: Version des Basisprodukts.
comment
Gibt an: Ein Kommentar zu dieser Elementversion.
item
Gibt den Namen des neuen Elements an.
noChecksum
Wenn dieser optionale Parameter angegeben ist, gibt es keine Integritätsprüfung
über die Prüfsumme.
Standardmäßig ist die Prüfsummenkontrolle aktiviert, wenn von "regsw" ein Paket
definiert wird. Wenn die Prüfsumme deaktiviert werden soll, muss dieser
Parameter angegeben werden.
Im detaillierten Modus müssen Sie "Yes" oder "No" für den Parameter
"NoChecksum" eingeben. Geben Sie "Yes" ein, um den Parameter zu aktivieren und
"No", um ihn zu deaktivieren.
Die Standardeinstellung für den detaillierten Modus ist "No", d.&#160;h. die
Prüfsummenkontrolle ist aktiviert.
Kapitel 3: cadsmcmd-Befehle 239
Kompatibilität
path
Gibt Folgendes an: Verzeichnis des Managers, in dem sich das Bild des Elementes
befindet, das registriert wird.
Wenn "Quellpfad" auf ein zugeordnetes Laufwerk verweist, muss der SD-Dienst auf
dieses zugreifen können.
Verfahren
Dieser Parameter gibt den Namen einer Datei an, die die eingebetteten Prozeduren
des zu registrierenden Elements definiert.
SD muss Zugriff auf diese Datei haben.
Die Prozeduren werden durch "regproc"-Befehle definiert.
Für die Inhalte dieser Datei gilt Folgendes:
■
"regrpoc" kann ohne Element und Versionsparameter angegeben werden. Sie
sind für eine solche Datei optional. Wenn sie aber angegeben werden, müssen
sie sich auf das registrierte Produkt beziehen. Anderenfalls wird ein Fehler
angezeigt.
■
"regproc" kann sich über mehrere Zeilen erstrecken.
■
Es können Kommentare hinzugefügt werden. Ihnen muss ein Hash-Zeichen (#)
vorangestellt sein.
■
Parameterwerte, die Leerzeichen enthalten, müssen in doppelte
Anführungszeichen (") eingeschlossen werden.
Wenn der Parameter "procedures" angegeben ist, wird das Produkt nach
erfolgreicher Registrierung automatisch versiegelt. Anderenfalls bleibt es für die
weitere Verarbeitung weiter unversiegelt.
supplier
Gibt Folgendes an: Hersteller des Elementes.
Version
Gibt Folgendes an: Version des Elements.
Das folgende Beispiel zeigt die Ausgabe des Befehls "regsw" über einen Linux-Server
zum Registrieren der Version 0.45 eines Softwarepakets namens "Software Test".
cadsmcmd regsw item="Software Test" version=0.45 path=/usr/test/swtest1
comment="Test software registration" supplier=CA
procedures=/usr/test/proclist.txt
Das folgende Beispiel zeigt die Registrierung desselben Softwarepakets über einen
Windows-Server und enthält vier eingebettete Elementprozeduren. Der Parameter
"procedures" gibt den Namen der Datei an, die die Liste der Prozeduren enthält.
cadsmcmd regsw item="Software Test" version=0.45 path=c:\test\swtest1
comment="Test software registration"supplier=CA procedures=c:\test\proclist.txt
240 CLI-Referenzhandbuch
Kompatibilität
Das folgende Beispiel zeigt eine Datei, die eine Liste mit Prozeduren enthält:
# Diese Datei enthält eine Liste aller eingebetteter Elementprozeduren für Software Test
Version 0.45
regproc task=install procedure="Install Proc 1" os=WINDOWS_32-BIT type=command
enduser file=install1.cmd path=\
regproc task=activate procedure="Activate Proc 1" os=WINDOWS_32-BIT type=command
enduser file=activ1.cmd path=\
regproc task=configure procedure="Configure Proc 1" os=WINDOWS_32-BIT
type=command enduser file=config1.cmd path=\
regproc task=uninstall procedure="Uninstall Proc 1" os=WINDOWS_32-BIT
type=command enduser file=uninst1.cmd path=\
Die Pfadangabe lautet "\", da sich die Prozeduren im selben Verzeichnis wie die
Software selbst befinden. Befänden sich die Prozeduren im Unterverzeichnis
"C:\test\swtest1\proc", müsste in der Datei mit den Prozeduren die Angabe
"path=\proc" verwendet werden. Auf Linux-Servern wird der Pfad auf die gleiche Art
und Weise angegeben, nur dass als Trennzeichen "/" verwendet wird.
renew – Erneuern einer Verteilung
Der Befehl "renew" ist nur gültig, wenn er vom Enterprise-Manager ausgegeben wird.
"renew" wird verwendet, um eine fehlgeschlagene oder angehaltene Verteilung wieder
aufzunehmen.
Dieser Befehl hat das folgende Format:
renew name=Verteilungsname
[sendTime=JJJJ-MM-TT HH:MM]
[haltTime=JJJJ-MM-TT HH:MM]
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.
Name
Gibt Folgendes an: Name der Verteilung, die erneuert werden soll.
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.
Kapitel 3: cadsmcmd-Befehle 241
Kompatibilität
Beispiel:
Beispiel für die Ausgabe des Befehls "cadsmcmd progress":
cadsmcmd progress name=TestCont11
Dieser Befehl zeigt TestCont11 als angehaltene Verteilung:
Verteilungsname: TestCont11, Status - Angehalten.
SendDateTime: 2003/03/05 18:04, InstallDateTime: 2003/03/05 18:10, HaltDateTime:
2003/03/05 18:15
Gesamtzahl der Bereiche: 2, Warten: 0, Aktiv: 0, in Fehler: 1, OK: 1.
Bereich: N_LOCAL_SRV at Downtown 100 % gesendet. Status - OK.
Bereich: N_LOCAL_SRV_02 at Rural Area 0 % gesendet. Status - Angehalten.
SDCMD<A000000> : OK
Der Befehl "cadsmcmd renew" wird ausgegeben, um die angehaltene TestCont11Verteilung zu erneuern:
cadsmcmd renew name=TestCont11
Eine erneute Ausgabe des Befehls "cadsmcmd progress" zeigt, dass die TestCont11Verteilung erneuert wurde, so dass der Status "Aktiv" ist.
Verteilungsname: TestCont11, Status - Aktiv.
SendDateTime: 2003/03/05 18:04, InstallDateTime: 2003/03/05 19:10, HaltDateTime:
2003/03/05 22:30
Gesamtzahl der Bereiche: 2, Warten: 0, Aktiv: 1, in Fehler: 0, OK: 1.
Bereich: N_LOCAL_SRV at Downtown 100 % gesendet. Status - OK.
Bereich: N_LOCAL_SRV_02 at Rural Area 0 % gesendet. Status - Aktiv.
SDCMD<A000000> : OK
242 CLI-Referenzhandbuch
Kompatibilität
renewjob – Erneuern eines Jobs
Der Renewjob-Befehl erneuert einen fehlgeschlagenen Job. Der Befehl ist nur gültig,
wenn er vom Domänen-Manager ausgegeben wird.
Dieser Befehl hat das folgende Format:
renewjob
item=Elementname
version=Versionsname
procedure=Prozedurname
installedwith=Name_der_Installationsprozedur
task={install | activate | configure | uninstall}
[deliverytime="jjjj-mm-tt hh:mm" ]
[calendername=Lieferausschlusskalender]
[attime="jjjj-mm-tt hh:mm" ]
[timeout=Stunden]
[runAtShutdown[={y|n}]]
[userJobMessage]
[userMessage]
oder
renewjob
cname=[Name]
[item=Elementname
version=Versionsname
procedure=Prozedurname ]
[deliverytime="jjjj-mm-tt hh:mm" ]
[attime="jjjj-mm-tt hh:mm" ]
[calendername=Lieferausschlusskalender]
[timeout=Stunden]
[runAtShutdown[={y|n}]]
[userJobMessage]
[userMessage]
Kapitel 3: cadsmcmd-Befehle 243
Kompatibilität
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 eines Kalenders, der die Zeiträume angibt, in denen
Lieferungen ausgeschlossen sind
cname
Gibt an: optionaler eindeutiger Name eines Jobcontainers, der die zu erneuernden
Jobs enthält.
Die Parameter "item", "version" und "procedure" sind optional, wenn "cname"
angegeben ist:
Wenn letztere angegeben sind, werden nur die Jobs des Containers, die durch diese
Parameter angegeben sind, erneuert.
Wenn sie nicht angegeben sind, werden alle erneuerbaren Jobs des angegebenen
Containers erneuert.
Wenn "cname" nicht angegeben ist, ist der zu erneuernde Job der erste erfasste
erneuerbare Job, der der Spezifikation der Parameter "item", "version",
"installedWith", "procedure" und "task" entspricht.
deliverytime
Gibt Folgendes an: Startzeit der Lieferung vom Domänen-Manager.
Das Datum wird im ISO-Format "JJJJ-MM-TT HH:MM" angegeben.
installedWith
Gibt Folgendes an: Name der Installationsprozedur.
Der zu erneuernde Job wurde mit dieser Prozedur installiert.
Der Parameter wird ignoriert, wenn "cname" angegeben ist.
item
Gibt Folgendes an: Name des Elements. Der zu erneuernde Job muss sich auf dieses
Element beziehen.
Prozedur
Gibt Folgendes an: Name einer Prozedur. Der zu erneuernde Job muss sich auf diese
Prozedur beziehen.
244 CLI-Referenzhandbuch
Kompatibilität
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.
task
Gibt Folgendes an: Typ des von der Elementprozedur auszuführenden Tasks.
Die wiederherzustellende Prozedur muss sich auf eine Prozedur dieses Task-Typs
beziehen.
install
Eine Installationsprozedur.
configure
Eine Konfigurationsprozedur.
activate
Eine Aktivierungsprozedur.
uninstall
Eine Deinstallationsprozedur.
Der Parameter wird ignoriert, wenn "cname" angegeben ist.
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".
Version
Kapitel 3: cadsmcmd-Befehle 245
Kompatibilität
Gibt Folgendes an: Version des Elements, dessen Registrierung aufgehoben wird.
userJobMessage
Gibt die benutzerdefinierte Administratormeldung für einen erneuerten Job in
einem Jobcontainer an.
userMessage
Gibt die benutzerdefinierte Administratormeldung für einen Jobcontainer an.
Hinweis: Der erste Job mit Fehlerstatus in der Jobliste, der den Parametern "item",
"version", "procedure" und "installedWith" entspricht, wird für die Operation "renew"
ausgewählt. Diese verwendet die von dem Parameter "procedure" angegebene
Prozedur.
Hinweis: In der "cname"-Variante des Befehls sind die Parameter "block item",
"version" und "procedure" optional. Wenn Sie nicht angegeben werden, werden alle
erneuerbaren Jobs des Containers erneuert.
resume – Wiederaufnehmen einer angehaltenen Verteilung
Dieser Befehl wird für die Wiederaufnahme einer angehaltenen Verteilung verwendet.
Folgendes Format wird verwendet:
resume name=Jobcontainername
[sendtime=JJJJ-MM-TT HH:MM ]
[halttime=JJJJ-MM-TT HH:MM ]
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.
Hinweis: Max_Dist_Time gibt die maximale Anzahl von Minuten an, die vergehen
kann, bevor eine Containerverteilung in den Fehlerzustand versetzt wird.
Name
Gibt Folgendes an: Name der Verteilung, die angehalten wird und
wiederaufgenommen werden soll.
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.
246 CLI-Referenzhandbuch
Kompatibilität
rregproc – Remote-Registrierung von Prozeduren
Dieser Befehl wird verwendet, um eine Anweisung zur Registrierung einer Prozedur in
der Bibliothek eines oder mehrerer Domänen-Manager zu senden. Der Befehl wird an
einen Enterprise-Manager übergeben und an eine Domäne oder eine Domänengruppe
weitergeleitet.
Der Befehl ist nur für Enterprise-Manager zulässig.
Folgendes Format wird verwendet:
rregproc item=Elementname
version=Versionsname
procedure=Prozedurname
{{area=Bereichsname} | {domain=Domänenname} | toAllAreas}
[cname=Name]
[sendTime=JJJJ-MM-TT HH:MM]
[haltTime=JJJJ-MM-TT HH:MM]
area
Gibt Folgendes an: Name einer CA ITCM-Domäne, in der die Prozedur am
angegebenen Produkt registriert werden soll.
Dieser Parameter kann mehrfach angegeben werden, um eine Liste von CA ITCMDomänen zu adressieren.
Dieser Parameter sollte nicht mit den Parametern "domain" oder "toAllAreas"
angegeben werden.
cname
Gibt Folgendes an: optionaler eindeutiger Name eines Verteilungscontainers..
Wenn kein Parameter "cname" angegeben wird, wird intern ein Name generiert,
der von der Befehlszeilenschnittstelle als ID zurückgegeben wird.
domain
Gibt Folgendes an: Name einer CA ITCM-Domänengruppe, in der die Prozedur am
angegebenen Produkt registriert werden soll.
Dieser Parameter kann mehrfach angegeben werden, um eine Liste von CA ITCMDomänengruppen zu adressieren.
Dieser Parameter sollte nicht mit den Parametern "area" oder "toAllAreas"
angegeben werden.
Kapitel 3: cadsmcmd-Befehle 247
Kompatibilität
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.
item
Gibt Folgendes an: Name des Elements, bei dem die angegebene Prozedur
registriert wird.
Prozedur
Gibt Folgendes an: Name einer Prozedur, die registriert werden soll.
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.
toAllAreas
Wenn dieser Parameter angegeben ist, wird die zugehörige Verteilung an alle CA
ITCM-Domänen gesendet, die beim Enterprise-Manager registriert sind.
"toAllAreas" sollte nicht mit den Parametern "area" oder "domain" angegeben
werden.
Version
Gibt Folgendes an: Version des Elements, bei dem die angegebenen Prozeduren
registriert werden.
Beispiel:
Folgendes Syntaxbeispiel wurde über einen Windows-Server eingegeben:
cadsmcmd rregproc item="Software TestC" version=0.46 procedure=Install2
area=N_LOCAL_SRV_02 area=WO_LOCAL_SRV cname=TestCont2 sendtime="2005-03-04 17:35"
halttime="2005-03-04 22:55"
248 CLI-Referenzhandbuch
Kompatibilität
rregsw – Remote-Registrierung von Software
Der Befehl "rregsw" wird verwendet, um ein neues Softwareprogramm aus der
Enterprise-Manager-Bibliothek an eine angegebene Liste von Domänen oder
Domänengruppen zu verteilen, und dieses in der Bibliothek der Domänen-Manager in
diesen Domänen zu registrieren.
Der Befehl "rregsw" ist nur gültig, wenn er von der Befehlszeile des EnterpriseManagers ausgegeben wird.
Dieser Befehl hat das folgende Format:
rregsw item=Elementname
version=Versionsname
{{area=Bereichsname} | {domain=Domänenname} | toAllAreas}
[cname=Name]
[sendTime=JJJJ-MM-TT HH:MM]
[haltTime=JJJJ-MM-TT HH:MM]
[delta[={y|n}]]
area
Gibt Folgendes an: Name einer CA ITCM-Domäne, in der ein Element registriert
werden soll.
Dieser Parameter kann mehrfach angegeben werden, um eine Liste von CA ITCMDomänen zu adressieren.
Dieser Parameter sollte nicht mit den Parametern "domain" oder "toAllAreas"
angegeben werden.
cname
Gibt Folgendes an: optionaler eindeutiger Name der Verteilung.
Wenn kein Parameter "cname" angegeben wird, wird intern ein Name generiert,
der von der Befehlszeilenschnittstelle als ID zurückgegeben wird.
delta
Gibt an, dass nur das Delta an Remote-CA ITCM-Domänen gesendet wird, wenn das
Element auf einer früheren Version beruht. Die frühere Version muss bereits bei
den Remote-CA ITCM-Domänen registriert sein.
Kapitel 3: cadsmcmd-Befehle 249
Kompatibilität
domain
Gibt Folgendes an: Name einer CA ITCM-Domänengruppe, in der das angegebene
Element registriert wird.
Dieser Parameter kann mehrfach angegeben werden, um eine Liste von CA ITCMDomänengruppen zu adressieren.
Dieser Parameter sollte nicht mit den Parametern "area" oder "toAllAreas"
angegeben werden.
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.
Weitere Informationen zur Wiederaufnahme einer angehaltenen Verteilung finden
Sie unter dem Befehl resume.
item
Gibt Folgendes an: Name des Elements, dessen Registrierung aufgehoben wird.
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.
toAllAreas
Wenn dieser Parameter angegeben ist, wird die zugehörige Verteilung an alle CA
ITCM-Domänen gesendet, die beim Enterprise-Manager registriert sind.
"toAllAreas" sollte nicht mit den Parametern "area" oder "domain" angegeben
werden.
Version
Gibt Folgendes an: Version des Elements, das registriert wird.
Beispiel:
cadsmcmd rregsw item="Software TestC" version=0.46 area=N_LOCAL_SRV
area=N_LOCAL_SRV_02 area=W0_LOCAL_SRV
cname=TestCont1 sendtime="2005-03-03 17:05" halttime="2005-03-03 21:05"
scalabilityServer
Dieser Abschnitt enthält die folgenden Themen:
collectSector – Erfassen von Sektorinformationen auf dem Scalability-Server (siehe Seite
251)
250 CLI-Referenzhandbuch
Kompatibilität
collectSector – Erfassen von Sektorinformationen auf dem Scalability-Server
Mit dieser Aktion planen Sie eine Anfrage zum Erfassen der Sektorinformationen auf
dem angegebenen Scalability-Server.
Sie hat die folgende Syntax:
scalabilityServer action=collectSector
name=Name_des_Scalability-Servers
[COLLECTALL]
Name
Gibt den Namen des Scalability-Servers an, auf dem die Sektorinformationen erfasst
werden.
COLLECTALL
(Optional) Diese Option steuert die im Sektor erfasste Datenmenge.
Wenn diese Option nicht codiert ist, werden nur die Informationen zu allgemeinen
Computern und Benutzern erfasst.
Wenn die Option codiert ist, werden alle verfügbaren Sektorinformationen
einschließlich Asset Management-Inventardaten erfasst.
Hinweis: Sie sollten Folgendes beachten:
■
Die Aktion arbeitet asynchron. Sie kehrt zurück, sobald die Anfrage geplant wird. Sie
wartet nicht darauf, dass eine Engine diesen Task ausführt.
■
Der Name des Scalability-Servers muss eindeutig sein, anderenfalls schlägt die
Aktion fehl.
■
Der angesprochene Asset Management-Manager ermittelt automatisch aus dem
Namen des Scalability-Servers die für die Verarbeitung dieser Anfrage zuständige
Engine.
■
Die Aktion steht nur für einen Domänen-Manager zur Verfügung. Wenn sie für
einen Enterprise-Manager gestartet wird, wird sie mit einem Fehler abgelehnt.
security
Mit der Sicherheitsaktion können Sie die Sicherheitsbereichszuweisungen für einige
Typen von verteilten Objekten durch Nachverarbeitung verwalten.
Der Befehl ist für Domänen-Manager verfügbar.
Dieser Abschnitt enthält die folgenden Themen:
linkSAToSO (siehe Seite 252)
unlinkSAFromSO (siehe Seite 254)
Kapitel 3: cadsmcmd-Befehle 251
Kompatibilität
linkSAToSO
Der Befehl verknüpft eine Liste von angegebenen gesicherten Objekten mit einem
angegebenen Sicherheitsbereich.
Dieser Befehl ist nur für Domänen-Manager gültig.
Folgendes Format wird verwendet:
cadsmcmd security
action=linkSAToSO
name=Name_des_Sicherheitsbereichs
{soName=Name_des_gesicherten_Objekts}
classId=Sicherheitsklassen-ID
[folderName=Ordnername
folderClassId=ID_der_Ordnerklasse]
[domainName=Domänenname]
Name
Gibt den Namen des Sicherheitsbereichs an, mit dem die angegebenen Objekte
verknüpft sind.
soName
Gibt den Namen (die Bezeichnung) des gesicherten Objekts an, das mit dem
angegebenen Sicherheitsbereich verknüpft werden soll.
Diese Option kann mehrfach codiert werden, um eine Liste von gesicherten
Objekten zu übergeben.
Wenn das gesicherte Objekt aus der Sicherheitsklasse "SoftwarePackage" stammt,
müssen Sie den Namen und die Version im folgenden Format angeben:
«Name»|«Version».
Falls «Name» Leerzeichen enthält, müssen Sie «Name»|«Version» in Anführungszeichen
setzen:
"«Name»|«Version»".
Beispiel:
Name "Testpaket" und Version "1.0"
soname=Testpaket|1.0
Name "CA ITCM-Manager" und Version "12.0"
soname="CA ITCM-Manager|12.0"
252 CLI-Referenzhandbuch
Kompatibilität
classId
Gibt die ID der Sicherheitsklasse an, zu der die gesicherten Objekte gehören. Die
folgenden IDs sind gültig:
SoftwarePackage
für die Softwarepaketklasse
SoftwareJob
für die Software-Jobklasse
SoftwareJobContainer
für die Software-Jobcontainerklasse
SoftwarePolicy
für die Klasse von Software-basierten Richtlinien.
folderName
Gibt den Namen eines Ordners oder Containers an, zu dem alle angegebenen
gesicherten Objekte gehören. Die Option ist für die folgenden Sicherheitsklassen
obligatorisch:
SoftwareJob
In allen anderen Fällen wird der Parameter ignoriert.
folderClassId
Gibt die ID der Sicherheitsklasse an, zu der der angegebene Ordner gehört. Die
folgenden IDs sind gültig:
■
SoftwareJobContainer
■
SoftwarePolicy
Der Parameter wird ignoriert, wenn der Parameter "folderName" ignoriert wird.
Domänenname
Gibt den Namen der Domäne an, zu der alle angegebenen gesicherten Objekte und
möglicherweise vorhandenen Ordner gehören. Wenn der Parameter nicht codiert
ist, wird davon ausgegangen, dass alle Objekte zur lokalen Domäne des Managers
gehören, der durch diesen CADSMCMD-Aufruf angesprochen wird.
Hinweis: Diese Option ist für Sicherheitsobjekte des Typs "SoftwarePackage"
veraltet und wird ignoriert, wenn sie codiert ist.
cadsmcmd.example.linkSAToSo
Das folgende Beispiel zeigt, wie das gesicherte Objekt "RAC:srktest" mit dem
Sicherheitsbereich "m1_area001" verknüpft wird.
Cadsmcmd security action=linkSAToSO name=m1_area001 soname="RAC:srktest [1/8/2010
12:55PM]" classid=softwarejobcontainer domainname=testdomain
Kapitel 3: cadsmcmd-Befehle 253
Kompatibilität
unlinkSAFromSO
Der Befehl hebt die Verknüpfung zwischen einer Liste von angegebenen gesicherten
Objekten und einem angegebenen Sicherheitsbereich auf.
Dieser Befehl ist nur für Domänen-Manager gültig.
Folgendes Format wird verwendet:
cadsmcmd security
action=unlinkSAFromSO
name=Name_des_Sicherheitsbereichs
{soName=Name_des_gesicherten_Objekts}
classId=Sicherheitsklassen-ID
[folderName=Ordnername
folderClassId=ID_der_Ordnerklasse]
[domainName=Domänenname]
Name
Gibt den Namen des Sicherheitsbereichs an, dessen Verknüpfung mit den
angegebenen Objekten aufgehoben wird.
soName
Gibt den Namen (die Bezeichnung) des gesicherten Objekts an, dessen Verknüpfung
mit dem angegebenen Sicherheitsbereich aufgehoben werden soll.
Diese Option kann mehrfach codiert werden, um eine Liste von gesicherten
Objekten zu übergeben.
Wenn das gesicherte Objekt aus der Sicherheitsklasse "SoftwarePackage" stammt,
müssen Sie den Namen und die Version im folgenden Format angeben:
«Name»|«Version».
Falls «Name» Leerzeichen enthält, müssen Sie «Name»|«Version» in Anführungszeichen
setzen:
"«Name»|«Version»".
Beispiel:
Name "Testpaket" und Version "1.0"
soname=Testpaket|1.0
Name "CA ITCM-Manager" und Version "12.0"
soname="CA ITCM-Manager|12.0"
254 CLI-Referenzhandbuch
Kompatibilität
classId
Gibt die ID der Sicherheitsklasse an, zu der die gesicherten Objekte gehören. Die
folgenden IDs sind gültig:
SoftwarePackage
für die Softwarepaketklasse
SoftwareJob
für die Software-Jobklasse
SoftwareJobContainer
für die Software-Jobcontainerklasse
SoftwarePolicy
für die Klasse von Software-basierten Richtlinien.
folderName
Gibt den Namen eines Ordners oder Containers an, zu dem alle angegebenen
gesicherten Objekte gehören. Die Option ist für die folgenden Sicherheitsklassen
obligatorisch:
SoftwareJob
In allen anderen Fällen wird der Parameter ignoriert.
folderClassId
Gibt die ID der Sicherheitsklasse an, zu der der angegebene Ordner gehört. Die
folgenden IDs sind gültig:
■
SoftwareJobContainer
■
SoftwarePolicy
Der Parameter wird ignoriert, wenn der Parameter "folderName" ignoriert wird.
Domänenname
Gibt den Namen der Domäne an, zu der alle angegebenen gesicherten Objekte und
möglicherweise vorhandenen Ordner gehören. Wenn der Parameter nicht codiert
ist, wird davon ausgegangen, dass alle Objekte zur lokalen Domäne des Managers
gehören, der durch diesen CADSMCMD-Aufruf angesprochen wird.
Hinweis: Diese Option ist für Sicherheitsobjekte des Typs "SoftwarePackage"
veraltet und wird ignoriert, wenn sie codiert ist.
cadsmcmd.example.unlinkSAFromSO
Das folgende Beispiel zeigt, wie die Verknüpfung des gesicherten Objekts "RAC:srktest"
mit dem Sicherheitsbereich "m1_area001" aufgehoben wird.
Cadsmcmd security action=unlinkSAFromSO name=m1_area001 soname="RAC:srktest
[1/8/2010 12:55PM]" classid=softwarejobcontainer domainname=testdomain
Kapitel 3: cadsmcmd-Befehle 255
Kompatibilität
servergroup – Verwalten von Servergruppen
Eine Servergruppe (ServerGroup) ist eine Sammlung von Scalability-Servern.
Alle Methoden von "ServerGroup" sind sowohl auf dem Domänen-Manager als auch auf
dem Enterprise-Manager verfügbar, solange nichts anderes angegeben wird.
Dieser Abschnitt enthält die folgenden Themen:
Allgemeine Gruppenverwaltung (siehe Seite 256)
Mitgliedschaftsverwaltung (siehe Seite 260)
Hierarchieverwaltung (siehe Seite 264)
Allgemeine Gruppenverwaltung
Dieser Abschnitt enthält die folgenden Themen:
create – Erstellen von Servergruppen (siehe Seite 256)
delete – Löschen von Servergruppen (siehe Seite 258)
list – Auflisten von Servergruppen (siehe Seite 258)
modify – Ändern von Servergruppen (siehe Seite 258)
showAttr – Anzeigen von Attributen von Servergruppen (siehe Seite 259)
create – Erstellen von Servergruppen
Mit dieser Aktion können Sie Servergruppen erstellen.
Folgendes Format wird verwendet:
servergroup action=create
name=Gruppenname
[superGroup=Name der übergeordneten Gruppe]
[comment=Kommentar]
[{server=Scalability-Server} | addall]
[InheritPerms[={y|n}]]
addall
Alle Scalability-Server, die zum Zeitpunkt der Erstellung vorhanden sind, werden zur
Gruppe hinzugefügt.
comment
Gibt einen Kommentar für die zu erstellende Gruppe an.
256 CLI-Referenzhandbuch
Kompatibilität
inheritPerms
Dieser Parameter gibt an, ob die erstellte Gruppe Sicherheitsberechtigungen
übernimmt.
Wenn "InheritPerms" oder "InheritPerms=y" codiert ist, gibt die angegebene
Gruppe Berechtigungen an ihre Mitglieder weiter und wird zu einer
Sicherheitsgruppe.
Wenn "InheritPerms=n" codiert ist, gibt die angegebene Gruppe keine
Berechtigungen an ihre Mitglieder weiter und ist daher keine Sicherheitsgruppe.
Standard: InheritPerms=y .
Name
Gibt den Namen der Servergruppe an, die erstellt werden soll.
Server
Gibt den Namen eines Scalability-Servers an, der der Gruppe hinzugefügt werden
soll.
Dieser Parameter kann mehrfach angegeben werden, um der Gruppe mehrere
Server hinzuzufügen.
superGroup
Gibt den Namen einer vorhandenen Servergruppe an, in der die betreffende
Gruppe als Untergruppe erstellt wird.
Wenn dieser Parameter nicht angegeben wird, wird die Gruppe im Systemordner
für Scalability-Servergruppen erstellt.
Beispiel
Es soll eine Servergruppe erstellt werden:
■
Die Gruppe soll "LA_Server" heißen.
■
Sie soll die Scalability-Server "LA_server01" und "LA_server02" umfassen.
■
Die Gruppe soll zunächst keine Untergruppe einer anderen Gruppe sein.
Eine solche Gruppe können Sie mit dem folgenden Befehl erstellen:
cadsmcmd servergroup action=create name=LA_Server server=LA_Server01
server=LA_Server02
Kapitel 3: cadsmcmd-Befehle 257
Kompatibilität
delete – Löschen von Servergruppen
Mit dieser Aktion können Sie Servergruppen löschen.
Diese Aktion hat das folgende Format:
jobcontainer action=delete name=Gruppenname
Name
Gibt den Namen der Servergruppe an, die gelöscht werden soll.
Beispiel
Um die Gruppe "sg" zu löschen, geben Sie den folgenden Befehl ein:
cadsmcmd servergroup action=delete name=sg
list – Auflisten von Servergruppen
Mit dieser Aktion können Sie alle Servergruppen auflisten.
Diese Aktion hat das folgende Format:
servergroup action=list
Beispiel
Der folgende Befehl generiert eine Liste aller Servergruppen:
cadsmcmd servergroup action=list
modify – Ändern von Servergruppen
Mit dieser Aktion können Sie Servergruppen ändern.
Folgendes Format wird verwendet:
servergroup action=modify
name=Gruppenname
[NewName=Neuer Name]
[InheritPerms[={y|n}]]
[comment=Kommentar]
258 CLI-Referenzhandbuch
Kompatibilität
comment
Gibt den neuen Kommentar für die Gruppe an. Geben Sie eine leere Zeichenfolge
ein (""), wenn Sie einen Kommentar löschen möchten.
inheritPerms
Dieser optionale Parameter gibt an, ob die geänderte Gruppe eine
Sicherheitsgruppe ist.
Wenn "InheritPerms=n" codiert ist, gibt die angegebene Gruppe keine
Berechtigungen an ihre Mitglieder weiter und ist daher keine Sicherheitsgruppe
mehr.
Wenn "InheritPerms" oder "InheritPerms=y" codiert ist, gibt die angegebene
Gruppe Berechtigungen an ihre Mitglieder weiter und wird daher zu einer
Sicherheitsgruppe.
Wenn der Parameter nicht codiert ist, werden die BerechtigungsübernahmeEinstellungen der Gruppe nicht geändert.
Name
Gibt den Namen der Servergruppe an, die geändert werden soll.
NewName
Gibt Folgendes an: Neuer Name der Servergruppe.
Beispiel
Angenommen, die Gruppe "LA_Server" soll bearbeitet werden.
Der Name der Gruppe soll in "LA District" geändert werden.
Diese Änderungen wird mit Hilfe des folgenden Befehls durchgeführt:
cadsmcmd servergroup action=modify name=LA_Server newName="LA District"
showAttr – Anzeigen von Attributen von Servergruppen
Mit dieser Aktion können Sie die Attribute von Servergruppen auflisten.
Diese Aktion hat das folgende Format:
servergroup action=showattr
name=Gruppenname
[groupScope={global | local}]
Kapitel 3: cadsmcmd-Befehle 259
Kompatibilität
Name
Gibt den Namen der Servergruppe an, deren Attribute angezeigt werden.
groupScope
Gibt den Bereich der definierten Gruppe an. Für diese Option sind folgende Werte
gültig:
Global
Bei der Gruppe handelt es sich um eine globale, auf einem Enterprise-Manager
erstellte Gruppe. Sie kann auf einem Domänen-Manager repliziert werden.
Lokal
Gibt eine auf dem mit "CADSMCMD" verbundenen Domänen-Manager erstellte
lokale Gruppe an.
Wenn "groupScope" nicht angegeben ist, versucht der Befehl "CADSMCMD"
zunächst, die Gruppe als lokale Gruppe zu bestimmen. Sollte dies fehlschlagen, wird
versucht, die Gruppe als globale Gruppe zu bestimmen.
Beispiel
cadsmcmd servergroup action=showattr name=sg_1
Die Ausgabe lautet folgendermaßen:
----------------------------------------------------------------------------Attribute der Servergruppe "sg_1"
----------------------------------------------------------------------------Servergruppenname....................: sg_1
Kommentar.............................:
Sicherheitstyp..........................: Sicherheitsgruppe
Erstellungsdatum..........................: 2006-08-28
Erstellungszeitpunkt..........................: 09:57
Änderungsdatum............................: 2006-08-28
Änderungszeitpunkt............................: 09:57
SDCMD<A000000>: OK
Mitgliedschaftsverwaltung
Dieser Abschnitt enthält die folgenden Themen:
add – Hinzufügen von Servern zu Servergruppen (siehe Seite 261)
listMem – Auflisten der Mitglieder von Servergruppen (siehe Seite 262)
listMembership – Auflisten der Mitgliedschaft von Servergruppen (siehe Seite 263)
remove – Entfernen von Servern aus Servergruppen (siehe Seite 264)
260 CLI-Referenzhandbuch
Kompatibilität
add – Hinzufügen von Servern zu Servergruppen
Mit dieser Aktion können Sie einer Servergruppe Server hinzufügen.
Diese Aktion hat das folgende Format:
servergroup action=add
name=Gruppenname
{{{server=Servername |
qserver=(Servername Trennzeichen Domänenname)}}
| addall}
[sep=Trennzeichen]
Name
Gibt den Namen der Servergruppe an, der die Server hinzugefügt werden.
qserver
Gibt den Server als ein Paar bestehend aus einem Servernamen und dem Namen
der Domäne an, zu dem dieser gehört. Standardmäßig sind die Namen durch einen
Punkt (".") getrennt. Sie können jedoch mit der Option "sep" ein anderes
Trennzeichen festlegen. Das Trennzeichen darf nicht Teil der Namen sein.
"qserver" kann in einem Aufruf mit dem Server angegeben werden.
Dieser Server wird hinzugefügt.
sep
Gibt ein alternatives Trennzeichen für die Option "qserver" an. Das Trennzeichen
darf nicht Teil der Namen sein, die mit den qserver-Optionen angegeben werden.
Server
Gibt den Namen eines Scalability-Servers an, der der Gruppe hinzugefügt werden
soll.
addall
Alle Scalability-Server, die zum Zeitpunkt der Erstellung vorhanden sind, werden der
Gruppe hinzugefügt.
Hinweis : Die Parameter zum Ansprechen eines Scalability-Servers (Ziels) können
mehrfach codiert werden, um mehrere Scalability-Server anzusprechen.
Beispiel
Geben Sie den folgenden Befehl ein, um die Server "server01" und "server02" der
Gruppe "sg_1" hinzuzufügen:
cadsmcmd servergroup action=add name=sg_1 server=server01 server=server02
Kapitel 3: cadsmcmd-Befehle 261
Kompatibilität
listMem – Auflisten der Mitglieder von Servergruppen
Mit dieser Aktion können Sie die Mitglieder einer Gruppe auflisten.
Diese Aktion hat das folgende Format:
servergroup action=listMem
name=Gruppenname
[groupScope={global | local}]
Name
Gibt den Namen der Gruppe an.
groupScope
Gibt den Bereich der definierten Gruppe an. Für diese Option sind folgende Werte
gültig:
Global
Bei der Gruppe handelt es sich um eine globale, auf einem Enterprise-Manager
erstellte Gruppe. Sie kann auf einem Domänen-Manager repliziert werden.
Lokal
Gibt eine auf dem mit "CADSMCMD" verbundenen Domänen-Manager erstellte
lokale Gruppe an.
Wenn "groupScope" nicht angegeben ist, versucht der Befehl "CADSMCMD"
zunächst, die Gruppe als lokale Gruppe zu bestimmen. Sollte dies fehlschlagen, wird
versucht, die Gruppe als globale Gruppe zu bestimmen.
Beispiel
Geben Sie den folgenden Befehl ein, um die Liste der Mitglieder von Gruppe "sg_1"
abzurufen:
cadsmcmd servergroup action=listMem name=sg_1
Die folgende Liste wird ausgegeben:
----------------------------------------------------------------------------Mitglieder von Servergruppe "sg_1" (lokal)
----------------------------------------------------------------------------server01 (server01)
server02 (server02)
262 CLI-Referenzhandbuch
Kompatibilität
listMembership – Auflisten der Mitgliedschaft von Servergruppen
Mit dieser Aktion können Sie die Gruppen auflisten, in denen eine Gruppe als
Untergruppe enthalten ist.
Diese Aktion hat das folgende Format:
servergroup action=listMembership
name=Gruppenname
[groupScope={global | local}]
Name
Gibt den Namen der Servergruppe an, für die die Mitgliedschaft aufgelistet wird.
groupScope
Gibt den Bereich der definierten Gruppe an. Für diese Option sind folgende Werte
gültig:
Global
Bei der Gruppe handelt es sich um eine globale, auf einem Enterprise-Manager
erstellte Gruppe. Sie kann auf einem Domänen-Manager repliziert werden.
Lokal
Gibt eine auf dem mit "CADSMCMD" verbundenen Domänen-Manager erstellte
lokale Gruppe an.
Wenn "groupScope" nicht angegeben ist, versucht der Befehl "CADSMCMD"
zunächst, die Gruppe als lokale Gruppe zu bestimmen. Sollte dies fehlschlagen, wird
versucht, die Gruppe als globale Gruppe zu bestimmen.
Beispiel
Geben Sie den folgenden Befehl ein, um eine Liste der Servergruppen zu erhalten:
cadsmcmd servergroup action=listMembership name=sg_2
Die folgenden Informationen werden bereitgestellt:
----------------------------------------------------------------------------"sg_2" ist Mitglied der folgenden Gruppen
----------------------------------------------------------------------------sg_1 (28.08.06 09:57)
sg_x (28.08.06 10:56)
Kapitel 3: cadsmcmd-Befehle 263
Kompatibilität
remove – Entfernen von Servern aus Servergruppen
Mit dieser Aktion können Sie Server aus der Servergruppe entfernen.
Diese Aktion hat das folgende Format:
servergroup action=remove
name=Gruppenname
{{{server=Servername |
qserver=(Servername Trennzeichen Domänenname)}}
[sep=Trennzeichen]
Name
Gibt den Namen der Servergruppe an, aus der Mitglieder entfernt werden sollen.
qserver
Gibt den Server als ein Paar bestehend aus einem Servernamen und dem Namen
der Domäne an, zu dem dieser gehört. Standardmäßig sind die Namen durch einen
Punkt (".") getrennt. Sie können jedoch mit der Option "sep" ein anderes
Trennzeichen festlegen. Das Trennzeichen darf nicht Teil der Namen sein.
Dieser Server wird entfernt.
sep
Gibt ein alternatives Trennzeichen für die Option "qserver" an. Das Trennzeichen
darf nicht Teil der Namen sein, die mit den qserver-Optionen angegeben werden.
Server
Gibt den Namen des Servers an, der aus der Gruppe entfernt werden soll.
Dieser Parameter kann mehrfach angegeben werden, um mehrere Server aus der
Gruppe zu entfernen.
Hinweis: Wenn ein Server mit einem zweideutigen Namen aus einer Gruppe entfernt
werden soll, müssen Sie hierfür die Option "qserver" verwenden. Anderenfalls ist das
Ergebnis unvorhersehbar.
Beispiel
Geben Sie folgenden Befehl ein, um die Server "server01" und "server02" aus der
Gruppe "sg_1" zu entfernen:
cadsmcmd servergroup action=remove name=sg_1 server=server01 server=server02
Hierarchieverwaltung
Dieser Abschnitt enthält die folgenden Themen:
addSubgroups – Hinzufügen von Untergruppen zu Servergruppen (siehe Seite 265)
listSubgroups – Auflisten der Untergruppen von Servergruppen (siehe Seite 265)
removeSubgroups – Entfernen von Untergruppen aus Servergruppen (siehe Seite 267)
264 CLI-Referenzhandbuch
Kompatibilität
addSubgroups – Hinzufügen von Untergruppen zu Servergruppen
Mit dieser Aktion können Sie einer Servergruppe Untergruppen hinzufügen.
Diese Aktion hat das folgende Format:
servergroup action=addSubgroups
[name=Gruppenname]
{servgrp=Gruppenname}
Name
Name der Servergruppe, der die von "servgrp" angegebene Servergruppe
hinzugefügt wird.
Wenn dieser Parameter nicht angegeben ist, werden die Untergruppen in den
Container "Scalability-Servergruppen" kopiert.
servgrp
Gibt den Namen einer vorhandenen Servergruppe an, die hinzugefügt werden soll.
Dieser Parameter kann mehrfach angegeben werden, um eine Liste von Servern
hinzuzufügen.
Beispiel
Angenommen, die Servergruppen mit den Bezeichnungen "LA admin" und "LA sales"
sollen der Servergruppe "LA District" als Untergruppen hinzugefügt werden.
Mit Hilfe des folgenden Befehls werden diese Gruppen der übergeordneten Gruppe "LA
District" als Untergruppen zugewiesen:
cadsmcmd servergroup action=addSubgroups name="LA District" servgrp="LA admin"
servgrp="LA sales"
Die Gruppen "LA admin" und "LA sales" müssen übrigens zum Zeitpunkt des
Befehlsaufrufs definiert werden, anderenfalls wird aufgrund der fehlenden Untergruppe
ein Fehler ausgegeben.
listSubgroups – Auflisten der Untergruppen von Servergruppen
Mit dieser Aktion können Sie die Untergruppen einer Servergruppe auflisten.
Diese Aktion hat das folgende Format:
servergroup action=listSubgroups
[name=Gruppenname]
[groupScope={global | local}]
Kapitel 3: cadsmcmd-Befehle 265
Kompatibilität
Name
Gibt den Namen der Servergruppe an, deren Untergruppen aufgelistet werden.
Wenn dieser Parameter nicht angegeben ist, werden die Servergruppen des
Containers "Scalability-Servergruppen" aufgelistet.
groupScope
Gibt den Bereich der definierten Gruppe an. Für diese Option sind folgende Werte
gültig:
Global
Bei der Gruppe handelt es sich um eine globale, auf einem Enterprise-Manager
erstellte Gruppe. Sie kann auf einem Domänen-Manager repliziert werden.
Lokal
Gibt eine auf dem mit "CADSMCMD" verbundenen Domänen-Manager erstellte
lokale Gruppe an.
Wenn "groupScope" nicht angegeben ist, versucht der Befehl "CADSMCMD"
zunächst, die Gruppe als lokale Gruppe zu bestimmen. Sollte dies fehlschlagen, wird
versucht, die Gruppe als globale Gruppe zu bestimmen.
Die Ausgabeliste besitzt das folgende Format:
----------------------------------------------------------------------------Untergruppenliste der Servergruppe "Gruppenname"
----------------------------------------------------------------------------Untergruppenname
Untergruppenname
...
Beispiel
Geben Sie Folgendes ein, um alle mit der Servergruppe "LA District" verbundenen
Untergruppen aufzulisten:
cadsmcmd servergroup action=listSubgroups name="LA District"
266 CLI-Referenzhandbuch
Kompatibilität
removeSubgroups – Entfernen von Untergruppen aus Servergruppen
Mit dieser Aktion können Sie Untergruppen aus einer Servergruppe entfernen.
Diese Aktion hat das folgende Format:
servergroup action=removeSubgroups
[name=Gruppenname]
{servgrp=Gruppenname}
Name
Gibt den Namen der Servergruppe an, aus der die mit "servgrp" angegebene
Servergruppe entfernt wird.
Wenn dieser Parameter nicht angegeben ist, werden die Untergruppen aus dem
Container "Scalability-Servergruppen" entfernt.
servgrp
Gibt den Namen einer vorhandenen Servergruppe an, die entfernt werden soll.
Dieser Parameter kann mehrfach angegeben werden, um eine Liste von
Servergruppen zu entfernen.
Hinweis: "Remove" bedeutet nicht, dass alle Servergruppen des Parameters
"servgrp" gelöscht werden. Es wird lediglich die Verknüpfung mit der mit dem
Parameter "name" angegebenen übergeordneten Gruppe entfernt.
Hinweis: Wenn eine Servergruppe A die Servergruppe B enthält, und wenn B weder in
einer anderen Servergruppe noch im Container "Scalability-Servergruppen" enthalten
ist, führt der Versuch, B aus A zu entfernen, zu einer Fehlermeldung. Mindestens eine
der Inhaltsbeziehungen muss erhalten werden.
Beispiel
Angenommen, die Servergruppen mit den Bezeichnungen "LA admin" und "LA sales"
sollen wieder aus der Servergruppe "LA District" entfernt werden.
Mit Hilfe des folgenden Befehls werden diese Gruppen als Untergruppen aus der
übergeordneten Gruppe "LA District" entfernt:
cadsmcmd servergroup action=removeSubgroups name="LA District" servgrp="LA admin"
servgrp="LA sales"
Kapitel 3: cadsmcmd-Befehle 267
Kompatibilität
Die Gruppen "LA admin" und "LA sales" werden durch den Befehl nicht aus der
Datenbank gelöscht, sondern lediglich aus der Gruppe "LA District" entfernt. Alle
anderen Inhaltsbeziehungen, neben den zuvor genannten, sind weiterhin vorhanden.
Der Befehl meldet einen Fehler, wenn die aufzulösende Inhaltsbeziehung für eine der zu
entfernenden Untergruppen die einzige Inhaltsbeziehung ist. "LA admin" wird
beispielsweise lediglich als Untergruppe von "LA District" genannt, während die anderen
Untergruppen auch im Ordner "Scalability-Servergruppen" oder in anderen Gruppen
vorhanden sind.
stagingserver – Befehle des Scalability-Servers
Der Scalability-Server - in früheren Versionen als "Staging-Server" bezeichnet - wird in
SD-Netzwerken verwendet, um die Installations-Software für die ihm angeschlossenen
Zielcomputer bereitzustellen und um die Kommunikationsverknüpfungen zwischen den
Domänen-Managern und diesen zugeordneten Zielcomputern zu optimieren. Ein
Scalability-Server wird immer an einen eindeutigen Domänen-Manager angeschlossen.
Der Befehl "stagingserver" ist nur für Domänen-Manager zulässig.
Dieser Abschnitt enthält die folgenden Themen:
activateStageCheck – Aktivieren des Phasenprüfungsprogramms (siehe Seite 268)
addItem – Hinzufügen von Elementen zu einem Scalability-Server (siehe Seite 269)
list – Auflisten von Scalability-Servern (siehe Seite 271)
Beispiel (siehe Seite 271)
listComp – Auflisten von einem Scalability-Server zugewiesenen Computern (siehe Seite
272)
listItem – Auflisten von Elementen des Scalability-Servers (siehe Seite 272)
removeItem – Entfernen von Elementen aus Scalability-Server-Bibliotheken (siehe Seite
273)
activateStageCheck – Aktivieren des Phasenprüfungsprogramms
Diese Aktion startet das Phasenprüfungsprogramm, das eine Prüfung auf ausstehende
Aufträge initiiert.
Sie wartet die Fertigstellung nicht ab.
Diese Aktion hat das folgende Format:
stagingserver action=activatestagecheck
computer=Name
268 CLI-Referenzhandbuch
Kompatibilität
computer
Gibt den Namen des Computers an, auf dem das Phasenprüfungsprogramm
aktiviert wird.
addItem – Hinzufügen von Elementen zu einem Scalability-Server
Diese Aktion fügt einer oder mehreren Staging-Bibliotheken ein Element hinzu.
Diese Aktion hat das folgende Format:
stagingserver action=additem
item=Elementname
version=Elementversion
{{computer=Computername} | {compgrp=Computergruppenname}}
[cname=Name]
[atTime=JJJJ-MM-TT HH:MM]
[timeout=Stunden]
[{nolinkage | transaction | synchronized } ]
[jcPriority={1,...,10}]
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.
cname
Gibt Folgendes an: optionaler eindeutiger Name eines Jobcontainers, in dem der
erstellte Job gespeichert wird.
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.
compgrp
Gibt den Namen einer Servergruppe von Scalability-Servern an, an die das Element
geliefert werden soll.
Der Parameter kann mehrfach angegeben werden , um eine Liste von
Servergruppen zu adressieren.
Der Parameter sollte nicht mit dem Parameter "computer" angegeben werden.
Kapitel 3: cadsmcmd-Befehle 269
Kompatibilität
computer
Gibt den Namen eines Scalability-Servers an, an den das Element geliefert werden
soll.
Der Parameter kann mehrfach codiert werden, um eine Liste von Scalability-Servern
anzusprechen.
Der Parameter darf nicht mit dem Parameter "compgrp" codiert werden.
item
Gibt Folgendes an: Name des Elements, das an die Scalability-Server geliefert
werden soll.
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.
nolinkage
Führt den Job unabhängig von den anderen Jobs im Container aus.
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".
Transaktion
Die Jobverknüpfungsoption wird auf "Batch-Jobausführung" gesetzt.
Version
Gibt die Version des hinzuzufügenden Elements an.
270 CLI-Referenzhandbuch
Kompatibilität
list – Auflisten von Scalability-Servern
Es wird eine Liste aller Scalability-Server angezeigt. Es kann ein zusätzlicher Filter
angegeben werden, um die Liste auf die Scalability-Server zu beschränken, die den
Filterkriterien entsprechen. Wenn keine Filter angegeben werden, wird die vollständige
Liste der Produkte angezeigt. Der Filter ist auf 100&#160;Byte beschränkt.
Diese Aktion hat das folgende Format:
stagingserver action=list
[{filter="Filter"
| filterfile=Dateiname}]
filter
Gibt Folgendes an: Ausdruck, um die Anzahl der aufgelisteten Informationen
einzuschränken.
Sie können auch die Attribute verwenden, die durch die Aktion "targetcomputer
list" angezeigt werden.
filterfile
Gibt Folgendes an: Name der Datei, die die Filterbefehle enthält.
Die Befehle der Datei werden auf die gleiche Weise festgelegt wie im Parameter
"Filter". Die Kapazität der Datei wird jedoch durch die Kapazität des den Befehl
ausführenden Systems begrenzt.
Beispiel
Geben Sie den folgenden Befehl ein, um eine Liste der Staging-Server aller
Servergruppen zu erzeugen:
cadsmcmd stagingserver action=list
Der Befehl gibt auf stdout eine Ausgabeliste mit dem folgenden Format aus:
------------------------------------------------------------------------------Liste der Staging-Server
------------------------------------------------------------------------------Test01mc
Test02mc
WWWWH01
------------------------------------------------------------------------------Gesamtzahl der Computer: 3
Gesamtzahl der gefundenen Staging-Server: 3
Gesamtzahl der angezeigten Staging-Server: 3
SDCMD<A000000>: OK
Kapitel 3: cadsmcmd-Befehle 271
Kompatibilität
Geben Sie den folgenden Befehl ein, um mit Hilfe von Filtern eine Liste der StagingServer aller Servergruppen zu erzeugen, die mit "Test" beginnen:
cadsmcmd stagingserver action=list filter="computer name=Test*"
Auf "stdout" wird die folgende Ausgabe zurückgegeben:
------------------------------------------------------------------------------Liste der Staging-Server
------------------------------------------------------------------------------Test01mc
Test02mc
------------------------------------------------------------------------------Gesamtzahl der Computer: 3
Gesamtzahl der gefundenen Staging-Server: 3
Gesamtzahl der angezeigten Staging-Server: 2
SDCMD<A000000>: OK
listComp – Auflisten von einem Scalability-Server zugewiesenen Computern
Diese Aktion zeigt eine Liste aller Computer an, die einem bestimmten Scalability-Server
zugewiesen sind. Die Liste enthält lediglich die Namen der Computer.
Diese Aktion hat das folgende Format:
stagingserver action=listcomp
name=Staging-Server-Name
Name
Gibt den Namen des Scalability-Servers an, dessen zugewiesene Computer
aufgelistet werden.
listItem – Auflisten von Elementen des Scalability-Servers
Diese Aktion zeigt die auf einem bestimmten Scalability-Server verfügbaren Elemente
an. Die Liste zeigte die Namen der Elemente und ihre Version an.
Diese Aktion hat das folgende Format:
stagingserver action=listitem
name=Staging-Server-Name
Name
Gibt den Namen des Scalability-Servers an, dessen zugehörige Elemente angezeigt
werden.
272 CLI-Referenzhandbuch
Kompatibilität
removeItem – Entfernen von Elementen aus Scalability-Server-Bibliotheken
Diese Aktion entfernt ein Element aus einer oder mehreren Staging-Bibliotheken.
Diese Aktion hat das folgende Format:
stagingserver action=removeitem
item=Elementname
version=Elementversion
{ { computer=Computername} }
| { compgrp=Computergruppenname } }
[cname=Name]
[{nolinkage | transaction | synchronized } ]
[atTime=JJJJ-MM-TT HH:MM]
[timeout=Stunden]
[jcPriority={1,...,10}]
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.
cname
Gibt Folgendes an: optionaler eindeutiger Name eines Jobcontainers, in dem der
erstellte Job gespeichert wird.
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.
compgrp
Gibt den Namen einer Servergruppe von Scalability-Servern an, aus der das Element
entfernt werden soll.
Der Parameter kann mehrfach angegeben werden , um eine Liste von
Servergruppen zu adressieren.
Der Parameter sollte nicht mit dem Parameter "computer" angegeben werden.
Kapitel 3: cadsmcmd-Befehle 273
Kompatibilität
computer
Gibt Folgendes an: Name des Scalability-Servers, aus der das Element entfernt
werden soll.
Der Parameter kann mehrfach angegeben werden , um eine Liste von ScalabilityServern zu adressieren.
Dieser Parameter sollte nicht mit dem Parameter "compgrp" angegeben werden.
item
Gibt Folgendes an: Name des Elements, die entfernt werden sollen.
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.
nolinkage
Führt den Job unabhängig von den anderen Jobs im Container aus.
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".
Transaktion
Die Jobverknüpfungsoption wird auf "Batch-Jobausführung" gesetzt.
Version
Gibt Folgendes an: Version des Elements, die entfernt werden sollen.
Hinweis: Wenn weder "synchronisiert" noch "Transaktion" angegeben ist, wird ein
Jobcontainer des Typs "nolinkage" erstellt.
274 CLI-Referenzhandbuch
Kompatibilität
swlibrary – Softwarebibliotheksbefehle
Soweit nichts anderes angegeben wird, gelten alle Methoden dieses Kapitels für
Enterprise-Manager und Domänen-Manager.
Die Softwarepaketbibliothek (swlibrary) verwaltet die gesamte Software sowie alle
Softwaregruppen und Prozedurgruppen für den Enterprise-Manager und den DomänenManager.
Dieser Abschnitt enthält die folgenden Themen:
Allgemeine Verwaltung der Softwaregruppe (siehe Seite 275)
Softwaregruppen-Verwaltung (siehe Seite 325)
Kataloggruppen-Verwaltung (siehe Seite 334)
Prozedurgruppen-Verwaltung (siehe Seite 338)
Produktverwaltung (siehe Seite 343)
Allgemeine Verwaltung der Softwaregruppe
Dieser Abschnitt enthält die folgenden Themen:
assignGroupToTarget – Zuordnen von Gruppen zu einem Ziel (siehe Seite 275)
createGroup – Erstellen einer Gruppe (siehe Seite 303)
deleteGroup – Löschen von Softwaregruppen oder Prozedurgruppen (siehe Seite 307)
deliverGroupToStage – Liefern von Elementen der Softwaregruppe an Scalability-Server
(siehe Seite 308)
listGroups – Auflisten von Gruppen (siehe Seite 316)
listMembership – Auflisten der Mitgliedschaft (siehe Seite 318)
modifyGroup – Bearbeiten von Attributen der Softwaregruppe oder Prozedurgruppe
(siehe Seite 319)
undeliverGroupFromStage – Zurückrufen von Elementen von Softwaregruppen von
Scalability-Servern (siehe Seite 320)
assignGroupToTarget – Zuordnen von Gruppen zu einem Ziel
Mit Hilfe dieser Aktion kann Zielcomputern oder Computergruppen (einschließlich
Softwarevorlagen) eine Softwaregruppe oder eine Prozedurgruppe zugewiesen werden.
Wenn die Softwaregruppe Untergruppen enthält, sind diese Untergruppen rekursiv an
der Zuordnung beteiligt.
In der Standardausgabe wird neben weiteren Informationen der Name des
verwendeten Jobcontainers oder der verwendeten Verteilung angezeigt.
Kapitel 3: cadsmcmd-Befehle 275
Kompatibilität
Diese Aktion hat das folgende Format:
swLibrary action=assignGroupToTarget name=Gruppenname
{{computer=Computername} |
{compgrp=Computergruppenname | ccompgrp=(Computergruppenname Trennzeichen
Gruppenbereich)}
[sep=Trennzeichen]
| {swTemplates=Name_der_Softwarevorlage}}
cname=[Name]
[dname=Name_der_Verteilung]
[unsealed]
[{nolinkage|transaction[rollback]|synchronized}[nocascade]]
[deliveryTime=JJJJ-MM-TT HH:MM]
[atTime=JJJJ-MM-TT HH:MM]
after={exacttime|boottime}
[calendername=Lieferungskalender]
[preaction={none|reboot|logoff}]
[postaction={none|reboot|logoff|rebootAtEnd|logoffAtEnd|shutdownAtEnd}]
[promptUser[={y|n}]]
[allowCancel[={y|n}]]
[execTimedOut[={y|n}]]
[prompt=Tage.Stunden]
[offline[={y|n}]]
[runAtShutdown[={y|n}]]
[preventLogon[={y|n}]]
[globalTime]
[nocalendar]
[resolveQuery]
[parameters=Benutzerparameter]
[repeat={y|n}]
[stagingServer]
[jobTimeout=t.h]
[procedures=Prozedurdatei]
276 CLI-Referenzhandbuch
Kompatibilität
[{{area=area_name} | {domain=domain_name} | toAllAreas}]
[sendTime=JJJJ-MM-TT HH:MM]
[haltTime=JJJJ-MM-TT HH:MM]
[jcPriority={1,...,10}]
[distPriority={1,...,10}]
[reinstall[={y|n}]]
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.
Wenn durch diesen Aufruf "promptUser" weder festgelegt wird, noch bereits
aktiviert ist, wird dieser Parameter ignoriert. Es wird keine Warnung angezeigt.
area
Gibt Folgendes an: Name einer CA ITCM-Domäne, an die die Verteilung gesendet
wird.
Der Parameter kann mehrfach angegeben werden , um eine Liste mit CA ITCMDomänen anzugeben.
Wenn dieser Parameter angegeben wird, wird die Verteilung versiegelt und
automatisch an ihre Ziele gesendet, nachdem der Befehl erfolgreich abgeschlossen
wurde.
Wenn weder der Parameter "area" noch der Parameter "domain" oder "toAllAreas"
angegeben wird, bleibt die Verteilung unversiegelt und kann weiterhin geändert
werden.
Dieser Parameter sollte nicht mit den Parametern "domain" oder "toAllAreas"
angegeben werden.
(nur Enterprise-Manager)
Kapitel 3: cadsmcmd-Befehle 277
Kompatibilität
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.
Wenn der Parameter nicht angegeben ist, werden das aktuelle Datum und die
aktuelle Uhrzeit verwendet.
calendarname
Gibt Folgendes an: Name des Kalenders, der die Zeit steuert, während der die
Evaluierung ausgeführt werden kann.
ccompgrp
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.
cname
Gibt Folgendes an: optionaler eindeutiger Name eines Jobcontainers.
Wenn kein Parameter "cname" angegeben wird, wird intern ein Name generiert,
der von der Befehlszeilenschnittstelle als ID zurückgegeben wird.
Die erzeugten Jobs werden ihm zugewiesen.
Wenn dieser Jobcontainer nicht existiert, wird er angelegt.
Wenn er existiert, werden die erzeugten Jobs hinzugefügt, sofern der Container
nicht versiegelt ist.
Wenn er versiegelt ist, wird der Befehl "cadsmcmd" mit einem Fehler beendet.
compgrp
Gibt die zu adressierende Computergruppe an.
Der Parameter kann mehrfach angegeben werden , um mehrere Computergruppen
zu adressieren.
Dieser Parameter sollte nicht mit den Parametern "computer" oder "swTemplates"
angegeben werden.
278 CLI-Referenzhandbuch
Kompatibilität
computer
Gibt den Namen eines zu adressierenden Computers an.
Der Parameter kann mehrfach angegeben werden , um mehrere Computer zu
adressieren.
Dieser Parameter sollte nicht mit den Parametern "compgrp" oder "swTemplates"
angegeben werden.
(nur Domänen-Manager)
deliveryTime
Gibt Folgendes an: Startzeit der Lieferung vom Domänen-Manager.
Das Datum wird im ISO-Format "JJJJ-MM-TT HH:MM" angegeben.
Wenn der Parameter nicht angegeben ist, werden das aktuelle Datum und die
aktuelle Uhrzeit verwendet.
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.
Kapitel 3: cadsmcmd-Befehle 279
Kompatibilität
dname
Gibt Folgendes an: Name der Verteilung, in der die Jobs und der Jobcontainer
gespeichert werden.
Wenn die Verteilung bereits vorhanden und noch für Änderungen geöffnet ist, wird
diese verwendet, andernfalls wird eine Fehlermeldung ausgegeben. Wenn die
Verteilung nicht vorhanden ist, wird sie erstellt.
Wenn der Parameter nicht angegeben ist, wird eine Verteilung mit dem
Standardnamen erzeugt.
(nur Enterprise-Manager)
domain
Gibt Folgendes an: Name einer CA ITCM-Domänengruppe, an die die Verteilung
gesendet wird.
Der Parameter kann mehrfach angegeben werden , um eine Liste von CA ITCMDomänengruppen zu adressieren.
Wenn dieser Parameter angegeben wird, wird die Verteilung versiegelt und
automatisch an ihre Ziele gesendet, nachdem der Befehl erfolgreich abgeschlossen
wurde.
Wenn weder der Parameter "area" noch der Parameter "domain" oder "toAllAreas"
angegeben wird, bleibt die Verteilung unversiegelt und kann weiterhin geändert
werden.
Dieser Parameter sollte nicht mit den Parametern "area" oder "toAllAreas"
angegeben werden.
(nur Enterprise-Manager)
280 CLI-Referenzhandbuch
Kompatibilität
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.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert
der zugehörigen Prozedur verwendet.
Wenn "promptUser" durch diesen Aufruf nicht festgelegt wird und auch noch nicht
aktiviert wurde, wird dieser Parameter ignoriert. Es wird keine Warnung angezeigt.
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änenManagers. (Standard)
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.
Weitere Informationen zur Wiederaufnahme einer angehaltenen Verteilung finden
Sie unter dem Befehl resume.
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 die Priorität nicht geändert.
jobTimeOut
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".
Kapitel 3: cadsmcmd-Befehle 281
Kompatibilität
Name
Gibt Folgendes an: Name der Gruppe. Wenn es sich um eine Softwaregruppe
handelt, werden die Mitglieder der Gruppe am Standort des Ziels installiert.
Die Prozedur der Mitglieder, die auf dem Ziel ausgeführt werden soll, kann mit der
Option "procedures" angegeben und konfiguriert werden. Erfolgt keine Angabe,
werden die Standardinstallationsprozeduren der Mitglieder verwendet.
Wenn es sich um eine Prozedurgruppe handelt, werden die enthaltenen
Prozeduren am Standort des Ziels ausgeführt.
noCalendar
Wenn "noCalendar" angegeben ist, wird ein möglicherweise auf dem Zielcomputer
vorhandener Kalender für die Jobausführung ignoriert.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert
der zugehörigen Prozedur verwendet.
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.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert
der zugehörigen Prozedur verwendet.
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.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert
der zugehörigen Prozedur verwendet.
282 CLI-Referenzhandbuch
Kompatibilität
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.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert
der zugehörigen Prozedur verwendet.
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.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert
der zugehörigen Prozedur verwendet.
Kapitel 3: cadsmcmd-Befehle 283
Kompatibilität
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.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert
der zugehörigen Prozedur verwendet.
Verfahren
Gibt Folgendes an: Name der Datei, die die für die Softwaregruppe verwendeten
Prozeduren und/oder die einzelnen Joboptionen für die Prozeduren (Software- und
Prozedurgruppen) definiert.
Den Inhalt dieser Prozedurdatei finden Sie unter "Format der Prozedurdatei (siehe
Seite 287)".
prompt=d.h
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.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert
der zugehörigen Prozedur verwendet.
reinstall
Die Option "reinstall" ist optional, der Standardwert lautet "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: Diese Option gilt nur für Installationsjobs. In allen anderen Fällen wird sie
ignoriert.
284 CLI-Referenzhandbuch
Kompatibilität
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.
(nur Enterprise-Manager)
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 ScalabilityServer der Zielcomputer.
Dieser Parameter bezieht sich nur auf Prozeduren des Aufgabentyps "install".
swTemplates
Gibt Folgendes an: Namen der Softwarevorlage.
Der Parameter kann mehrfach codiert werden, um mehrere Software-Vorlagen
anzusprechen.
Wenn der Parameter codiert ist, wird der Parameter "cname" ungültig, und die zu
erstellenden Jobs werden keinem Jobcontainer zugewiesen, sondern der SoftwareVorlage. Aus diesem Grund sollten die Softwarevorlagen der Liste nicht versiegelt
sein.
Dieser Parameter sollte nicht mit den Parametern "computer" oder "compgrp"
angegeben werden.
Kapitel 3: cadsmcmd-Befehle 285
Kompatibilität
synchronisiert
Die Jobverknüpfungsoption wird auf "Synchronisierte Jobausführung" gesetzt.
toAllAreas
Wenn dieser Parameter angegeben ist, wird die zugehörige Verteilung an alle CA
ITCM-Domänen gesendet, die beim Enterprise-Manager registriert sind.
"toAllAreas" sollte nicht mit den Parametern "area" oder "domain" angegeben
werden.
Wenn weder der Parameter "area" noch der Parameter "domain" oder "toAllAreas"
angegeben wird, bleibt die Verteilung unversiegelt und kann weiterhin geändert
werden.
(nur Enterprise-Manager)
Transaktion
Die Jobverknüpfungsoption wird auf "Batch-Jobausführung" gesetzt.
Dies ist die Standardeinstellung.
unsealed
Der adressierte Jobcontainer bleibt unversiegelt, nachdem der generierte Job
erfolgreich erstellt wurde.
(nur Domänen-Manager)
Hinweise:
Wenn weder der Parameter "area" noch der Parameter "domain" oder "toAllAreas"
angegeben wird, bleibt der Verteilungscontainer unversiegelt und kann weiterhin
geändert werden.
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.
286 CLI-Referenzhandbuch
Kompatibilität
Format der Prozedurdatei
Der Inhalt der Prozedurdatei besteht aus Einträgen der folgenden Syntax:
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=Lieferungskalender]
[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]
[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.
Kapitel 3: cadsmcmd-Befehle 287
Kompatibilität
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
dargestellten Syntaxdefinition für "cadsmcmd swlibrary action=assigngrouptotarget"
erfolgen. Die verbleibenden Parameter können in beliebiger Reihenfolge angegeben
werden.
Die Bedeutung der anderen Parameter entspricht der Bedeutung der in "cadsmcmd
swlibrary action=assigngrouptotarget" dargestellten Befehlsparameter.
Die Prozeduroptionen für eine Jobprozedur werden aus den Einstellungen in dieser Liste
übernommen.
Wenn für eine Prozedur im entsprechenden Listeneintrag keine Option angegeben
wurde, wird die Einstellung der Befehlsebene verwendet.
Ist sie nicht angegeben, wird sie den registrierten Prozeduroptionen entnommen.
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 SoftwaregruppenProdukte 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.
288 CLI-Referenzhandbuch
Kompatibilität
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
Kapitel 3: cadsmcmd-Befehle 289
Kompatibilität
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.&#160;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
290 CLI-Referenzhandbuch
Kompatibilität
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
Kapitel 3: cadsmcmd-Befehle 291
Kompatibilität
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
292 CLI-Referenzhandbuch
Kompatibilität
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}]
Kapitel 3: cadsmcmd-Befehle 293
Kompatibilität
[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.
294 CLI-Referenzhandbuch
Kompatibilität
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 StandardParametereinstellung 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:
■
Die Jobs werden in der richtigen Reihenfolge ausgeführt. Wenn ein Job fehlschlägt,
wird kein weiterer Job ausgeführt, bereits ausgeführte Jobs werden zurückgesetzt.
■
Abhängigkeiten werden aufgelöst, und Installationsüberlappungen werden erstellt.
Kapitel 3: cadsmcmd-Befehle 295
Kompatibilität
Für alle generierten Jobs gelten die folgenden Standardwerte:
■
Der Lieferungszeitpunkt ist 30.06.2005, 13:00 Uhr.
■
Die Startzeit für die Verarbeitung auf den Zielsystemen ist 05.07.2005, 01:00 Uhr.
Die Verarbeitung kann sofort starten, wenn der Zeitstempel erreicht ist.
■
Vor der Generierung der Jobs muss eine mögliche Abfrage für die Computergruppe
evaluiert werden.
■
Für die verbleibenden Attribute werden die Standardwerte verwendet.
■
Einzelne Attribute für die Jobs werden mit der Prozedurdatei "c:\temp\proc.usd"
weitergegeben.
Die individuellen Anforderungen für Jobs und Elemente lauten wie folgt:
■
Prozeduren der Prozedurgruppe "pg_1":
■
Für "remdir" und "setdir" von "tstbase" ist ein Neustart nach der Installation
erforderlich.
■
Für "inst" von "tstkpk01" gelten keine weiteren Anforderungen.
■
Elemente der Softwaregruppe "swg_1":
■
"tstbase" wird durch die Installationsprozedur "inst" installiert.
■
Angemeldete Benutzer werden vor dem Start der Installation abgemeldet.
■
Während der Installation werden jegliche Anmeldeversuche abgewiesen.
■
DMS-Editor wird mit der Standardprozedur "Lokale Installation" installiert.
■
Es gelten keine weiteren individuellen Anforderungen.
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
296 CLI-Referenzhandbuch
Kompatibilität
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
Kapitel 3: cadsmcmd-Befehle 297
Kompatibilität
Jobcontainerstatus....................: wartet
.........................................3 - Jobs
.........................................0 - Jobs
.........................................2 - Jobs
.........................................0 - Jobs
wartend
aktiv
OK
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 %).........:
298 CLI-Referenzhandbuch
Kompatibilität
....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............................:
Kapitel 3: cadsmcmd-Befehle 299
Kompatibilität
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 %).........:
300 CLI-Referenzhandbuch
Kompatibilität
....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
Kapitel 3: cadsmcmd-Befehle 301
Kompatibilität
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
302 CLI-Referenzhandbuch
Kompatibilität
createGroup – Erstellen einer Gruppe
Mit dieser Aktion können Sie eine Software- oder Prozedurgruppe erstellen.
Diese Aktion hat das folgende Format:
swLibrary action=createGroup name=Gruppenname
[superGroup=Name der übergeordneten Gruppe]
[GroupType={SWG|PG}]
[comment=Kommentar]
Name
Gibt den Namen der zu erstellenden Gruppe an.
superGroup
Gibt den Namen der übergeordneten Gruppe an, in der die neue Gruppe als
Untergruppe erstellt wird. Die übergeordnete Gruppe muss eine Softwaregruppe
sein. Wenn der Parameter nicht angegeben wird, wird die Gruppe auf der obersten
Ebene erstellt, d.&#160;h. im Ordner "Softwarepaketbibliothek".
GroupType
Gibt den Typ der zu erstellenden Gruppe an. Folgende Werte sind gültig:
SWG
Definiert die Gruppe als Softwaregruppe. Dies ist die Standardeinstellung.
PG
Definiert die Gruppe als Prozedurgruppe.
comment
Kommentar zu den Gruppen
Kapitel 3: cadsmcmd-Befehle 303
Kompatibilität
Beispiel:
Angenommen, die Softwaregruppe "swg_1" soll erstellt werden. Anschließend soll eine
Prozedurgruppe namens "pg_1" als Untergruppe der bereits vorhandenen
Softwaregruppe "swg_1" erstellt werden. Diese Gruppen werden mit den folgenden
Befehlen erstellt.
cadsmcmd swlibrary action=createGroup name=swg_1
cadsmcmd swlibrary action=createGroup name=pg_1 groupType=PG superGroup=swg_1
Geben Sie zur Überprüfung der Erstellung den folgenden Befehl ein, mit dem alle
verfügbaren Software- und Prozedurgruppen aufgelistet werden:
cadsmcmd swlibrary action=listGroups recursive
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
Verbindung zu Manager "<Standard-Manager>" als Benutzer "<Standardbenutzer>" wird
hergestellt... OK.
Manager: myManager
Domäne: myDomain
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
------------------------------------------------------------------------------Liste der Gruppen in der Softwarebibliothek
------------------------------------------------------------------------------Softwaregruppen
..Gruppenname...........................: Katalog
....Kommentar............................: Reservierte Gruppe in CA-Software
Delivery
....Erstellungsdatum......................: 2005-04-09 11:26
....Änderungsdatum........................: 2005-04-09 11:26
..Gruppenname...........................: Software Delivery
....Kommentar............................: Reservierte Gruppe in CA-Software
Delivery
....Erstellungsdatum......................: 2005-04-09 11:26
....Änderungsdatum........................: 2005-04-09 11:27
..Gruppenname...........................: swg_1
304 CLI-Referenzhandbuch
Kompatibilität
....Kommentar............................:
....Erstellungsdatum......................: 2005-04-10
....Änderungsdatum........................: 2003-04-10
....Prozedurgruppen
......Gruppenname.......................: pg_1
........Kommentar........................:
........Erstellungsdatum..................: 2005-04-10
........Änderungsdatum....................: 2005-04-10
08:51
09:11
09:11
09:11
SDCMD<A000000>: OK
Sie müssen das Argument "recursive" unbedingt hinzufügen, denn anderenfalls wird die
Prozedurgruppe "pg_1" als Untergruppe nicht aufgeführt, sondern nur die Gruppen der
obersten Ebene.
cadsmcmd swlibrary action=listGroups
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Verbindung zu Manager "kkkkk01b" als Benutzer "Standardbenutzer" wird
hergestellt...OK.
------------------------------------------------------------------------------Liste der Gruppen in der Softwarebibliothek
------------------------------------------------------------------------------Softwaregruppen
..Gruppenname...........................: Katalog
....Kommentar............................: Reservierte Gruppe in CA-Software
Delivery
....Erstellungsdatum......................: 2005-04-09 11:26
....Änderungsdatum........................: 2005-04-09 11:26
..Gruppenname...........................: Software Delivery
....Kommentar............................: Reservierte Gruppe in CA-Software
Delivery
....Erstellungsdatum......................: 2005-4-09 11:26
....Änderungsdatum........................: 200504-09 11:27
..Gruppenname...........................: swg_1
....Kommentar............................:
Kapitel 3: cadsmcmd-Befehle 305
Kompatibilität
....Erstellungsdatum......................: 2005-04-10 08:51
....Änderungsdatum........................: 2005-04-10 09:11
SDCMD<A000000>: OK
Angenommen, es sollen außerdem die Softwaregruppe "swg_2" sowie die
Softwaregruppe "swg_2_1" als Untergruppe von "swg_2" erstellt werden. Darüber
hinaus ist eine weitere Prozedurgruppe namens "pg_2" erforderlich. Die folgenden
Befehle generieren diese Gruppen und die entsprechende Hierarchie:
cadsmcmd swlibrary action=createGroup name=swg_2 groupType=SWG
cadsmcmd swlibrary action=createGroup name=swg_2_1 superGroup=swg_2
cadsmcmd swlibrary action=createGroup name=pg_2 groupType=PG
.
In der rekursiven Liste der Gruppen wird nun Folgendes angegeben:
cadsmcmd swlibrary action=listGroups recursive
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Verbindung zu Manager "kkkkk01b" als Benutzer "Standardbenutzer" wird
hergestellt...OK.
------------------------------------------------------------------------------Liste der Gruppen in der Softwarebibliothek
------------------------------------------------------------------------------Softwaregruppen
..Gruppenname...........................: Katalog
....Kommentar............................: Reservierte Gruppe in CA-Software
Delivery
....Erstellungsdatum......................: 2005-04-09 11:26
....Änderungsdatum........................: 2005-04-09 11:26
..Gruppenname...........................: Software Delivery
....Kommentar............................: Reservierte Gruppe in CA-Software
Delivery
....Erstellungsdatum......................: 2005-04-09 11:26
....Änderungsdatum........................: 2005-04-09 11:27
..Gruppenname...........................: swg_1
....Kommentar............................:
....Erstellungsdatum......................: 2005-04-10 08:51
....Änderungsdatum........................: 2005-04-10 09:11
....Prozedurgruppen
306 CLI-Referenzhandbuch
Kompatibilität
......Gruppenname.......................: pg_1
........Kommentar........................:
........Erstellungsdatum..................: 2005-04-10 09:11
........Änderungsdatum....................: 2005-04-10 09:11
..Gruppenname...........................: swg_2
....Kommentar............................:
....Erstellungsdatum......................: 2005-04-10 09:28
....Änderungsdatum........................: 200504-10 09:28
....Softwaregruppen
......Gruppenname.......................: swg_2_1
........Kommentar........................:
........Erstellungsdatum..................: 2005-04-10
........Änderungsdatum....................: 2005-04-10
Prozedurgruppen
..Gruppenname...........................: pg_2
....Kommentar............................:
....Erstellungsdatum......................: 2005-04-10
....Änderungsdatum........................: 2005-04-10
09:28
09:28
09:29
09:29
SDCMD<A000000>: OK
deleteGroup – Löschen von Softwaregruppen oder Prozedurgruppen
Mit dieser Aktion können Sie eine Software- oder Prozedurgruppe löschen.
Diese Aktion hat das folgende Format:
swLibrary action=deleteGroup name=Gruppenname [recursive]
Name
Gibt Folgendes an: Name der Gruppe, das gelöscht werden soll.
Die Gruppennamen "Alle Softwareprogramme" und "Katalog" können für diese
Methode nicht verwendet werden.
rekursiv
Es wird nicht nur die Gruppe gelöscht, sondern auch alle enthaltenen
Untergruppen.
Produkte oder Prozeduren, die einer zu löschenden Gruppe zugeordnet sind,
werden nicht gelöscht, sondern die Verknüpfung zu der Gruppe wird getrennt.
Hinweis: Wenn die zu löschende Gruppe nicht existiert, wird die Aktion mit Erfolg
durchgeführt (Rückgabecode: SDCMD<A000000>: OK).
Kapitel 3: cadsmcmd-Befehle 307
Kompatibilität
Beispiel:
Angenommen, die Softwaregruppe "swg_2" wird nicht mehr benötigt und soll gelöscht
werden. Darüber hinaus sollen auch alle Untergruppen dieser Gruppe gelöscht werden.
Geben Sie den folgenden Befehl ein, um die Gruppen zu löschen:
cadsmcmd swlibrary action=deleteGroup name=swg_2 recursive
Sie können auch den folgenden Befehl eingeben:
cadsmcmd swlibrary action=deleteGroup name=swg_2
In diesem Fall wird nur die angegebene Gruppe gelöscht. Dieser Vorgang schlägt fehl,
wenn die Gruppe "swg_2" eine Untergruppe enthält und "swg_2" die einzige dieser
Untergruppe übergeordnete Gruppe ist.
Sind weitere übergeordnete Gruppen vorhanden, wird die Verknüpfung der
Untergruppe mit der angegebenen Gruppe aufgehoben und die Gruppe gelöscht.
deliverGroupToStage – Liefern von Elementen der Softwaregruppe an Scalability-Server
Mit dieser Aktion können Sie Elemente einer Softwaregruppe an Scalability-Server
liefern.
Diese Aktion hat das folgende Format:
swLibrary action=deliverGroupToStage name=Gruppenname
{{computer=Computername
| {compgrp=Computergruppenname | ccompgrp=(Computergruppenname Trennzeichen
Gruppenbereich)}}
[sep=Trennzeichen]
[dname=Name_der_Verteilung]
cname=[Name]
[unsealed]
[{nolinkage|transaction[rollback]|synchronized}[nocascade]]
[deliveryTime="JJJJ-MM-TT hh:mm"]
[calendarname=Lieferungskalender]
[globalTime]
308 CLI-Referenzhandbuch
Kompatibilität
[{{area=area_name} | {domain=domain_name} | toAllAreas}]
[sendTime="JJJJ-MM-TT hh:mm"]
[haltTime="JJJJ-MM-TT hh:mm"]
[jcPriority={1,...,10}]
[distPriority={1,...,10}]
area
Gibt Folgendes an: Name einer CA ITCM-Domäne, an die die Verteilung gesendet
wird.
Der Parameter kann mehrfach angegeben werden , um eine Liste von CA ITCMDomänen zu adressieren.
Wenn dieser Parameter angegeben ist, wird die Verteilung versiegelt und an die
Ziele gesendet.
Wenn weder der Parameter "area" noch der Parameter "domain" oder "toAllAreas"
angegeben wird, bleibt die Verteilung unversiegelt und kann weiterhin geändert
werden.
Dieser Parameter sollte nicht mit den Parametern "domain" oder "toAllAreas"
angegeben werden.
(nur Enterprise-Manager)
calendarName
Gibt Folgendes an: Name des Kalenders, der die Zeit steuert, während der die
Evaluierung ausgeführt werden kann.
ccompgrp
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.
Kapitel 3: cadsmcmd-Befehle 309
Kompatibilität
cname
Gibt Folgendes an: optionaler eindeutiger Name eines Jobcontainers.
Wenn kein Parameter "cname" angegeben wird, wird intern ein Name generiert,
der von der Befehlszeilenschnittstelle als ID zurückgegeben wird.
compgrp
Gibt den Namen einer Servergruppe an, die die zu adressierenden Scalability-Server
enthält.
Der Parameter kann mehrfach angegeben werden , um mehrere Servergruppen zu
adressieren.
Die Parameter "compgrp" und "computer" sollten nicht gemeinsam verwendet
werden (nur Domänen-Manager).
computer
Gibt den Namen des Scalability-Servers an, der angesprochen werden soll.
Der Parameter kann mehrfach codiert werden, um mehrere Scalability-Server
anzusprechen.
Die Parameter "compgrp" und "computer" sollten nicht gemeinsam verwendet
werden.
(nur Domänen-Manager)
deliveryTime
Gibt Folgendes an: Startzeit der Lieferung vom Domänen-Manager.
Das Datum wird im ISO-Format "JJJJ-MM-TT HH:MM" angegeben.
Wenn der Parameter nicht angegeben ist, werden das aktuelle Datum und die
aktuelle Uhrzeit verwendet.
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.
dname
Gibt Folgendes an: Name der Verteilung.
Wenn der Parameter nicht angegeben ist, wird der Name automatisch erzeugt.
(nur Enterprise-Manager)
310 CLI-Referenzhandbuch
Kompatibilität
domain
Gibt Folgendes an: Name einer CA ITCM-Domänengruppe, an die die Verteilung
gesendet wird.
Der Parameter kann mehrfach angegeben werden , um eine Liste mit CA ITCMDomänengruppen anzugeben.
Wenn dieser Parameter angegeben ist, wird die Verteilung versiegelt und an die
Ziele gesendet.
Wenn weder der Parameter "area" noch der Parameter "domain" oder "toAllAreas"
angegeben wird, bleibt die Verteilung unversiegelt und kann weiterhin geändert
werden.
Dieser Parameter sollte nicht mit den Parametern "area" oder "toAllAreas"
angegeben werden.
(nur Enterprise-Manager)
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änenManagers.
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.
(nur Enterprise-Manager)
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 die Priorität nicht geändert.
Name
Gibt Folgendes an: Name einer Softwaregruppe, deren Mitglieder an den
angegebenen Scalability-Server übermittelt werden.
Kapitel 3: cadsmcmd-Befehle 311
Kompatibilität
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.
Rollback
Setzt die Jobverknüpfungsoption auf "Transaktion aktivieren".
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.
(nur Enterprise-Manager)
sep
Gibt ein alternatives Trennzeichen für die Option "ccompgroup" an. Das
Trennzeichen darf nicht Teil des Gruppennamencodes für die "ccompgroup"Optionen sein.
synchronisiert
Die Jobverknüpfungsoption wird auf "Synchronisierte Jobausführung" gesetzt.
Transaktion
Die Jobverknüpfungsoption wird auf "Batch-Jobausführung" gesetzt.
Dies ist die Standardeinstellung.
312 CLI-Referenzhandbuch
Kompatibilität
toAllAreas
Wenn dieser Parameter angegeben ist, wird die zugehörige Verteilung an alle CA
ITCM-Domänen gesendet, die beim Enterprise-Manager registriert sind.
Wenn dieser Parameter angegeben wird, wird die Verteilung versiegelt und
automatisch an ihre Ziele gesendet, nachdem der Befehl erfolgreich abgeschlossen
wurde.
Wenn weder der Parameter "area" noch der Parameter "domain" oder "toAllAreas"
angegeben wird, bleibt die Verteilung unversiegelt und kann weiterhin geändert
werden.
(nur Enterprise-Manager)
unsealed
Der adressierte Jobcontainer bleibt unversiegelt, nachdem der generierte Job
erfolgreich erstellt wurde.
(nur Domänen-Manager)
Wenn weder der Parameter "area" noch der Parameter "domain" oder "toAllAreas"
angegeben wird, bleibt der Verteilungscontainer unversiegelt und kann weiterhin
geändert werden.
Beispiel:
Angenommen, die Elemente der Softwaregruppe "swg_1" sollen an alle ScalabilityServer geliefert werden. Dieser Befehl wird auf einem Domänen-Manager aufgerufen.
"swg_1" hat den folgenden Inhalt:
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 zu Manager "<Standard-Manager>" als Benutzer "<Standardbenutzer>" wird
hergestellt... OK.
Manager: myManager
Domäne: myDomain
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
Kapitel 3: cadsmcmd-Befehle 313
Kompatibilität
------------------------------------------------------------------------------Mitglieder der Softwaregruppe "swg_1" auflisten
------------------------------------------------------------------------------tstbase 1.0 <allgemein>, <normal>, 22622(0), CA, http://supportconnect.ca.com/
tstkpk01 1.0 <allgemein>, <normal>, 22752(0), CA, http://supportconnect.ca.com/
tstkpk02 1.0 <allgemein>, <normal>, 22832(0), CA, http://supportconnect.ca.com/
DMS Editor 6.01.0000 <MSI>, <Regular>, 22972(0), CA,
http://supportconnect.ca.com/
pg_1 <Prozedurgruppe>
Hinweis: Die Einträge der Untergruppe "pg_1" wurden ignoriert, da Prozedurgruppen
nicht zum Liefern von Produkten an Scalability-Server verwendet werden können.
SDCMD<A000000>: OK
cadsmcmd swlibrary action=listPG name=pg_1
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.
------------------------------------------------------------------------------Mitglieder der Prozedurgruppe "pg_1" auflisten
------------------------------------------------------------------------------remdir (tstbase 1.0 <1>)
setdir (tstbase 1.0 <2>)
SDCMD<A000000>: OK
314 CLI-Referenzhandbuch
Kompatibilität
Geben Sie den folgenden Befehl ein, um die Lieferung durchzuführen:
cadsmcmd swlibrary action=deliverGroupToStage name=swg_1 compgrp="SD scalability
servers"
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 SD scalability servers [04/10/02 14:26:39.578] wurde
erstellt.
Gruppe swg_1 evaluieren
Gruppe swg_1/pg_1 evaluieren
Job "tstbase 1.0:delivery proc" generieren: OK.
Job "tstkpk01 1.0:delivery proc" generieren: OK.
Job "tstkpk02 1.0:delivery proc" generieren: OK.
Job "DMS Editor 6.01.0000:delivery proc" generieren: OK.
SDCMD<A000000>: OK
Mit Hilfe des folgenden Befehls wird der Inhalt des generierten Jobcontainers angezeigt:
cadsmcmd jobContainer action=listJobs name="SD staging servers [04/10/02
14:26:39.578]"
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.
------------------------------------------------------------------------------Jobliste des Jobcontainers "SD scalability servers [04/10/02 14:26:39.578]"
------------------------------------------------------------------------------Jobname................................: tstbase 1.0:delivery proc
..Task.................................: deliver
..Gesamtstatus......................: WAITING
..Jobauftragsnummer.....................: 1
Kapitel 3: cadsmcmd-Befehle 315
Kompatibilität
Jobname................................: tstkpk01 1.0:delivery proc
..Task.................................: deliver
..Gesamtstatus......................: WAITING
..Jobauftragsnummer.....................: 2
Jobname................................: tstkpk02 1.0:delivery proc
..Task.................................: deliver
..Gesamtstatus......................: WAITING
..Jobauftragsnummer.....................: 3
Jobname................................: DMS Editor 6.01.0000:delivery proc
..Task.................................: deliver
..Gesamtstatus......................: WAITING
..Jobauftragsnummer.....................: 4
------------------------------------------------------------------------------Anzahl der gelesenen Jobs: 4
Anzahl der gelesenen Jobs: 4
SDCMD<A000000>: OK
listGroups – Auflisten von Gruppen
Mit dieser Aktion listen Sie alle Software- und Prozedurgruppen auf.
Diese Aktion hat das folgende Format:
swLibrary action=listGroups [rekursiv]
rekursiv
Listet Unterverzeichnisse rekursiv auf.
Wenn dieser Parameter nicht angegeben wird, werden lediglich die Gruppen der
obersten Ebene angezeigt.
316 CLI-Referenzhandbuch
Kompatibilität
Beispiel
cadsmcmd swlibrary action=listgroups recursive
Die folgenden Informationen werden angezeigt:
------------------------------------------------------------------------------Liste der Gruppen in der Softwarebibliothek
------------------------------------------------------------------------------Softwaregruppen
..Gruppenname...........................: Katalog
....Kommentar............................: Reservierte Gruppe in CA-Software
Delivery
....Erstellungsdatum......................: 2001-07-05 10:28
....Änderungsdatum........................: 2001-08-28 17:42
..Gruppenname...........................: Software Delivery
....Kommentar............................: Reservierte Gruppe in CA-Software
Delivery
....Erstellungsdatum......................: 2001-07-05 10:29
....Änderungsdatum........................: 2001-09-06 10:36
..Gruppenname...........................: swg 0
....Kommentar............................:
....Erstellungsdatum......................: 2001-09-12 10:35
....Änderungsdatum........................: 2001-09-12 10:35
..Gruppenname...........................: swg 1
....Kommentar............................: Softwaregruppe zu Testzwecken
....Erstellungsdatum......................: 2001-09-12 08:54
....Änderungsdatum........................: 2001-09-12 10:35
....Softwaregruppen
......Gruppenname.......................: swg 0
........Kommentar........................:
........Erstellungsdatum..................: 2001-09-12 10:35
........Änderungsdatum....................: 2001-09-12 10:35
......Gruppenname.......................: swg 2
........Kommentar........................: eingebettete Softwaregruppe der Ebene
1
........Erstellungsdatum..................: 2001-09-12 09:19
........Änderungsdatum....................: 2001-09-12 09:31
Kapitel 3: cadsmcmd-Befehle 317
Kompatibilität
........Softwaregruppen
..........Gruppenname...................: swg 3
............Kommentar....................: eingebettete Softwaregruppe der Ebene
2
............Erstellungsdatum..............: 2001-09-12 09:31
............Änderungsdatum................: 2001-09-12 10:16
............Softwaregruppen
..............Gruppenname...............: swg 4
................Kommentar................: Dies ist ebenfalls eine eingebettete
Softwaregruppe.
................Erstellungsdatum..........: 2001-09-12 10:15
................Änderungsdatum............: 2001-09-12 10:15
............Prozedurgruppen
..............Gruppenname...............: pg 2
................Kommentar................: Dies ist ebenfalls eine eingebettete
Prozedurgruppe.
................Erstellungsdatum..........: 2001-09-12 10:16
................Änderungsdatum............: 2001-09-12 10:16
....Prozedurgruppen
......Gruppenname.......................: pg 0
........Kommentar........................:
........Erstellungsdatum..................: 2001-09-12 10:35
........Änderungsdatum....................: 2001-09-12 10:35
Prozedurgruppen
..Gruppenname...........................: pg 0
....Kommentar............................:
....Erstellungsdatum......................: 2001-09-12 10:35
....Änderungsdatum........................: 2001-09-12 10:35
..Gruppenname...........................: pg 1
....Kommentar............................: Prozedurgruppe zu Testzwecken
....Erstellungsdatum......................: 2001-09-12 08:54
....Änderungsdatum........................: 2001-09-12 08:54
SDCMD<A000000>: OK
listMembership – Auflisten der Mitgliedschaft
Mit dieser Aktion können Sie die Mitgliedschaften einer Gruppe auflisten. D.&#160;h.,
es werden die Gruppen angezeigt, in denen die Gruppe eine Untergruppe ist.
Diese Aktion hat das folgende Format:
swLibrary action=listMembership name=Gruppenname
Name
Gibt Folgendes an: Name einer Softwaregruppe oder einer Prozedurgruppe, deren
Mitgliedschaften aufgelistet werden.
318 CLI-Referenzhandbuch
Kompatibilität
Beispiel:
Geben Sie den folgenden Befehl ein, um Informationen zu Softwaregruppen abzurufen,
die die Prozedurgruppe "pg_1" enthalten:
cadsmcmd swlibrary action=listMembership name=pg_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 zu Manager "<Standard-Manager>" als Benutzer "<Standardbenutzer>" wird
hergestellt... OK.
Manager: myManager
Domäne: myDomain
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
------------------------------------------------------------------------------"pg_1" ist Mitglied der folgenden Gruppen
------------------------------------------------------------------------------swg_1 (Softwaregruppe, 2005-04-10 08:51)
swg_2.1 (Softwaregruppe, 2005-04-10 09:28)
SDCMD<A000000>: OK
modifyGroup – Bearbeiten von Attributen der Softwaregruppe oder Prozedurgruppe
Mit dieser Aktion können Sie die Attribute einer Software- oder Prozedurgruppe ändern.
Diese Aktion hat das folgende Format:
swLibrary action=modifyGroup name=Gruppenname
[newName=neuer Gruppenname]
[comment=Kommentar]
Kapitel 3: cadsmcmd-Befehle 319
Kompatibilität
comment
Gibt einen neuen Kommentar für die Gruppe an.
Hinweis: Geben Sie eine leere Zeichenfolge ein (""), um einen vorhandenen
Kommentar zu löschen.
Name
Gibt Folgendes an: Name einer Computergruppe, der geändert werden soll.
newName
Gibt Folgendes an: Neuer Name der Computergruppe.
Neu Name einer Computergruppe.
Beispiel:
Angenommen, die Softwaregruppe "swg_2_1" soll bearbeitet werden. Der neue Name
der Gruppe lautet "swg_2.1", und der Kommentar "4 test only" wird hinzugefügt. Geben
Sie den folgenden Befehl ein, um die Änderungen vorzunehmen:
cadsmcmd swlibrary action=modifyGroup name=swg_2_1 newName=swg_2.1 comment="4
test only"
undeliverGroupFromStage – Zurückrufen von Elementen von Softwaregruppen von ScalabilityServern
Diese Aktion ermöglicht den "Rückruf" von Elementen einer Softwaregruppe von
Scalability-Servern, d.&#160;h., sie werden aus der Softwarebibliothek des ScalabilityServers entfernt.
Diese Aktion hat das folgende Format:
swLibrary action=undeliverGroupFromStage name=Gruppenname
{{computer=Computername
| {compgrp=Computergruppenname | ccompgrp=(Computergruppenname Trennzeichen
Gruppenbereich)}}
[sep=Trennzeichen]
[dname=Name_der_Verteilung]
cname=[Name]
[unsealed]
[{nolinkage|transaction[rollback]|synchronized}[nocascade]]
[deliveryTime="JJJJ-MM-TT hh:mm"]
[calendarname=Lieferungskalender]
[globalTime]
[{{area=area_name} | {domain=domain_name} | toAllAreas}]
[sendTime="JJJJ-MM-TT hh:mm"]
[haltTime="JJJJ-MM-TT hh:mm"]
[jcPriority={1,...,10}]
[distPriority={1,...,10}]
320 CLI-Referenzhandbuch
Kompatibilität
area
Gibt Folgendes an: Name einer CA ITCM-Domäne, an die die Verteilung gesendet
wird.
Der Parameter kann mehrfach angegeben werden , um eine Liste von CA ITCMDomänen zu adressieren.
Wenn dieser Parameter angegeben wird, wird die Verteilung versiegelt und
automatisch an ihre Ziele gesendet, nachdem der Befehl erfolgreich abgeschlossen
wurde.
Wenn weder der Parameter "area" noch der Parameter "domain" oder "toAllAreas"
angegeben wird, bleibt die Verteilung unversiegelt und kann weiterhin geändert
werden.
Dieser Parameter sollte nicht mit den Parametern "domain" oder "toAllAreas"
angegeben werden.
(nur Enterprise-Manager)
calendarName
Gibt Folgendes an: Name des Kalenders, der die Zeit steuert, während der die
Evaluierung ausgeführt werden kann.
ccompgrp
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.
Kapitel 3: cadsmcmd-Befehle 321
Kompatibilität
cname
Gibt Folgendes an: optionaler eindeutiger Name eines Jobcontainers..
Wenn kein Parameter "cname" angegeben wird, wird intern ein Name generiert,
der von der Befehlszeilenschnittstelle als ID zurückgegeben wird.
compgrp
Gibt den Namen der Servergruppe an, die die zu adressierenden Scalability-Server
enthält.
Der Parameter kann mehrfach angegeben werden , um mehrere Servergruppen zu
adressieren.
Der Parameter sollte nicht mit dem Parameter "computer" angegeben werden.
computer
Gibt den Namen des Scalability-Servers an, der angesprochen werden soll.
Der Parameter kann mehrfach codiert werden, um mehrere Scalability-Server
anzusprechen.
Die Parameter "compgrp" und "computer" sollten nicht gemeinsam verwendet
werden.
(nur Domänen-Manager)
deliveryTime
Gibt Folgendes an: Startzeit der Lieferung vom Domänen-Manager.
Das Datum wird im ISO-Format "JJJJ-MM-TT HH:MM" angegeben.
Wenn der Parameter nicht angegeben ist, werden das aktuelle Datum und die
aktuelle Uhrzeit verwendet.
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.
dname
Gibt Folgendes an: Name der Verteilung
(nur Enterprise-Manager)
322 CLI-Referenzhandbuch
Kompatibilität
domain
Gibt Folgendes an: Name einer CA ITCM-Domänengruppe, an die die Verteilung
gesendet wird.
Der Parameter kann mehrfach angegeben werden , um eine Liste von CA ITCMDomänengruppen zu adressieren.
Wenn dieser Parameter angegeben wird, wird die Verteilung versiegelt und
automatisch an ihre Ziele gesendet, nachdem der Befehl erfolgreich abgeschlossen
wurde.
Wenn weder der Parameter "area" noch der Parameter "domain" oder "toAllAreas"
angegeben wird, bleibt die Verteilung unversiegelt und kann weiterhin geändert
werden.
Dieser Parameter sollte nicht mit den Parametern "area" oder "toAllAreas"
angegeben werden.
(nur Enterprise-Manager)
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änenManagers.
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.
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.
Name
Gibt Folgendes an: Name einer Softwaregruppe, deren Mitglieder von dem
angegebenen Scalability-Server zurückgerufen werden.
Kapitel 3: cadsmcmd-Befehle 323
Kompatibilität
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.
Rollback
Setzt die Jobverknüpfungsoption auf "Transaktion aktivieren".
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.
(nur für Enterprise-Manager)
sep
Gibt ein alternatives Trennzeichen für die Option "ccompgroup" an. Das
Trennzeichen darf nicht Teil des Gruppennamencodes für die "ccompgroup"Optionen sein.
synchronisiert
Die Jobverknüpfungsoption wird auf "Synchronisierte Jobausführung" gesetzt.
toAllAreas
Wenn dieser Parameter angegeben ist, wird die zugehörige Verteilung an alle CA
ITCM-Domänen gesendet, die beim Enterprise-Manager registriert sind.
Wenn dieser Parameter angegeben wird, wird die Verteilung versiegelt und
automatisch an ihre Ziele gesendet, nachdem der Befehl erfolgreich abgeschlossen
wurde.
Wenn weder der Parameter "area" noch der Parameter "domain" oder "toAllAreas"
angegeben wird, bleibt die Verteilung unversiegelt und kann weiterhin geändert
werden.
"toAllAreas" sollte nicht mit den Parametern "area" oder "domain" angegeben
werden.
(nur Enterprise-Manager)
324 CLI-Referenzhandbuch
Kompatibilität
Transaktion
Die Jobverknüpfungsoption wird auf "Batch-Jobausführung" gesetzt.
unsealed
Der adressierte Jobcontainer bleibt unversiegelt, nachdem der generierte Job
erfolgreich erstellt wurde.
(nur Domänen-Manager)
Wenn weder der Parameter "area" noch der Parameter "domain" oder "toAllAreas"
angegeben wird, bleibt der Verteilungscontainer unversiegelt und kann weiterhin
geändert werden.
Softwaregruppen-Verwaltung
Dieser Abschnitt enthält die folgenden Themen:
addGroupToSWG – Hinzufügen einer Gruppe zu einer Softwaregruppe (siehe Seite 325)
addItemToSWG – Hinzufügen eines Elements zu einer Softwaregruppe (siehe Seite 326)
listSWG – Auflisten von Produkten der Softwaregruppe (siehe Seite 327)
removeGroupFromSWG – Entfernen einer Gruppe aus einer Softwaregruppe (siehe
Seite 333)
removeItemFromSWG – Element aus einer Softwaregruppe entfernen (siehe Seite 333)
addGroupToSWG – Hinzufügen einer Gruppe zu einer Softwaregruppe
Mit dieser Aktion können Sie einer Softwaregruppe neue Untergruppen hinzufügen.
Diese Aktion hat das folgende Format:
swLibrary action=addGroupToSWG [name=Gruppenname]
{subGroup=Gruppenname}
Name
Gibt Folgendes an: Name einer Softwaregruppe, die durch die neue Untergruppe
des Parameters "subGroup" erweitert wird.
Wenn dieser Parameter nicht angegeben ist, wird der Ordner "Softwarebibliothek"
der obersten Ebene verwendet.
subGroup
Gibt Folgendes an: Name einer Untergruppe, die der Gruppe hinzugefügt werden
soll.
Die Untergruppe muss bereits als Gruppe in der Softwarebibliothek vorhanden sein.
Der Parameter kann mehrfach angegeben werden , um eine Liste von
Untergruppen hinzuzufügen.
Kapitel 3: cadsmcmd-Befehle 325
Kompatibilität
addItemToSWG – Hinzufügen eines Elements zu einer Softwaregruppe
Mit dieser Aktion können Sie einer Softwaregruppe Produkte hinzufügen.
Diese Aktion hat das folgende Format:
swLibrary action=addItemToSWG
name=Softwaregruppenname
{item=Elementname version=Elementversion
| {itemList=(Elementname/Elementversion)}}
item
Gibt Folgendes an: Name des Elements, die hinzugefügt werden sollen.
Wenn dieser Parameter angegeben ist, wird die Parameterversion obligatorisch.
Dieser Parameter sollte nicht mit dem Parameter "itemList" angegeben werden.
itemList
Gibt Folgendes an: Element, gekennzeichnet durch das Paar (Elementname
Elementversion)., das der Softwaregruppe hinzugefügt werden soll.
Dieser Parameter kann auch mehrfach angegeben werden, um eine Liste mit
Elementen zu erstellen. , die hinzugefügt werden sollen.
Da der Schrägstrich ("/") als Trennzeichen verwendet wird, müssen Elementnamen
oder Elementversionen, die Schrägstriche enthalten, in Anführungszeichen (")
eingeschlossen werden.
Dieser Parameter sollte nicht mit dem Parameter "item" angegeben werden.
326 CLI-Referenzhandbuch
Kompatibilität
Name
Gibt Folgendes an: Name einer Softwaregruppe, der das Element hinzugefügt wird.
Version
Gibt Folgendes an: Version des Elements, die hinzugefügt werden sollen.
Dieser Parameter sollte nur mit dem Parameter "item" angegeben werden.
Hinweise: Es gibt zwei Möglichkeiten, ein hinzuzufügendes Element anzugeben: Die
erste Möglichkeit ist die Verwendung der Parameter "item" und "version", die zweite
die Verwendung des Parameters "itemList". Beide Formate sollten innerhalb des Befehls
nicht gleichzeitig verwendet werden. Einer von beiden sollte jedoch verwendet werden.
Die hinzuzufügenden Elemente müssen zum Zeitpunkt des Befehlsaufrufs bereits in der
Softwarebibliothek definiert sein. Dieser Befehl erzeugt keine neuen Elemente in der
Softwarebibliothek.
Wenn Sie den Parameter "itemList" an der Batch- oder der Befehlszeilenschnittstelle
verwenden, müssen alle eventuell vorhandenen Schrägstriche in Elementnamen oder
Elementversion verdoppelt werden.
Wenn der itemList-Parameter Leerzeichen enthält, setzen Sie es in Anführungszeichen
("). (Dies gilt sowohl für die Verwendung in der Befehlszeile als auch in BatchProzessen).
listSWG – Auflisten von Produkten der Softwaregruppe
Diese Aktion listet die Produkte einer Softwaregruppe rekursiv auf.
Diese Aktion hat das folgende Format:
swLibrary action=listSWG name=Gruppenname [recursive]
Name
Gibt Folgendes an: Name einer Softwaregruppe, die aufgelistet werden soll.
rekursiv
Listet Unterverzeichnisse rekursiv auf.
Wenn dieser Parameter nicht angegeben wird, werden lediglich die Gruppen der
obersten Ebene angezeigt.
Kapitel 3: cadsmcmd-Befehle 327
Kompatibilität
Beispiel
Im Fall einer Softwaregruppe "swg_1". Vor einer Änderung sollten die Gruppe, die
Struktur der Gruppe und die Inhalte aufgelistet werden. Geben Sie dazu die folgenden
Befehle ein:
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: DATEI
Name der Trace-Datei: C:\ProgramFiles\CA\DSM\SD\..\logs\cadsmcmd.log
Verbindung zu Manager "<Standardmanager>" als Benutzer "<Standardbenutzer>" wird
hergestellt ...OK.
Manager: myManager
Domäne: myDomain
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM AM
------------------------------------------------------------------------------Mitglieder der Softwaregruppe "swg_1" auflisten
------------------------------------------------------------------------------tstbase 1.0 <allgemein>, <normal>, 22622(0), CA, http://supportconnect.ca.com/
tstkpk01 1.0 <allgemein>, <normal>, 22752(0), CA, http://supportconnect.ca.com/
tstkpk02 1.0 <allgemein>, <normal>, 22832(0), CA, http://supportconnect.ca.com/
tstkpk03 1.0 <allgemein>, <normal>, 22962(0), CA, http://supportconnect.ca.com/
pg_1 <Prozedurgruppe>
SDCMD<A000000>: OK
cadsmcmd swlibrary action=listPG name=pg_1
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Verbindung zu Manager "kkkkk01b" als Benutzer "Standardbenutzer" wird
hergestellt...OK.
------------------------------------------------------------------------------Mitglieder der Prozedurgruppe "pg_1" auflisten
------------------------------------------------------------------------------inst (tstbase 1.0 <1>)
inst (tstkpk03 1.0 <2>)
SDCMD<A000000>: OK
328 CLI-Referenzhandbuch
Kompatibilität
Der Eintrag"tstkpk03" ist nicht erforderlich und sollte entfernt werden. Um diese Aktion
auszuführen, verwenden Sie den folgenden Befehl:
cadsmcmd swlibrary action=removeItemFromSWG name=swg_1 item=tstkpk03 version=1.0
Die Entfernung bedeutet nicht, dass das Element tstkpk03 aus der Softwarebibliothek
gelöscht wird. Es ist noch in "Alle Software-Programme" und in allen anderen Gruppen,
denen es zugewiesen worden ist, verfügbar. Das Objekt wird lediglich aus der Gruppe
swg_1 entfernt.
Wenn außer tstkpk03 auch der Eintrag tstbase entfernt werden soll, ermöglicht Ihnen
der folgende Befehl das Entfernen beider Einträge mit einem Aufruf:
cadsmcmd swlibrary action=removeItemFromSWG name=swg_1 itemList=(tstbase/1.0)
itemList=("tstkpk03" /"1.0")
Angenommen, Sie möchten der Gruppe ein Produkt mit dem Namen "DMS Editor" der
Version 6.01.0000 hinzufügen. Der folgende Befehl nimmt die Zuordnung vor:
cadsmcmd swlibrary action=addItemToSWG name=swg_1 item="DMS Editor"
version=6.01.0000
Wenn ein weiteres Produkt (beispielsweise "DMS Interpreter" der Version 6.01.0000)
hinzugefügt werden soll, können Sie dies mit dem folgenden Befehl in einem Aufruf tun:
cadsmcmd swlibrary action=addItemToSWG name=swg_1 itemList=("DMS Editor"
/6.01.0000) itemList=("DMS Interpreter" /6.01.0000)
Die Gruppe besitzt nun die folgenden Inhalte:
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.
Verbindung zu Manager "kkkkk01b" als Benutzer "Standardbenutzer" wird
hergestellt...OK.
------------------------------------------------------------------------------Mitglieder der Softwaregruppe "swg_1" auflisten
------------------------------------------------------------------------------tstbase 1.0 <allgemein>, <normal>, 22622(0), CA, http://supportconnect.ca.com/
tstkpk01 1.0 <allgemein>, <normal>, 22752(0), CA, http://supportconnect.ca.com/
tstkpk02 1.0 <allgemein>, <normal>, 22832(0), CA, http://supportconnect.ca.com/
DMS Editor 6.01.0000 <MSI>, <Regular>, 22972(0), CA http://supportconnect.ca.com/
pg_1 <Prozedurgruppe>
SDCMD<A000000>: OK
Kapitel 3: cadsmcmd-Befehle 329
Kompatibilität
cadsmcmd swlibrary action=listPG name=pg_1
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Verbindung zu Manager "kkkkk01b" als Benutzer "Standardbenutzer" wird
hergestellt...OK.
------------------------------------------------------------------------------Mitglieder der Prozedurgruppe "pg_1" auflisten
------------------------------------------------------------------------------inst (tstbase 1.0 <1>)
inst (tstkpk03 1.0 <2>)
SDCMD<A000000>: OK
Betrachten Sie folgende Situation:
cadsmcmd swlibrary action=listGroups recursive
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Verbindung zu Manager "kkkkk01b" als Benutzer "Standardbenutzer" wird
hergestellt...OK.
------------------------------------------------------------------------------Liste der Gruppen in der Softwarebibliothek
------------------------------------------------------------------------------Softwaregruppen
..Gruppenname...........................: Katalog
....Kommentar............................: Reservierte Gruppe in CA-Software
Delivery
....Erstellungsdatum......................: 2003-04-09 11:26
....Änderungsdatum........................: 2003-04-09 11:26
..Gruppenname...........................: Software Delivery
....Kommentar............................: Reservierte Gruppe in CA-Software
Delivery
....Erstellungsdatum......................: 2003-04-09 11:26
....Änderungsdatum........................: 2003-04-09 11:27
..Gruppenname...........................: swg_1
....Kommentar............................:
....Erstellungsdatum......................: 2003-04-10 08:51
....Änderungsdatum........................: 2003-04-10 10:33
330 CLI-Referenzhandbuch
Kompatibilität
....Prozedurgruppen
......Gruppenname.......................: pg_1
........Kommentar........................:
........Erstellungsdatum..................: 2003-04-10
........Änderungsdatum....................: 2003-04-10
..Gruppenname...........................: swg_2
....Kommentar............................:
....Erstellungsdatum......................: 2003-04-10
....Änderungsdatum........................: 2003-04-10
09:11
10:13
09:28
09:28
....Softwaregruppen
......Gruppenname.......................: swg_2.1
........Kommentar........................: nur zu Testzwecken
........Erstellungsdatum..................: 2003-04-10 09:28
........Änderungsdatum....................: 2003-04-10 09:57
..Gruppenname...........................: swg_2.1
....Kommentar............................: nur zu Testzwecken
....Erstellungsdatum......................: 2003-04-10 09:28
....Änderungsdatum........................: 2003-04-10 09:57
Prozedurgruppen
..Gruppenname...........................: pg_2
....Kommentar............................:
....Erstellungsdatum......................: 2003-04-10 09:29
....Änderungsdatum........................: 2003-04-10 09:29
SDCMD<A000000>: OK
Die Softwaregruppe "swg_2.1" soll als Untergruppe aus der Gruppe "swg_2" entfernt
werden. Stattdessen soll "pg_2" als neue Untergruppe zu "swg_2" hinzugefügt werden.
Die folgenden Befehle ordnen die Hierarchie neu:
cadsmcmd swlibrary action=removeGroupFromSWG name=swg_2 subgroup=swg_2.1
cadsmcmd swlibrary action=addGroupToSWG name=swg_2 subgroup=pg_2
Die Hierarchie sieht nun folgendermaßen aus:
cadsmcmd swlibrary action=listGroups recursive
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Verbindung zu Manager "kkkkk01b" als Benutzer "Standardbenutzer" wird
hergestellt...OK.
Kapitel 3: cadsmcmd-Befehle 331
Kompatibilität
------------------------------------------------------------------------------Liste der Gruppen in der Softwarebibliothek
------------------------------------------------------------------------------Softwaregruppen
..Gruppenname...........................: Katalog
....Kommentar............................: Reservierte Gruppe in CA-Software
Delivery
....Erstellungsdatum......................: 2003-04-09 11:26
....Änderungsdatum........................: 2003-04-09 11:26
..Gruppenname...........................: Software Delivery
....Kommentar............................: Reservierte Gruppe in CA-Software
Delivery
....Erstellungsdatum......................: 2003-04-09 11:26
....Änderungsdatum........................: 2003-04-09 11:27
..Gruppenname...........................: swg_1
....Kommentar............................:
....Erstellungsdatum......................: 2003-04-10
....Änderungsdatum........................: 2003-04-10
....Prozedurgruppen
......Gruppenname.......................: pg_1
........Kommentar........................:
........Erstellungsdatum..................: 2003-04-10
........Änderungsdatum....................: 2003-04-10
08:51
10:58
09:11
10:13
..Gruppenname...........................: swg_2
....Kommentar............................:
....Erstellungsdatum......................: 2003-04-10 09:28
....Änderungsdatum........................: 2003-04-10 11:11
....Prozedurgruppen
......Gruppenname.......................: pg_2
........Kommentar........................:
........Erstellungsdatum..................: 2003-04-10 09:29
........Änderungsdatum....................: 2003-04-10 09:29
..Gruppenname...........................: swg_2.1
....Kommentar............................: nur zu Testzwecken
....Erstellungsdatum......................: 2003-04-10 09:28
....Änderungsdatum........................: 2003-04-10 09:57
Prozedurgruppen
..Gruppenname...........................: pg_2
....Kommentar............................:
....Erstellungsdatum......................: 2003-04-10 09:29
....Änderungsdatum........................: 2003-04-10 09:29
SDCMD<A000000>: OK
Wenn swg_2.1 nicht außerhalb von swg_2 eine Zuordnung besitzt (d.h., wenn swg_2 die
einzige übergeordnete Gruppe ist) resultiert der Befehl zum Entfernen dieser
Untergruppe aus swg_2 in dem Fehler A001563.
332 CLI-Referenzhandbuch
Kompatibilität
removeGroupFromSWG – Entfernen einer Gruppe aus einer Softwaregruppe
Diese Aktion entfernt Untergruppen aus einer Softwaregruppe. Dies bedeutet nicht,
dass die Untergruppen gelöscht werden.
Diese Aktion hat das folgende Format:
swLibrary action=removeGroupFromSWG [name=Gruppenname]
{subGroup=Gruppenname}
Name
Gibt Folgendes an: Name der Gruppe, aus der die Untergruppe entfernt wird.
Wenn dieser Parameter nicht angegeben ist, wird der Ordner
"Softwarepaketbibliothek" der obersten Ebene verwendet.
subGroup
Gibt Folgendes an: Name einer Untergruppe, die aus der Gruppe entfernt werden
soll.
Der Parameter kann mehrfach angegeben werden , um eine Liste von
Untergruppen zu entfernen.
Die Verknüpfung der Untergruppen mit der Gruppe wird getrennt.
Dieser Prozess schlägt fehl, wenn die angegebene Gruppe die einzige
übergeordnete Gruppe der Untergruppe ist. Eine solche Untergruppe kann
ausschließlich mit Hilfe von action=deleteGroup gelöscht werden.
Wenn eine Untergruppe aus einer Gruppe entfernt wird, bedeutet das nicht, dass
die Untergruppe gelöscht wird.
removeItemFromSWG – Element aus einer Softwaregruppe entfernen
Diese Aktion entfernt Produkte aus einer Softwaregruppe.
Diese Aktion hat das folgende Format:
swLibrary action=removeItemFromSWG
name=Softwaregruppenname
{item=Elementname
version=Elementversion |
{itemList=(Elementname/Elementversion)}}
Kapitel 3: cadsmcmd-Befehle 333
Kompatibilität
item
Gibt Folgendes an: Name des Elements, die entfernt werden sollen.
itemList
Gibt Folgendes an: Element, gekennzeichnet durch das Paar (Elementname
Elementversion)., das aus der Softwaregruppe entfernt werden soll.
Dieser Parameter kann auch mehrfach angegeben werden, um eine Liste mit
Elementen zu erstellen. , die entfernt werden sollen.
Da der Schrägstrich ("/") als Trennzeichen verwendet wird, müssen Elementnamen
oder Elementversionen, die Schrägstriche enthalten, in Anführungszeichen (")
eingeschlossen werden.
Name
Gibt Folgendes an: Name einer Softwaregruppe, aus der das Element entfernt wird.
Version
Gibt Folgendes an: Version des Elements, die entfernt werden sollen.
Hinweise: Es gibt zwei Möglichkeiten, ein zu entfernendes Element anzugeben. Die
erste Möglichkeit ist die Verwendung der Parameter "item" und "version" die zweite die
Verwendung des Parameters "itemList". Beide Formate sollten innerhalb des Befehls
nicht gleichzeitig verwendet werden. Einer von beiden sollte jedoch verwendet werden.
Ein Element aus einer Softwaregruppe zu entfernen bedeutet nicht, dass das Element
aus der Softwarebibliothek gelöscht wird. Andere Zuweisungen zu anderen
Softwaregruppen werden nicht geändert. Wenn Sie den Parameter "itemList" an der
Batch- oder der Befehlszeilenschnittstelle verwenden, müssen alle eventuell
vorhandenen Schrägstriche in Elementnamen oder Elementversion verdoppelt werden.
Wenn der itemList-Parameter Leerzeichen enthält, setzen Sie es in Anführungszeichen
("). (Dies gilt sowohl für die Verwendung in der Befehlszeile als auch in BatchProzessen).
Beispiele (Siehe Definition auf Seite 328)
Kataloggruppen-Verwaltung
Die Katalogverarbeitung ist eine besondere Form der Softwaregruppen-Verarbeitung.
Folgende Katalogmethoden stehen zu Verfügung.
Sie können nur beim Domänen-Manager verwendet werden.
Dieser Abschnitt enthält die folgenden Themen:
createCG – Erstellen von Kataloggruppen (siehe Seite 335)
listCG – Auflisten von Kataloggruppen (siehe Seite 335)
removeCG – Entfernen von Kataloggruppen (siehe Seite 338)
334 CLI-Referenzhandbuch
Kompatibilität
createCG – Erstellen von Kataloggruppen
Mit dieser Aktion können Sie Kataloggruppen erstellen.
Diese Aktion ist nur für Domänen-Manager zulässig.
Diese Aktion hat das folgende Format:
swLibrary action=createCG
name=Computergruppenname
[groupScope={global | local}]
groupScope
Gibt den Bereich der definierten Gruppe an. Für diese Option sind folgende Werte
gültig:
Global
Bei der Gruppe handelt es sich um eine globale, auf einem Enterprise-Manager
erstellte Gruppe. Sie kann auf einem Domänen-Manager repliziert werden.
Lokal
Gibt eine auf dem mit "CADSMCMD" verbundenen Domänen-Manager erstellte
lokale Gruppe an.
Wenn "groupScope" nicht angegeben ist, versucht der Befehl "CADSMCMD"
zunächst, die Gruppe als lokale Gruppe zu bestimmen. Sollte dies fehlschlagen, wird
versucht, die Gruppe als globale Gruppe zu bestimmen.
Name
Gibt Folgendes an: Name einer Computergruppe, um eine Kataloggruppe zu
erstellen.
Hinweis: Ein Beispiel zur Verwendung des Befehls "createCG" finden Sie im Beispiel für
den Befehl "listCG".
listCG – Auflisten von Kataloggruppen
Mit dieser Aktion können Sie alle vorhandenen Kataloggruppen auflisten.
Diese Aktion ist nur für Domänen-Manager zulässig.
Diese Aktion hat das folgende Format:
swLibrary action=listCG [detailed]
detailed
Listet die zugeordneten Produkte auf.
Kapitel 3: cadsmcmd-Befehle 335
Kompatibilität
Beispiel:
Geben Sie den folgenden Befehl ein, um alle definierten Kataloggruppen anzuzeigen:
cadsmcmd swlibrary action=listCG
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: DATEI
Name der Trace-Datei: C:\ProgramFiles\CA\DSM\SD\..\logs\cadsmcmd.log
Verbindung zu Manager "<Standard-Manager>" als Benutzer "<Standardbenutzer>" wird
hergestellt... OK.
Manager: myManager
Domäne: myDomain
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
------------------------------------------------------------------------------Liste der Kataloggruppen
------------------------------------------------------------------------------c_grp (cgrp, local)
q_grp (qgrp, local)
t_grp (tgrp, local)
SDCMD<A000000>: OK
Wenn auch die den Kataloggruppen zugewiesenen Produkte aufgelistet werden sollen,
führen Sie den folgenden Befehl aus:
cadsmcmd swlibrary action=listCG detailed
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: DATEI
Name der Trace-Datei: C:\ProgramFiles\CA\DSM\SD\..\logs\cadsmcmd.log
Verbindung mit dem Manager "Standard-Manager" als Benutzer "<Standardbenutzer>"
wird hergestellt...OK.
336 CLI-Referenzhandbuch
Kompatibilität
Manager: myManager
Domäne: myDomain
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
------------------------------------------------------------------------------Liste der Kataloggruppen
------------------------------------------------------------------------------c_grp (cgrp, local)
..DMS Editor 6,01.0000 <MSI>, <normal>, 22422<0>, CA,
http://supportconnect.ca.com/
q_grp (qgrp, local)
..DM Skript-Generator 4,0 <allgemein>, <normal>, 22722<0>, CA,
http://supportconnect.ca.com/
t_grp (tgrp, local)
..SD Boot-Servererweiterung für WinNT/W2K 4,0 <allgemein>, <normal>, 22922<0>,
CA, http://supportconnect.ca.com/
SDCMD<A000000>: OK
Angenommen, die Kataloggruppe "t_grp" wird nicht mehr benötigt und soll entfernt
werden. Außerdem soll für die Computergruppe "tq_grp" eine neue Kataloggruppe
hinzugefügt werden. Die folgenden Befehle führen diese Neuordnung aus:
cadsmcmd swlibrary action=removeCG name=t_grp
cadsmcmd swlibrary action=createCG name=tq_grp
Geben Sie folgenden Befehl ein, um der Kataloggruppe "tq_grp" das Element "Data
Transport Service for Win32" der Version "2.0 SP1 ENU" hinzuzufügen:
cadsmcmd swlibrary action=addItemToSWG name=tq_grp item="Data Transport Service
for Win32" version="2.0 SP1 ENU"
Sie können Elemente mit der Aktion "removeItemFromSWG" aus einer Kataloggruppe.
Die Katalogliste sieht nun folgendermaßen aus:
cadsmcmd swlibrary action=listCG detailed
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: DATEI
Name der Trace-Datei: C:\ProgramFiles\CA\DSM\SD\..\logs\cadsmcmd.log
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
Kapitel 3: cadsmcmd-Befehle 337
Kompatibilität
------------------------------------------------------------------------------Liste der Kataloggruppen
------------------------------------------------------------------------------c_grp (cgrp, local)
..DMS Editor 6,01.0000 <MSI>, <normal>, 22422<0>, CA,
http://supportconnect.ca.com/
q_grp (qgrp, local)
..DM Skript-Generator 4,0 <allgemein>, <normal>, 22722<0>, CA,
http://supportconnect.ca.com/
tq_grp (tgrp, local)
..Data Transport Service für Win32 2.0 SP1 ENU <allgemein>, <normal>, 22922<0>,
CA, http://supportconnect.ca.com/
SDCMD<A000000>: OK
removeCG – Entfernen von Kataloggruppen
Diese Aktion entfernt eine Kataloggruppe.
Diese Aktion ist nur für Domänen-Manager zulässig.
Diese Aktion hat das folgende Format:
swLibrary action=removeCG name=Kataloggruppenname
Name
Gibt Folgendes an: Name der Kataloggruppe, das gelöscht werden soll.
Hinweis: Ein Beispiel zur Verwendung des Befehls "removeCG" finden Sie im Beispiel für
den Befehl "listCG".
Prozedurgruppen-Verwaltung
Dieser Abschnitt enthält die folgenden Themen:
addProcToPG – Hinzufügen von Prozeduren zu Prozedurgruppen (siehe Seite 339)
listPG – Auflisten von Prozedurgruppen der Prozedurgruppe (siehe Seite 339)
removeProcFromPG – Entfernen von Prozeduren aus Prozedurgruppen (siehe Seite 342)
repositionItem – Neuanordnung von Elementen in der Prozedurgruppe (siehe Seite 343)
338 CLI-Referenzhandbuch
Kompatibilität
addProcToPG – Hinzufügen von Prozeduren zu Prozedurgruppen
Mit dieser Aktion können Sie einer Prozedurgruppe Produktprozeduren hinzufügen.
Das Element muss bereits in der Softwarebibliothek definiert sein, und die Prozedur
muss bereits für das Element definiert sein.
Diese Aktion hat das folgende Format:
swLibrary action=addProcToPG name=Prozedurgruppenname
procedure=Prozedurname
item=Elementname
version=Elementversion
Name
Gibt Folgendes an: Name der Prozedurgruppe, der die Prozedur hinzugefügt wird.
Prozedur
Gibt Folgendes an: Name einer Prozedur, die hinzugefügt wird.
item
Gibt Folgendes an: Name des Elements, dem die Prozedur entnommen wird.
Version
Gibt Folgendes an: Version des Elements, dem die Prozedur entnommen wird.
listPG – Auflisten von Prozedurgruppen der Prozedurgruppe
Diese Aktion listet Prozeduren auf, die einer Prozedurgruppe zugewiesen sind.
Diese Aktion hat das folgende Format:
swLibrary action=listPG name=Prozedurgruppenname
Name
Gibt Folgendes an: Name der Prozedurgruppe, die aufgelistet werden soll.
Es werden die folgenden Informationen angezeigt:
------------------------------------------------------------------------------Mitglieder der Prozedurgruppe "pg 0" auflisten
------------------------------------------------------------------------------Reinstall Package (xxbl0del (SXP) 2.0/00 <1>)
Reinstall Package (xxbl1del (SXP) 2.0/00 <2>)
Reinstall Package (xxbl4del (SXP) 2.0/00 <3>)
SDCMD<A000000>: OK
Die Zahl in spitzen Klammern zeigt die Reihenfolge der Prozedur in der Prozedurgruppe
an.
Kapitel 3: cadsmcmd-Befehle 339
Kompatibilität
Beispiel:
Geben Sie den folgenden Befehl ein, um die Inhalte der Prozedurgruppe "pg_1"
aufzulisten:
cadsmcmd swlibrary action=listPG name=pg_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 zu Manager "<Standard-Manager>" als Benutzer "<Standardbenutzer>" wird
hergestellt... OK.
Manager: myManager
Domäne: myDomain
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
------------------------------------------------------------------------------Mitglieder der Prozedurgruppe "pg_1" auflisten
------------------------------------------------------------------------------inst (tstbase 1.0 <1>)
inst (tstkpk03 1.0 <2>)
SDCMD<A000000>: OK
340 CLI-Referenzhandbuch
Kompatibilität
Der Eintrag "tstbase" muss durch zwei andere Einträge ersetzt werden, die die
Prozeduren "remdir" und "setdir" aufrufen. Mit den folgenden Befehlen können die
erforderlichen Änderungen am Inhalt vorgenommen werden:
cadsmcmd swlibrary action=removeProcFromPG name=pg_1 procedure=inst item=tstbase
version=1.0
cadsmcmd swlibrary action=addProcToPG name=pg_1 procedure=remdir item=tstbase
version=1.0
cadsmcmd swlibrary action=addProcToPG name=pg_1 procedure=setdir item=tstbase
version=1.0
Die Gruppe "pg_1" enthält nun die folgenden Inhalte:
cadsmcmd swlibrary action=listPG name=pg_1
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Verbindung zu Manager "kkkkk01b" als Benutzer "Standardbenutzer" wird
hergestellt...OK.
------------------------------------------------------------------------------Mitglieder der Prozedurgruppe "pg_1" auflisten
------------------------------------------------------------------------------inst (tstkpk03 1.0 <1>)
remdir (tstbase 1.0 <2>)
setdir (tstbase 1.0 <3>)
SDCMD<A000000>: OK
Kapitel 3: cadsmcmd-Befehle 341
Kompatibilität
Die Prozeduren einer Prozedurgruppe werden auf den Zielsystemen entsprechend ihrer
Reihenfolge in der Prozedurgruppe ausgeführt. Diese Auftragsnummer einer Prozedur
wird in spitzen Klammern angezeigt. Um die Prozedur "inst" ordnungsgemäß
auszuführen, müssen zunächst "remdir" und "setdir" ausgeführt werden. Mit dem
folgenden Befehl wird die Reihenfolge in der Prozedurgruppe geändert:
cadsmcmd swlibrary action=repositionItem name=pg_1 procedure=inst item=tstkpk03
version=1.0 position=3
Nun enthält die Gruppe "pg_1" folgende Inhalte:
cadsmcmd swlibrary action=listPG name=pg_1
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Verbindung zu Manager "kkkkk01b" als Benutzer "Standardbenutzer" wird
hergestellt...OK.
------------------------------------------------------------------------------Mitglieder der Prozedurgruppe "pg_1" auflisten
------------------------------------------------------------------------------remdir (tstbase 1.0 <1>)
setdir (tstbase 1.0 <2>)
inst (tstkpk03 1.0 <3>)
SDCMD<A000000>: OK
removeProcFromPG – Entfernen von Prozeduren aus Prozedurgruppen
Diese Aktion entfernt Prozeduren aus einer Prozedurgruppe.
Diese Aktion hat das folgende Format:
swLibrary action=removeProcFromPG name=Prozedurgruppenname
procedure=Prozedurname
item=Elementname
version=Elementversion
item
Gibt den Namen des Elements an, in dem die Prozedur gespeichert ist.
Name
Gibt Folgendes an: Name der Prozedurgruppe, aus der die Prozedur entfernt wird.
Prozedur
Gibt Folgendes an: Name einer Prozedur, die entfernt werden sollen.
342 CLI-Referenzhandbuch
Kompatibilität
Version
Gibt Folgendes an: Version des Elements, in dem die Prozedur gespeichert ist.
Hinweis: Diese Funktion trennt nur die Verknüpfung zwischen Prozedur und
Prozedurgruppe. Die Funktion entfernt nicht die Prozedur aus dem Element und wirkt
sich auch nicht auf andere Prozedur- und Softwaregruppen aus, wenn sie nicht die
fragliche Prozedurgruppe enthalten.
repositionItem – Neuanordnung von Elementen in der Prozedurgruppe
Diese Aktion ändert die Reihenfolge in einer Prozedurgruppe, indem einem Element der
Prozedurgruppe eine neue Auftragsnummer zugewiesen wird.
Diese Aktion hat das folgende Format:
swlibrary action=repositionItem name=Prozedurgruppenname
procedure=Prozedurname
item=Elementname
version=Elementversion
position=neue Position
item
Gibt den Namen des Elements an, in dem die Prozedur gespeichert ist.
Name
Gibt Folgendes an: Name der Prozedurgruppe, der umgruppiert werden soll.
position
Gibt die neue Position der Prozedur an.
Die Position muss größer als null sein und sollte die Anzahl der Prozeduren in der
Prozedurgruppe nicht überschreiten.
Prozedur
Gibt Folgendes an: Name einer Prozedur, die neu angeordnet wird.
Version
Gibt Folgendes an: Version des Elements, in dem die Prozedur gespeichert ist.
Produktverwaltung
Dieser Abschnitt enthält die folgenden Themen:
archive – Archivieren von Produkten in der Softwarebibliothek (siehe Seite 344)
export – Exportieren von Produkten (siehe Seite 344)
list - Auflisten von Produkten in der Softwarebibliothek (siehe Seite 345)
ListFailedJobs – Auflisten fehlgeschlagener Jobs (siehe Seite 347)
listJobs – Auflisten von Jobs (siehe Seite 351)
restore – Wiederherstellen eines Produkts aus dem Archiv (siehe Seite 356)
sealItem – Versiegeln von Produkten (siehe Seite 356)
Kapitel 3: cadsmcmd-Befehle 343
Kompatibilität
archive – Archivieren von Produkten in der Softwarebibliothek
Diese Aktion archiviert das angegebene Produkt am angegebenen Speicherort.
Diese Aktion hat das folgende Format:
swlibrary action=archive
item=Elementname
version=Elementversion
path=Pfadname
[bereinigen]
[onserver]
[comment=Kommentar]
comment
Optionaler Parameter:Ein Kommentar für die Aktion.
item
Gibt Folgendes an: Name des Produkts, das archiviert werden soll.
onserver
Wenn dieser Parameter angegeben wird, wird der Zielspeicherort auf dem Server
angelegt, anderenfalls nicht.
path
Gibt Folgendes an: Name eines leeren Verzeichnisses, in dem das Produkt archiviert
werden soll.
Bereinigen
Wenn das Produkt bereits archiviert ist, werden die Produktdateien aus der
Softwarebibliothek gelöscht.
Version
Gibt Folgendes an: Version des Produkts, das archiviert werden soll.
export – Exportieren von Produkten
Diese Aktion exportiert das angegebene Produkt an den angegebenen Speicherort.
Diese Aktion hat das folgende Format:
swlibrary action=export
item=Elementname
version=Elementversion
path=Pfadname
[onserver]
[as_image]
344 CLI-Referenzhandbuch
Kompatibilität
as_image
Wenn dieser Parameter angegeben ist, wird die Software in ein Bibliotheks-Image
exportiert, das vom Software Management Installer dazu verwendet werden kann,
Pakete von einer CD zu entnehmen.
item
Gibt den Namen des zu exportierenden Produkts an.
Version
Gibt die Version des zu exportierenden Produkts an.
path
Gibt den Zielspeicherort des zu exportierenden Produkts an. Das Verzeichnis muss
leer sein.
onserver
Wenn dieser Parameter angegeben wird, wird der Zielspeicherort auf dem Manager
angelegt, anderenfalls nicht.
list - Auflisten von Produkten in der Softwarebibliothek
Diese Aktion zeigt eine Liste der Produkte aus der Softwarebibliothek an. Es kann ein
zusätzlicher Filter angegeben werden, um die Liste auf die Produkte zu beschränken, die
den Filterkriterien entsprechen. Wenn keine Filter angegeben werden, wird die
vollständige Liste der Produkte angezeigt. Der Filter ist auf 100&#160;Byte beschränkt.
Diese Aktion hat das folgende Format:
swlibrary action=list [{filter="filter" | filterfile=filename }]
filter
Gibt Folgendes an: Ausdruck, um die Anzahl der aufgelisteten Informationen
einzuschränken, in diesem Fall die Menge der anzuzeigende Produkte.
Sie können auch die von dieser list-Aktion angezeigten Attribute verwenden.
Hinweis: Sie können eine Liste virtueller oder normaler Softwarepakete anzeigen,
indem Sie einen der folgenden Filter angeben:
filter="Package format=Virtual"
filter="Package format=Regular"
filterfile
Gibt Folgendes an: Name der Datei, die die Filterbefehle enthält.
Die Befehle der Datei werden auf die gleiche Weise festgelegt wie im Parameter
"Filter". Die Kapazität der Datei wird jedoch durch die Kapazität des den Befehl
ausführenden Systems begrenzt.
Kapitel 3: cadsmcmd-Befehle 345
Kompatibilität
Beispiel:
Geben Sie den folgenden Befehl ein, um die Liste der Produkte aus der
Softwarebibliothek anzuzeigen:
cadsmcmd swlibrary action=list
Die folgenden Informationen werden ausgegeben:
------------------------------------------------------------------------------Liste der Bibliothekselemente
------------------------------------------------------------------------------Elementname....: tstool_1
..Elementversion........: 1.0
..Elementtyp......: SOFTWARE
..Pakettyp.....: Allgemein
..Paketformat...: Normal
..Paketgröße.....:90
..Basiert auf Element.:
..Basiert auf Version......:
..Erstellungsdatum........: 2009-09-25
..Erstellungszeitpunkt........: 11:39
..Änderungsdatum........: 2009-09-25
..Änderungszeitpunkt........: 11:41
..Prüfsumme aktiviert...: Ja
........................
Elementname....: tstool_1
..Elementversion........: 1.1
..Elementtyp......: SOFTWARE
..Pakettyp.....: Allgemein
..Paketformat...: Normal
..Paketgröße.....:70
..Basiert auf Element.: tstool_1
..Basiert auf Version........: 1.0
..Erstellungsdatum........: 2009-09-25
..Erstellungszeitpunkt........: 11:41
..Änderungsdatum........: 2009-09-25
..Änderungszeitpunkt........: 11:45
..Prüfsumme aktiviert...: Ja
------------------------------------------------------------------------------Gesamtzahl der Elemente: 74
Gesamtzahl der gelesenen Elemente: 74
Gesamtzahl der angezeigten Elemente: 74
SDCMD<A000000>: OK
346 CLI-Referenzhandbuch
Kompatibilität
Geben Sie den folgenden Befehl ein, um mit Hilfe von Filtern die Liste der Produkte aus
der Softwarebibliothek anzuzeigen, deren Namen mit "tst" beginnen und die die Version
1.1 haben:
cadsmcmd swlibrary action=list filter="(Item name=tst* && Item version=1.1)"
Die folgenden Informationen werden ausgegeben:
------------------------------------------------------------------------------Liste der Bibliothekselemente
------------------------------------------------------------------------------Elementname....: tstool_1
..Elementversion........: 1.1
..Elementtyp......: SOFTWARE
..Pakettyp.....: Allgemein
..Paketformat...: Normal
..Paketgröße.....:80
..Basiert auf Element.: tstool_1
..Basiert auf Version........: 1.0
..Erstellungsdatum........: 2009-09-25
..Erstellungszeitpunkt........: 11:41
..Änderungsdatum........: 2009-09-25
..Änderungszeitpunkt........: 11:45
..Prüfsumme aktiviert...: Ja
------------------------------------------------------------------------------Gesamtzahl der Elemente: 74
Gesamtzahl der gelesenen Elemente: 74
Gesamtzahl der angezeigten Elemente:1
SDCMD<A000000>: OK
ListFailedJobs – Auflisten fehlgeschlagener Jobs
Diese Aktion zeigt eine Liste der fehlgeschlagenen Jobs an.
Diese Aktion ist nur für Domänen-Manager zulässig.
Diese Aktion hat das folgende Format:
swlibrary action=listfailedjobs
item=Elementname
version=Versionsname
{alt |
procedure=Prozedurname
[{filter=Filter|filterfile=Dateiname}]}
Kapitel 3: cadsmcmd-Befehle 347
Kompatibilität
alt
Eine alternative Liste wird nur auf der Grundlage des Namens und der Version des
Elements bereitgestellt.
Bei der Angabe dieses Parameters können der Wert des Elements und der
Parameter "version" datenbankgestützte Platzhalter enthalten, zum Beispiel
"%"
für eine beliebige, selbst leere Zeichenfolge
"_"
für ein beliebiges einzelnes Zeichen
Für Microsoft SQL Server haben die eckigen Klammern ("[","]") eine besondere
Bedeutung. Dies muss beim Codieren des Namens berücksichtigt werden.
filter
Gibt Folgendes an: Ausdruck, um die Anzahl der aufgelisteten Informationen
einzuschränken, in diesem Fall die Menge der Produkte.
Sie können auch die von dieser list-Aktion angezeigten Attribute verwenden.
filterfile
Gibt Folgendes an: Name der Datei, die die Filterbefehle enthält.
Die Befehle der Datei werden auf die gleiche Weise festgelegt wie im Parameter
"Filter". Die Kapazität der Datei wird jedoch durch die Kapazität des den Befehl
ausführenden Systems begrenzt.
item
Gibt Folgendes an: Name des Elements, für das die Liste zur Verfügung gestellt wird.
Prozedur
Gibt Folgendes an: Name der Elementprozedur, die in den fraglichen Jobs
verwendet wird.
Version
Gibt Folgendes an: Version des Elements, für das die Liste zur Verfügung gestellt
wird.
348 CLI-Referenzhandbuch
Kompatibilität
Beispiel:
C:\>cadsmcmd local mydomain swlibrary action=listfailedjobs item=tstprod
version=1.5 procedure=inst
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
Verbindung zu Manager "<Standard-Manager>" als Benutzer "<Standardbenutzer>" wird
hergestellt... OK.
Manager: myManager
Domäne: myDomain
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
------------------------------------------------------------------------------Liste der Jobs "tstprod 1.5:inst"
------------------------------------------------------------------------------Jobname.........: tstprod 1.5:inst
..Job-ID........: 19438
..Jobstatus........: ERROR
..Jobauftragsnummer........: 0
..Jobtask.........: 1 - install
..Erstellungsdatum........: 2005-02-14
..Erstellungszeitpunkt........: 11:13
..Lieferungsdatum........: 2005-02-14
..Lieferungszeitpunkt........: 11:13
..Aktivierungsdatum........: 2005-02-14
..Aktivierungszeitpunkt........: 11:13
..Zielsystem.............: ZZZZ01B
....Computerjob-ID........: 19470
....Status.......: AUSFÜHRUNGSFEHLER
Kapitel 3: cadsmcmd-Befehle 349
Kompatibilität
....Fehlermeldung........: Beendigungscode 2 deutet auf mögliche Fehler hin
....Fehlerursache........: 228001
....Beendigungsdatum........: 2005-02-14
....Beendigungszeit........: 11:14
Jobname.........: tstprod 1.5:inst
..Job-ID........: 19446
..Jobstatus........: ERROR
..Jobauftragsnummer........: 2
..Jobtask.........: 1 - install
..Erstellungsdatum........: 2005-03-17
..Erstellungszeitpunkt........: 12:23
..Lieferungsdatum........: 2005-03-17
..Lieferungszeitpunkt........: 12:23
..Aktivierungsdatum........: 2005-03-17
..Aktivierungszeitpunkt........: 12:23
..Zielsystem........: ZZZZ01A
....Computerjob-ID........: 19485
....Status.......: AUSFÜHRUNGSFEHLER
....Fehlermeldung........: Beendigungscode 2 deutet auf mögliche Fehler hin
....Fehlerursache........: 228001
....Beendigungsdatum........: 2005-03-17
....Beendigungszeit........: 12:25
SDCMD<A000000>: OK
350 CLI-Referenzhandbuch
Kompatibilität
Geben Sie den folgenden Befehl ein, um eine Liste der fehlgeschlagenen Jobs mit der
Jobauftragsnummer "0" anzuzeigen:
cadsmcmd swlibrary action=listfailedjobs item=tstprod version=1.5 procedure=inst
filter=”Job order number=0”
Die folgende Liste wird zurückgegeben:
------------------------------------------------------------------------------Liste der Jobs "tstprod 1.5:inst"
------------------------------------------------------------------------------Jobname.........: tstprod 1.5:inst
..Job-ID........: 19438
..Jobstatus........: ERROR
..Jobauftragsnummer........: 0
..Jobtask.........: 1 - install
..Erstellungsdatum........: 2005-02-14
..Erstellungszeitpunkt........: 11:13
..Lieferungsdatum........: 2005-02-14
..Lieferungszeitpunkt........: 11:13
..Aktivierungsdatum........: 2005-02-14
..Aktivierungszeitpunkt........: 11:13
..Zielsystem.............: ZZZZ01B
....Computerjob-ID........: 19470
....Status.......: AUSFÜHRUNGSFEHLER
....Fehlermeldung........: Beendigungscode 2 deutet auf mögliche Fehler hin
....Fehlerursache........: 228001
....Beendigungsdatum........: 2005-02-14
....Beendigungszeit........: 11:14
SDCMD<A000000>: OK
listJobs – Auflisten von Jobs
Diese Aktion zeigt eine Liste der Jobs an, die mit dem Element verbunden sind. Die
Informationen zeigen auch die von dem Job adressierten Computer sowie einzelne
Ergebnisse des Jobs für jeden Computer an.
Diese Aktion ist nur für Domänen-Manager zulässig.
Diese Aktion hat das folgende Format:
swlibrary action=listjobs
item=Elementname
version=Versionsname
{alt |
procedure=Prozedurname
[{filter=Filter|filterfile=Dateiname}]}
Kapitel 3: cadsmcmd-Befehle 351
Kompatibilität
alt
Eine alternative Liste wird nur auf der Grundlage des Namens und der Version des
Elements bereitgestellt.
Eine alternative Liste wird nur auf der Grundlage des Namens und der Version des
Elements bereitgestellt.
Bei der Angabe dieses Parameters können der Wert des Elements und der
Parameter "version" datenbankgestützte Platzhalter enthalten, zum Beispiel
"%"
für eine beliebige, selbst leere Zeichenfolge
"_"
für ein beliebiges einzelnes Zeichen
Für Microsoft SQL Server haben die eckigen Klammern ("[","]") eine besondere
Bedeutung. Dies muss beim Codieren des Namens berücksichtigt werden.
filter
Gibt Folgendes an: Ausdruck, um die Anzahl der aufgelisteten Informationen
einzuschränken.
Sie können auch die von dieser list-Aktion angezeigten Attribute verwenden.
filterfile
Gibt Folgendes an: Name der Datei, die die Filterbefehle enthält.
Die Befehle der Datei werden auf die gleiche Weise festgelegt wie im Parameter
"Filter". Die Kapazität der Datei wird jedoch durch die Kapazität des den Befehl
ausführenden Systems begrenzt.
item
Gibt Folgendes an: Name des Elements, für das die Liste zur Verfügung gestellt wird.
Prozedur
Gibt Folgendes an: Name der Elementprozedur, die in den fraglichen Jobs
verwendet wird.
Version
Gibt Folgendes an: Version des Elements, für das die Liste zur Verfügung gestellt
wird.
352 CLI-Referenzhandbuch
Kompatibilität
Beispiel:
Es werden die folgenden Informationen angezeigt:
C:\>cadsmcmd local mydomain swlibrary action=listjobs item=tstprod version=1.5
procedure=inst
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
Verbindung zu Manager "<Standard-Manager>" als Benutzer "<Standardbenutzer>" wird
hergestellt... OK.
Manager: myManager
Domäne: myDomain
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
------------------------------------------------------------------------------Liste der Jobs "tstprod 1.5:inst"
------------------------------------------------------------------------------Jobname.........: tstprod 1.5:inst
..Job-ID........: 19438
..Jobstatus........: ERROR
..Jobauftragsnummer........: 0
..Jobtask.........: 1 - install
..Erstellungsdatum........: 2006-02-14
..Erstellungszeitpunkt........: 11:13
..Lieferungsdatum........: 2006-02-14
..Lieferungszeitpunkt........: 11:13
..Aktivierungsdatum........: 2006-02-14
..Aktivierungszeitpunkt........: 11:13
..Zielsystem.............: ZZZZZ01A
....Computerjob-ID........: 19472
....Status.......: EXECUTION_OK
....Fehlermeldung........: OK
....Fehlerursache........: 0
....Beendigungsdatum........: 2006-02-14
....Beendigungszeit........: 11:18
..Zielsystem.............: ZZZZZ01B
....Computerjob-ID........: 19470
....Status.......: AUSFÜHRUNGSFEHLER
....Fehler
Kapitel 3: cadsmcmd-Befehle 353
Kompatibilität
....Fehlermeldung........: Beendigungscode 2 deutet auf mögliche Fehler hin
....Fehlerursache........: 228001
....Beendigungsdatum........: 2006-02-14
....Beendigungszeit........: 11:14
........
Jobname.........: tstprod 1.5:inst
..Job-ID........: 19454
..Jobstatus........: OK
..Jobauftragsnummer........: 0
..Jobtask.........: 1 - install
..Erstellungsdatum........: 2006-02-14
..Erstellungszeitpunkt........: 11:14
..Lieferungsdatum........: 2006-02-14
..Lieferungszeitpunkt........: 11:13
..Aktivierungsdatum........: 2006-02-14
..Aktivierungszeitpunkt........: 11:14
..Zielsystem.............: YYYYY
....Computerjob-ID........: 19481
....Status.......: EXECUTION_OK
....Fehlermeldung........: OK
....Fehlerursache........: 0
....Beendigungsdatum........: 2006-02-14
....Beendigungszeit........: 11:18
..Zielsystem.............: XXXX01
....Computerjob-ID........: 19479
....Status.......: EXECUTION_OK
....Fehlermeldung........: OK
....Fehlerursache........: 0
....Beendigungsdatum........: 2006-02-14
....Beendigungszeit........: 11:14
SDCMD<A000000>: OK
354 CLI-Referenzhandbuch
Kompatibilität
Geben Sie den folgenden Befehl ein, um eine Liste der Jobs mit dem Status "ERROR"
anzuzeigen:
cadsmcmd swlibrary action=listjobs item=tstprod version=1.5 procedure=inst
filter=”Job state=ERROR”
Die folgende Liste wird zurückgegeben:
------------------------------------------------------------------------------Liste der Jobs "tstprod 1.5:inst"
------------------------------------------------------------------------------Jobname.........: tstprod 1.5:inst
..Job-ID........: 19438
..Jobstatus........: ERROR
..Jobauftragsnummer........: 0
..Jobtask.........: 1 - install
..Erstellungsdatum........: 2006-02-14
..Erstellungszeitpunkt........: 11:13
..Lieferungsdatum........: 2006-02-14
..Lieferungszeitpunkt........: 11:13
..Aktivierungsdatum........: 2006-02-14
..Aktivierungszeitpunkt........: 11:13
..Zielsystem.............: ZZZZZ01A
....Computerjob-ID........: 19472
....Status.......: EXECUTION_OK
....Fehlermeldung........: OK
....Fehlerursache........: 0
....Beendigungsdatum........: 2006-02-14
....Beendigungszeit........: 11:18
..Zielsystem.............: ZZZZZ01B
....Computerjob-ID........: 19470
....Status.......: AUSFÜHRUNGSFEHLER
....Fehler
....Fehlermeldung........: Beendigungscode 2 deutet auf mögliche Fehler hin
....Fehlerursache........: 228001
....Beendigungsdatum........: 2006-02-14
....Beendigungszeit........: 11:14
SDCMD<A000000>: OK
Kapitel 3: cadsmcmd-Befehle 355
Kompatibilität
restore – Wiederherstellen eines Produkts aus dem Archiv
Diese Aktion stellt das angegebene Produkt aus einem Archiv in der Softwarebibliothek
wieder her.
Diese Aktion hat das folgende Format:
swlibrary action=restore
{item=Elementname version=Elementversion
| path=Pfadname }
item
Gibt Folgendes an: Name des Produkts, das aus dem Archiv wiederhergestellt
werden soll.
path
Gibt Folgendes an: destination, in dem das wiederherzustellende Produkt archiviert
wurde.
Version
Gibt Folgendes an: Version des Produkts, das aus dem Archiv wiederhergestellt
werden soll.
Hinweis: Wenn das Produkt mit Hilfe von "name" und "version" gekennzeichnet wird,
wird das Archiv anhand der mit dem Produkt gespeicherten Archivpfad-Informationen
ermittelt. Wenn der Pfadname angegeben wird, wird das archivierte Produkt von dort
wiederhergestellt und auch anhand der dort gespeicherten Informationen
gekennzeichnet.
sealItem – Versiegeln von Produkten
Diese Aktion versiegelt das angegebene Produkt.
Diese Aktion hat das folgende Format:
swlibrary action=sealitem
item=Elementname
version=Elementversion
item
Gibt Folgendes an: Name des Produkts, die versiegelt werden soll.
Version
Gibt Folgendes an: Version des Produkts, die versiegelt werden soll.
356 CLI-Referenzhandbuch
Kompatibilität
swpolicy – Befehle für Software-Richtlinien
Dieser Abschnitt enthält die folgenden Themen:
addItem – Hinzufügen von Jobs zu einer unversiegelten lokalen Software-Richtlinie
(siehe Seite 357)
create – Erstellen einer lokalen Software-Richtlinie (siehe Seite 367)
removeItem – Entfernen von Jobs aus einer unversiegelten lokalen Software-Richtlinie
(siehe Seite 373)
listItem – Anzeigen von Informationen über die einer Software-Richtlinie zugewiesenen
Jobs (siehe Seite 375)
modifyItem – Ändern eines Jobs einer unversiegelten lokalen Software-Richtlinie (siehe
Seite 377)
showAttrItem – Anzeigen von Informationen über einen einer Software-Richtlinie
zugewiesenen Job (siehe Seite 383)
repositionItem – Umgruppieren von einer unversiegelten lokalen Software-Richtlinie
zugewiesenen Jobs (siehe Seite 385)
link – Verknüpfen von Software-Richtlinien mit Computergruppen (siehe Seite 386)
unlink – Entfernen von Verknüpfungen zwischen Software-Richtlinien und
Computergruppen (siehe Seite 389)
seal – Versiegeln von Software-Richtlinien (siehe Seite 390)
unseal – Aufheben der Versiegelung von Software-Richtlinien (siehe Seite 391)
register – Registrieren einer Software-Richtlinie auf einer Domäne (siehe Seite 392)
deregister – Aufheben der Registrierung einer Software-Richtlinie auf einer Domäne
(siehe Seite 394)
list – Auflisten von Software-Richtlinien (siehe Seite 396)
modify – Ändern von Attributen einer unversiegelten lokalen Software-Richtlinie (siehe
Seite 398)
showAttr – Auflisten der Attribute der Software-Richtlinie (siehe Seite 402)
delete – Löschen von Software-Richtlinien (siehe Seite 404)
listViolators – Auflisten von Richtlinienverletzern einer unversiegelten SoftwareRichtlinie (siehe Seite 404)
addItem – Hinzufügen von Jobs zu einer unversiegelten lokalen Software-Richtlinie
Dieser Befehl fügt Jobs einer unversiegelten lokalen Software-Richtlinie hinzu. Die
hinzuzufügenden Jobs können durch Prozedur- oder Software-Gruppen, durch eine
Datei mit allen erforderlichen Informationen oder durch das direkte Übergeben der
Informationen für einen Job mit dem Aufruf angegeben werden. Wenn das Hinzufügen
erfolgreich verläuft, kann die Richtlinie optional mit dieser Aktion versiegelt werden.
Kapitel 3: cadsmcmd-Befehle 357
Kompatibilität
Dieser Befehl hat das folgende Format:
swPolicy action=Element hinzufügen
name=Name_der_Software-Richtlinie
{group=Name_einer_Software-_oder_Prozedurgruppe|
procedures=Jobdatei|
item=Elementname
version=Elementversion
[task={activate | configure | install | uninstall}]
procedure=Prozedurname
[installedWith=Name_der_Installationsprozedur]
[after={exacttime|boottime}]
[reinstall[={y|n}]]
[preaction={none|reboot|logoff}]
[postaction={none | reboot | logoff | rebootAtEnd | logoffAtEnd |
shutdownAtEnd}]
[promptUser[={y|n}]]
[allowCancel[={y|n}]]
[execTimedOut[={y|n}]]
[offline[={y|n}]]
[runAtShutdown[={y|n}]]
[preventLogon[={y|n}]]
[triggeredByScalSrv[={y|n}]]
[globaltime[={y|n}]]
[calendarname=Name_des_Lieferungskalenders]
[noCalendar[={y|n}]]
[resolveQuery[={y|n}]]
[stagingServer[={y|n}]]
[parameters=Benutzerparameter]
[prompt=t.h]
[jobTimeout=t.h]
[repeat[={y|n}]]
[seal[={y|n}]]
[userJobMessage]
358 CLI-Referenzhandbuch
Kompatibilität
Name
Der Name der Software-Richtlinie, zu der die Jobs hinzugefügt werden.
Gruppe
Diese Option gibt den Namen einer Software- oder Prozedurgruppe an. Die
Mitglieder der Gruppe werden zum Hinzufügen von Jobs zur Software-Richtlinie
verwendet.
■
Die angegebene Gruppe ist eine "Software-Gruppe":
Die Jobs der Richtlinie werden aus den standardmäßigen
Installationsprozeduren der Gruppenmitglieder generiert, sofern diese
vorhanden sind, oder aus der ersten Installationsprozedur in der Reihenfolge.
Die Joboptionen werden aus den Standardeinstellungen oder von der Prozedur
übernommen. Wenn für ein Mitglied keine Installationsprozeduren vorhanden
sind, wird dieses Mitglied übersprungen und eine Warnung gemeldet.
■
Die angegebene Gruppe ist eine "Prozedurgruppe":
Die Jobs für die Richtlinie werden aus den Prozeduren der Gruppe erstellt. Die
Joboptionen werden aus den Standardeinstellungen oder von der Prozedur
übernommen.
Wenn diese Option nicht codiert ist, erfolgt keine Evaluierung von Gruppen zum
Ausfüllen der erstellten Software-Richtlinie.
Die Option "group" darf nicht mit der Option "procedures" oder "item" codiert
werden.
Kapitel 3: cadsmcmd-Befehle 359
Kompatibilität
Verfahren
Diese Option gibt den Namen einer Datei an, die die Prozeduren zum Erstellen der
Jobs für die Software-Richtlinie enthält. Für jeden Job, der erstellt und der Richtlinie
zugewiesen werden soll, muss in der Datei ein Eintrag mit der folgenden Syntax
erstellt werden:
item=Elementname version=Elementversion
procedure=Prozedurname
task={activate | configure | install | uninstall}
[installedWith=Name_der_Installationsprozedur]
[after={exacttime|boottime}]
[reinstall[={y|n}]]
[preaction={none|reboot|logoff}]
[postaction={none | reboot | logoff | rebootAtEnd | logoffAtEnd |
shutdownAtEnd}]
[promptUser[={y|n}]]
[allowCancel[={y|n}]]
[execTimedOut[={y|n}]]
[offline[={y|n}]]
[runAtShutdown[={y|n}]]
[preventLogon[={y|n}]]
[triggeredByScalSrv[={y|n}]]
[globaltime[={y|n}]]
[calendarname=Name_des_Lieferungskalenders]
[noCalendar[={y|n}]]
[resolveQuery[={y|n}]]
[stagingServer[={y|n}]]
[parameters=Benutzerparameter]
[prompt=t.h]
[jobTimeout=t.h]
[repeat[={y|n}]]
360 CLI-Referenzhandbuch
Kompatibilität
Eine Zeile darf jeweils nur einen Eintrag enthalten, und ein Eintrag darf nicht mehr
als eine Zeile umfassen. Der Eintrag muss mit den Parametern "item", "version",
"procedure" und "task" in dieser Reihenfolge beginnen. Die Reihenfolge der übrigen
Parameter ist beliebig. Parameterwerte, die Leerzeichen enthalten, müssen in
Anführungszeichen (") eingeschlossen werden. Wenn ein Parameterwert ein
Anführungszeichen enthält, muss dieses verdoppelt werden.
Die Bedeutung der Parameter ist in den unten stehenden Optionsbeschreibungen
angegeben.
Die Option "procedures" darf nicht mit der Option "group" oder "item" codiert
werden.
item
Gibt den Namen eines registrierten Element-Produkts an. Der Job wird für dieses
Element erstellt und zur Software-Richtlinie hinzugefügt.
Die Option "item" darf nicht mit der Option "group" oder "procedures" codiert
werden.
Version
Gibt die Version des angegebenen Elements an, die für die Jobgenerierung
verwendet wird.
task
Gibt den Typ der Prozedur an, für die der Job der Software-Richtlinie hinzugefügt
wird. Die folgenden Task-Typen sind gültig:
activate
Die ausgewählte Prozedur ist eine Aktivierungsprozedur.
configure
Die ausgewählte Prozedur ist eine Konfigurationsprozedur.
Kapitel 3: cadsmcmd-Befehle 361
Kompatibilität
install
Die ausgewählte Prozedur ist eine Installationsprozedur.
uninstall
Die ausgewählte Prozedur ist eine Deinstallationsprozedur.
Wenn die Option nicht codiert ist, ist "install" die Standardeinstellung.
Prozedur
Name der Elementprozedur, die zum Generieren des Jobs verwendet wird, der zur
Software-Richtlinie hinzugefügt werden soll.
installedWith
Wenn diese Option angegeben ist, handelt es sich um den Namen einer
Installationsprozedur des angegebenen Elements. Der zu generierende Job wird nur
auf Computern ausgeführt, auf denen das Element mit dieser angegebenen
Prozedur installiert wird. Wenn es sich bei dem hinzuzufügenden Job selbst um
einen Installationsjob handelt, wird dieser Parameter ignoriert.
Wenn die Option nicht codiert ist, wird nicht geprüft, auf welche Weise das Element
installiert wird.
after
Diese Option gibt an, wann die Jobausführung auf den Zielsystemen startet.
Folgende Werte sind gültig:
exacttime
Die Verarbeitung der Prozedur beginnt, sobald der Auftrag fällig ist.
boottime
Nachdem der Auftrag fällig geworden ist, wird die Verarbeitung der Prozedur
bis zum nächsten Hochfahren (bzw. Neustart) zurückgestellt.
Der Standardwert ist "exacttime".
reinstall
Wenn "reinstall" oder "reinstall=y" codiert ist, wird das Element bei jeder
Evaluierung der Software-Richtlinie neu auf den Zielen installiert. Wenn
"reinstall=n" codiert ist oder die Option fehlt, wird das Element nur installiert, wenn
es auf den Zielen nicht vorhanden ist. Die Option ist für Installationsprozeduren
gültig. Bei allen anderen Prozedurtypen wird sie ignoriert.
362 CLI-Referenzhandbuch
Kompatibilität
preaction={none | reboot | logoff}]
Gibt Aktionen an, die ausgeführt werden müssen, bevor der entsprechende Job auf
den Zielcomputern verarbeitet wird. Die gültigen Vorabaktionen sind:
kein
Führt keine vorangestellten Aktionen aus.
reboot
Startet das System neu, bevor der Job ausführt wird.
logoff
Meldet den Benutzer ab, bevor der Job ausführt wird.
Wenn diese Option nicht codiert ist, wird die Standardeinstellung durch die
Optionen der Elementprozedur bestimmt.
postaction={none | reboot | logoff | rebootAtEnd | logoffAtEnd | shutdownAtEnd}]
Gibt Aktionen an, die ausgeführt werden müssen, nachdem der entsprechende Job
auf den Zielcomputern verarbeitet wurde. Die folgenden Folgeaktion sind gültig:
kein
Führt keine Folgeaktionen aus.
reboot
Startet das System neu, nachdem der Job ausführt wurde.
logoff
Meldet die Benutzer ab, nachdem der Job ausführt wurde.
rebootAtEnd
Gibt an, dass nach der Verarbeitung des Jobs ein Neustart erforderlich ist. Der
Neustart kann jedoch zurückgestellt werden, bis alle anderen Jobs, die das
Ergebnis derselben Evaluierung der Software-Richtlinie sind, verarbeitet
wurden, oder bis ein nachfolgender Job einen sofortigen Neustart vor oder
nach seiner Verarbeitung erfordert.
logoffAtEnd
Gibt an, dass nach der Verarbeitung des Jobs die Abmeldung des Benutzers
erforderlich ist. Die Abmeldung kann jedoch zurückgestellt werden, bis alle
anderen Jobs, die das Ergebnis derselben Evaluierung der Software-Richtlinie
sind, verarbeitet wurden, oder bis ein nachfolgender Job einen sofortigen
Neustart oder eine Abmeldung vor oder nach seiner Verarbeitung erfordert.
Kapitel 3: cadsmcmd-Befehle 363
Kompatibilität
shutdownAtEnd
Fährt den Zielcomputer nach Abschluss der Jobs herunter.
Wenn diese Option nicht codiert ist, wird die Standardeinstellung durch die
Optionen der Elementprozedur bestimmt.
promptUser
Wenn "promptUser" oder "promptUser=y" angegeben wurde, wird der Benutzer
auf den Zielen vor der Jobausführung benachrichtigt. Wenn "prompt=n" angegeben
ist, wird der Job ausgeführt, ohne dass dem Benutzer eine Meldung angezeigt wird.
Wenn diese Option nicht codiert ist, wird die Standardeinstellung durch die
Optionen der Elementprozedur bestimmt.
allowCancel
Wenn "allowCancel" oder "allowCancel=y" angegeben ist, kann der Benutzer auf
den Zielen die Ausführung des Jobs abbrechen, wenn die Meldung über die
Ausführung angezeigt wird. Wenn "allowCancel=n" angegeben ist, kann der
Benutzer den Job nicht abbrechen.
Die Anzeige der Meldung über die Ausführung muss zugelassen sein, damit das
Abbrechen der Jobausführung ermöglicht werden kann. Anderenfalls wird ein
Fehler gemeldet.
Wenn diese Option nicht codiert ist, wird die Standardeinstellung durch die
Optionen der Elementprozedur bestimmt.
execTimedOut
Wenn "execTimedOut" oder "execTimedOut=y" codiert ist, wird die Ausführung des
Jobs automatisch gestartet, wenn die das Zeitlimit für die Anzeige der
Benachrichtigung für den Benutzer überschritten wird. Wenn "execTimedOut=n"
codiert ist, startet der Job nicht bei der Überschreitung des Zeitlimits.
Die Anzeige der Meldung über die Ausführung muss zugelassen sein, damit der
Start nach der Überschreitung des Zeitlimits aktiviert werden kann. Anderenfalls
wird ein Fehler gemeldet.
Wenn diese Option nicht codiert ist, wird die Standardeinstellung durch die
Optionen der Elementprozedur bestimmt.
offline
Wenn "offline" oder "offline=y" angegeben ist, wird die Verbindung zwischen dem
Ziel und dem zugeordneten Server für die Jobausführung getrennt. Wenn
"offline=n" angegeben ist, wird die Verbindung nicht getrennt.
Wenn diese Option nicht codiert ist, wird die Standardeinstellung durch die
Optionen der Elementprozedur bestimmt.
364 CLI-Referenzhandbuch
Kompatibilität
runAtShutdown
Wenn "runAtShutdown" oder "runAtShutdown=y" codiert ist, wird der Job nur beim
Herunterfahren des Systems ausgeführt. Wenn "runAtShutdown=n" codiert ist,
wird der Job auch zu jedem anderen Zeitpunkt ausgeführt, zu dem er fällig ist.
Wenn diese Option nicht codiert ist, wird die Standardeinstellung durch die
Optionen der Elementprozedur bestimmt.
Diese Option gilt nur für UNIX.
preventLogon
Wenn "preventLogon" oder "preventLogon=y" angegeben ist, werden
Anmeldeversuche von Benutzern auf den Zielen während der Ausführung des Jobs
abgelehnt. Wenn ein Benutzer bereits angemeldet ist, wenn der Job startet, wird
die Ausführung zurückgestellt, bis sich der Benutzer abgemeldet hat.
Wenn "preventLogon=n" codiert ist, hat es keinen Einfluss auf die Ausführung des
Jobs, ob ein Benutzer angemeldet ist oder versucht, sich während der Ausführung
anzumelden.
Wenn diese Option nicht codiert ist, wird die Standardeinstellung durch die
Optionen der Elementprozedur bestimmt.
Diese Option gilt nur für Windows-Ziele.
triggeredByScalSrv
Wenn "triggeredByScalSrv" oder "triggeredByScalSrv=y" codiert ist, initiieren die
den Zielen zugeordneten Scalability-Server die Ausführung des Jobs. Wenn
"triggeredByScalSrv=n" codiert ist, initiiert das Ziel die Ausführung zum Zeitpunkt
des Neustarts oder der Jobprüfung.
Der Standardwert ist "triggeredByScalSrv".
globaltime
Wenn "globalTime" oder "globalTime=y" codiert ist, basieren alle dem Job
zugeordneten Datumsangaben auf der Zeit des Enterprise-Managers, anderenfalls
auf der Zeit des Domänen-Managers.
Der Standardwert ist "globaltime=n".
calendarname
Gibt den Namen des Kalenders an, der dafür zuständig ist, die Lieferung des Jobs an
die Scalability-Server und Ziele zu steuern.
Kapitel 3: cadsmcmd-Befehle 365
Kompatibilität
noCalendar
Wenn "noCalendar" oder "noCalendar=y" codiert ist, wird ein möglicherweise
vorhandener, den Zielcomputern zugeordneter Ausführungskalender für die
Jobverarbeitung ignoriert. Wenn "noCalendar=n" codiert ist, wird der Kalender
berücksichtigt.
Der Standardwert ist "noCalendar=n".
resolveQuery
Wenn "resolveQuery" oder "resolveQuery=y" codiert ist und die der SoftwareVorlage zugeordnete Gruppe eine Abfragegruppe ist, wird diese Gruppe vor der
Erstellung des Jobs erneut evaluiert. Anderenfalls findet keine erneute Evaluierung
statt.
Der Standardwert ist "resolveQuery=n".
stagingserver
Wenn "stagingserver" oder "stagingserver=y" codiert ist, wird das zugehörige
Element durch Staging auf den Scalability-Servern bereitgestellt, die
angesprochenen Zielen zugeordnet sind. Anderenfalls wird es nicht durch Staging
bereitgestellt. Die Option wird ignoriert, wenn die Prozedur keine
Installationsprozedur ist. Wenn sie nicht codiert ist oder "stagingserver=n"
angegeben ist, wird der Schritt der Bereitstellung durch Staging übersprungen.
Der Standardwert ist "stagingserver=n".
parameters
Gibt die Parameter an, die an die Prozedur des Jobs übergeben werden. Wenn eine
leere Zeichenfolge codiert ist, wird angenommen, dass keine Parameter vorhanden
sind.
Wenn die Option nicht codiert ist, werden die Benutzerparameter den Optionen
der Elementprozedur entnommen.
prompt
Gibt den Zeitraum an, in dem einem Benutzer auf dem Ziel erneut die Meldung
über den Start der Jobausführung angezeigt wird, wenn der Benutzer die
Ausführung zurückstellt. Der Zeitraum wird im Format "t.h" angegeben, wobei "t"
für die Tage und "h" für die Stunden steht. Der zulässige Bereich ist 0.3 <= t.h <=7.0.
Wenn der angegebene Wert unter den zulässigen Mindestwert fällt, wird der
Mindestwert festgelegt, und wenn er den Höchstwert überschreitet, wird der
Höchstwert festgelegt. In diesen Fällen wird keine Warnung angezeigt.
366 CLI-Referenzhandbuch
Kompatibilität
jobTimeOut
Gibt das Ablaufdatum des Jobs in Form eines Zeitraums an. Der Zeitraum wird im
Format "d.h" angegeben. Dabei steht "d" für Tage und "h" für Stunden. Der
Parameterbereich kann über den Manager definiert werden.
Wenn der angegebene Wert unter den zulässigen Mindestwert fällt, wird der
Mindestwert festgelegt, und wenn er den Höchstwert überschreitet, wird der
Höchstwert festgelegt. In diesen Fällen wird keine Warnung angezeigt. Wenn die
Option nicht codiert ist, wird als Standardeinstellung 7.0 verwendet.
repeat
Wenn "repeat" oder "repeat=y" codiert ist, wird der zugehörige Job jedes Mal
wiederholt, wenn eine Evaluierung stattfindet. Wenn "repeat=n" codiert ist, wird
der zugehörige Job nicht wiederholt.
Der Standardwert ist "repeat=n".
seal
Wenn "seal" oder "seal=y" codiert ist, wird die Richtlinie versiegelt, nachdem die
Jobs hinzugefügt wurden. Anderenfalls bleibt sie für weitere Änderungen
unversiegelt. Die Versiegelung wird nur durchgeführt, wenn alle erforderlichen Jobs
erfolgreich generiert und hinzugefügt und für keinen Job Fehler gemeldet wurden.
Warnungen für generierte Jobs unterdrücken die Versiegelung nicht.
Der Standardwert ist "seal=n".
userJobMessage
Gibt die benutzerdefinierte Administratormeldung für einen Job in einer SoftwareRichtlinie an.
Hinweis:. Wenn die hinzugefügten Jobs durch eine Gruppe oder die Prozedurdatei
bestimmt werden, wird ein Fehler, der während der Jobgenerierung gefunden wird, für
den zugehörigen Job gemeldet, und der Prozess fährt mit der Generierung des nächsten
Jobs fort. Es wird kein Rollback ausgeführt.
create – Erstellen einer lokalen Software-Richtlinie
Dieser Befehl erstellt eine lokale Software-Richtlinie auf der Basis der angegebenen
Optionen. Sie können optional die Software-Richtlinie mit einer lokalen oder globalen
Computergruppe verknüpfen und sie während der Erstellung mit Jobs füllen. Wenn Sie
die Richtlinie erfolgreich verknüpfen und füllen, können Sie sie auch versiegeln.
Kapitel 3: cadsmcmd-Befehle 367
Kompatibilität
Dieser Befehl hat das folgende Format:
swPolicy action=erstellen
name=Name_der_Software-Richtlinie
[target=Computergruppenname
[groupScope={local|global}]]
[seal[={y|n}]]
[{group=Name_einer_Software-_oder_Prozedurgruppe|
procedures=Jobdatei}]
[jcPriority=1…10]
[{transaction|synchronized|nolinkage}]
[rollback[={y|n}]]
[cascade[={y|n}]]
[{setup_jobs|setup&activate_jobs}]
[regenerate[={y|n}]]
[evaluateGroup[={y|n}]]
[evaluationStart=JJJJ-MM-TT hh:mm]
[globalTime[={y|n}]]
[evaluationPeriod=Stunden]
[calendarname=Kalendername]
[{adhoc_only|adhoc_always}]
[comment=Kommentar_zur_Software-Richtlinie]
[userMessage]
Name
Mit dieser Option wird der Name der erstellten Software-Richtlinie angegeben.
Dieser Name muss eindeutig sein.
target
Der mit dieser Option angegebene Name ist der Name einer Computergruppe, mit
der die Software-Richtlinie verknüpft wird. Die Computergruppe muss bereits
vorhanden sein. Es kann sich bei ihr entweder um eine globale Gruppe auf dem
Enterprise-Manager oder um eine lokale oder globale Gruppe auf dem DomänenManager handeln.
Wenn diese Option nicht codiert ist, wird die zu erstellende Software-Richtlinie mit
keiner Computergruppe verknüpft.
368 CLI-Referenzhandbuch
Kompatibilität
groupScope
Legt den Typ der Computergruppe fest, die mit der Software-Richtlinie verknüpft
wird:
«nicht festgelegt»
Wenn eine lokale Computergruppe mit dem angegebenen Namen vorhanden
ist, wird diese verwendet, anderenfalls wird nach einer globalen Gruppe
gesucht.
lokal
Die Computergruppe muss eine lokale Gruppe sein.
global
Die Computergruppe muss eine globale Gruppe sein.
seal
Wenn "seal" oder "seal=y" codiert ist, wird die erstellte Richtlinie versiegelt.
Anderenfalls bleibt sie für weitere Änderungen unversiegelt.
Die Versiegelungsoption ist nur zugelassen, wenn die Richtlinie bei der Erstellung
verknüpft und ausgefüllt wird, und sie wird nur verarbeitet, wenn die Verknüpfung
und das Ausfüllen erfolgreich waren.
Gruppe
Diese Option gibt den Namen einer Software- oder Prozedurgruppe an. Die
Mitglieder der Gruppe werden verwendet, um die Software-Richtlinie während des
Erstellungsprozesses mit Jobs auszufüllen.
■
Die angegebene Gruppe ist eine "Software-Gruppe":
Die Jobs der Richtlinie werden aus den standardmäßigen
Installationsprozeduren der Gruppenmitglieder generiert, sofern diese
vorhanden sind, oder aus der ersten Installationsprozedur in der Reihenfolge.
Die Joboptionen werden aus den Standardeinstellungen oder von der Prozedur
übernommen.
■
Die angegebene Gruppe ist eine "Prozedurgruppe":
Die Jobs für die Richtlinie werden aus den Prozeduren der Gruppe erstellt. Die
Joboptionen werden aus den Standardeinstellungen oder von der Prozedur
übernommen.
Wenn diese Option nicht codiert ist, erfolgt keine Evaluierung von Gruppen zum
Ausfüllen der erstellten Software-Richtlinie.
Die Option "group" darf nicht mit der Option "procedures" codiert werden.
Kapitel 3: cadsmcmd-Befehle 369
Kompatibilität
Verfahren
Diese Option gibt den Namen einer Datei an, die die Informationen zum Erstellen
der Jobs für die Software-Richtlinie enthält. Für jeden Job, der generiert und der
Richtlinie zugewiesen werden soll, muss in der Datei ein Eintrag mit der folgenden
Syntax erstellt werden:
item=Elementname version=Elementversion
procedure=Prozedurname
task={activate | configure | install | uninstall}
[installedWith=Name_der_Installationsprozedur]
[after={exacttime|boottime}]
[reinstall={y|n}]
[preaction={none|reboot|logoff}]
[postaction={none | reboot | logoff | rebootAtEnd | logoffAtEnd |
shutdownAtEnd}]
[promptUser={y|n}]
[allowCancel={y|n}]
[execTimedOut={y|n}]
[offline={y|n}]
[runAtShutdown={y|n}]
[preventLogon={y|n}]
[triggeredByScalSrv={y|n}]
[globaltime={y|n}]
[calendarname=Name_des_Lieferungskalenders]
[noCalendar={y|n}]
[resolveQuery={y|n}]
[stagingServer={y|n}]
[parameters=Benutzerparameter]
[prompt=t.h]
[jobTimeout=t.h]
[repeat={y|n}]
Eine Zeile darf jeweils nur einen Eintrag enthalten, und ein Eintrag darf nicht mehr
als eine Zeile umfassen. Der Eintrag muss mit den Parametern "item", "version",
"procedure" und "task" in dieser Reihenfolge beginnen. Die Reihenfolge der übrigen
Parameter ist beliebig. Parameterwerte, die Leerzeichen enthalten, müssen in
Anführungszeichen (") eingeschlossen werden. Wenn ein Parameterwert ein
Anführungszeichen enthält, muss dieses verdoppelt werden.
Die Bedeutung der Parameter finden Sie unter "cadsmcmd swPolicy
action=addItem (siehe Seite 357)".
Die Option "procedures" darf nicht mit der Option "group" codiert werden.
jcPriority
Diese Option gibt die Jobcontainer-Priorität an, die von der Richtlinie zum Erstellen
eines Jobcontainers für den Start ihrer SD-Aufträge verwendet wird. Gültige Werte
für die Priorität sind 1, 2, 3, 4, 5, 6, 7, 8, 9, 10. 10 ist die niedrigste Priorität und 1
die höchste. Wenn die Option nicht codiert ist, wird die Priorität 5 festgelegt.
370 CLI-Referenzhandbuch
Kompatibilität
{transaction|synchronized|nolinkage}
Diese Option gibt die Jobverknüpfung innerhalb des Jobcontainers an, der von der
Richtlinie zum Starten der SD-Aufträge erstellt wurde.
«nicht angegeben»
Keine Verknüpfung zwischen Aufträgen.
Transaktion
Batch-Jobausführung ohne Transaktion.
synchronisiert
Synchronisierte Jobausführung.
nolinkage
Keine Verknüpfung zwischen den Aufträgen.
Rollback
Wenn die Option "rollback" oder "rollback=y" codiert ist, wird die Jobverknüpfung
auf "Transaktion aktivieren" gesetzt. Wenn die Option als "rollback=n" codiert ist,
wird "Transaktion aktivieren" nicht festgelegt.
Der Standardwert ist "rollback=n".
Dieser Parameter sollte nur codiert werden, wenn der Parameter "transaction" mit
diesem Befehl codiert wird.
cascade
Wenn die Option "cascade" oder "cascade=y" codiert ist, löst SD die Abhängigkeiten
von überlappenden Installationsanforderungen auf und fügt die fehlenden
Installationsaufträge automatisch hinzu. Wenn die Option als "cascade=n" codiert
ist, wird die Abhängigkeit nicht aufgelöst.
Der Standardwert ist "cascade".
{setup_jobs|setup&activate_jobs}
Diese Option steuert die Ergebnisse der Auswertung der Richtlinie:
«nicht angegeben»
SD prüft während der Evaluierung der Richtlinie nur auf Konformität und
meldet die nicht konformen Ziele, es werden jedoch keine Jobs zum
Übertragen der nicht konformen Ziele in konforme Ziele generiert.
setup_jobs
Infolge der Evaluierung generiert SD Jobs zum Übertragen aller nicht
konformen Ziele in konforme Ziele, diese Jobs werden jedoch nicht zur
Ausführung gestartet. Dies wird dem Benutzer überlassen.
setup&activate_jobs
Infolge der Evaluierung generiert SD Jobs zum Übertragen aller nicht
konformen Ziele in konforme Ziele und startet sie zur Ausführung.
Kapitel 3: cadsmcmd-Befehle 371
Kompatibilität
regenerate
Wenn die Option "regenerate" oder "regenerate=y" codiert ist, werden alle Jobs,
die zuvor fehlgeschlagen sind und noch nicht erfolgreich abgeschlossen wurden,
erneut zur Ausführung geplant, um Konformität zu erzielen. Wenn die Option
"regenerate=n" codiert ist, wird diese erneute Planung übersprungen.
Der Standardwert ist "regenerate".
evaluateGroup
Wenn die Option "evaluateGroup" oder "evaluateGroup=y" codiert ist, wird im Falle
einer der Richtlinie zugeordneten Abfragegruppe diese Gruppe während der
Evaluierung der Richtlinie ebenfalls erneut evaluiert. Wenn "evaluationGroup=n"
codiert ist, findet diese erneute Evaluierung der Gruppe nicht statt.
Der Standardwert ist "evaluateGroup=n".
evaluationStart
Diese Option gibt den frühesten Zeitpunkt an, zu dem die Evaluierung der Richtlinie
startet. Der Wert wird im ISO-Format "JJJJ-MM-TT hh:mm" angegeben, wobei "JJJJ"
das Jahr, "MM" den Monat, "TT" den aktuellen Tag des Monats, "hh" die Stunde
und "mm" die Minute angibt. Wenn diese Option nicht codiert ist, wird die aktuelle
Uhrzeit verwendet.
globalTime
Diese Option gibt an, ob die Zeitangaben für die Richtlinie auf Enterprise- oder auf
Domänenzeit basieren. Wenn diese Option codiert ist, basieren sie auf EnterpriseZeit, anderenfalls auf Domänenzeit.
evaluationPeriod
Diese Option gibt den Zeitraum an, in dem die Evaluierung der Richtlinie stattfindet.
Der Wert wird in Stunden angegeben. Wenn "0" angegeben ist, findet die
Evaluierung nur einmal statt.
calendarname
Diese Option gibt den Namen des Kalenders an, der von SD zur Planung der
zeitgesteuerten Aktionen der Richtlinie verwendet wird.
{adhoc_only | adhoc_always}
Diese Option gibt an, ob SD diese Richtlinie evaluiert, wenn ein Ziel sein Inventar
meldet, und sie gibt den Verarbeitungsmodus an:
«nicht angegeben»
Die Richtlinienevaluierung wird nicht durch Inventarberichte von Zielen
initiiert.
adhoc_only
Die Evaluierung wird durch Inventarberichte von neuen oder erneut
installierten Zielen gestartet.
372 CLI-Referenzhandbuch
Kompatibilität
ad_hoc_always
Die Evaluierung wird durch alle Inventarberichte von Zielen gestartet.
comment
Die Option gibt einen Kommentar an, der mit der Richtlinie gespeichert wird.
userMessage
Gibt die benutzerdefinierte Administratormeldung für eine Software-Richtlinie an.
Hinweis: Sie sollten Folgendes beachten:
■
Falls während der Verknüpfungs- oder der Versiegelungsphase ein Fehler gefunden
wird, wird die weitere Verarbeitung gestoppt und der Fehler gemeldet. Es findet
kein Rollback statt. Die Richtlinie verbleibt in dem Zustand, in dem sie sich beim
Auftreten des Fehlers befindet.
■
Falls während des Ausfüllens der Richtlinie ein Fehler gefunden wird, wird der
Fehler für die zugehörigen Jobs gemeldet, der Ausfüllvorgang wird jedoch
fortgesetzt. Es wird lediglich eine möglicherweise erforderliche Versiegelung
unterdrückt.
removeItem – Entfernen von Jobs aus einer unversiegelten lokalen Software-Richtlinie
Diese Aktion entfernt Jobs aus einer unversiegelten lokalen Software-Richtlinie. Die zu
entfernenden Jobs werden entweder direkt mit dem Befehl übergeben oder durch eine
Prozedur oder Software-Gruppe angegeben. Wenn das Entfernen erfolgreich verläuft,
kann die Richtlinie optional versiegelt werden.
Die Syntax der Aktion lautet folgendermaßen:
swPolicy action=removeItem
name=«Name_der_Software-Richtlinie»
{group=«Name_einer_Software-_oder_Prozedurgruppe»|
{jobNames=«Jobname», ...}}
[seal[={y|n}]]
Kapitel 3: cadsmcmd-Befehle 373
Kompatibilität
Name
Der Name der Software-Richtlinie, aus der die angegebenen Jobs entfernt werden.
Gruppe
Diese Option gibt den Namen einer Software- oder Prozedurgruppe an. Die
Mitglieder der Gruppe werden verwendet, um festzulegen, welche Jobs aus der
Software-Richtlinie entfernt werden sollen.
■
Die angegebene Gruppe ist eine "Software-Gruppe":
Die Mitglieder der Gruppe und die dazugehörigen
Standardinstallationsprozeduren legen fest, welche Jobs aus der Richtlinie
entfernt werden sollen. Wenn ein Mitglied keine Standardinstallationsgruppe
hat, wird die erste Installationsprozedur in der Reihenfolge verwendet. Wenn
ein Mitglied keine Installationsparameter aufweist, wird dieses Mitglied
übersprungen und eine Warnung gemeldet.
■
Die angegebene Gruppe ist eine "Prozedurgruppe":
Die Prozedurmitglieder der Gruppe legen fest, welche Jobs aus der Richtlinie
entfernt werden sollen.
Falls ein zu entfernender Job nicht der Richtlinie zugewiesen ist, wird für diesen Job
ein Fehler gemeldet und die Aktion fährt mit dem nächsten Job fort.
Wenn diese Option nicht codiert ist, erfolgt keine Evaluierung von Gruppen zum
Entfernen von Jobs aus der Software-Richtlinie.
Die Option "group" darf nicht mit der Option "jobNames" codiert werden.
jobNames
Gibt den Namen der Jobs an, die aus der Software-Richtlinie entfernt werden. Diese
Option kann mehrfach codiert werden, um eine Liste von Jobnamen zu übergeben.
Wenn in der Liste ein Job angegeben ist, der der Richtlinie nicht zugewiesen ist,
wird ein Fehler gemeldet und die Aktion führt den nächsten Job in der Liste aus.
Die Option "jobNames" darf nicht mit der Option "group" codiert werden.
seal
Wenn "seal" oder "seal=y" codiert ist, wird die Richtlinie versiegelt, nachdem die
Jobs entfernt wurden. Anderenfalls bleibt sie für weitere Änderungen unversiegelt.
Die Versiegelung wird nur durchgeführt, wenn alle erforderlichen Jobs erfolgreich
entfernt und für keinen dieser Jobs Fehler gemeldet wurden. Warnungen für Jobs
unterdrücken die Versiegelung nicht.
Die Versiegelung wird ebenfalls unterdrückt, wenn die Richtlinienjobzuweisung
durch diese Aktion leer wird.
374 CLI-Referenzhandbuch
Kompatibilität
listItem – Anzeigen von Informationen über die einer Software-Richtlinie zugewiesenen Jobs
Diese Aktion bietet Informationen über die Jobs, die der angegebenen SoftwareRichtlinie zugewiesen sind.
Die Syntax der Aktion lautet folgendermaßen:
swPolicy action=listItem
name=Name_der_Software-Richtlinie
[swpScope={distributed | local}]
[detailed]
Name
Der Name der Software-Richtlinie, deren Jobs aufgelistet werden.
swpScope
Diese Option legt den für die Aktion verwendeten Typ der Softwarerichtlinie fest.
«nicht angegeben»
Wenn eine lokal erstellte Software-Richtlinie des angeforderten Namens
vorhanden ist, wird diese verwendet. Falls nicht, wird eine von einem
Enterprise-Manager verteilte Richtlinie gesucht. Letzteres ist nur auf DomänenManagern zulässig.
distributed
Die angegebene Software-Richtlinie muss auf dem Enterprise-Manager erstellt
und an den angegebenen Manager verteilt worden sein.
(Nur für Domänen-Manager)
lokal
Die angegebene Softwarerichtlinie muss lokal erstellt worden sein.
Hinweis: Enterprise-Manager unterstützen nur Software-Richtlinien vom Typ
"lokal".
detailed
Kapitel 3: cadsmcmd-Befehle 375
Kompatibilität
Wenn diese Option codiert ist, wird eine detaillierte Liste angegeben, anderenfalls
werden nur die Namen der zugewiesenen Jobs aufgelistet.
Die angegebene kurze Liste besitzt das folgende Format:
---------------------------------------------------------------Der Software-Richtlinie «Name der Software-Richtlinie» zugewiesene Jobs auflisten
Short
---------------------------------------------------------------«Name von Job 1»
•
•
•
«Name von Job n»
Die detaillierte Liste besitzt das folgende Format:
---------------------------------------------------------------Der Software-Richtlinie «Name der Software-Richtlinie» zugewiesene Jobs auflisten
Detailliert
---------------------------------------------------------------Jobname : «Name von Job 1»
..Elementname
: «Name des Elements»
..Elementversion : «Version des Elements»
..Prozedurname : «Prozedurname»
..Jobtask
: {configure|activate|
install|uninstall}
..Position
: «Position des Jobs»
..Neuinstallation erforderlich : {yes|no}
..Aktion davor : {none|reboot|logoff}
..Aktion danach : {none|reboot|logoff|
rebootAtEnd|logoffAtEnd}
..Benutzer-Eingabeaufforderung : {yes|no}
....Abbruch zulassen
: {yes|no}
....Jobs nach Zeitüberschreitung der Eingabeaufforderung ausführen
{yes|no}
....Eingabeaufforderung während (Tage/Stunden)
: t/h
..Offline vom Server aus ausführen
: {yes|no}
..Beim Herunterfahren ausführen : {yes|no}
..Benutzeranmeldung verhindern : {yes|no}
..Jobstart
: {local|global} Zeit/{exact|at boot}
..Lieferungskalender
: «Name des Lieferungskalenders»
..Jobkalender auf Ziel ignorieren
: {yes|no}
376 CLI-Referenzhandbuch
:
Kompatibilität
..Abfragegruppen auflösen
: {yes|no}
..Element durch Staging bereitstellen
: {yes|no}
..Benutzerparameter
: «Benutzerparameter»
..Jobzeitlimit (Tage/Stunden)
: t/h
Jobname : «Name von Job 2»
•
•
•
Jobname : «Name von Job n»
modifyItem – Ändern eines Jobs einer unversiegelten lokalen Software-Richtlinie
Dieser Befehl ändert einen Job einer unversiegelten lokalen Software-Richtlinie. Sie
können optional die Richtlinie mit diesem Befehl versiegeln.
Dieser Befehl hat das folgende Format:
swPolicy action=modifyItem
name=Name_der_Software-Richtlinie
jobname=Name_des_Jobs
[newjobname=neuer_Jobname]
[after={exacttime|boottime}]
[reinstall[={y|n}]]
[preaction={none|reboot|logoff}]
[postaction={none | reboot | logoff | rebootAtEnd | logoffAtEnd |
shutdownAtEnd}]
[promptUser[={y|n}]]
[allowCancel[={y|n}]]
[execTimedOut[={y|n}]]
[offline[={y|n}]]
[runAtShutdown[={y|n}]]
[preventLogon[={y|n}]]
[triggeredByScalSrv[={y|n}]]
[globaltime[={y|n}]]
[calendarname=Name_des_Lieferungskalenders]
[noCalendar[={y|n}]]
[resolveQuery[={y|n}]]
[stagingServer[={y|n}]]
[parameters=Benutzerparameter]
[prompt=t.h]
[jobTimeout=t.h]
[repeat[={y|n}]]
[seal[={y|n}]]
[userJobMessage]
Kapitel 3: cadsmcmd-Befehle 377
Kompatibilität
Name
Der Name der Software-Richtlinie, die den zu ändernden Job enthält.
jobname
Der Name des Jobs, der geändert wird.
newjobname
Der neue Name des Jobs. Wenn diese Option nicht codiert ist, bleibt der alte Name
bestehen.
after
Diese Option steuert, wann die Jobausführung auf den Zielsystemen startet.
Folgende Werte sind gültig:
exacttime
Die Verarbeitung des Jobs beginnt, sobald der Auftrag fällig ist.
boottime
Nachdem der Auftrag fällig geworden ist, wird die Verarbeitung des Jobs bis zum
nächsten Hochfahren (bzw. Neustart) zurückgestellt.
Wenn sie nicht codiert ist, wird diese Option nicht geändert.
reinstall
Wenn "reinstall" oder "reinstall=y" codiert ist, wird das Element bei jeder
Evaluierung der Software-Richtlinie neu auf den Zielen installiert. Wenn
"reinstall=n" codiert ist, wird das Element nur installiert, wenn es auf den Zielen
nicht vorhanden ist. Die Option ist nur für Installationsprozeduren gültig. Bei allen
anderen Prozedurtypen wird sie ignoriert.
Wenn sie nicht codiert ist, wird diese Option nicht geändert.
preaction={none | reboot | logoff}]
Gibt Aktionen an, die ausgeführt werden müssen, bevor der entsprechende Job auf
den Zielcomputern verarbeitet wird. Die gültigen Vorabaktionen sind:
kein
Führt keine vorangestellten Aktionen aus.
reboot
Startet das System neu, bevor der Job ausführt wird.
378 CLI-Referenzhandbuch
Kompatibilität
logoff
Meldet den Benutzer ab, bevor der Job ausführt wird.
Wenn sie nicht codiert ist, wird diese Option nicht geändert.
postaction={none | reboot | logoff | rebootAtEnd | logoffAtEnd | shutdownAtEnd}]
Gibt Aktionen an, die ausgeführt werden müssen, nachdem der entsprechende Job
auf den Zielcomputern verarbeitet wurde. Die folgenden Folgeaktion sind gültig:
kein
Führt keine Folgeaktionen aus.
reboot
Startet das System neu, nachdem der Job ausführt wurde.
logoff
Meldet die Benutzer ab, nachdem der Job ausführt wurde.
rebootAtEnd
Gibt an, dass nach der Verarbeitung des Jobs ein Neustart erforderlich ist. Der
Neustart kann jedoch zurückgestellt werden, bis alle anderen Jobs, die das
Ergebnis derselben Evaluierung der Software-Richtlinie sind, verarbeitet
wurden, oder bis ein nachfolgender Job einen sofortigen Neustart vor oder
nach seiner Verarbeitung erfordert.
logoffAtEnd
Gibt an, dass nach der Verarbeitung des Jobs die Abmeldung des Benutzers
erforderlich ist. Die Abmeldung kann jedoch zurückgestellt werden, bis alle
anderen Jobs, die das Ergebnis derselben Evaluierung der Software-Richtlinie
sind, verarbeitet wurden, oder bis ein nachfolgender Job einen sofortigen
Neustart oder eine sofortige Abmeldung vor oder nach seiner Verarbeitung
erfordert.
shutdownAtEnd
Fährt den Zielcomputer nach Abschluss der Jobs herunter.
Wenn sie nicht codiert ist, wird diese Option nicht geändert.
promptUser
Wenn "promptUser" oder "promptUser=y" angegeben wurde, wird der Benutzer
auf den Zielen vor der Jobausführung benachrichtigt. Wenn "promptUser=n"
angegeben ist, wird der Job ausgeführt, ohne dass dem Benutzer eine Meldung
angezeigt wird.
Wenn sie nicht codiert ist, wird diese Option nicht geändert.
Kapitel 3: cadsmcmd-Befehle 379
Kompatibilität
allowCancel
Wenn "allowCancel" oder "allowCancel=y" angegeben ist, kann der Benutzer auf
den Zielen die Ausführung des Jobs abbrechen, wenn die Meldung über die
Ausführung angezeigt wird. Wenn "allowCancel=n" angegeben ist, kann der
Benutzer den Job nicht abbrechen.
Die Anzeige der Meldung über die Ausführung muss erforderlich sein, damit das
Abbrechen der Jobausführung ermöglicht werden kann. Anderenfalls wird ein
Fehler gemeldet.
Wenn sie nicht codiert ist, wird diese Option nicht geändert.
execTimedOut
Wenn "execTimedOut" oder "execTimedOut=y" codiert ist, wird die Ausführung des
Jobs automatisch gestartet, wenn die das Zeitlimit für die Anzeige der
Benachrichtigung für den Benutzer überschritten wird. Wenn "execTimedOut=n"
codiert ist, startet die Prozedur nicht bei der Überschreitung des Zeitlimits.
Die Anzeige der Meldung über die Ausführung muss zugelassen sein, damit der
Start nach der Überschreitung des Zeitlimits aktiviert werden kann. Anderenfalls
wird ein Fehler gemeldet.
Wenn sie nicht codiert ist, wird diese Option nicht geändert.
offline
Wenn "offline" oder "offline=y" angegeben ist, wird die Verbindung zwischen dem
Ziel und dem zugeordneten Server für die Jobausführung getrennt. Wenn
"offline=n" angegeben ist, wird die Verbindung nicht getrennt.
Wenn sie nicht codiert ist, wird diese Option nicht geändert.
runAtShutdown
Wenn "runAtShutdown" oder "runAtShutdown=y" codiert ist, wird der Job nur beim
Herunterfahren des Systems ausgeführt. Wenn "runAtShutdown=n" codiert ist,
wird der Job auch zu jedem anderen Zeitpunkt ausgeführt, zu dem er fällig ist.
Wenn sie nicht codiert ist, wird diese Option nicht geändert.
Diese Option gilt nur für UNIX.
preventLogon
Wenn "preventLogon" oder "preventLogon=y" angegeben ist, werden
Anmeldeversuche von Benutzern auf den Zielen während der Ausführung des Jobs
abgelehnt. Wenn ein Benutzer bereits angemeldet ist, wenn der Job startet, wird
die Ausführung zurückgestellt, bis sich der Benutzer abgemeldet hat.
Wenn "preventLogon=n" codiert ist, hat es keinen Einfluss auf die Ausführung des
Jobs, ob ein Benutzer angemeldet ist oder versucht, sich während der Ausführung
anzumelden.
Wenn sie nicht codiert ist, wird diese Option nicht geändert.
Diese Option gilt nur für Windows-Ziele.
380 CLI-Referenzhandbuch
Kompatibilität
triggeredByScalSrv
Wenn "triggeredByScalSrv" oder "triggeredByScalSrv=y" codiert ist, initiieren die
den Zielen zugeordneten Scalability-Server die Ausführung des Jobs. Wenn
"triggeredByScalSrv=n" codiert ist, initiiert das Ziel die Ausführung zum Zeitpunkt
des Neustarts oder der Jobprüfung.
Wenn sie nicht codiert ist, wird diese Option nicht geändert.
globaltime
Wenn "globalTime" oder "globalTime=y" codiert ist, basieren alle dem Job
zugeordneten Datumsangaben auf der Zeit des Enterprise-Managers, und wenn
"globaltime=n" codiert ist, auf der Zeit des Domänen-Managers.
Wenn sie nicht codiert ist, wird diese Option nicht geändert.
calendarname
Gibt den Namen des Kalenders an, der dafür zuständig ist, die Lieferung des Jobs an
die Scalability-Server und Ziele zu steuern. Wenn eine leere Zeichenfolge ("")
codiert ist, wird der Eintrag für den Lieferungskalender geleert.
Wenn sie nicht codiert ist, wird diese Option nicht geändert.
noCalendar
Wenn "noCalendar" oder "noCalendar=y" codiert ist, wird ein möglicherweise
vorhandener, den Zielcomputern zugeordneter Ausführungskalender für die
Jobverarbeitung ignoriert. Wenn "noCalendar=n" codiert ist, wird der Kalender
berücksichtigt.
Wenn sie nicht codiert ist, wird diese Option nicht geändert.
resolveQuery
Wenn "resolveQuery" oder "resolveQuery=y" codiert ist und die der SoftwareVorlage zugeordnete Gruppe eine Abfragegruppe ist, wird diese Gruppe vor der
Erstellung des Jobs für die zugehörige Prozedur erneut evaluiert. Wenn
"resolveQuery=n" codiert ist, findet keine erneute Evaluierung statt.
Wenn sie nicht codiert ist, wird diese Option nicht geändert.
Kapitel 3: cadsmcmd-Befehle 381
Kompatibilität
stagingserver
Wenn "stagingserver" oder "stagingserver=y" codiert ist, wird das zugehörige
Element durch Staging auf den Scalability-Servern bereitgestellt, die den Zielen
zugeordnet sind. Anderenfalls wird es nicht durch Staging bereitgestellt. Die Option
wird ignoriert, wenn der Job kein Installationsjob ist. Wenn "stagingserver=n"
codiert ist, wird der Schritt der Bereitstellung durch Staging übersprungen.
Wenn sie nicht codiert ist, wird diese Option nicht geändert.
parameters
Gibt die Parameter an, die an die Jobprozedur übergeben werden. Wenn eine leere
Zeichenfolge ("") codiert ist, wird angenommen, dass keine Parameter übergeben
werden müssen.
Wenn sie nicht codiert ist, wird diese Option nicht geändert.
prompt
Gibt den Zeitraum an, in dem einem Benutzer auf dem Ziel erneut die Meldung
über den Start der Jobprozedur angezeigt wird, wenn der Benutzer die Ausführung
zurückstellt. Der Zeitraum wird im Format "t.h" angegeben, wobei "t" für die Tage
und "h" für die Stunden steht. Der zulässige Bereich ist 0.3 <= t.h <=7.0.
Wenn der angegebene Wert unter den zulässigen Mindestwert fällt, wird der
Mindestwert festgelegt, und wenn er den Höchstwert überschreitet, wird der
Höchstwert festgelegt. In diesen Fällen wird keine Warnung angezeigt.
Wenn sie nicht codiert ist, wird diese Option nicht geändert.
382 CLI-Referenzhandbuch
Kompatibilität
jobTimeOut
Gibt das Ablaufdatum der Prozedur in Form eines Zeitraums an. Der Zeitraum wird
im Format "t.h" angegeben. Dabei steht "t" für Tage und "h" für Stunden. Der
Parameterbereich kann über den Manager definiert werden.
Wenn der angegebene Wert unter den zulässigen Mindestwert fällt, wird der
Mindestwert festgelegt, und wenn er den Höchstwert überschreitet, wird der
Höchstwert festgelegt. In diesen Fällen wird keine Warnung angezeigt.
Wenn sie nicht codiert ist, wird diese Option nicht geändert.
repeat
Wenn "repeat" oder "repeat=y" codiert ist, wird der zugehörige Job jedes Mal
wiederholt, wenn eine Evaluierung stattfindet. Wenn "repeat=n" codiert ist, wird
der zugehörige Job nicht wiederholt.
Wenn sie nicht codiert ist, wird diese Option nicht geändert.
seal
Wenn "seal" oder "seal=y" codiert ist, wird die Richtlinie versiegelt, nachdem die
Änderung abgeschlossen wurde. Anderenfalls bleibt sie für weitere Änderungen
unversiegelt. Die Versiegelung wird nur dann ausgeführt, wenn die Änderungen
erfolgreich waren und kein Fehler gemeldet wurde. Warnungen unterdrücken die
Versiegelung nicht.
Wenn sie nicht codiert ist, wird diese Option nicht geändert.
userJobMessage
Ändert die benutzerdefinierte Administratormeldung für einen Job in einer
Software-Richtlinie.
showAttrItem – Anzeigen von Informationen über einen einer Software-Richtlinie
zugewiesenen Job
Diese Aktion bietet Informationen über den angegebenen Job, der der angegebenen
Software-Richtlinie zugewiesen ist.
Die Syntax der Aktion lautet folgendermaßen:
swPolicy action=showAttrItem
name=Name_der_Software-Richtlinie
[swpScope={distributed | local}]
jobname=Jobname
Name
Der Name der Software-Richtlinie, bei der sich der anzuzeigende Job befindet.
Kapitel 3: cadsmcmd-Befehle 383
Kompatibilität
swpScope
Diese Option legt den für die Aktion verwendeten Typ der Softwarerichtlinie fest.
«nicht angegeben»
Wenn eine lokal erstellte Software-Richtlinie des angeforderten Namens
vorhanden ist, wird diese verwendet. Falls nicht, wird eine von einem
Enterprise-Manager verteilte Richtlinie gesucht. Letzteres ist nur auf DomänenManagern zulässig.
distributed
Die angegebene Software-Richtlinie muss auf dem Enterprise-Manager erstellt
und an den angegebenen Manager verteilt worden sein.
lokal
Die angegebene Softwarerichtlinie muss lokal erstellt worden sein.
Hinweis: Enterprise-Manager unterstützen nur Software-Richtlinien vom Typ
"lokal".
jobname
Name des aufzulistenden Jobs.
Die aufgelisteten Informationen besitzen das folgende Format:
---------------------------------------------------------------Jobs «Jobname» von Software-Richtlinie «Name der Software-Richtlinie» anzeigen
---------------------------------------------------------------Elementname
: «Name des Elements»
Elementversion : «Version des Elements»
Prozedurname
: «Prozedurname»
Jobtask : {configure|activate|
install|uninstall}
Position : «Position des Jobs»
Neuinstallation erforderlich
: {yes|no}
Aktion davor
: {none|reboot|logoff}
Aktion danach
: {none|reboot|logoff|
rebootAtEnd|logoffAtEnd}
Benutzer-Eingabeaufforderung
: {yes|no}
384 CLI-Referenzhandbuch
Kompatibilität
..Abbruch zulassen
: {yes|no}
..Jobs nach Zeitüberschreitung der Eingabeaufforderung ausführen : {yes|no}
..Eingabeaufforderung während (Tage/Stunden)
: t/h
Offline vom Server aus ausführen : {yes|no}
Beim Herunterfahren ausführen
: {yes|no}
Benutzeranmeldung verhindern
: {yes|no}
Jobstart : {local|global} Zeit/{exact|at boot}
Lieferungskalender
: «Name des Lieferungskalenders»
Jobkalender auf Ziel ignorieren : {yes|no}
Abfragegruppen auflösen : {yes|no}
Element durch Staging bereitstellen
: {yes|no}
Benutzerparameter
: «Benutzerparameter»
Jobzeitlimit (Tage/Stunden)
: t/h
repositionItem – Umgruppieren von einer unversiegelten lokalen Software-Richtlinie
zugewiesenen Jobs
Diese Aktion ermöglicht das Umgruppieren der Jobs, die der angegebenen
unversiegelten lokalen Software-Richtlinie zugewiesen sind. Dies bedeutet, dass die
Reihenfolge der Jobausführung an den Zielen geändert wird.
Die Syntax der Aktion lautet folgendermaßen:
swPolicy action=repositionItem
name=Name_der_Software-Richtlinie
jobName=Name_des_Jobs
position=neue_Position_des_Jobs
[seal[={y|n}]]
Name
Der Name der Software-Richtlinie, die umgruppiert wird.
jobName
Name des Jobs, der neu positioniert wird.
position
Neue Position des angegebenen Jobs in der Software-Richtlinie.
seal
Wenn "seal" oder "seal=y" codiert ist, wird die Richtlinie versiegelt, nachdem die
Neupositionierung abgeschlossen wurde. Anderenfalls bleibt sie für weitere
Änderungen unversiegelt. Die Versiegelung wird nur dann ausgeführt, wenn die
Neupositionierung erfolgreich war und kein Fehler gemeldet wurde. Warnungen
unterdrücken die Versiegelung nicht.
Kapitel 3: cadsmcmd-Befehle 385
Kompatibilität
link – Verknüpfen von Software-Richtlinien mit Computergruppen
Diese Aktion verknüpft eine Software-Richtlinie mit einer vorhandenen
Computergruppe oder erstellt diese Verknüpfung erneut. Die Computergruppe kann
lokal oder global sein. Die Softwarerichtlinie darf nicht versiegelt sein, da die Aktion
sonst mit einem Fehler abgebrochen wird. Wenn eine Richtlinie erneut verknüpft
werden soll, muss die Option "currentGroup" oder "replace" mit dem Aufruf codiert
werden, anderenfalls schlägt die erneute Verknüpfung fehl.
Die Software-Richtlinie muss unversiegelt sein, sie kann jedoch einen beliebigen Bereich
umfassen. Dieser gilt auch für die Computergruppe, mit der die Richtlinie verknüpft ist.
Mit der Verknüpfungsaktion kann die Richtlinie optional versiegelt werden.
Die Syntax der Aktion lautet folgendermaßen:
swPolicy action=link
name=Name_der_Software-Richtlinie
[swpScope={distributed | local}]
group=Computergruppenname
[groupScope={global | local}]
[{currentGroup=Name_der_aktuellen_Computergruppe
[currentGroupScope={global | local}]| replace}]
[seal[={y|n}]]
Name
Der Name der Software-Richtlinie, die mit der angegebenen Computergruppe
verknüpft ist.
swpScope
Diese Option legt den für die Aktion verwendeten Typ der Softwarerichtlinie fest.
«nicht angegeben»
Wenn eine lokal erstellte Software-Richtlinie des angeforderten Namens
vorhanden ist, wird diese verwendet. Falls nicht, wird eine von einem
Enterprise-Manager verteilte Richtlinie gesucht. Letzteres ist nur auf DomänenManagern zulässig.
distributed
Die angegebene Software-Richtlinie muss auf dem Enterprise-Manager erstellt
und an den angegebenen Manager verteilt worden sein.
lokal
Die angegebene Softwarerichtlinie muss lokal erstellt worden sein.
Hinweis: Enterprise-Manager unterstützen nur Software-Richtlinien vom Typ
"lokal".
386 CLI-Referenzhandbuch
Kompatibilität
Gruppe
Diese Option gibt den Namen einer vorhandenen Computergruppe an, der die
angegebene Software-Richtlinie zugewiesen wird.
groupScope
Diese Option gibt den Gruppentyp an, dem die Software-Richtlinie zugewiesen wird.
global
Die Computergruppe wurde auf dem Enterprise-Manager erstellt und kann in
der Domäne repliziert werden.
lokal
Die Computergruppe wurde auf dem Domänen-Manager erstellt.
Auf Enterprise-Managern sind alle Computergruppen global.
Wenn die Option nicht codiert ist, versucht CADSMCMD zunächst, die Gruppe als
lokale Gruppe zu finden, und wenn dies fehlschlägt, wird nach einer globalen
Gruppe gesucht.
Kapitel 3: cadsmcmd-Befehle 387
Kompatibilität
currentGroup
Diese Option gibt den Namen einer Computergruppe an, mit der die
Softwarerichtlinie bereits verknüpft ist. Bei Angabe wird die Verknüpfung zwischen
der aktuellen Gruppe und der Softwarerichtlinie entfernt und durch eine
Verknüpfung zwischen der Softwarerichtlinie und der neuen Zielcomputergruppe
ersetzt.
currentGroupScope
Diese Option gibt an, mit welchem Gruppentyp die Softwarerichtlinie bereits
verknüpft ist:
global
Die Computergruppe wurde auf dem Enterprise-Manager erstellt und kann in
der Domäne repliziert werden.
lokal
Die Computergruppe wurde auf dem Domänen-Manager erstellt.
Auf Enterprise-Managern sind alle Computergruppen global.
Wenn die Option nicht codiert ist, versucht CADSMCMD zunächst, die Gruppe als
lokale Gruppe zu finden, und wenn dies fehlschlägt, wird nach einer globalen
Gruppe gesucht.
replace
Wenn diese Option angegeben wird, wird die angegebene Gruppe mit der
angegebenen Softwarerichtlinie verknüpft, unabhängig davon, ob mit der Richtlinie
bereits eine andere Gruppe verknüpft ist.
seal
Wenn "seal" oder "seal=y" codiert ist, wird die Richtlinie versiegelt, nachdem die
Verknüpfung abgeschlossen wurde. Anderenfalls bleibt sie für weitere Änderungen
unversiegelt. Die Versiegelung wird nur dann ausgeführt, wenn die Verknüpfung
erfolgreich war und kein Fehler gemeldet wurde. Warnungen unterdrücken die
Versiegelung nicht.
Hinweis: Wenn weder die Option "replace" noch die Option "currentGroup" angegeben
wurde, schlägt die Aktion mit einer Fehlermeldung fehl, wenn mit der SoftwareRichtlinie bereits eine Gruppe verknüpft ist.
388 CLI-Referenzhandbuch
Kompatibilität
unlink – Entfernen von Verknüpfungen zwischen Software-Richtlinien und Computergruppen
Mit dieser Aktion wird die Verknüpfung zwischen einer Computergruppe und der ihr
zugewiesenen Softwarerichtlinie aufgehoben. Ohne zugewiesene Computergruppe wird
der Befehl ohne Fehler oder Warnung erfolgreich abgeschlossen. Die Softwarerichtlinie
darf nicht versiegelt sein, da die Aktion sonst mit einem Fehler abgebrochen wird.
Die Syntax der Aktion lautet folgendermaßen:
swPolicy action=unlink
name=Name_der_Software-Richtlinie
[swpScope={distributed | local}]
[group=Computergruppenname
[groupScope={global | local}]]
Name
Der Name der Software-Richtlinie, deren Verknüpfung mit der ihr zugewiesenen
Computergruppe aufgehoben wird.
swpScope
Diese Option legt den für die Aktion verwendeten Typ der Softwarerichtlinie fest.
«nicht angegeben»
Wenn eine lokal erstellte Software-Richtlinie des angeforderten Namens
vorhanden ist, wird diese verwendet. Falls nicht, wird eine von einem
Enterprise-Manager verteilte Richtlinie gesucht. Letzteres ist nur auf DomänenManagern zulässig.
distributed
Die angegebene Software-Richtlinie muss auf dem Enterprise-Manager erstellt
und an den angegebenen Manager verteilt worden sein.
lokal
Die angegebene Softwarerichtlinie muss lokal erstellt worden sein.
Enterprise-Manager unterstützen nur Software-Richtlinien vom Typ "local".
Kapitel 3: cadsmcmd-Befehle 389
Kompatibilität
Gruppe
Bei Angabe dieser Option wird geprüft, ob der Name der Computergruppe, deren
Verknüpfung zu einer Softwarerichtlinie entfernt werden soll, mit dem mit dieser
Option angegebenem Namen identisch ist. Ist dies der Fall, wird die Aktion
fortgesetzt. Anderenfalls schlägt sie fehl. Wird die Option nicht angegeben, erfolgt
keine Überprüfung, und die Aktion zum Entfernen der Verknüpfung wird
verarbeitet.
groupScope
Bei Angabe dieser Option wird geprüft, ob die angegebene, mit der
Softwarerichtlinie verknüpfte Gruppe dem Gruppentyp entspricht, der mit dieser
Option angegeben wird. Ist dies der Fall, wird die Aktion fortgesetzt. Anderenfalls
schlägt sie fehl. Wenn die Option nicht codiert ist, wird keine solche Prüfung
durchgeführt. Die folgenden Gruppentypen sind zulässig:
global
Die Computergruppe wurde auf dem Enterprise-Manager erstellt und kann in
der Domäne repliziert werden.
lokal
Die Computergruppe wurde auf dem Domänen-Manager erstellt.
Wenn die Option nicht codiert ist, versucht CADSMCMD zunächst, die Gruppe als
lokale Gruppe zu finden, und wenn dies fehlschlägt, wird nach einer globalen
Gruppe gesucht.
Auf Enterprise-Managern sind alle Computergruppen global.
seal – Versiegeln von Software-Richtlinien
Diese Aktion versiegelt eine Softwarerichtlinie. Wenn die Richtlinie auf einem DomänenManager leer ist oder keiner Computergruppe zugewiesen wurde, schlägt die Aktion mit
einer Fehlermeldung fehl. Auf einem Enterprise-Manager kann jedoch eine nicht
verknüpfte Richtlinie, die nicht leer ist, versiegelt werden. Wenn die Softwarerichtlinie
bereits versiegelt wurde, wird kein Fehler bzw. keine Warnung ausgegeben und die
Aktion erfolgreich abgeschlossen.
Die Syntax der Aktion lautet folgendermaßen:
swPolicy action=seal
name=Name_der_Software-Richtlinie
[swpScope={distributed | local}]
390 CLI-Referenzhandbuch
Kompatibilität
Name
Der Name der Software-Richtlinie, die versiegelt wird.
swpScope
Diese Option legt den für die Aktion verwendeten Typ der Softwarerichtlinie fest.
«nicht angegeben»
Wenn eine lokal erstellte Software-Richtlinie des angeforderten Namens
vorhanden ist, wird diese verwendet. Falls nicht, wird eine von einem
Enterprise-Manager verteilte Richtlinie gesucht. Letzteres ist nur auf DomänenManagern zulässig.
distributed
Die angegebene Software-Richtlinie muss auf dem Enterprise-Manager erstellt
und an den angegebenen Manager verteilt worden sein.
lokal
Die angegebene Softwarerichtlinie muss lokal erstellt worden sein.
Enterprise-Manager unterstützen nur Softwarerichtlinien vom Typ "local".
unseal – Aufheben der Versiegelung von Software-Richtlinien
Diese Aktion hebt die Versiegelung einer Softwarerichtlinie auf. Wenn die Versiegelung
der Softwarerichtlinie bereits aufgehoben wurde, wird kein Fehler bzw. keine Warnung
ausgegeben und die Aktion erfolgreich abgeschlossen.
Die Syntax der Aktion lautet folgendermaßen:
swPolicy action=unseal
name=Name_der_Software-Richtlinie
[swpScope={distributed | local}]
Kapitel 3: cadsmcmd-Befehle 391
Kompatibilität
Name
Der Name der Software-Richtlinie, deren Versiegelung aufgehoben wird.
swpScope
Diese Option legt den für die Aktion verwendeten Typ der Softwarerichtlinie fest.
«nicht angegeben»
Wenn eine lokal erstellte Software-Richtlinie des angeforderten Namens
vorhanden ist, wird diese verwendet. Falls nicht, wird eine von einem
Enterprise-Manager verteilte Richtlinie gesucht. Letzteres ist nur auf DomänenManagern zulässig.
distributed
Die angegebene Software-Richtlinie muss auf dem Enterprise-Manager erstellt
und an den angegebenen Manager verteilt worden sein.
lokal
Die angegebene Softwarerichtlinie muss lokal erstellt worden sein.
Enterprise-Manager unterstützen nur Software-Richtlinien vom Typ "local".
register – Registrieren einer Software-Richtlinie auf einer Domäne
Diese Aktion registriert eine Software-Richtlinie vom Enterprise-Manager auf einer
Domäne.
Die Syntax der Aktion lautet folgendermaßen:
swPolicy action=register
{names=Name_der_Software-Richtlinie}
[dname=Name_der_Verteilung]
[{{area=Bereichsname}|
{domain=Domänenname}| toAllAreas}
[sendtime=jjjj-mm-tt HH:MM]
[halttime=jjjj-mm-tt HH:MM]]
[replace]
[distPriority={1,...,10}]
392 CLI-Referenzhandbuch
Kompatibilität
Namen
Der Name der Software-Richtlinie, die verteilt und registriert werden soll. Das
Argument kann mehrfach angegeben werden, um eine Liste von Richtlinien zu
verarbeiten.
dname
Name der Verteilung, die verwendet wird, um die Registrierungsanfrage an die
angesprochenen DSM-Domänen zu senden. Falls eine solche Verteilung existiert
und noch nicht versiegelt ist, wird der Auftrag zu dieser Verteilung hinzugefügt.
Wenn die Verteilung bereits versiegelt ist, wird die Aktion mit einem Fehler
beendet.
Wenn keine Verteilung mit dem angegebenen Namen vorhanden ist, wird sie
erstellt.
Wenn diese Option nicht angegeben ist, wird ein Standardname generiert und von
der CLI auf stdout gemeldet.
area
Gibt den Namen einer DSM-Domäne an, an die die Registrierungsanfrage gesendet
wird. Dieser Parameter kann mehrfach codiert werden, um eine Liste von DSMDomänen anzugeben, die angesprochen werden sollen.
Wenn diese Option codiert ist, wird die zugeordnete Verteilung versiegelt und für
die Verarbeitung geplant.
Diese Option darf nicht codiert werden, wenn die Option "domain" oder
"toAllAreas" codiert ist.
domain
Gibt den Namen einer DSM-Domänengruppe an, an die die Registrierungsanfrage
gesendet wird. Dieser Parameter kann mehrfach codiert werden, um eine Liste von
DSM-Domänengruppen anzugeben, die angesprochen werden sollen.
Wenn diese Option codiert ist, wird die zugeordnete Verteilung versiegelt und für
die Verarbeitung geplant.
Diese Option darf nicht codiert werden, wenn die Option "area" oder "toAllAreas"
codiert ist.
Kapitel 3: cadsmcmd-Befehle 393
Kompatibilität
toAllAreas
Wenn dieser Parameter angegeben ist, wird die zugehörige Verteilung an alle
Domänen-Manager gesendet, die beim Enterprise-Manager registriert sind.
Wenn diese Option codiert ist, wird die zugeordnete Verteilung versiegelt und für
die Verarbeitung geplant.
Diese Option darf nicht codiert werden, wenn die Option "area" oder "domain"
codiert ist.
sendtime
Gibt die Startzeit für die Verarbeitung der Verteilung auf dem Enterprise-Manager
an. Das Datum wird im ISO-Format angegeben. Wenn diese Option nicht codiert ist,
werden das aktuelle Datum und die aktuelle Uhrzeit verwendet.
halttime
Gibt den Zeitpunkt an, zu dem die Verarbeitung der Verteilung gestoppt wird. Das
Datum wird im ISO-Format angegeben. Wenn diese Option nicht codiert ist, werden
das aktuelle Datum und die aktuelle Uhrzeit + 1h verwendet.
replace
Wenn diese Option angegeben ist, werden die Software-Richtlinien aktualisiert.
Wenn diese Option nicht codiert ist, werden die Software-Richtlinien erstellt. Wenn
sie jedoch bereits vorhanden sind, wird ein Fehler gemeldet.
distPriority
Gibt die der Verteilung zugewiesene Priorität an. Die Priorität ist numerisch. Gültige
Werte sind die Zahlen 1 (höchste Priorität) bis 10 (niedrigste Priorität).
Standard: 5
Hinweis: Wenn keine der Optionen "area", "domain" und "toAllAreas" codiert ist, bleibt
die Verteilung unversiegelt, und weitere Aufträge können zu ihr hinzugefügt werden.
deregister – Aufheben der Registrierung einer Software-Richtlinie auf einer Domäne
Diese Aktion hebt die Registrierung einer Software-Richtlinie vom Enterprise-Manager
auf einer Domäne auf.
Die Syntax der Aktion lautet folgendermaßen:
swPolicy action=deregister
{names=Name_der_Software-Richtlinie}
[dname=Name_der_Verteilung]
[{{area=Bereichsname}|
{domain=Domänenname}| toAllAreas}
[sendtime=jjjj-mm-tt HH:MM]
[halttime=jjjj-mm-tt HH:MM]]
[distPriority={1,...,10}]
394 CLI-Referenzhandbuch
Kompatibilität
Namen
Der Name der Software-Richtlinie, die verteilt und deren Registrierung aufgehoben
werden soll. Das Argument kann mehrfach angegeben werden, um eine Liste von
Richtlinien zu verarbeiten.
dname
Name der Verteilung, die verwendet wird, um die Anfrage für die Aufhebung der
Registrierung an die angesprochenen DSM-Domänen zu senden. Falls eine solche
Verteilung existiert und noch nicht versiegelt ist, wird der Auftrag zu dieser
Verteilung hinzugefügt. Wenn die Verteilung bereits versiegelt ist, wird die Aktion
mit einem Fehler beendet.
Wenn keine Verteilung mit dem angegebenen Namen vorhanden ist, wird sie
erstellt.
Wenn diese Option nicht angegeben ist, wird ein Standardname generiert und von
der CLI auf stdout gemeldet.
area
Gibt den Namen einer DSM-Domäne an, an die die Anfrage für die Aufhebung der
Registrierung gesendet wird. Dieser Parameter kann mehrfach codiert werden, um
eine Liste von DSM-Domänen anzugeben, die angesprochen werden sollen.
Wenn diese Option codiert ist, wird die zugeordnete Verteilung versiegelt und für
die Verarbeitung geplant.
Diese Option darf nicht codiert werden, wenn die Option "domain" oder
"toAllAreas" codiert ist.
domain
Gibt den Namen einer DSM-Domänengruppe an, an die die Anfrage für die
Aufhebung der Registrierung gesendet wird. Dieser Parameter kann mehrfach
codiert werden, um eine Liste von DSM-Domänengruppen anzugeben, die
angesprochen werden sollen.
Wenn diese Option codiert ist, wird die zugeordnete Verteilung versiegelt und für
die Verarbeitung geplant.
Diese Option darf nicht codiert werden, wenn die Option "area" oder "toAllAreas"
codiert ist.
Kapitel 3: cadsmcmd-Befehle 395
Kompatibilität
toAllAreas
Wenn dieser Parameter angegeben ist, wird die zugehörige Verteilung an alle DSM
gesendet, deren Registrierung beim Enterprise-Manager aufgehoben wurde.
Wenn diese Option codiert ist, wird die zugeordnete Verteilung versiegelt und für
die Verarbeitung geplant.
Diese Option darf nicht codiert werden, wenn die Option "area" oder "domain"
codiert ist.
sendtime
Gibt die Startzeit für die Verarbeitung der Verteilung auf dem Enterprise-Manager
an. Das Datum wird im ISO-Format angegeben. Wenn diese Option nicht codiert ist,
werden das aktuelle Datum und die aktuelle Uhrzeit verwendet.
halttime
Gibt den Zeitpunkt an, zu dem die Verarbeitung der Verteilung gestoppt wird. Das
Datum wird im ISO-Format angegeben. Wenn diese Option nicht codiert ist, werden
das aktuelle Datum und die aktuelle Uhrzeit + 1h verwendet.
distPriority
Gibt die der Verteilung zugewiesene Priorität an. Die Priorität ist numerisch. Gültige
Werte sind die Zahlen 1 (höchste Priorität) bis 10 (niedrigste Priorität).
Standard: 5
Hinweis: Wenn keine der Optionen "area", "domain" und "toAllAreas" codiert ist, bleibt
die Verteilung unversiegelt, und weitere Aufträge können zu ihr hinzugefügt werden.
list – Auflisten von Software-Richtlinien
Diese Aktion listet alle bei der Domäne oder dem Enterprise registrierten SoftwareRichtlinien auf.
Die Syntax der Aktion lautet folgendermaßen:
swPolicy action=list
[{detailed |separator=Trennzeichen}]
detailed
Wenn diese Option codiert ist, wird eine detaillierte Liste angegeben, anderenfalls
nur eine kurze Liste.
396 CLI-Referenzhandbuch
Kompatibilität
Trennzeichen
Das Trennzeichen ist ein Zeichen, das zum Trennen der verschiedenen
Ausgabefelder in den Zeilen der Auflistungen verwendet wird. Das standardmäßige
Trennzeichen ist ":" (Doppelpunkt).
Die kurze Liste mit dem standardmäßigen Trennzeichen besitzt das folgende Format:
---------------------------------------------------------------Liste der Software-Richtlinien
Short
---------------------------------------------------------------«Name von Richtlinie_1»:«Typ von Richtlinie_1»:«verknüpfte Gruppe»:«Bereich der
verknüpften Gruppe»: [un]sealed
...
...
...
«Name von Richtlinie_n»:«Typ von Richtlinie_n»:«verknüpfte
Gruppe»:«Gruppenbereich»: [un]sealed)
Die detaillierte Liste besitzt das folgende Format:
---------------------------------------------------------------Liste der Software-Richtlinien
Detailliert
---------------------------------------------------------------Richtlinienname : «Name von Richtlinie 1»
..Richtlinientyp : {verteilt|lokal}
..Status : {deaktiviert|nicht evaluiert|wird ausgewertet|nicht konform|konform}
..Priorität
: «Priorität der Vorlage»
..Zugeordnete Gruppe
: «Gruppenname»
..Gruppentyp
: {global|lokal}
..Letzte Evaluierung
: «jjjj-mm-tt HH:MM»
..Richtlinienverletzer : «Anzahl der Richtlinienverletzer»
..Verknüpfung
: {Stapel|Transaktion|
synchronisiert|keine Verknüpfung}
..Überlappende Installation
: {yes|no}
Kapitel 3: cadsmcmd-Befehle 397
Kompatibilität
..Automatisierungsgrad : {Konformitätsprüfung|Jobs einrichten|Jobs einrichten
und aktivieren}
..Neuerstellung von Jobs : {yes|no}
..Evaluierung von dynamischer Gruppe
: {yes|no}
..Aktivierungszeitpunkt : «jjjj-mm-tt HH:MM»
..Zeitsteuerung durch Enterprise-Manager : {yes|no}
..Evaluierungszeitraum : «Evaluierungszeitraum»
..Evaluierungskalender : «Kalendername»
..Adhoc-Evaluierung
: {deaktiviert|nur bei neuem Inventar|immer}
Richtlinienname : «Name von Richtlinie 2»
•
•
•
Richtlinienname : «Name von Richtlinie n»
modify – Ändern von Attributen einer unversiegelten lokalen Software-Richtlinie
Dieser Befehl ändert die Attribute einer unversiegelten lokalen Software-Richtlinie. Sie
können optional die Richtlinie mit diesem Befehl versiegeln.
Dieser Befehl hat das folgende Format:
swPolicy action=modify
name=Name_der_Software-Richtlinie
[newName=neuer_Name_der_Software-Vorlage]
[jcPriority=«1…10»]
[{transaction|synchronized|nolinkage}]
[rollback[={y|n}]]
[cascade[={y|n}]]
[{nosetup|setup_jobs|setup&activate_jobs}]
[regenerate[={y|n}]]
[evaluateGroup[={y|n}]]
[evaluationStart=JJJJ-MM-TT hh:mm]
[globalTime[={y|n}]]
[evaluationPeriod=Stunden]
[calendarname=Kalendername]
[{adhoc_disable|adhoc_only|adhoc_always}]
[comment=neuer_Kommentar_zur_Software-Richtlinie]
[seal[={y|n}]]
[userMessage]
398 CLI-Referenzhandbuch
Kompatibilität
Name
Der Name einer lokalen Software-Richtlinie, die geändert wird.
newname
Gibt den neuen Namen der ausgewählten Software-Richtlinie an.
Wenn diese Option nicht codiert ist, wird der Name der Richtlinie nicht geändert.
jcPriority
Diese Option gibt die neue Priorität für durch diese Richtlinie generierte
Jobcontainer an. Gültige Werte für die Priorität sind 1, 2, 3, 4, 5, 6, 7, 8, 9, 10. 1 ist
die höchste Priorität und 10 die niedrigste.
Wenn diese Option nicht codiert ist, wird die Priorität nicht geändert.
{transaction|synchronized|nolinkage}
Diese Option gibt die neue Jobverknüpfung für durch die Richtlinie erstellte
Jobcontainer an.
«nicht angegeben»
Die Jobverknüpfung wird nicht geändert.
batch
Die Jobverknüpfung wird auf Batch-Jobs ohne Transaktion gesetzt.
Transaktion
Die Jobverknüpfung wird auf Batch-Jobs ohne Transaktion gesetzt.
synchronisiert
Die Jobverknüpfung wird auf "Synchronisierte Jobausführung" gesetzt.
nolinkage
Die Jobverknüpfung wird auf "Keine Verknüpfung" gesetzt.
Kapitel 3: cadsmcmd-Befehle 399
Kompatibilität
Rollback
Wenn die Option "rollback" oder "rollback=y" codiert ist, wird die Jobverknüpfung
auf "Transaktion aktivieren" gesetzt. Wenn die Option als "rollback=n" codiert ist,
wird "Transaktion aktivieren" nicht festgelegt.
Wenn diese Option nicht codiert ist, wird sie nicht geändert.
Der Parameter sollte nur angegeben werden, wenn sich der Job bereits im BatchVerarbeitungsmodus befindet oder durch die Verwendung des Parameters
"transaction" mit diesem Befehl in diesen Modus versetzt wird.
Standardwert: rollback=n.
cascade
Wenn die Option "cascade" oder "cascade=y" codiert ist, löst SD die Abhängigkeiten
von überlappenden Installationsanforderungen auf und fügt die fehlenden
Installationsaufträge automatisch hinzu. Wenn die Option als "cascade=n" codiert
ist, wird die Abhängigkeit nicht mehr aufgelöst.
Wenn diese Option nicht codiert ist, wird sie nicht geändert.
{nosetup|setup_jobs|setup&activate_jobs}
Diese Option steuert die Ergebnisse der Auswertung der Richtlinie:
«nicht angegeben»
Der Automatisierungsgrad wird nicht geändert.
nosetup
Der Automatisierungsgrad wird dahingehend geändert, dass nur auf
Konformität geprüft wird.
setup_jobs
Der Automatisierungsgrad wird dahingehend geändert, dass Jobs für nicht
konforme Ziele eingerichtet werden, die jedoch nicht aktiviert werden.
setup&activate_jobs
Der Automatisierungsgrad wird dahingehend geändert, dass Jobs für nicht
konforme Ziele eingerichtet und aktiviert werden.
400 CLI-Referenzhandbuch
Kompatibilität
regenerate
Wenn die Option "regenerate" oder "regenerate=y" codiert ist, werden alle Jobs,
die zuvor fehlgeschlagen sind und noch nicht erfolgreich abgeschlossen wurden,
erneut zur Ausführung geplant, um Konformität zu erzielen. Wenn die Option
"regenerate=n" codiert ist, wird diese erneute Planung jetzt übersprungen.
Wenn diese Option nicht codiert ist, wird sie nicht geändert.
evaluateGroup
Wenn die Option "evaluateGroup" oder "evaluateGroup=y" codiert ist, wird im Falle
einer der Richtlinie zugeordneten Abfragegruppe diese Gruppe während der
Evaluierung der Richtlinie ebenfalls erneut evaluiert. Wenn "evaluationGroup=n"
codiert ist, findet diese erneute Evaluierung der Gruppe nicht statt.
Wenn diese Option nicht codiert ist, wird sie nicht geändert.
evaluationStart
Diese Option gibt einen neuen frühesten Zeitpunkt an, zu dem die Evaluierung der
Richtlinie startet. Der Wert wird im ISO-Format "JJJJ-MM-TT hh:mm" angegeben,
wobei "JJJJ" das Jahr, "MM" den Monat, "TT" den aktuellen Tag des Monats, "hh"
die Stunde und "mm" die Minute angibt.
Wenn diese Option nicht codiert ist, wird sie nicht geändert.
globalTime
Wenn "globalTime" oder "globalTime=y" angegeben ist, basieren die Zeitangaben
für die Richtlinie auf der Enterprise-Zeit. Wenn "globalTime=n" codiert ist, basieren
die Zeitangaben auf der Domänenzeit.
Wenn diese Option nicht codiert ist, wird sie nicht geändert.
evaluationPeriod
Diese Option gibt den neuen Zeitraum an, in dem die Evaluierung der Richtlinie
stattfindet. Der Wert wird in Stunden angegeben. Wenn "0" angegeben ist, findet
die Evaluierung nur einmal bei der Versiegelung statt.
Wenn diese Option nicht codiert ist, wird sie nicht geändert.
calendarname
Diese Option gibt den Namen eines neuen Kalenders an, der von SD zur Planung der
zeitgesteuerten Aktionen der Richtlinie verwendet wird. Wenn eine leere
Zeichenfolge eingegeben wird, wird ein möglicherweise vorhandener
Kalendereintrag entfernt und Kalender werden nicht mehr berücksichtigt.
Wenn diese Option nicht codiert ist, wird sie nicht geändert.
Kapitel 3: cadsmcmd-Befehle 401
Kompatibilität
{adhoc_disable | adhoc_only | adhoc_always}
Diese Option gibt den neuen Typ der Adhoc-Evaluierung an:
«nicht angegeben»
Der Typ der Adhoc-Evaluierung wird nicht geändert.
adhoc_disable
Die Adhoc-Evaluierung ist nicht mehr verfügbar.
adhoc_only
Die Adhoc-Evaluierung startet jetzt, wenn Inventarberichte von neuen oder
neu installierten Zielen eingehen.
ad_hoc_always
Die Adhoc-Evaluierung startet jetzt bei allen Inventarberichten von Zielen.
comment
Diese Option gibt den neuen Kommentar zur Software-Richtlinie an. Wenn eine
leere Zeichenfolge codiert ist, wird der alte Kommentar entfernt.
Wenn die Option nicht codiert wird, bleibt der Kommentar unverändert.
seal
Wenn "seal" oder "seal=y" codiert ist, wird die Richtlinie versiegelt, nachdem die
Änderung abgeschlossen wurde. Anderenfalls bleibt sie für weitere Änderungen
unversiegelt. Die Versiegelung wird nur dann ausgeführt, wenn die Änderung
erfolgreich war und kein Fehler gemeldet wurde. Warnungen unterdrücken die
Versiegelung nicht.
Wenn diese Option nicht codiert ist, wird sie nicht geändert.
userMessage
Ändert die benutzerdefinierte Administratormeldung, während sie die
Eigenschaften der Software-Richtlinie aktualisiert.
showAttr – Auflisten der Attribute der Software-Richtlinie
Diese Aktion listet die Attribute einer Software-Richtlinie auf.
Die Syntax der Aktion lautet folgendermaßen:
swPolicy action=showAttr
name=Name_der_Software-Richtlinie
[swpScope={distributed | local}]
Name
Name der Software-Richtlinie, deren Attribute aufgelistet werden.
402 CLI-Referenzhandbuch
Kompatibilität
swpScope
Diese Option legt den für die Aktion verwendeten Typ der Softwarerichtlinie fest.
«nicht angegeben»
Wenn eine lokal erstellte Software-Richtlinie des angeforderten Namens
vorhanden ist, wird diese verwendet. Falls nicht, wird eine von einem
Enterprise-Manager verteilte Richtlinie gesucht. Letzteres ist nur auf DomänenManagern zulässig.
distributed
Die angegebene Software-Richtlinie muss auf dem Enterprise-Manager erstellt
und an den angegebenen Manager verteilt worden sein.
lokal
Die angegebene Softwarerichtlinie muss lokal erstellt worden sein.
Hinweis: Enterprise-Manager unterstützen nur Software-Richtlinien vom Typ
"lokal".
Die Liste der Attribute besitzt das folgende Format:
---------------------------------------------------------------Attribute der Software-Richtlinie «Name der Software-Richtlinie»
---------------------------------------------------------------Richtlinientyp : {verteilt|lokal}
Status : {deaktiviert|nicht evaluiert|wird ausgewertet|nicht konform|konform}
Kommentar
: «Kommentar zur Richtlinie»
Priorität
: «Priorität der Vorlage»
Zugeordnete Gruppe
: «Gruppenname»
Gruppentyp
: {global|lokal}
Letzte Evaluierung
: «jjjj-mm-tt HH:MM»
Richtlinienverletzer
: «Anzahl der Richtlinienverletzer»
Verknüpfung
: {Stapel|Transaktion|
synchronisiert|keine Verknüpfung}
Überlappende Installation
: {yes|no}
Automatisierungsgrad
: {Konformitätsprüfung|Jobs einrichten|Jobs einrichten
und aktivieren}
Neuerstellung von Jobs : {yes|no}
Evaluierung von dynamischer Gruppe
: {yes|no}
Aktivierungszeitpunkt
: «jjjj-mm-tt HH:MM»
Zeitsteuerung durch Enterprise-Manager : {yes|no}
Evaluierungszeitraum
: «Evaluierungszeitraum»
Evaluierungskalender
: «Kalendername»
Adhoc-Evaluierung
: {deaktiviert|nur bei neuem Inventar|immer}
Kapitel 3: cadsmcmd-Befehle 403
Kompatibilität
delete – Löschen von Software-Richtlinien
Mit dieser Aktion löschen Sie eine nicht versiegelte Software-Richtlinie.
Die Syntax der Aktion lautet folgendermaßen:
swPolicy action=delete
name=Name_der_Software-Richtlinie
[swpScope={distributed | local}]
Name
Name der zu löschenden Software-Richtlinie.
swpScope
Diese Option legt den für die Aktion verwendeten Typ der Softwarerichtlinie fest.
«nicht angegeben»
Wenn eine lokal erstellte Software-Richtlinie des angeforderten Namens
vorhanden ist, wird diese verwendet. Falls nicht, wird eine von einem
Enterprise-Manager verteilte Richtlinie gesucht. Letzteres ist nur auf DomänenManagern zulässig.
distributed
Die angegebene Software-Richtlinie muss auf dem Enterprise-Manager erstellt
und an den angegebenen Manager verteilt worden sein.
lokal
Die angegebene Softwarerichtlinie muss lokal erstellt worden sein.
Hinweis: Enterprise-Manager unterstützen nur Software-Richtlinien vom Typ
"lokal".
listViolators – Auflisten von Richtlinienverletzern einer unversiegelten Software-Richtlinie
Diese Aktion listet alle Richtlinienverletzer einer unversiegelten Software-Richtlinie auf.
Wenn die Richtlinie nicht versiegelt ist, wird die Anfrage abgelehnt.
Die Syntax der Aktion lautet folgendermaßen:
swPolicy action=listViolators
name=Name_der_Software-Richtlinie
[swpScope={distributed | local}]
[separator=Trennzeichen]
Name
Name der Software-Richtlinie, deren Richtlinienverletzer aufgelistet werden.
404 CLI-Referenzhandbuch
Kompatibilität
swpScope
Diese Option legt den für die Aktion verwendeten Typ der Softwarerichtlinie fest.
«nicht angegeben»
Wenn eine lokal erstellte Software-Richtlinie des angeforderten Namens
vorhanden ist, wird diese verwendet. Falls nicht, wird eine von einem
Enterprise-Manager verteilte Richtlinie gesucht. Letzteres ist nur auf DomänenManagern zulässig.
distributed
Die angegebene Software-Richtlinie muss auf dem Enterprise-Manager erstellt
und an den angegebenen Manager verteilt worden sein.
lokal
Die angegebene Softwarerichtlinie muss lokal erstellt worden sein.
Hinweis: Enterprise-Manager unterstützen nur Software-Richtlinien vom Typ
"lokal".
Trennzeichen
Das Trennzeichen ist ein Zeichen, das zum Trennen der verschiedenen
Ausgabefelder in den Zeilen der Auflistungen verwendet wird. Das standardmäßige
Trennzeichen ist ":" (Doppelpunkt).
Die Ausgabeliste mit dem Standardtrennzeichen sieht folgendermaßen aus:
---------------------------------------------------------------Liste der Richtlinienverletzer für Software-Richtlinie «Name der SoftwareRichtlinie»
Verknüpfte Computergruppe: «Name der Computergruppe»
---------------------------------------------------------------«Name von Richtlinienverletzer 1»:{Computer | Benutzerprofil}
•
•
•
«Name von Richtlinienverletzer n»:{Computer | Benutzerprofil}
targetcomputer – Zielcomputer-Befehle
Diese Methode ist nur für Domänen-Manager gültig.
Dieser Abschnitt enthält die folgenden Themen:
Allgemeine Aktionen (siehe Seite 406)
Jobmanagement-Befehle (siehe Seite 425)
Zielcomputer-Befehle mit Bezug zur BS-Installationsverwaltung (OSIM) (siehe Seite 449)
Kapitel 3: cadsmcmd-Befehle 405
Kompatibilität
Allgemeine Aktionen
Dieser Abschnitt enthält die folgenden Themen:
create – Zielcomputer erstellen (siehe Seite 406)
delete – Löschen eines Zielcomputers (siehe Seite 413)
list – Auflisten von Zielcomputern (siehe Seite 413)
modify – Bearbeiten von Zielcomputern (siehe Seite 417)
showAttr – Anzeigen von Attributen des Zielcomputers (siehe Seite 419)
create – Zielcomputer erstellen
Diese Aktion erstellt einen Zielcomputer auf dem Domänen-Manager.
Diese Aktion hat das folgende Format:
targetComputer action=create
name=Computername
computertype={machine|user profile| staging server | docking_device}
address=Adresse
[stagingserver=[Staging-Server-Name]
os=Name des Betriebssystems
[calendarname=Kalendername]
[user= Benutzer]
[phone=Telefon]
[location=Standort]
[comment=Kommentar] }
[softwaremanagedsystem [={y/n}] <Standard = n>]
[racpolicy={common | disabled | deferred | automatic} <default=common>]
[hostname=Hostname]
{[macaddress=Mac-Adresse] |
[bootserver=Boot-Server-Name] macaddress=Mac-Adresse
osimage=BS-Image-Name }
address
Gibt Folgendes an: network address des Computers.
bootserver
Gibt Folgendes an: Name des Boot-Servers, mit dem der Computer verbunden ist.
calendarname
Gibt Folgendes an: Name des Kalenders, der die Aktivitäten auf dem Zielcomputer
steuert
406 CLI-Referenzhandbuch
Kompatibilität
comment
Optionaler Parameter, bei dem Sie Ein Kommentar zum Computer eingeben
können.
Dabei kann es sich beispielsweise um Informationen handeln, die nicht in den
Computerattributen oder dem Installationsregister verfügbar sind.
Der Kommentar kann 255 Zeichen lang sein.
computertype
Eine ID, die einen der folgenden Typen besitzen kann.
machine
Das angegebene Ziel ist ein Computersystem. Es wird davon ausgegangen, dass
ein SD-Agent auf dem System installiert wird.
user profile
Legt ein Benutzerprofil für ein Zielcomputersystem fest.
Der Name des Benutzerprofils hat folgendes Format:
Computer/[Domäne/]Benutzer
So ergibt beispielsweise der Benutzer "john" auf dem System "doe" den Namen
"doe/john".
Der angegebene Computer muss beim Erstellen des Benutzerprofils bereits für
DSM definiert sein.
Der Typ "user_profile" ersetzt die früheren Typen "domain_user" und
"local_user", die nun nicht mehr benötigt werden. Wenn sie angegeben
werden, werden sie dem Typ "user_profile" zugeordnet.
Hinweis: Die folgenden Parameter werden von CADSMCMD ignoriert, wenn sie
für 'targetComputer action=create computerType="user profile"': aufgerufen
werden:
- Address
- bootServer
- hostName
- macAddress
- os
- osImage
- stagingserver
Staging-Server
Beim erstellten Zielcomputer handelt es sich um einen Scalability-Server. Es
wird davon ausgegangen, dass SD für dieses Ziel installiert wird.
Docking-Gerät
Kapitel 3: cadsmcmd-Befehle 407
Kompatibilität
Das erstellte Ziel ist ein Docking-Gerät. Es wird davon ausgegangen, dass es sich
bei der angegebenen Adresse um den Namen der Docking-Station handelt und
dass SD für die Systeme installiert wurde.
hostname
Gibt Folgendes an: Hostname des Computers.
Wenn dieser Parameter nicht angegeben wird, wird standardmäßig der Name des
Zielcomputers verwendet.
Hinweis: Der Parameter "HostName" kann nur so lange bearbeitet werden, wie das
angegebene Zielsystem noch nicht vom Netzwerk registriert wurde.
Wenn das System bereits registriert wurde, wird der Fehler "CMD00149" gemeldet:
"Das Ziel wurde bereits registriert. Der Vorgang ist nicht zulässig."
Standort
Wenn dieser Parameter angegeben ist, gibt er den Standort des Computers an..
macaddress
Gibt Folgendes an: MAC-Adresse des Systems.
Name
Gibt den Namen des Ziels an.
Der Name des Ziels entspricht je nach Wert des Parameters "computertype" einem
von vier Typen.
Bei der Angabe von "computertype={machine| staging server| docking device}"
handelt es sich beim Ziel um ein Computersystem, dessen Name dem Namen des
Computers im Netzwerk entspricht.
Wenn der Eintrag "computertype=user profile" lautet, setzt sich der Name des
Benutzerprofils aus dem Computernamen und der Benutzer-ID zusammen, die
durch einen Schrägstrich voneinander getrennt sind. Die Benutzer-ID kann die
Benutzer-ID des lokalen Computers oder eine Domänen-Benutzer-ID sein.
os
Gibt Folgendes an: Betriebssystemtyp des Ziels.
Informationen zu gültigen Werten für das BS finden Sie unter "Verwendung von
regproc".
Der bei der Erstellung eines Ziels festgelegte Wert (beispielsweise "Beliebige") wird
in aktuellen SD-Serverumgebungen bei der automatischen Registrierung durch den
aktuellen BS-Wert des Computers ersetzt.
408 CLI-Referenzhandbuch
Kompatibilität
Werte:
os={AIX|AIX_3.2_RS/6000|AIX_4.1_RS/6000
...|AIX_4.2_RS/6000|AIX_4.3_RS/6000
...|AIX_5.0_RS/6000|AIX_5.1_RS/6000
...|AIX_5.2_RS/6000|AIX_5.3_RS/6000
...|AIX_5.4_RS/6000|AIX_5.5_RS/6000
...|AIX_5.6_RS/6000|AIX_5.7_RS/6000
...|AIX_5.8_RS/6000|ANY|COMPAQ_TRU64_(DEC)
...|COMPAQ_TRU64_5.X_ALPHA
...|DEC_3.0_ALPHA|DEC_3.2_ALPHA
...|DEC_4.0_ALPHA|DGUX|DGUX_4.1_INTEL
...|DGUX_4.1_MC88|DGUX_4.2_INTEL
...|DOS|DRS/NX_7MP_SPARC|DRS/NX_7_SPARC
...|DRS/NX_SPARC|DYNIX|DYNIX_4.2.X_INTEL
...|DYNIX_4.4.X_INTEL|HPUX
...|HPUX_10|HPUX_10_700|HPUX_10_800
...|HPUX_11|HPUX_11I_V2|HPUX_11_700
...|HPUX_11_800|HPUX_11_IA64
...|HPUX_12|HPUX_12I_V2|HPUX_12_700
...|HPUX_12_800|HPUX_12_IA64
...|HPUX_9|HPUX_9_700|HPUX_9_800
...|IRIX|IRIX_6.2|IRIX_6.3
...|IRIX_6.4|IRIX_6.5|LINUX
...|LINUX_2.1_INTEL|LINUX_2.2_INTEL
...|LINUX_2.2_S/390|LINUX_2.3_INTEL
...|LINUX_2.3_S/390|LINUX_2.4_INTEL
...|LINUX_2.4_S/390|LINUX_2.5_INTEL
...|LINUX_2.5_S/390|LINUX_2.6_INTEL
...|LINUX_2.6_INTEL_64-BIT
...|LINUX_2.6_S/390|MACINTOSH
...|MACINTOSH_10.0_PPC|MACINTOSH_10.1_PPC
...|MACINTOSH_10.2_PPC|MACINTOSH_10.3_PPC
...|MACINTOSH_10.4_PPC|NCR_SST
...|NCR_SST_S4I_INTEL|NCR_SST_S4_INTEL
...|NCR_SV|NCR_SV_2X_INTEL
...|NCR_SV_3X_INTEL|NETWARE
...|NETWARE_3_INTEL|NETWARE_4_INTEL
...|NETWARE_5_INTEL|NETWARE_6_INTEL
...|NOKIA_ADMINSUITE|NOKIA_ADMINSUITE_1.0
...|OPENVMS|OPENVMS_5.5_VAX
...|OPENVMS_6.0_ALPHA|OPENVMS_6.0_VAX
...|OPENVMS_6.1_ALPHA|OPENVMS_6.1_VAX
...|OPENVMS_6.2_ALPHA|OPENVMS_6.2_VAX
...|OPENVMS_7.0_ALPHA|OPENVMS_7.0_VAX
...|OPENVMS_7.1_ALPHA|OPENVMS_7.1_VAX
...|OPENVMS_7.2_ALPHA|OPENVMS_7.2_VAX
...|OS/2_16-BIT|OS/2_32-BIT
...|PALM_OS|SCO|SCO_3.2_V5_INTEL
...|SCO_5.2_V5_INTEL|SINIX
Kapitel 3: cadsmcmd-Befehle 409
Kompatibilität
...|SINIX_5.42_R4000|SINIX_5.43_R4000
...|SINIX_5.44_R4000|SINIX_5.45_R4000
...|SOLARIS|SOLARIS_10_INTEL
...|SOLARIS_10_SPARC|SOLARIS_2.3_SPARC
...|SOLARIS_2.4_INTEL|SOLARIS_2.4_SPARC
...|SOLARIS_2.5_INTEL|SOLARIS_2.5_SPARC
...|SOLARIS_2.6_INTEL|SOLARIS_2.6_SPARC
...|SOLARIS_7_INTEL|SOLARIS_7_SPARC
...|SOLARIS_8_INTEL|SOLARIS_8_SPARC
...|SOLARIS_9_INTEL|SOLARIS_9_SPARC
...|SUNOS|SUNOS_4.1.4_SPARC
...|UNIX|UNIXWARE|UNIXWARE2.0_INTEL
...|UNIXWARE2.1_INTEL|UNIXWARE7.X_INTEL
...|WINDOWS_16-BIT|WINDOWS_32-BIT
...|WINDOWS_95|WINDOWS_98
...|WINDOWS_ME|WIN_2000|WIN_2000_INTEL
...|WIN_CE|WIN_CE_2.00_MIPS
...|WIN_CE_2.00_SH3|WIN_CE_2.01_MIPS
...|WIN_CE_2.01_SH3|WIN_CE_2.11_ARM
...|WIN_CE_2.11_MIPS|WIN_CE_2.11_SH3
...|WIN_CE_2.11_SH4|WIN_CE_3.00_ARM
...|WIN_CE_3.00_MIPS|WIN_CE_3.00_PPC2002_ARM
...|WIN_CE_3.00_SH3|WIN_CE_3.00_SH4
...|WIN_CE_4.20_MOBILE2003_ARM
...|WIN_LONGHORN_SERVER_INTEL
...|WIN_LONGHORN_SERVER_ITANIUM
...|WIN_LONGHORN_SERVER_X64
...|WIN_NT|WIN_NT_ALPHA|WIN_NT_INTEL
...|WIN_NT_MIPS|WIN_SERVER_2003
...|WIN_SERVER_2003_INTEL
...|WIN_SERVER_2003_ITANIUM
...|WIN_SERVER_2003_X64|WIN_VISTA_INTEL
...|WIN_VISTA_ITANIUM|WIN_VISTA_X64
...|WIN_XP|WIN_XP_INTEL|WIN_XP_ITANIUM
...|WIN_XP_X64}
Hinweis: Um eine aktuelle Liste unterstützter Betriebssysteme einschließlich deren
Versionen aufzurufen, geben Sie im detaillierten Modus die Befehle "regproc" oder
"targetcomputer action=create" ein.
410 CLI-Referenzhandbuch
Kompatibilität
osimage
Gibt Folgendes an: Name des BS-Image, das dem System zugewiesen ist, das in
einer geplanten Konfiguration erstellt wurde.
Vor Aktivierung der Konfiguration, die auf dem Zielcomputer installiert werden soll,
muss das BS-Image auf dem Boot-Server freigegeben werden, der mit dem
Zielcomputer verbunden ist.
Dieser Parameter sollte nur mit dem Parameter "macAddress" angegeben werden.
Wenn die Installationsreihenfolge vorab bereitgestellt werden muss, muss auch der
Parameter "bootserver" angegeben werden.
phone
Wenn dieser Parameter angegeben ist, gibt er den Telefonnummer oder E-MailAdresse an. des Computerbenutzers an.
racpolicy
Optionaler Parameter, der die RAC-Richtlinie (Reinstall after crash; Neuinstallation
nach Absturz) des Systems festlegt.
Folgende Werte können verwendet werden:
common
Für diesen Computer wird die allgemeine Richtlinie verwendet.
disabled
RAC ist auf diesem Computer deaktiviert. Für den Computer wird kein
Jobcontainer eingerichtet. Seine Installationsdatensätze im Installationsordner
auf dem SD-Server werden jedoch als entfernt gekennzeichnet, wenn der SDAgent des Computers eine neue BS-Installation meldet (durch eine geänderte
UUID).
deferred
Ein RAC-Jobcontainer wird erstellt. Da dieser Container manuell aktiviert
werden muss, kann er auch überprüft und bearbeitet werden.
automatic
Ein RAC-Jobcontainer, der die Lieferung von Jobaufträgen an den Computer
startet, wird erstellt und aktiviert.
Standard = common.
Hinweis: Wenn Sie versuchen, die RAC-Richtlinie eines Computers zu ändern, der
sich im Offline-Modus befindet, führt der Befehl "cadsmcmd targetComputer
action=modify" zu einer Fehlermeldung.
softwaremanagedsystem
Dieser optionale Parameter kennzeichnet einen Zielcomputer als
softwareverwaltetes System.
Kapitel 3: cadsmcmd-Befehle 411
Kompatibilität
stagingserver
Gibt Folgendes an: Name des Scalability-Servers.
Wenn dieser Parameter angegeben ist, wird davon ausgegangen, dass die
Verbindung mit dem zu erstellenden Zielcomputer mit Hilfe des angegebenen
Scalability-Servers hergestellt wird. Der Scalability-Server muss bereits in SD
angemeldet sein.
Hinweis: Wenn diese Optionen nicht angegeben wird, wird der Domänen-Manager
der Standard-Scalability-Server.
Benutzer
Wenn dieser Parameter angegeben ist, gibt er den Name des Benutzers an..
Hinweis: Verwenden Sie für die Vorregistrierung der von OSIM zu verwaltenden
Computern die Befehle "macaddress" und "osimage" mit targetcomputer action=create.
Beispiel:
Normalerweise werden Zielsysteme den SD-Servern hinzugefügt, wenn der Agent
installiert und die erste Jobprüfung ausgeführt wird. Auf diese Weise können
Softwarepakete dem neuen System nur hinzugefügt werden, wenn sie im Netzwerk
registriert wurden.
In manchen Fällen ist es besser, die Software für das neue System im Voraus
bereitzustellen. Hierzu müssen die neuen Systeme der Manager-Datenbank manuell
hinzugefügt werden.
Nach dem Hinzufügen können sie für Softwarevorlagen oder die Joblieferung verwendet
werden. Dennoch können Jobs erst geliefert werden, nachdem die Systeme im
Netzwerk registriert wurden.
Angenommen, das System "newComp" soll manuell im Manager erstellt werden und
den folgenden Anforderungen entsprechen:
Das System ist mit dem Scalability-Server "stage_01" verbunden.
■
Die Adresse des Systems ist newComp.myCompany.com.
■
Das Betriebssystem ist Windows&#160;XP Professional für Intel.
■
Es ist ein softwareverwaltetes System.
Mit dem folgenden Befehl wird dieses System dem Server hinzugefügt:
cadsmcmd targetcomputer action=create name=newComp address=newComp.myCompany.com
os=WIN_XP_INTEL computerType=machine softwareManagedSystem stagingServer=stage_01
412 CLI-Referenzhandbuch
Kompatibilität
delete – Löschen eines Zielcomputers
Mit dieser Aktion wird ein Ziel aus dem Domänen-Manager gelöscht.
Diese Aktion hat das folgende Format:
targetcomputer action=delete
name=Computername
Name
Gibt Folgendes an: Name des Ziels, das gelöscht werden soll.
list – Auflisten von Zielcomputern
Mit dieser Aktion wird eine Liste der Ziele angezeigt, die dem System bekannt sind.
Mit einem zusätzlichen Filter kann die Liste auf die Ziele beschränkt werden, die den
Filterkriterien entsprechen. Wenn keine Filter angegeben werden, wird die vollständige
Liste der Ziele angezeigt. Der Filter ist auf 100&#160;Byte beschränkt.
Hinweis: Die Verwendung des Filters bei dieser Aktion unterscheidet sich von der bei
anderen Befehlen.
Diese Aktion hat das folgende Format:
targetcomputer action=list
[{filter=Filter |filterfile=Dateiname}]
[{DisHwOnly | usrProfOnly | UnMgdPcOnly}]
filter
Gibt Folgendes an: Ausdruck, um die Anzahl der aufgelisteten Informationen
einzuschränken
Die folgenden Attribute können zur Erstellung elementarer Filterausdrücke
verwendet werden:
Attribut
Typ
Compare ops
Computername
Zeichenfolge
=, !=, <, <=, >, >=
Computertyp
{ Computer |
Benutzerprofil |
Staging-Server |
Docking-Gerät}
=, !=
Hostname
Zeichenfolge
=, !=, <, <=, >, >=
Primäre Netzwerkadresse
Zeichenfolge
=, !=, <, <=, >, >=
IP-Adresse
Zeichenfolge
=, !=, <, <=, >, >=
Kapitel 3: cadsmcmd-Befehle 413
Kompatibilität
Attribut
Typ
Compare ops
Betriebssystemtyp
beliebiger gültiger BS-Typ
des BS-Parameters der
Aktion "create"
=, !=
Kalendername
Zeichenfolge
=, !=, <, <=, >, >=
Eigentümer
Zeichenfolge
=, !=, <, <=, >, >=
Telefon
Zeichenfolge
=, !=, <, <=, >, >=
Standort
Zeichenfolge
=, !=, <, <=, >, >=
Kommentar
Zeichenfolge
=, !=, <, <=, >, >=
Staging-Server-Name
Zeichenfolge
=, !=, <, <=, >, >=
Softwareverwaltetes System
{ yes | no }
=, !=
RAC-Richtlinie
{ automatisch |
allgemein |
zurückgestellt |
deaktiviert | offline}
=, !=
Erstellungsdatum
JJJJ-MM-TT HH:MM:SS
=, !=, <, <=, >, >=
Änderungsdatum
JJJJ-MM-TT HH:MM:SS
=, !=, <, <=, >, >=
Bei der Erstellung eines Filters muss bei den Attributnamen in den Atomic-Ausdrücken die Groß-/Kleinschreibung
beachtet werden.
JJJJ-MM-TT HH:MM:SS steht für eine zusammengesetzte Angabe von Uhrzeit und Datum im ISO-Format.
Die Werte für Attribute des Typs "string" können Platzhalter enthalten.
"*" oder "?", wobei "*" für eine beliebige, selbst leere Zeichenfolge steht, während "?" für ein einzelnes, aber
beliebiges Zeichen steht. Wenn ein "*" oder "?" nicht als Platzhalter interpretiert werden soll, muss ein Apostroph
(') vorangestellt werden. Um Mehrdeutigkeiten zu vermeiden, müssen Apostrophe als Teil des Attributwertes
dupliziert werden.
414 CLI-Referenzhandbuch
Kompatibilität
filterfile
Gibt Folgendes an: Name der Datei, die die Filterbefehle enthält.
Die Befehle der Datei werden auf die gleiche Weise festgelegt wie im Parameter
"Filter". Die Kapazität der Datei wird jedoch durch die Kapazität des den Befehl
ausführenden Systems begrenzt..
{DisHwOnly | UsrProfOnly | UnMgdPcOnly}
Diese Optionen werden verwendet, um die Suche auf Informationen zu
beschränken, an denen der Benutzer interessiert ist. Wenn dieser Parameter nicht
angegeben ist, wird eine Liste von Computern, Benutzerprofilen, Scalability-Servern,
Docking-Geräten und nicht durch OSIM verwalteten Computern bereitgestellt, und
alle zugehörigen Datenbanktabellen werden durchsucht.
DisHwOnly
Die Liste ist beschränkt auf registrierte Hardware, wie Computer, ScalabilityServer und Docking-Geräte.
UsrProfOnly
Die Liste ist ausschließlich auf Benutzerprofile beschränkt.
UnMgdPcOnly
Die Liste ist ausschließlich auf nicht durch OSIM verwaltete Computer
beschränkt.
Beispiel:
Geben Sie den folgenden Befehl ein, um alle auf einem Domänen-Manager definierten
Ziele aufzulisten:
cadsmcmd targetComputer action=list
Die zur Verfügung gestellte Liste könnte nun wie folgt aussehen:
------------------------------------------------------------------------------Liste der Zielcomputer
------------------------------------------------------------------------------PPAPPGP0C (computer; Win NT Intel 4.0.1381)
newComp (computer; Win XP Intel)
HHHHH01B (computer; Win NT Intel 4.0.1381)
KKKKK01A (computer; Win NT Intel 4.0.1381)
stage_01 (staging server; Win 2000 Intel 5.0.2195)
Kapitel 3: cadsmcmd-Befehle 415
Kompatibilität
ORIONXH (computer; Win XP Intel 5.1.2600)
PPPPP98 (computer; Windows&#160;98 4.10.2222)
WWWWW01B (computer; Win 2000 Intel 5.0.2195)
--------------------------------------------------------------------------------------------------------------------------------------------------Liste der unbenannten und nicht vom BMS verwalteten Computer
--------------------------------------------------------------------------------------------------------------------------------------------------Gesamtzahl der Zielcomputer: 8
Anzahl der unbenannten und nicht vom BMS verwalteten Systeme: 0
SDCMD<A000000>: OK
Geben Sie den folgenden Befehl ein, um mit Hilfe von Filtern alle auf einem DomänenManager definierten Ziele aufzulisten, deren Staging-Server "stage01-ss" und deren Typ
"computer" lautet:
cadsmcmd targetcomputer action=list filter="(staging server name=stage01-ss &&
Computer type=computer)"
Die Informationen werden wie folgt aufgelistet:
-------------------------------------------------------------------------Liste der Zielcomputer
------------------------------------------------------------------------Test01(computer; WIN_SERVER_2003_INTEL)
-------------------------------------------------------------------------Liste der unbenannten und nicht vom BMS verwalteten Computer
--------------------------------------------------------------------------------------------------------------------------------------------------Gesamtzahl der Zielcomputer: 1
Anzahl der unbenannten und nicht vom BMS verwalteten Systeme: 0
SDCMD<A000000>: OK
416 CLI-Referenzhandbuch
Kompatibilität
modify – Bearbeiten von Zielcomputern
Diese Aktion ändert die Attribute des Zielcomputers.
Diese Aktion hat das folgende Format:
targetcomputer action=modify name=Computername
[address=Netzwerkadresse]
[calendarname=Kalendername]
[user=Benutzername]
[phone=Telefon]
[location=Standort]
[comment=Kommentar]
[softwareManagedSystem={y|n}]
[racpolicy={automatic|common|deferred|disabled}]
[downloadMethod={NOS|NOSLESS|DTS}]
address
Gibt Folgendes an: network address.
Dieser Eintrag sollte keine leere Zeichenfolge sein.
calendarname
Gibt Folgendes an: Name des Kalenders, der die Aktivitäten auf dem Zielcomputer
steuert
Hinweis: Wenn eine leere Zeichenfolge eingegeben wird, wird davon ausgegangen,
dass kein Kalender vorhanden ist.
comment
Gibt an: Ein Kommentar.
Wenn eine leere Zeichenfolge eingegeben wird, wird davon ausgegangen, dass kein
Kommentar vorhanden ist.
downloadMethod
Optionaler Parameter.
Wenn diese Option codiert ist, wird die Download-Methode des angesprochenen
Zielsystems wie folgt geändert:
NOS
"Intern - NOS"
NOSLESS
"Intern - ohne NOS"
DTS
"DTS - ohne NOS"
Wenn die Option nicht codiert ist, bleibt die Download-Methode unverändert.
Kapitel 3: cadsmcmd-Befehle 417
Kompatibilität
Standort
Gibt Folgendes an: Standort des Computers.
Wenn eine leere Zeichenfolge eingegeben wird, wird davon ausgegangen, dass kein
Standort vorhanden ist.
name
Gibt Folgendes an: Name des Ziels, der geändert werden soll.
phone
Gibt Folgendes an: Telefonnummer oder E-Mail-Adresse des Benutzers. Wenn eine
leere Zeichenfolge eingegeben wird, wird davon ausgegangen, dass keine
Telefonnummer oder E-Mail-Adresse vorhanden ist.
racpolicy
Optionaler Parameter, der die RAC-Richtlinie (Reinstall after crash; Neuinstallation
nach Absturz) des Systems festlegt.
Folgende Werte können verwendet werden:
common
Für diesen Computer wird die allgemeine Richtlinie verwendet.
disabled
RAC ist auf diesem Computer deaktiviert. Für den Computer wird kein
Jobcontainer eingerichtet. Seine Installationsdatensätze im Installationsordner
auf dem SD-Server werden jedoch als entfernt gekennzeichnet, wenn der SDAgent des Computers eine neue BS-Installation meldet (durch eine geänderte
UUID).
deferred
Ein RAC-Jobcontainer wird erstellt. Da dieser Container manuell aktiviert
werden muss, kann er auch überprüft und bearbeitet werden.
automatic
Ein RAC-Jobcontainer, der die Lieferung von Jobaufträgen an den Computer
startet, wird erstellt und aktiviert.
Standard = common.
Hinweis: Wenn Sie versuchen, die RAC-Richtlinie eines Computers zu ändern, der
sich im Offline-Modus befindet, führt der Befehl "cadsmcmd targetComputer
action=modify" zu einer Fehlermeldung.
softwareManagedSystem
Wenn "softwareManagedSystem=y", dann wird das System als ein
softwareverwaltetes System betrachtet. Wenn "softwareManagedSystem=n", dann
wird es nicht mehr als softwareverwaltetes System betrachtet.
Anwender
418 CLI-Referenzhandbuch
Kompatibilität
Gibt Folgendes an: Name des Benutzers.
Wenn eine leere Zeichenfolge eingegeben wird, wird davon ausgegangen, dass kein
Benutzernameneintrag vorhanden ist.
Hinweis: Wenn ein Parameter nicht angegeben wird, bleibt das entsprechende
Zielcomputerattribut unverändert.
Beispiel:
Angenommen, die folgenden Attribute des Zielcomputers "newComp" müssen geändert
werden:
■
Der Speicherort ist "Pdb".
■
Der Benutzer ist "joe".
■
Die E-Mail-Adresse des Benutzers lautet joe@myComp.com
Der folgende Befehl enthält die Änderungen:
cadsmcmd targetComputer action=modify name=newComp location=Pdb user=joe
phone=joe@myComp.com
showAttr – Anzeigen von Attributen des Zielcomputers
Diese Aktion zeigt die Attribute des Computersystems an.
Diese Aktion hat das folgende Format:
targetcomputer action=showattr
name=Computername
Name
Gibt Folgendes an: Name des Ziels, dessen Attribute angezeigt werden.
Es werden die folgenden Informationen angezeigt:
------------------------------------------------------------------------------Attribute des Zielcomputers anzeigen
------------------------------------------------------------------------------Computername
Computertyp
Hostname
Primäre Netzwerkadresse
IP-Adresse
Betriebssystemtyp
Kapitel 3: cadsmcmd-Befehle 419
Kompatibilität
Eigentümer
Telefon
Standort
Kommentar
Staging-Server-Name
Kalendername
Softwareverwaltetes System
RAC-Richtlinie
Erstellungsdatum
Erstellungszeit
Änderungsdatum
Änderungszeitpunkt
MAC-Adresse
Aktuelle Konfiguration*
Aktivierte Konfiguration*
Aktivierungszeit*
Status*
Aktivierung*
Neustart*
Auf Server warten*
Auf Image warten*
Geplante Konfiguration*
Verbunden mit Boot-Server*
Ist Boot-Server
* Diese Informationen werden angezeigt, wenn das System vom BS-InstallationsManager verwaltet wird.
Beispiel:
Der folgende Befehl stellt die Liste der Attribute des Zielcomputers "newComp" bereit:
cadsmcmd targetComputer action=showattr name=newComp
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.
420 CLI-Referenzhandbuch
Kompatibilität
------------------------------------------------------------------------------Attribute des Zielcomputers anzeigen
------------------------------------------------------------------------------Computername...........................: newComp
Computertyp.............................: computer
Netzwerkadresse.......................: newComp.myComp.com
Betriebssystem..........................: Win XP Intel
Betriebssystemtyp........................: WIN_XP
Kalendername...........................:
Eigentümer...........................:
Telefon................................:
Standort...............................:
Kommentar.............................:
Staging-Server-Name...................: stage_01
Softwareverwaltetes System.............: Ja
RAC-Richtlinie........................: common
Erstellungsdatum..........................: 2005-04-15
Erstellungszeitpunkt..........................: 15:43
Änderungsdatum............................: 2005-04-15
Änderungszeitpunkt............................: 15:43
Ist Boot-Server.......................: Nein
sdcmd<a000000>: OK
Kapitel 3: cadsmcmd-Befehle 421
Kompatibilität
Beispiel für Nicht-ADS-Geräte:
------------------------------------------------------------------------------Attribute des Zielcomputers anzeigen
------------------------------------------------------------------------------Computername...........................: mySystem
Computertyp.............................: computer
Hostname...............................: mySystem
Primäre Netzwerkadresse...............: mySystem.myCompany.com
IP-Adresse.............................:
Betriebssystemtyp........................: ALLE
Eigentümer...........................:
Standort...............................:
Telefon................................:
Kommentar.............................:
Staging-Server-Name...................: my-DSM-stage
Kalendername...........................:
Softwareverwaltetes System.............: Nein
RAC-Richtlinie........................: common
Erstellungsdatum..........................: 2006-09-20
Erstellungszeitpunkt..........................: 16:42:39
Änderungsdatum............................: 2006-09-20
Änderungszeitpunkt............................: 16:42:41
MAC-Adresse............................: FF:01:23:45:67:8A
Ist ADS-Gerät..........................: Nein
Aktuelle Konfiguration.................:
Aktivierte Konfiguration................:
Geplante Konfiguration................: myWinXP
Verbunden mit Boot-Server...........: my-DSM-stage
Ist Boot-Server.......................: Nein
422 CLI-Referenzhandbuch
Kompatibilität
Beispiel für die Attribute eines ADS-verwalteten Systems:
------------------------------------------------------------------------------Attribute des Zielcomputers anzeigen
------------------------------------------------------------------------------Computername...........................: name=myADSdevice
Computertyp.............................: computer
Hostname...............................: name=myADSdevice
Primäre Netzwerkadresse...............: name=myADSdevice.myCompany.com
IP-Adresse.............................:
Betriebssystemtyp........................: ALLE
Eigentümer...........................:
Standort...............................:
Telefon................................:
Kommentar.............................:
Staging-Server-Name...................: myManager
Kalendername...........................:
Softwareverwaltetes System.............: Nein
RAC-Richtlinie........................: common
Erstellungsdatum..........................: 2006-09-20
Erstellungszeitpunkt..........................: 13:57:12
Änderungsdatum............................: 2006-09-20
Änderungszeitpunkt............................: 13:57:14
MAC-Adresse............................: FF:01:23:45:67:89
Ist ADS-Gerät..........................: Ja
ADS-Server-Name.......................: myADSserver.ADSnet.myCompany.com
Ist Boot-Server.......................: Nein
Kapitel 3: cadsmcmd-Befehle 423
Kompatibilität
Beispiel für die Attribute eines OSIM-verwalteten Systems:
012: targetcomputer action=showattr name=HUMPFA
Befehl wird verarbeitet...
------------------------------------------------------------------------------Attribute des Zielcomputers anzeigen
------------------------------------------------------------------------------Computername...........................: HUMPFA
Computertyp.............................: computer
Netzwerkadresse.......................: HUMPFA.ca.com
Betriebssystem..........................: Windows
Betriebssystemtyp........................: WINDOWS_16-BIT
Kalendername...........................:
Eigentümer...........................:
Telefon................................:
Standort...............................:
Kommentar.............................:
Name des Scalability-Servers.......:
Softwareverwaltetes System.............: Nein
RAC-Richtlinie........................: common
Erstellungsdatum..........................: 2005-03-27
Erstellungszeitpunkt..........................: 11:04
Änderungsdatum............................: 2005-03-27
Änderungszeitpunkt............................: 11:04
MAC-Adresse............................: 11.22.33.44.55.77
Aktuelle Konfiguration.................:
Aktivierte Konfiguration................: w2kp_ger
..Aktivierungszeitpunkt......................: 2005-03-27 11:00:47
..Status...............................: stopped
..Aktivierung..............................: 1
..Neustart..............................: 1
..Auf Server warten......................: 0
..Auf Image warten.......................: 0
Geplante Konfiguration................:
Verbunden mit Boot-Server...........:
Ist Boot-Server.......................: Nein
sdcmd<A000000>: OK
424 CLI-Referenzhandbuch
Kompatibilität
Das Attribut "Aktivierung" gibt an, ob der Computer hochgefahren wird, und das
Attribut "Neustart" gibt an, ob ein automatischer Neustart geplant ist.
Wenn die Attribute "Aktivieren" oder "Neustart" eingerichtet wurden, wird "1"
angezeigt, anderenfalls "0".
Wenn "Erforderlich" für "Auf Server warten" angezeigt wird, wird die BSInstallationsanforderung zurückgestellt, bis das Ziel einem Boot-Server zugewiesen wird.
Wenn "Warten" angezeigt wird, ist die Anforderung zwar fällig, wurde jedoch aufgrund
des fehlenden Boot-Servers zurückgestellt.
Wenn der Eintrag "Auf Server warten" fehlt, wurde entweder keine Verzögerung
gefordert oder es wurde bereits ein Boot-Server zugewiesen.
Wenn "Erforderlich" für "Auf Image warten" angezeigt wird, wird die BS-Anforderung
zurückgestellt, bis die zugehörigen Boot- und BS-Images auf dem zugehörigen BootServer bereitgestellt wurden.
Wenn "Auf Boot-Image warten" angezeigt wird, wurde das zugehörige Boot-Image nicht
auf dem Boot-Server bereitgestellt, und die Anforderung wird zurückgestellt, auch wenn
sie bereits fällig ist.
Wenn "Auf BS-Image warten" angezeigt wird, steht das zugehörige BS-Image noch nicht
auf dem Boot-Server bereit, und die Anforderung wird zurückgestellt, auch wenn sie
bereits fällig ist.
Wenn der Eintrag "Auf Image warten" nicht angezeigt wird, wurde entweder für die
Anforderung keine Verzögerung festgelegt oder alle erforderlichen Images stehen auf
dem Boot-Server zur Verfügung.
Jobmanagement-Befehle
Dieser Abschnitt enthält die folgenden Themen:
activateJobCheck – Aktivieren des Jobprüfungsprogramms (siehe Seite 426)
activateStageCheck – Aktivieren des Phasenprüfungsprogramms (siehe Seite 426)
listFailedJobs – Auflisten von fehlgeschlagenen zum Zielcomputer gehörigen Jobs (siehe
Seite 426)
listInst – Auflisten installierter Produkte (siehe Seite 430)
listJobs – Auflisten von zum Zielcomputer gehörigen Jobs (siehe Seite 434)
listMembership – Auflisten von Mitgliedschaften des Zielcomputers (siehe Seite 439)
reinstallProduct – Neuinstallation des Produkts (siehe Seite 440)
removeJob – Entfernen von Jobs aus der Jobliste (siehe Seite 446)
showJobAttr – Anzeigen von Jobattributen (siehe Seite 447)
Kapitel 3: cadsmcmd-Befehle 425
Kompatibilität
activateJobCheck – Aktivieren des Jobprüfungsprogramms
Diese Aktion startet das Jobprüfungsprogramm. Der Agent auf dem ausgewählten
Computer nimmt Kontakt zu seinem Domänen-Manager auf, um zu überprüfen, ob
wartende Jobs vorhanden sind, und um Änderungen der Computerattribute zu melden.
Sie wartet die Fertigstellung nicht ab.
Die Aktion besitzt das folgende Format:
targetcomputer action=activateJobCheck
computer=Name
computer
Gibt den Namen des Computers an, auf dem das Jobprüfungsprogramm gestartet
wird.
activateStageCheck – Aktivieren des Phasenprüfungsprogramms
Diese Aktion startet das Phasenprüfungsprogramm, das eine Prüfung auf ausstehende
Aufträge initiiert.
Sie wartet die Fertigstellung nicht ab.
Diese Aktion hat das folgende Format:
targetcomputer action=activatestagecheck
computer=Name
computer
Gibt den Namen des Computers an, auf dem das Phasenprüfungsprogramm
aktiviert wird.
listFailedJobs – Auflisten von fehlgeschlagenen zum Zielcomputer gehörigen Jobs
Diese Aktion listet alle mit diesem Zielcomputer verbundenen fehlgeschlagenen Jobs
auf. Um die Menge der angezeigten Daten einzuschränken, kann ein Filter festgelegt
werden.
Diese Aktion hat das folgende Format:
targetcomputer action=listFailedJobs
name=Computername
[{alt |
{filter=Filter|filterfile=Dateiname}
[detailed]}]
426 CLI-Referenzhandbuch
Kompatibilität
alt
Es wird eine alternative Ausgabeliste ausgegeben.
Eine alternative Liste wird nur auf der Grundlage des Namens und der Version des
Elements bereitgestellt.
Bei der Angabe dieses Parameters können der Wert des Elements und der
Parameter "version" datenbankgestützte Platzhalter enthalten, zum Beispiel
"%"
für eine beliebige, selbst leere Zeichenfolge
"_"
für ein beliebiges einzelnes Zeichen
Für Microsoft SQL Server haben die eckigen Klammern ("[","]") eine besondere
Bedeutung. Dies muss beim Codieren des Namens berücksichtigt werden.
detailed
Informationen werden detailliert aufgelistet
filter
Gibt Folgendes an: Ausdruck, um die Anzahl der aufgelisteten Informationen
einzuschränken
Informationen zu Attributen, die für die Erstellung von Atomic-Filterausdrücke
gültig sind, finden Sie unter der Aktion "listjobs".
filterfile
Gibt Folgendes an: Name der Datei, die die Filterbefehle enthält.
Die Befehle der Datei werden auf die gleiche Weise festgelegt wie im Parameter
"Filter". Die Kapazität der Datei wird jedoch durch die Kapazität des den Befehl
ausführenden Systems begrenzt.
Name
Gibt Folgendes an: Name des Computers, dessen fehlgeschlagene Jobs aufgelistet
werden.
Kapitel 3: cadsmcmd-Befehle 427
Kompatibilität
Beispiele
Das Starten des folgenden Befehls:
cadsmcmd targetComputer action=listFailedJobs name=comp1
ergibt folgende Ausgabe:
------------------------------------------------------------------------------Liste der fehlgeschlagenen Jobs für Computer "comp1"
------------------------------------------------------------------------------tstkpk02 1.0:instCrash (AUSFÜHRUNGSFEHLER)
Gesamtzahl der gelesenen Jobs: 5
Gesamtzahl der angezeigten Aufträge 1
SDCMD<A000000>: OK
Durch Starten des Befehls
cadsmcmd targetComputer action=listFailedJobs name=comp1 detailed
wird folgende Liste dargestellt:
------------------------------------------------------------------------------Liste der fehlgeschlagenen Jobs für Computer "comp1"
(detailliert)
------------------------------------------------------------------------------Computerjob-ID..........................: 0C42D0D1-3E32-4974-8F47-E7220805BC4A
..Jobname..............................: tstkpk02 1.0:instCrash
..Elementname........................: tstkpk02
..Elementversion.........................: 1.0
..Prozedurname..........................: instCrash
..Computer-Installationsprozedur.......: instCrash
..Angefordert von.....................: winnt://comp1/administrator
..Erstellt am...........................: 2006-10-19 15:41
..Gestartet am...........................: 2006-10-19 15:41
..Beendet am........................: 2006-10-19 15:41
..Status...............................: AUSFÜHRUNGSFEHLER
..Fehlerursache..........................: 228001
..Fehlermeldung.........................: Beendigungscode 2 deutet auf mögliche
Fehler hin
..Jobausgabe.........................: Für diesen Job ist keine Ausgabe verfügbar
Gesamtzahl der gelesenen Jobs: 5
Gesamtzahl der angezeigten Aufträge 1
SDCMD<A000000>: OK
428 CLI-Referenzhandbuch
Kompatibilität
Und durch Starten des folgenden Befehls:
cadsmcmd targetComputer action=listFailedJobs name=comp% alt
wird folgende Liste dargestellt:
------------------------------------------------------------------------------Liste der fehlgeschlagenen Jobs "comp%"
------------------------------------------------------------------------------Ziel......................................: comp0
..Jobname.............................: tstkpk01 1.0: inst
..Job-ID................................: 23131B7D-AAE2-4878-A33B-563E473FF37E
..Elementname........................: tstkpk01
..Elementversion.........................: 1.0
..Prozedurname..........................: inst
..Task.................................: install
..Benutzerparameter...................:
..Jobstatus............................: DELIVERY_ERROR
..Fehlercode...........................: 228432
..Fehlermeldung.........................: Senden der Meldung an Computer <130.11
.........................................+ 9.101.163> fehlgeschlagen.
..Erstellungsdatum........................: 2006-10-20
..Erstellungszeitpunkt........................: 17:16
..Aktivierungsdatum......................: 2006-10-20
..Aktivierungszeitpunkt......................: 17:15
..Beendigungsdatum......................: 2006-10-20
..Beendigungszeit......................: 17:16
Ziel......................................: comp1
..Jobname..............................: tstkpk02 1.0:instCrash
..Job-ID................................: 0C42D0D1-3E32-4974-8F47-E7220805BC4A
..Elementname........................: tstkpk02
..Elementversion.........................: 1.0
..Prozedurname..........................: instCrash
..Task.................................: install
..Benutzerparameter...................:
..Jobstatus............................: AUSFÜHRUNGSFEHLER
..Fehlercode...........................: 228001
..Fehlermeldung........................: 2
..Erstellungsdatum........................: 2006-10-19
..Erstellungszeitpunkt........................: 15:41
..Aktivierungsdatum......................: 2006-10-19
..Aktivierungszeitpunkt......................: 15:41
..Beendigungsdatum......................: 2006-10-19
..Beendigungszeit......................: 15:41
------------------------------------------------------------------------------Gesamtzahl der Elemente: 2
SDCMD<A000000>: OK
Kapitel 3: cadsmcmd-Befehle 429
Kompatibilität
Geben Sie den folgenden Befehl ein, um mit Hilfe von Filtern eine Liste der
fehlgeschlagenen Jobs für Computer "test01" mit dem Jobstatus "Execution_Error"
anzuzeigen:
cadsmcmd targetcomputer action=listfailedjobs name=test01 filter="Job
state=EXECUTION_ERROR"
Die folgende Ausgabe wird zurückgegeben:
-------------------------------------------------------------------------Liste der fehlgeschlagenen Jobs für Computer "test01"
-------------------------------------------------------------------------CA DSM Agent + AM, RC, SD Plugin(s) (ENU) Win32 12.0.0.4860:Install
(EXECUTION_ERROR)
CA DSM Agent + AM, RC, SD Plugin(s) (ENU) Win32 12.0.0.4860:Install
(EXECUTION_ERROR)
CA DSM Agent + AM, RC, SD Plugin(s) (ENU) Win32 12.0.0.4860:Install
(EXECUTION_ERROR)
Gesamtzahl der gelesenen Jobs: 16
Gesamtzahl der angezeigten Aufträge 3
SDCMD<A000000>: OK
listInst – Auflisten installierter Produkte
Diese Aktion listet die Installationen auf dem Zielcomputer auf.
Diese Aktion hat das folgende Format:
targetcomputer action=listinst
name=Computername
[detailed]
detailed
Informationen werden detailliert aufgelistet
Name
Gibt Folgendes an: Name des Computers, dessen Softwareinstallationen aufgelistet
werden.
430 CLI-Referenzhandbuch
Kompatibilität
Beispiel:
Geben Sie den folgenden Befehl ein, um eine kurze Liste aller Installationen auf dem
Zielcomputer "KKKKK01B" zu erhalten.
cadsmcmd targetComputer action=listInst name=KKKKK01B
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
Verbindung zu Manager "<Standard-Manager>" als Benutzer "<Standardbenutzer>" wird
hergestellt... OK.
Manager: myManager
Domäne: myDomain
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
------------------------------------------------------------------------------Liste der installierten Programme auf dem Zielcomputer "KKKKK01B"
------------------------------------------------------------------------------SD-Scalability-Server für WinNT/W2K 4.0 ENU (I386): Scalability-Server
(EXECUTION_OK)
CA ITCM-Explorer für WinNT/W2K 4.0 ENU (I386): Lokal (EXECUTION_OK)
SD-Agent für WinNT/W2K 4.0 ENU (I386): Agent (EXECUTION_OK)
SD-Server für WinNT/W2K 4.0 ENU (I386): (EXECUTION_OK)
tstbase 1.0: inst (EXECUTION_OK)
Data Transport Service für Win32 2.0 SP1 ENU: DTS (EXECUTION_OK)
tstkpk03 1.0: inst (EXECUTION_OK)
tstkpk02 1.0: instCrash (EXECUTION_OK)
------------------------------------------------------------------------------Gesamtzahl der gefundenen Installationen: 8
Gesamtzahl der angezeigten Installationen: 8
SDCMD<A000000>: OK
Kapitel 3: cadsmcmd-Befehle 431
Kompatibilität
Geben Sie den folgenden Befehl ein, um eine detailliertere Liste zu erhalten:
cadsmcmd targetComputer action=listInst name=KKKKK01B detailed
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 installierten Programme auf dem Zielcomputer "KKKKK01B"
(detailliert)
------------------------------------------------------------------------------Computerjob-ID................: 5107
..Jobname..............................:
..Elementname........................: SD-Scalability-Server für WinNT/W2K
..Elementversion.....................: 4.0 DEU (I386)
..Prozedurname..........................: Scalability-Server
..Angefordert von.....................: System
..Erstellt am...........................: 2005-04-15 10:42
..Gestartet am...........................: 2005-04-15 10:42
..Installiert am.........................: 2005-04-15 10:42
Computerjob-ID................: 5113
..Jobname..............................:
..Elementname........................: CA ITCM-Explorer für WinNT/W2K
..Elementversion.....................: 4.0 DEU (I386)
..Prozedurname..........................: Lokal
..Angefordert von.....................: System
..Erstellt am...........................: 2005-04-15 10:42
..Gestartet am...........................: 2005-04-15 10:42
..Installiert am.........................: 2005-04-15 10:42
432 CLI-Referenzhandbuch
Kompatibilität
Computerjob-ID................: 5110
..Jobname..............................:
..Elementname........................: SD-Agent für WinNT/W2K
..Elementversion.....................: 4.0 DEU (I386)
..Prozedurname..........................: Agent
..Angefordert von.....................: System
..Erstellt am...........................: 2005-04-15 10:42
..Gestartet am...........................: 2005-04-15 10:42
..Installiert am.........................: 2005-04-15 10:42
Computerjob-ID................: 5104
..Jobname..............................:
..Elementname........................: SD-Server für WinNT/W2K
..Elementversion.....................: 4.0 DEU (I386)
Computerjob-ID................: 5418
..Jobname.............................: tstbase 1.0: inst
..Elementname........................: tstbase
..Elementversion.........................: 1.0
..Prozedurname..........................: inst
..Angefordert von.....................: KKKKK01
..Erstellt am...........................: 2005-04-15 10:59
..Gestartet am...........................: 2005-04-15 10:57
..Installiert am.........................: 2005-04-15 10:59
Computerjob-ID................: 5510
..Jobname..............................:
..Elementname........................: Data Transport Service für Win32
..Elementversion.....................: 2.0 SP1 ENU
..Prozedurname..........................: DTS
..Angefordert von.....................: Software Detector
..Erstellt am...........................: 2005-04-15 10:59
..Gestartet am...........................: 2005-04-15 10:59
..Installiert am.........................: 2005-04-15 10:59
Computerjob-ID................: 6159
..Jobname.............................: tstkpk03 1.0: inst
..Elementname........................: tstkpk03
..Elementversion.........................: 1.0
..Prozedurname..........................: inst
..Angefordert von.....................: KKKKK01
..Erstellt am...........................: 2005-04-15 11:23
..Gestartet am...........................: 2005-04-15 11:22
..Installiert am.........................: 2005-04-15 11:23
Kapitel 3: cadsmcmd-Befehle 433
Kompatibilität
Computerjob-ID................: 7805
..Jobname..............................: tstkpk02 1.0:instCrash
..Elementname........................: tstkpk02
..Elementversion.........................: 1.0
..Prozedurname..........................: instCrash
..Angefordert von.....................: KKKKK01
..Erstellt am...........................: 2005-04-15 12:15
..Gestartet am...........................: 2005-04-15 12:15
..Installiert am.........................: 2005-04-15 12:15
------------------------------------------------------------------------------Gesamtzahl der gefundenen Installationen: 8
Gesamtzahl der angezeigten Installationen: 8
SDCMD<A000000>: OK
listJobs – Auflisten von zum Zielcomputer gehörigen Jobs
Diese Aktion listet die Jobs auf, die mit dem durch den Parameter "name" angegebenen
System verbunden sind. Es kann ein zusätzlicher Filter angegeben werden, um die Liste
auf die Jobs zu beschränken, die den Filterkriterien entsprechen. Wenn keine Filter
angegeben werden, wird die vollständige Liste der Jobs angezeigt. Der Filter ist auf
100&#160;Byte beschränkt.
Diese Aktion hat das folgende Format:
targetcomputer action=listjobs
name=Computername
[{alt |
[{filter=Filter|filterfile=Dateiname}]
alt
Es wird eine alternative Ausgabeliste ausgegeben.
Eine alternative Liste wird nur auf der Grundlage des Namens und der Version des
Elements bereitgestellt.
Bei der Angabe dieses Parameters können der Wert des Elements und der
Parameter "version" datenbankgestützte Platzhalter enthalten, zum Beispiel
"%"
für eine beliebige, selbst leere Zeichenfolge
"_"
für ein beliebiges einzelnes Zeichen
Für Microsoft SQL Server haben die eckigen Klammern ("[","]") eine besondere
Bedeutung. Dies muss beim Codieren des Namens berücksichtigt werden.
434 CLI-Referenzhandbuch
Kompatibilität
filter
Gibt Folgendes an: Ausdruck, um die Anzahl der aufgelisteten Informationen
einzuschränken
Die folgenden Attribute können zur Erstellung elementarer Filterausdrücke
verwendet werden:
Attribut
Typ
Jobname
Zeichenfolge
Jobstatus
{UNDEFINED | WAITING |
DELIVERY_ORDERED | DELIVERING |
DELIVERY_OK | DELIVERY_ERROR |
ALREADY_DELIVERED |
EXECUTION_ORDERED | EXECUTING |
EXECUTION_OK | EXECUTION_ERROR |
UNDELIVERY_ORDERED | UNDELIVERING |
UNDELIVERY_OK | UNDELIVERY_ERROR |
ALREADY_INSTALLED |
MANIPULATION_NOT_ALLOWED}
Elementname
Zeichenfolge
Elementversion
Zeichenfolge
Elementtyp
{SOFTWARE | DOCUMENT | PROCEDURE |
UNSEALED ITEM | ENABLED ITEM |
DETECTED ITEM | ARCHIVED ITEM}
Prozedurname
Zeichenfolge
Reihenfolge
Zeichenfolge
Fehlermeldung
Zeichenfolge
Fehlerursache
Long
Kommentar
Zeichenfolge
Computer-Installationsprozedur
Zeichenfolge
Erstellungsdatum
Sdate
Erstellungszeit
Stime
Aktivierungsdatum
Sdate
Aktivierungszeit
Stime
Beendigungsdatum
Sdate
Beendigungszeit
Stime
Kapitel 3: cadsmcmd-Befehle 435
Kompatibilität
filterfile
Gibt Folgendes an: Name der Datei, die die Filterbefehle enthält.
Die Befehle der Datei werden auf die gleiche Weise festgelegt wie im Parameter
"Filter". Die Kapazität der Datei wird jedoch durch die Kapazität des den Befehl
ausführenden Systems begrenzt.
Name
Gibt Folgendes an: Name des Computers, dessen Jobs angezeigt werden.
Beispiel:
Durch Starten des folgenden Befehls
cadsmcmd targetComputer action=listJobs name=sys1
wird folgende Liste zurückgegeben:
------------------------------------------------------------------------------Liste der Jobs für Computer "sys1"
1. Liste der aktuell installierten Programme
------------------------------------------------------------------------------CA Unicenter CA ITCM-Explorer 11.0.8070.296:Install (EXECUTION_OK, B8E5FB21-06814C97-8FC1-E7B2E718B9CA)
CA Unicenter DSM Agent + Software Delivery Plugin 11.0.8070.296:Install
(EXECUTION_OK, C046CFB6-F2F9-4D05-B7E9-006E47F42454)
CA Unicenter DSM Agent + Asset Management Plugin 11.0.8070.296:Install
(EXECUTION_OK, EBC708F8-39C9-405A-B69D-F65DA74A72F6)
CA Unicenter DSM Agent + Basic Inventory Plugin 11.0.8070.296:Install
(EXECUTION_OK, 97741439-351E-4D03-9C64-33775C99649C)
tstbase 1.0:inst (EXECUTION_OK, FC23989D-C88B-4ADB-8A2E-30223A65B71E)
436 CLI-Referenzhandbuch
Kompatibilität
------------------------------------------------------------------------------2. Liste der anderen Aufträge
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------Gesamtzahl der Jobs: 5
Gesamtzahl der gelesenen Jobs: 5
Gesamtzahl der angezeigten Aufträge 5
SDCMD<A000000>: OK
Anzeige des Jobstatus und der Job-ID in Klammern.
Und durch Starten des folgenden Befehls:
cadsmcmd targetComputer action=listJobs name=sys% alt
wird folgende Liste zurückgegeben:
------------------------------------------------------------------------------Liste der Jobs "sys%"
------------------------------------------------------------------------------Ziel......................................: sys1
..Jobname.............................: tstbase 1.0: inst
..Job-ID................................: FC23989D-C88B-4ADB-8A2E-30223A65B71E
..Elementname........................: tstbase
..Elementversion.........................: 1.0
..Prozedurname..........................: inst
..Task.................................: install
..Benutzerparameter...................:
..Jobstatus............................: EXECUTION_OK
..Fehlercode...........................: 0
..Fehlermeldung.........................:
..Erstellungsdatum........................: 2006-10-18
..Erstellungszeitpunkt........................: 13:58
..Aktivierungsdatum......................: 2006-10-18
..Aktivierungszeitpunkt......................: 13:57
..Beendigungsdatum......................: 2006-10-18
..Beendigungszeit......................: 13:59
Ziel......................................: sys2
..Jobname.............................: tstbase 1.0: inst
..Job-ID................................: 653C4ECE-10BD-43AF-9809-3DAC494A35D8
..Elementname........................: tstbase
..Elementversion.........................: 1.0
..Prozedurname..........................: inst
..Task.................................: install
Kapitel 3: cadsmcmd-Befehle 437
Kompatibilität
..Benutzerparameter...................:
..Jobstatus............................: AUSFÜHRUNG
..Fehlercode...........................: 228432
..Fehlermeldung.........................: Dateiübertragung wurde erfolgreich
abgeschlossen
.........................................+
..Erstellungsdatum........................: 2006-10-19
..Erstellungszeitpunkt........................: 09:08
..Aktivierungsdatum......................: 2006-10-19
..Aktivierungszeitpunkt......................: 09:08
..Beendigungsdatum......................: 2006-10-19
..Beendigungszeit......................: 09:08
-------------------------------------------------------------------------Gesamtzahl der Elemente: 2
SDCMD<A000000>: OK
Durch Starten des folgenden Befehls:
cadsmcmd targetcomputer action=listjobs name=test01 filter="Job
state=EXECUTION_OK"
Die folgende Ausgabe wird zurückgegeben:
-------------------------------------------------------------------------Liste der Jobs für Computer "test01"
1. Liste der aktuell installierten Programme
-------------------------------------------------------------------------CA DSM Scalability Server 12.0.0.4860:Install (EXECUTION_OK, 21EC3E23-ABA8-4C188683-ABA423928815)
CA DSM Explorer 12.0.0.4860:Install (EXECUTION_OK, F4B97228-9BC0-458D-9378-6EF46
FDAFBA6)
CA DSM Agent + Asset Management-Plugin (nur englische Edition) 12.0.0.4860:Instal
l (EXECUTION_OK, 3643F431-59C8-4AEC-B213-66813863F053)
CA DSM Agent + Basisinventar-Plugin (nur englische Edition) 12.0.0.4860:Install
(EXECUTION_OK, 224D083A-D48F-4EAE-8060-37B6486580F5)
CA DSM Agent + Software Delivery-Plugin (nur englische Edition) 12.0.0.4860:Insta
ll (EXECUTION_OK, 742B5764-E4AF-475A-BA99-08B380BF6DC0)
CA DSM Agent + Data Transport-Plugin 12.0.0.4860:Install (EXECUTION_OK, 11A8AF71
-F703-44BF-B3BA-40D1C3218560)
438 CLI-Referenzhandbuch
Kompatibilität
CA DSM Agent + Remote Control-Plugin (nur englische Edition) 12.0.0.4860:Centrall
y Managed Complete Agent (EXECUTION_OK, 94A845B7-ACEE-4AF2-8760-6C4F0EFDA570)
CA DSM Manager 12.0.0.4860:Detect (EXECUTION_OK, 2A8EDFFE-7B1E-4229-94B1-4AD816E
9FF11)
-------------------------------------------------------------------------2. Liste der anderen Aufträge
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------Gesamtzahl der Jobs: 11
Gesamtzahl der gelesenen Jobs: 11
Gesamtzahl der angezeigten Aufträge 8
SDCMD<A000000>: OK
listMembership – Auflisten von Mitgliedschaften des Zielcomputers
Diese Aktion listet alle Gruppen auf, denen der angegebene Zielcomputer als Mitglied
angehört.
Diese Aktion hat das folgende Format:
targetcomputer action=listMembership name=Computername
Name
Gibt den Namen des Zielcomputers an. Die Mitgliedschaften werden aufgelistet.
Beispiel:
Geben Sie den folgenden Befehl ein, um alle Gruppen aufzulisten, von denen der
Zielcomputer "KKKKK01B" Mitglied ist:
cadsmcmd targetComputer action=listMembership name=KKKKK01B
Dadurch wird folgende Liste ausgegeben:
------------------------------------------------------------------------------"KKKKK01B" ist Mitglied der folgenden Gruppen
------------------------------------------------------------------------------cg (Gruppe, lokal)
qg (Abfragegruppe, global)
Software Delivery-Server (Gruppe, lokal)
tqg (Abfragegruppe, global)
SDCMD<A000000>: OK
Kapitel 3: cadsmcmd-Befehle 439
Kompatibilität
reinstallProduct – Neuinstallation des Produkts
Diese Aktion installiert ein Produkt, das bereits als installiert gekennzeichnet ist, auf
dem Zielcomputer neu.
Diese Aktion hat das folgende Format:
targetcomputer action=reInstallProduct
name=Computername
item=Elementname
version=Elementversion
procedure=Installationsprozedur
cname=[Name]
[{noLinkage|rollback|synchronized}]
[nocascade]
[deliveryTime=JJJJ-MM-TT HH:MM]
[atTime=JJJJ-MM-TT HH:MM]
after={exacttime|boottime}
[calendarname=Name_des_Lieferungskalenders]
[preaction={none|reboot|logoff}]
[postaction={none|reboot|logoff|rebootAtEnd|logoffAtEnd|shutdownAtEnd}]
[promptUser[={y|n}]]
[allowCancel[={y|n}]]
[execTimedOut[={y|n}]]
[prompt=Tage.Stunden]
[offline[={y|n}]]
[runAtShutdown[={y|n}]]
[preventLogon[={y|n}]]
[globalTime]
[noCalendar]
[parameters=Benutzerparameter]
[jobTimeOut=t.h]
[unsealed]
440 CLI-Referenzhandbuch
Kompatibilität
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.
Wenn durch diesen Aufruf "promptUser" weder festgelegt wird, noch bereits
aktiviert ist, wird dieser Parameter ignoriert. Es wird keine Warnung angezeigt.
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.
cname
Gibt Folgendes an: optionaler eindeutiger Name eines Jobcontainers. (Standard:
Zielcomputername[JJJJ-MM-TT hh:mm:ss]).
Er wird für die Verteilung der Anforderung verwendet. Wenn der Container bereits
vorhanden und nicht versiegelt ist, wird er ohne eine Änderung seiner
Verknüpfungsoptionen oder Überlappungsoptionen verwendet. Wenn er
vorhanden, aber versiegelt ist, wird ein Fehler gemeldet. Wenn er nicht vorhanden
ist, wird der Jobcontainer entsprechend der angegebenen Verknüpfungs- und
Überlappungsparameter erstellt.
Kapitel 3: cadsmcmd-Befehle 441
Kompatibilität
deliveryTime
Gibt Folgendes an: Startzeit der Lieferung vom Domänen-Manager.
Das Datum wird im ISO-Format "JJJJ-MM-TT HH:MM" angegeben.
Wenn der Parameter nicht angegeben ist, werden das aktuelle Datum und die
aktuelle Uhrzeit verwendet.
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.
Wenn durch diesen Aufruf "promptUser" weder festgelegt wird, noch bereits
aktiviert ist, wird dieser Parameter ignoriert. Es wird keine Warnung angezeigt.
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änenManagers.
item
Gibt Folgendes an: Name des Elements, der neu installiert werden soll.
jobTimeOut
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".
Name
Gibt Folgendes an: Name des Computers, auf dem das Produkt neu installiert
werden soll.
442 CLI-Referenzhandbuch
Kompatibilität
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|rollback|synchronized
Wenn mehrere Jobs vorhanden sind, verarbeitet dieser Modus die Verknüpfung
zwischen den einzelnen Jobs eines Jobcontainers. Dieser Code besitzt die folgende
Funktion:
Nicht verwendet
Der Modus Batch-Job wird ohne Rollback verwendet.
noLinkage
Führt den Job unabhängig von den anderen Jobs im Container aus.
rollBack
Setzt die Jobverknüpfungsoption auf "Transaktion aktivieren".
synchronisiert
Die Jobverknüpfungsoption wird auf "Synchronisierte Jobausführung" gesetzt.
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.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert
der zugehörigen Prozedur verwendet.
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
Kapitel 3: cadsmcmd-Befehle 443
Kompatibilität
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.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert
der zugehörigen Prozedur verwendet.
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.
444 CLI-Referenzhandbuch
Kompatibilität
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
Prozedur, die für die Neuinstallation verwendet werden soll.
prompt=d.h
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.
Wenn durch diesen Aufruf "promptUser" weder festgelegt wird, noch bereits
aktiviert ist, wird dieser Parameter ignoriert. 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.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert
der zugehörigen Prozedur verwendet.
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.
Kapitel 3: cadsmcmd-Befehle 445
Kompatibilität
unsealed
Der adressierte Jobcontainer bleibt unversiegelt, nachdem der generierte Job
erfolgreich erstellt wurde.
Version
Gibt Folgendes an: Version des Elements.
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.
removeJob – Entfernen von Jobs aus der Jobliste
Diese Aktion entfernt Jobs aus der Jobliste des angegebenen Zielcomputers.
Diese Aktion hat das folgende Format:
targetcomputer action=removeJob name=Computername
{cjid=Computerjob-ID|
item=Elementname
version=Elementversion
procedure=Elementprozedur
[installedWith=Installationsprozedur]}
cjid
Gibt Folgendes an: ID des Computerjobs, die entfernt werden sollen.
installedWith
Gibt Folgendes an: Name der Installationsprozedur, auf die in dem zu entfernenden
Job verwiesen wird.
item
Gibt Folgendes an: Name des Elements, auf das sich der zu entfernende Job bezieht.
Name
Gibt Folgendes an: Name des Computers, für den der Job aus der Jobliste entfernt
werden soll.
446 CLI-Referenzhandbuch
Kompatibilität
Prozedur
Gibt Folgendes an: Name der Elementprozedur, auf die in dem zu entfernenden Job
verwiesen wird.
Version
Gibt Folgendes an: Version des Elements, auf das sich der zu entfernende Job
bezieht.
Hinweis:Wenn der zu entfernende Job durch "item", "version" usw. bestimmt ist, wird
lediglich der erste diesen Kriterien entsprechende Job in der Liste gelöscht.
Beispiel:
Geben Sie folgenden Befehl ein, um den Job "tstkpk01 1.0:inst" mit der Job-ID
"2F126122-3848-4FE7-A41F-DF781E7CB5AD6050" aus der Liste der mit dem
Zielcomputer "KKKKK01B" verknüpften Jobs zu entfernen:
cadsmcmd targetComputer action=removeJob name=KKKKK01B cjid=2F126122-3848-4FE7A41F-DF781E7CB5AD6050
showJobAttr – Anzeigen von Jobattributen
Diese Aktion zeigt die Attribute eines mit einem Computer verbundenen Jobs an. Der
zugehörige Computer wird von dem Parameter "name" und der jeweilige Job von dem
Parameter "jobname" angegeben.
Diese Aktion hat das folgende Format:
targetcomputer action=showjobattr
name=Computername
jobname=Jobname
jobname
Gibt Folgendes an: Name des Jobs , dessen Attribute angezeigt werden.
Name
Gibt Folgendes an: Name des Computers, der mit den anzuzeigenden Jobattributen
verbunden ist.
Kapitel 3: cadsmcmd-Befehle 447
Kompatibilität
Beispiel:
Rufen Sie folgenden Befehl auf, um die Attribute des Jobs "tstkpk02 1.0:inst" des
Zielcomputers "KKKKKB1B" anzuzeigen:
cadsmcmd targetComputer action=showJobAttr name=KKKKK01B jobName="tstkpk02
1.0:inst"
Die Informationen können folgendermaßen angezeigt werden:
------------------------------------------------------------------------------Attribute von Job "tstkpk02 1.0:inst" auf
.........Computers "KKKKKB1B" anzeigen
------------------------------------------------------------------------------Computerjob-ID..........................: AF60EB2F-7706-4B78-B084-6B09DCB96D94
..Jobname.............................: tstkpk02 1.0: inst
..Elementname........................: tstkpk02
..Elementversion.........................: 1.0
..Elementtyp..........................: SOFTWARE
..Task.................................: 1
.........................................install
..Prozedurname..........................: inst
..Angefordert von.....................: winnt://677-lab-xxx2/xxx
..Jobstatus............................: EXECUTION_OK
..Fehlermeldung.........................: OK
..Fehlerursache..........................: 0
..Kommentar...........................:
..Computer-Installationsprozedur.......: inst
..Aktivierungsdatum......................: 2006-08-16
..Aktivierungszeitpunkt......................: 15:01
..Erstellungsdatum........................: 2006-08-16
..Erstellungszeitpunkt........................: 15:02
..Beendigungsdatum......................: 2006-08-16
..Beendigungszeit......................: 15:03
..Gesendete Daten (in %).........:
..Jobausgabe.........................: Für diesen Job ist keine Ausgabe verfügbar
SDCMD<A000000>: OK
448 CLI-Referenzhandbuch
Kompatibilität
Zielcomputer-Befehle mit Bezug zur BS-Installationsverwaltung (OSIM)
Die BS-Installationsverwaltung ist die Funktion von Software Delivery, welche die
Neuinstallation von Boot-Images und Betriebssystem-Images und deren Reinstallation
nach Systemabstürzen durchführt. Die folgenden Methoden erläutern, wie cadsmcmd
die Verwaltungsfunktionen der BS-Installationsverwaltung bereitstellt.
Die BS-Installationsverwaltung verwaltet sämtliche Daten zu
Betriebssysteminstallationen in einem Netzwerk oder Subnetzwerk.
Hinweis: Informationen zu den Themen
■
Erstellen von Zielcomputern
■
Löschen von Zielcomputern
■
Auflisten von Zielcomputern
■
Attribute anzeigen
finden Sie im Abschnitt "Allgemeine Befehle (siehe Seite 406)".
Dieser Abschnitt enthält die folgenden Themen:
activateOS – Aktivieren eines BS-Installationsauftrags (siehe Seite 450)
cancelOS – Abbrechen eines BS-Installationsauftrags (siehe Seite 451)
deletePlannedOS – Löschen eines geplanten BS-Installationauftrags (siehe Seite 452)
deleteScheduledOS – Löschen eines zeitlich geplanten BS-Installationauftrags (siehe
Seite 452)
modifyInstallParameter – Ändern der Installationsparameter von BSInstallationsaufträgen (siehe Seite 453)
modifyOS – Zuweisen eines BS-Images zu einem Ziel (siehe Seite 454)
reactivateOS – Reaktivieren eines beendeten oder fehlgeschlagenen BSInstallationsauftrags (siehe Seite 455)
reinstallOS – Neuinstallieren des Betriebssystems (siehe Seite 457)
removeFromOsim – Entfernen von Zielen aus OSIM (siehe Seite 458)
showInstallParameter – Anzeigen der Installationsparameter von BSInstallationsaufträgen (siehe Seite 459)
setupOS (Veraltete Aktion) (siehe Seite 460)
Kapitel 3: cadsmcmd-Befehle 449
Kompatibilität
activateOS – Aktivieren eines BS-Installationsauftrags
Diese Aktion legt den Zeitpunkt der Ausführung einer geplanten
Betriebssysteminstallation fest.
Wenn der Zielcomputer OSIM-verwaltet ist, ist für diesen ein geplantes Betriebssystem
verfügbar, und wenn keine BS-Installation für den Zielcomputer ansteht, wird die
Installation des geplanten BS für die Ausführung zeitlich festgelegt.
In allen anderen Fällen schlägt die Aktion fehl.
Diese Aktion hat das folgende Format:
targetComputer action=activateOS
name=Computername
[atTime=JJJJ-MM-TT HH:MM]
[wakeup[={y|n=}]]
[restart[={y|n}]]
[waitBs[={y|n}]]
[waitIm[={y|n}]]
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.
Name
Gibt Folgendes an: Name des Computers, für den die Installation des geplanten
Betriebssystems für die Ausführung zeitlich festgelegt wird.
restart
Dieser optionale Parameter bestimmt, ob ein aktives System bei Ausführung der
zugehörigen Installationsanforderung neu gestartet wird.
Der Neustart erfolgt, wenn "restart" oder "restart=y" angegeben ist.
Bei Angabe von "restart=n" wird kein automatischer Neustart durchgeführt, und es
liegt in der Verantwortung des Benutzers, das System neu zu starten, um den
Vorgang der Betriebssysteminstallation anzustoßen.
Wenn der Parameter nicht angegeben ist, gilt die Standardeinstellung "restart=n".
450 CLI-Referenzhandbuch
Kompatibilität
waitBs
Wenn "waitBs" oder "waitBs=y" angegeben ist, wird die Aktivierungsanforderung
möglicherweise zurückgestellt, bis dem adressierten Ziel ein Boot-Server
zugewiesen wird. Wenn "waitBs=n" angegeben ist, wird die Anforderung nicht
aufgrund einer fehlenden Boot-Serverzuweisung zurückgestellt. Der Standardwert
ist "waitBs=n".
WaitIm
Wenn "waitIm" oder "waitIm=y" angegeben ist, wird die Aktivierungsanforderung
möglicherweise zurückgestellt, bis die zugeordneten Boot- und BS-Images auf dem
zugehörigen Boot-Server bereitgestellt wurden. Wenn "waitIm=n" angegeben ist,
wird die Anforderung nicht aufgrund noch nicht bereitgestellten Images
zurückgestellt. Der Standardwert ist "waitIm=n".
wakeup
Dieser optionale Parameter bestimmt, ob ein Zielsystem im Standby-Modus für
diese Installation reaktiviert wird oder nicht.
Die Aktivierung des Systems erfolgt, wenn "wakeup" oder "wakeup=y" angegeben
wird.
Bei Angabe von "wakeup=n" findet keine Aktivierung statt.
Wenn dieser Parameter nicht angegeben ist, gilt die Standardeinstellung
"wakeup=n".
Beispiel:
Angenommen, eine geplante Installation eines Betriebssystems muss für den
Zielcomputer "dorabella" durchgeführt werden. Wenn das System sich im StandbyModus befindet, muss es aktiviert werden. Darüber hinaus muss ein automatischer
Neustart durchgeführt werden, um den Installationsprozess auf dem Zielsystem zu
starten. Diese Anforderung wird mit Hilfe des folgenden Befehls durchgeführt:
cadsmcmd targetcomputer action=activateOS name=dorabella wakeup restart
cancelOS – Abbrechen eines BS-Installationsauftrags
Diese Aktion bricht eine ausstehende Installation eines BS-Images ab.
Wenn das angegebene Zielsystem vorhanden und OSIM-verwaltet ist und für dieses
System eine Installation ansteht, bricht diese Methode die Installationsanforderung ab.
In allen anderen Fällen schlägt die Methode fehl.
Hinweis: Eine anstehende Installation kann nur abgebrochen werden, wenn die
Anweisung auf dem Boot-Server zeitlich geplant wurde und das Zielsystem noch nicht
mit der Installation begonnen hat.
Kapitel 3: cadsmcmd-Befehle 451
Kompatibilität
Diese Aktion hat das folgende Format:
targetComputer action=cancelOS
name=Computername
Name
Gibt Folgendes an: Name des Computers, für den die anstehende Installation
abgebrochen wird.
deletePlannedOS – Löschen eines geplanten BS-Installationauftrags
Diese Aktion ermöglicht das Löschen einer geplanten Konfiguration.
Wenn das System OSIM-verwaltet ist und eine Anforderung für eine geplante BSInstallation vorhanden ist, wird diese geplante BS-Installation gelöscht. In allen anderen
Fällen schlägt die Anforderung fehl.
Wenn die zu löschende geplante Konfiguration die einzige dem angegebenen System
zugeordnete Konfiguration ist, wird die OSIM-Verwaltung für das System aufgehoben.
Diese Aktion hat das folgende Format:
targetComputer action=deletePlannedOS
name=Computername
Name
Gibt Folgendes an: Name des Computers, für den eine bestehende geplante
Konfiguration gelöscht werden soll.
deleteScheduledOS – Löschen eines zeitlich geplanten BS-Installationauftrags
Diese Aktion löscht eine zeitlich geplante BS-Installationsanforderung mit dem
Unterstatus "Fehlgeschlagen" oder "Beendet".
Wenn das System OSIM-verwaltet ist und eine Anforderung für eine zeitlich geplante
BS-Installation mit dem erforderlichen Unterstatus vorhanden ist, wird diese
Anforderung gelöscht. In allen anderen Fällen schlägt die Anforderung fehl.
Wenn die zu löschende zeitlich geplante Konfiguration die einzige dem angegebenen
System zugeordnete Konfiguration ist, wird die OSIM-Verwaltung für das System
aufgehoben.
452 CLI-Referenzhandbuch
Kompatibilität
Diese Aktion hat das folgende Format:
targetComputer action=deleteScheduledOS
name=Computername
Name
Gibt Folgendes an: Name des Computers, für den eine bestehende zeitlich geplante
Konfiguration gelöscht werden soll.
modifyInstallParameter – Ändern der Installationsparameter von BS-Installationsaufträgen
Mit dieser Aktion werden Installationsparameter eines OSIM-verwalteten Systems für
eine Anforderung für eine geplante BS-Installation geändert.
Der angegebene Parameter wird entsprechend der angegebenen Argumente geändert.
Wenn "default" angegeben wird, wird der Parameter auf den Standardwert
zurückgesetzt (sofern vorhanden). Wenn kein Standardwert vorhanden ist, wird ein
Fehler gemeldet.
Andernfalls wird der alte Parameterwert durch den angegebenen ersetzt, wenn der
neue Wert den Parameterspezifikationen des zugehörigen BS-Image entspricht.
Es ist nicht möglich, mit dieser Aktion die Image-Parameter des BS zu ändern. Für die
Änderung der Zuweisung des BS-Images muss eine andere Aktion verwendet werden
(Aktion modifyOS).
Wenn die MAC-Adresse geändert wird, wird nicht nur der Konfigurationsparameter
geändert, sondern auch die Computer-Eigenschaft. Es wird überprüft, ob ein anderer
Computer in der OSIM-Datenbank bereits die MAC-Adresse verwendet. Wenn bereits
ein benannter Computereintrag mit dieser MAC-Adresse vorhanden ist, der sich noch
nicht in der Löschwarteschlange befindet, wird die Änderung der MAC-Adresse
abgelehnt. Wenn ein unbenannter Computereintrag mit dieser MAC-Adresse vorhanden
ist, wird dieser aus der Datenbank gelöscht.
Wenn Sie einen Parameter mit dem Typ "erweiterbare Liste" mit Hilfe eines
Parameterwertes ändern, der kein Element der zugehörigen Liste ist, wird dieser Wert
der Liste hinzugefügt. Bei einer nicht erweiterbaren Liste muss der Wert ein Element der
Liste sein. Andernfalls wird die Änderung verweigert.
Diese Aktion hat das folgende Format:
targetComputer action=ModifyInstallParameter
name=Computername
paramName=Parametername
{default|paramValue=Parameterwert}
Kapitel 3: cadsmcmd-Befehle 453
Kompatibilität
Standard
Verwirft die Benutzereinstellungen des angegebenen Parameters und setzt sie auf
den Standardwert.
Name
Gibt Folgendes an: Name des Computers, für den die Installationsparameter
geändert werden sollen.
paramName
Gibt Folgendes an: Name des Parameters, der geändert werden soll.
Hinweis: Der Parameter "HostName" kann nur so lange bearbeitet werden, wie das
angegebene Zielsystem noch nicht vom Netzwerk registriert wurde.
Wenn das System bereits registriert wurde, wird der Fehler "CMD00149" gemeldet:
"Das Ziel wurde bereits registriert. Der Vorgang ist nicht zulässig."
paramValue
Neuer Wert des Parameters.
Wenn der Parameter eine Zuordnungsliste oder eine erweiterte Zuordnungsliste ist,
verwenden Sie das Format "<Schlüssel> <Kommentar>"
Der Schlüssel und der Kommentar werden durch ein Leerzeichen voneinander
getrennt. Der Kommentar ist optional.
Wenn der Schlüssel Leerzeichen enthält, setzen Sie sie in Anführungszeichen.
Beispiel: Ändern Sie für ein XP BS-Image die Einstellung des Parameters "TimeZone"
in 095 oder in "095 Central Europe"
Ändern Sie für ein Vista-Image die Einstellung des Parameters "TimeZone" in "\"W.
Europe Standard Time\"" oder in "\"W. Europe Standard Time\" GB-Zeit"
modifyOS – Zuweisen eines BS-Images zu einem Ziel
Mit der Aktion "modifyOS" weisen Sie von OSIM verwalteten oder nicht von OSIM
verwalteten Systemen ein neues BS-Image zu.
Die Syntax der Aktion lautet folgendermaßen:
targetComputer action= modifyOS
name=Zielname
osImage=BS-Image
[bootserver]
[macAddress=«Mac-Adresse»]
454 CLI-Referenzhandbuch
Kompatibilität
Name
Name des Zielcomputers, dem das BS-Image zugewiesen wird.
osImage
Name des BS-Images, das auf dem Ziel installiert werden soll.
bootserver
Name eines Boot-Servers.
Wenn der Name angegeben wird und das angesprochene Ziel noch keinem BootServer zugewiesen ist, wird es dem angegebenen Boot-Server zugewiesen. Wenn
das angesprochene Ziel bereits einem Boot-Server zugewiesen ist und der Name
mit dem Parameter angegeben wird, wird die Aktion nur verarbeitet, wenn der
angegebene Name mit dem Namen des zugewiesenen Boot-Servers übereinstimmt.
Wenn der Parameter "bootserver" nicht codiert ist, werden keine der oben
beschriebenen Zuweisungen und Prüfungen vorgenommen.
macAddress
MAC-Adresse des Ziels.
Wenn das System noch nicht in OSIM registriert wurde und ihm noch keine MACAdressen zugewiesen wurden, wird diese MAC-Adresse verwendet, um das System
in OSIM einzurichten.
Wenn eine MAC-Adresse in OSIM verfügbar ist, muss sie mit dem angegebenen
Wert übereinstimmen. Anderenfalls gibt der Befehl einen Fehler zurück.
Wenn dieses Argument nicht codiert ist, wird angenommen, dass das
angesprochene System bereits in OSIM registriert ist.
reactivateOS – Reaktivieren eines beendeten oder fehlgeschlagenen BS-Installationsauftrags
Diese Aktion plant die Ausführung einer Installation erneut, wenn der Zielcomputer
OSIM-verwaltet und für diesen eine fehlgeschlagene oder beendete
Installationsanforderung vorhanden ist.
In allen anderen Fällen schlägt die Aktion fehl.
Diese Aktion hat das folgende Format:
targetComputer action=reactivateOS
name=Computername
[attime="JJJJ-MM-TT hh:mm" ]
[wakeup[={y|n=}]]
[restart[={y|n}]]
[waitBs[={y|n}]]
[waitIm[={y|n}]]
Kapitel 3: cadsmcmd-Befehle 455
Kompatibilität
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.
Name
Gibt Folgendes an: Name des Computers, für den eine beendete oder
fehlgeschlagene Installation erneut zur Ausführung geplant wird.
restart
Dieser optionale Parameter bestimmt, ob ein aktives System bei Ausführung der
zugehörigen Installationsanforderung neu gestartet wird.
Der Neustart erfolgt, wenn "restart" oder "restart=y" angegeben ist.
Bei Angabe von "restart=n" wird kein automatischer Neustart durchgeführt, und es
liegt in der Verantwortung des Benutzers, das System neu zu starten, um den
Vorgang der Betriebssysteminstallation anzustoßen.
Wenn der Parameter nicht angegeben ist, gilt die Standardeinstellung "restart=n".
waitBs
Wenn "waitBs" oder "waitBs=y" angegeben ist, wird die Aktivierungsanforderung
möglicherweise zurückgestellt, bis dem adressierten Ziel ein Boot-Server
zugewiesen wird. Wenn "waitBs=n" angegeben ist, wird die Anforderung nicht
aufgrund einer fehlenden Boot-Serverzuweisung zurückgestellt. Der Standardwert
ist "waitBs=n".
waitIm
Wenn "waitIm" oder "waitIm=y" angegeben ist, wird die Aktivierungsanforderung
möglicherweise zurückgestellt, bis die zugeordneten Boot- und BS-Images auf dem
zugehörigen Boot-Server bereitgestellt wurden. Wenn "waitIm=n" angegeben ist,
wird die Anforderung nicht aufgrund noch nicht bereitgestellten Images
zurückgestellt. Der Standardwert ist "waitIm=n".
wakeup
Dieser optionale Parameter bestimmt, ob ein Zielsystem im Standby-Modus für
diese Installation reaktiviert wird oder nicht.
Die Aktivierung des Systems erfolgt, wenn "wakeup" oder "wakeup=y" angegeben
wird.
Bei Angabe von "wakeup=n" findet keine Aktivierung statt.
Wenn dieser Parameter nicht angegeben ist, gilt die Standardeinstellung
"wakeup=n".
456 CLI-Referenzhandbuch
Kompatibilität
Beispiel:
Angenommen, eine beendete oder fehlgeschlagene BS-Installation muss für den
Zielcomputer "dorabella" geplant werden. Wenn das Zielsystem im Standby-Modus ist,
muss eine Aktivierung (wakeup) durchgeführt werden.
Darüber hinaus muss ein automatischer Neustart durchgeführt werden, um den
Installationsprozess auf dem Zielsystem zu starten. Diese Anforderung wird mit Hilfe des
folgenden Befehls durchgeführt:
cadsmcmd targetcomputer action=reactivateOS name=dorabella wakeup restart
reinstallOS – Neuinstallieren des Betriebssystems
Diese Aktion installiert einen Zielcomputer nach einem Absturz neu.
Wenn das System OSIM-verwaltet ist und eine aktuelle BS-Installation, jedoch keine
geplante Installationsanforderung vorhanden ist, wird eine erneute Installation des
aktuellen BS geplant, unabhängig davon, ob die BS-Installation aktiv, beendet oder
fehlgeschlagen ist. In allen anderen Fällen schlägt die Anforderung fehl.
Diese Aktion hat das folgende Format:
targetComputer action=reInstallOS
name=Computername
[atTime=JJJJ-MM-TT HH:MM]
[wakeup[={y|n=}]]
[restart[={y|n}]]
[waitBs[={y|n}]]
[waitIm[={y|n}]]
attime
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.
Name
Gibt Folgendes an: Name des Computers, der neu installiert werden soll.
restart
Dieser optionale Parameter bestimmt, ob ein aktives System bei Ausführung der
zugehörigen Installationsanforderung neu gestartet wird.
Der Neustart erfolgt, wenn "restart" oder "restart=y" angegeben ist.
Bei Angabe von "restart=n" wird kein automatischer Neustart durchgeführt, und es
liegt in der Verantwortung des Benutzers, das System neu zu starten, um den
Vorgang der Betriebssysteminstallation anzustoßen.
Wenn der Parameter nicht angegeben ist, gilt die Standardeinstellung "restart=n".
Kapitel 3: cadsmcmd-Befehle 457
Kompatibilität
waitBs
Wenn "waitBs" oder "waitBs=y" angegeben ist, wird die Aktivierungsanforderung
möglicherweise zurückgestellt, bis dem adressierten Ziel ein Boot-Server
zugewiesen wird. Wenn "waitBs=n" angegeben ist, wird die Anforderung nicht
aufgrund einer fehlenden Boot-Serverzuweisung zurückgestellt. Der Standardwert
ist "waitBs=n".
waitIm
Wenn "waitIm" oder "waitIm=y" angegeben ist, wird die Aktivierungsanforderung
möglicherweise zurückgestellt, bis die zugeordneten Boot- und BS-Images auf dem
zugehörigen Boot-Server bereitgestellt wurden. Wenn "waitIm=n" angegeben ist,
wird die Anforderung nicht aufgrund noch nicht bereitgestellten Images
zurückgestellt. Der Standardwert ist "waitIm=n".
wakeup
Dieser optionale Parameter bestimmt, ob ein Zielsystem im Standby-Modus für
diese Installation reaktiviert wird oder nicht.
Die Aktivierung des Systems erfolgt, wenn "wakeup" oder "wakeup=y" angegeben
wird.
Bei Angabe von "wakeup=n" findet keine Aktivierung statt.
Wenn dieser Parameter nicht angegeben ist, gilt die Standardeinstellung
"wakeup=n".
Beispiel:
Angenommen, der Zielcomputer "dorabella" muss nach einem Absturz neu installiert
werden. Wenn das System im Standby-Modus ist, muss es aktiviert werden. Darüber
hinaus muss ein automatischer Neustart durchgeführt werden, um den
Installationsprozess auf dem Zielsystem zu starten.
Diese Anforderung wird mit Hilfe des folgenden Befehls durchgeführt:
cadsmcmd targetcomputer action=reinstallOS name=dorabella wakeup restart
removeFromOsim – Entfernen von Zielen aus OSIM
Diese Aktion entfernt die angegebenen Zielobjekte aus der OSIM-Verwaltung, solange
keine geplante Konfiguration aktiv ist.
Die Syntax der Aktion lautet folgendermaßen:
targetComputer action= removeFromOSIM
{{computer=Zielname} |
{macAddresses=Mac-Adresse}}
458 CLI-Referenzhandbuch
Kompatibilität
computer
Name eines von OSIM verwalteten oder nicht von OSIM verwalteten Ziels, das aus
der OSIM-Verwaltung entfernt werden soll. Diese Option kann mehrfach codiert
werden, um eine Liste von OSIM-Objekten zu entfernen.
macAddresses
MAC-Adresse von Systemen, die entfernt werden sollen und in OSIM, jedoch nicht
in DSM registriert sind. Solche Systeme besitzen keinen Namen, sondern sie werden
in OSIM nur mit ihrer MAC-Adresse angezeigt.
Hinweis: "action=removeFromOSIM" bedeutet nicht, dass das Ziel aus DSM gelöscht
wird. Es wird nur aus OSIM gelöscht, und DSM bleibt ansonsten unverändert. Das
Entfernen stellt möglicherweise nur eine temporäre OSIM-Bereinigung dar.
Beispielsweise wird das entfernte System vielleicht beim nächsten Neustart wieder in
OSIM registriert.
showInstallParameter – Anzeigen der Installationsparameter von BS-Installationsaufträgen
Diese Aktion listet für einen Zielcomputer die mit der zugehörigen BSInstallationsanforderung verbundenen Installationsparameter auf.
Es werden die Installationsparameter aufgelistet, die mit der angegebenen BSInstallationsanforderung verbunden sind. Wenn "planned" angegeben wird, werden die
Parameter der geplanten BS-Installationsanforderung angezeigt. Wenn "scheduled"
angegeben wird, werden die Parameter der anstehenden BS-Installationsanforderungen
angezeigt. Wird keines dieser Schlüsselwörter oder "current" angegeben, werden die
Parameter der aktuellen BS-Installationsanforderung angezeigt.
Wenn der Zielcomputer kein OSIM-verwaltetes System ist, schlägt die Aktion fehl.
Diese Aktion hat das folgende Format:
targetComputer action=ShowInstallParameter
name=Computername
[planningLevel={current|scheduled|planned}]
Kapitel 3: cadsmcmd-Befehle 459
Kompatibilität
Name
Gibt Folgendes an: Name des Computers, für den die Installationsparameter
aufgelistet werden.
planningLevel
Optionaler Parameter. Gibt die Konfiguration an, der die Parameter entnommen
werden.
current
Es werden die Installationsparameter der aktuellen BS-Installationsanforderung
angezeigt. (Standard)
scheduled
Es werden die Installationsparameter der zeitlich zur Ausführung geplanten BSInstallationsanforderung angezeigt.
planned
Es werden die Installationsparameter der geplanten BSInstallationsanforderung angezeigt.
setupOS (Veraltete Aktion)
Durch die Erweiterung der Aktion "modifyOS" wird die Aktion "setupOS" nicht mehr
benötigt. Sie wird im Stapel-, Aufruf- und Pipe-Modus aus Kompatibilitätsgründen noch
von CADSMCMD akzeptiert und verarbeitet, im ausführlichen Modus steht sie jedoch
nicht mehr zur Verfügung.
templategroup – Softwarevorlagen-Befehle
Dieser Abschnitt enthält die folgenden Themen:
Allgemeine Vorlagengruppen-Verwaltung (siehe Seite 461)
Hinzufügen einer Computerliste zu einer Vorlagengruppe (siehe Seite 485)
Vorlagengruppen: Elementverwaltung (siehe Seite 489)
460 CLI-Referenzhandbuch
Kompatibilität
Allgemeine Vorlagengruppen-Verwaltung
Dieser Abschnitt enthält die folgenden Themen:
create – Erstellen einer Vorlagengruppe bzw. Software-Vorlage (siehe Seite 461)
delete – Löschen einer Software-Vorlage (siehe Seite 468)
deregister – Aufheben der Registrierung einer Vorlage (siehe Seite 469)
evaluate – Evaluieren einer Vorlage (siehe Seite 471)
list – Auflisten von Vorlagengruppen (siehe Seite 471)
listExceptions – Auflisten von Ausnahmen (siehe Seite 473)
listMembership – Auflisten der Zugehörigkeiten einer Vorlagengruppe (siehe Seite 474)
modify – Ändern von Attributen einer Vorlagengruppe bzw. Software-Vorlage (siehe
Seite 476)
register – Registrieren einer Vorlage (siehe Seite 481)
showAttr – Attribute der Software-Vorlage anzeigen (siehe Seite 482)
seal – Versiegeln von Software-Vorlagen (siehe Seite 483)
setupExecuteJobs – Einrichten und Ausführen von Jobs für eine Software-Vorlage (siehe
Seite 483)
setupJobs – Einrichten von Jobs für eine Software-Vorlage (siehe Seite 484)
unseal – Aufheben der Versiegelung von Software-Vorlagen (siehe Seite 484)
create – Erstellen einer Vorlagengruppe bzw. Software-Vorlage
Dieser Befehl erstellt eine neue Softwarevorlage.
Dieser Befehl hat das folgende Format:
templategroup action=create
name=Name_der_Vorlagengruppe
[supergroup=Gruppenname]
[swTemplate=Name_der_Software-Vorlage]
[comment=Kommentar]
[{query="Abfrage" | queryfile=Dateiname }]
[engineName=Engine-Name
[enginePeriod=Engine-Evaluierungshäufigkeit]]
[{transaction
[norollback]|
Kapitel 3: cadsmcmd-Befehle 461
Kompatibilität
synchronized }
[cascade[={y|n}]}]
[{setup_jobs | setup&activate_jobs }]
| [regenerate [ = {y/n}]]
| [{adhoc_only | adhoc_always}]
[evaluationstart ="JJJJ-MM-TT hh:mm"]
[evaluationperiod=Stunden]
[calendarname=Kalendername]
[globaltime]
[jcPriority={1,...,10}]
[userMessage]
{adhoc_only | adhoc_always}
Dieser Code besitzt die folgende Funktion:
adhoc_only
Adhoc-Evaluierung wird nur aktiviert, wenn neue oder erneut installierte Ziele
ihr Inventar melden.
adhoc_always
Adhoc-Evaluierung wird immer aktiviert, wenn Ziele ihr Inventar melden.
Wenn weder "adhoc_only" noch "adhoc_always" angegeben sind, wird keine
Adhoc-Behandlung angenommen.
calendarName
Gibt Folgendes an: Name des Kalenders, der die Zeit steuert, während der die
Evaluierung ausgeführt werden kann.
Hinweis: Sie müssen auch einen Wert für "evaluationperiod" eingeben, wenn Sie
einen Eintrag für "calendarname" aktivieren möchten.
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.
Dieser Parameter sollte nur angegeben werden, wenn sich die Jobverknüpfung des
Containers im Batch-Verarbeitungs- oder Synchronisierungsmodus befindet oder
mit dieser Aktion (durch die Eingabe von "Transaktion" oder "synchronisiert") in
einen dieser Modi versetzt wird.
462 CLI-Referenzhandbuch
Kompatibilität
comment
Gibt an: Ein Kommentar, der zusammen mit der Software-Vorlage gespeichert wird.
engineName
Gibt den Namen einer Engine an, die die Gruppenevaluierung verarbeitet.
Fehlt diese Angabe, kann die Evaluierung durch eine beliebige Engine verarbeitet
werden.
Dieser Parameter ist nur gültig, wenn "queryName" oder "sdQuery" angegeben ist.
enginePeriod
Gibt den Zeitraum in Minuten an, in dem die Engine die Gruppe neu evaluiert.
Wenn dieser Parameter nicht angegeben wird, wird von einem Zeitraum von 1
Minute ausgegangen.Wenn "engineName" angegeben ist, der Befehlsparameter
"enginePeriod" jedoch fehlt, wird ein Standardwert von 1 Minute angenommen.
Dieser Parameter ist nur zulässig, wenn "engineName" angegeben ist.
evaluationStart
Zeitpunkt, zu dem die Evaluierung beginnen soll. Der Zeitpunkt muss im ISO-Format
"JJJJ-MM-TT HH:MM" angegeben werden. Wenn "EvaluationStart" nicht angegeben
wird, wird der tatsächliche Zeitpunkt verwendet.
Dieser Parameter sollte nur für Abfrage- oder Vorlagengruppen verwendet werden.
evaluationPeriod
Der Zeitraum, in dem die Abfrage evaluiert wird. Der Zeitraum wird in Stunden
angegeben.
Dieser Parameter kann nur für Abfrage- oder Vorlagengruppen verwendet werden.
Wenn dieser Parameter nicht verwendet oder der Wert 0 angegeben wird, erfolgt
keine Neuevaluierung.
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änenManagers. (Standard)
Kapitel 3: cadsmcmd-Befehle 463
Kompatibilität
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.
Name
Gibt Folgendes an: Name der Vorlagengruppe.
Wenn die Gruppe nicht vorhanden ist, wird sie gemäß den angegebenen
Gruppenattributen erstellt. Andernfalls werden die angegebenen Gruppenattribute
ignoriert, und die angegebene Softwarevorlage wird erstellt und dieser Gruppe
zugewiesen.
norollback
Gibt an, dass im Fall eines Fehlers kein Rollback früherer Jobs der gleichen
Übertragung ausgeführt wird.
query
Gibt an, dass die Vorlage ebenfalls eine Abfragegruppe ist. Die angegebene Abfrage
muss eine USD 4.0 SP1-Legacy-Abfrage sein.
queryfile
Gibt Folgendes an: Die Datei, in der die Abfrage gespeichert ist. Die Größe der
gespeicherten Abfrage ist nur durch die Kapazität des Servers beschränkt. Bei der
Abfrage muss es sich um eine mit SD 4.0 SP1 kompatible zulässige Abfrage handeln.
Bei der angegebenen Abfrage muss es sich um eine mit SD 4.0 SP1 kompatible
Abfrage handeln.
regenerate
Bei "regenerate" oder "regenerate=y" wird eine Regenerierung der zuvor für diese
Vorlage fehlgeschlagenen Jobs durchgeführt.
Wird "regenerate=n" angegeben, erfolgt keine Regenerierung.
Bei fehlender Angabe des Parameters wird "regenerate=y" angenommen.
464 CLI-Referenzhandbuch
Kompatibilität
setup_jobs
Jobs werden in Übereinstimmung mit der Konformitätsprüfung eingerichtet, jedoch
nicht aktiviert.
Wenn weder "setup_jobs" noch "setup&activate_jobs" angegeben ist, wird lediglich
eine Konformitätsprüfung angenommen.
setup&activate_jobs
Jobs werden in Übereinstimmung mit der Konformitätsprüfung eingerichtet und
aktiviert.
Wenn weder "setup_jobs" noch "setup&activate_jobs" angegeben ist, wird lediglich
eine Konformitätsprüfung angenommen.
Hinweise: Wenn der Parameter "setup&activate_jobs" über die
Eingabeaufforderung oder die Shell-Ebene verwendet wird, muss der Parameter in
Anführungszeichen eingeschlossen werden, da das Zeichen "&" für die
Eingabeaufforderung und die Shell eine besondere Bedeutung besitzt. Bei der
Verwendung von Batch-Skripten werden die Anführungszeichen für diesen
Parameter nicht benötigt.
superGroup
Gibt Folgendes an: Name einer vorhandenen Computergruppe, in der die fragliche
Gruppe als Untergruppe erstellt wird. Wenn dieser Parameter nicht angegeben
wird, wird die Gruppe im Systemordner "Computer und Benutzer" erstellt.
swTemplate
Gibt Folgendes an: Namen der Softwarevorlage, der die Anweisung zugewiesen
wird.
Fehlt dieser Parameter, wird die Anweisung einer Softwarevorlage mit einem
Standardnamen ("<Gruppenname> [$date $time]") zugewiesen.
synchronisiert
Die Jobverknüpfungsoption wird auf "Synchronisierte Jobausführung" gesetzt.
Transaktion
Die Jobverknüpfungsoption wird auf "Batch-Jobausführung" gesetzt.
userMessage
Gibt die benutzerdefinierte Administratormeldung für eine Vorlagengruppe an.
Kapitel 3: cadsmcmd-Befehle 465
Kompatibilität
Beispiel:
Angenommen, eine Softwarevorlage wird benötigt, die folgende Anforderungen erfüllen
muss:
■
Der Name der Gruppe lautet "tgg".
■
Die Jobs auf dem Zielcomputer müssen in Folge ausgeführt werden. Wenn ein Job
fehlschlägt, werden die nachfolgenden Jobs nicht ausgeführt, und bereits
erfolgreich ausgeführte vorausgehende Jobs werden zurückgesetzt.
■
Abhängigkeiten zwischen Paketen, die zu überlappenden
Installationsanforderungen führen können, müssen aufgelöst werden.
■
Im Fall einer Konformitätsverletzung generiert die Softwarevorlage Jobs zur
Auflösung dieser Konformitätsverletzung und plant die Ausführung der Jobs.
■
Die Softwarevorlage ist nur auf Zielsysteme ausgerichtet, die zum Subnetz
172.16.213.* gehören und als Betriebssystem Windows&#160;NT Intel,
Windows&#160;2000 Intel oder Windows&#160;XP Intel ausführen.
■
Die Evaluierung der Gruppe soll beginnen, wenn diese versiegelt wird. Die
Evaluierung wird alle 48&#160;Stunden wiederholt. Die Evaluierung wird von einem
Kalender namens "tgCal" gesteuert.
Diese Gruppe können Sie mit dem folgenden Befehl erstellen:
cadsmcmd templateGroup action=create name=tgg transaction cascade
"setup&activate_jobs" query="Target.Address MATCHES '172.16.213.*' AND
(Target.OS='Win NT Intel' OR Target.OS='Win 2000 Intel' OR Target.OS='Win XP
Intel')" evaluationPeriod=48 calendarName=tgCal
Um die tatsächliche Liste der Softwarevorlagen zu steuern, können Sie mit dem
folgenden Befehl alle auf dem Server definierten Softwarevorlagen auflisten:
cadsmcmd templateGroup action=list
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
Verbindung zu Manager "<Standard-Manager>" als Benutzer "<Standardbenutzer>" wird
hergestellt... OK.
Manager: myManager
Domäne: myDomain
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
466 CLI-Referenzhandbuch
Kompatibilität
------------------------------------------------------------------------------Liste der Vorlagengruppen
------------------------------------------------------------------------------TG_KKKKK01A (lokal, Abfrage)
tgg (lokal, Abfrage)
tgs (lokal)
tg (lokal)
------------------------------------------------------------------------------Anzahl gefundener Software-Vorlagen: 4
SDCMD<A000000>: OK
Um die Attribute der erstellten Softwarevorlage zu steuern, können Sie mit dem
folgenden Befehl die Attributeinstellungen der Gruppe zurückgeben:
cadsmcmd templateGroup action=showAttr name=tgg
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
Verbindung zu Manager "<Standard-Manager>" als Benutzer "<Standardbenutzer>" wird
hergestellt... OK.
Manager: myManager
Domäne: myDomain
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
Kapitel 3: cadsmcmd-Befehle 467
Kompatibilität
------------------------------------------------------------------------------Attribute von Vorlagengruppe "tgg" anzeigen
------------------------------------------------------------------------------Name der Vorlagengruppe.............: tgg
Gruppentyp............................: Abfrage-/Vorlagengruppe
Bereich..................................: Lokal
Abfrage..................................: USD_tgg [04/09/05 13:53:49.916]
Kommentar.............................:
Engine-Name............................: <Alle Engines>
Engine-Zeitraum (Minuten)................: 1
Erstellungsdatum..........................: 2005-04-09
Erstellungszeitpunkt..........................: 13:53
Änderungsdatum............................: 2005-04-09
Änderungszeitpunkt............................: 13:53
Name der Vorlage......................: tgg [$date $time]
..Bereich..............................: Lokal
..Status...............................: Deaktiviert
..Jobcontainer-Priorität...............: 5
..Versiegelt..........................: Nein
..Kommentar...........................:
..Eigenschaften der Vorlage...........: 148
.........................................Transaktion
.........................................Überlappende Installation
.........................................Job-Setup und Aktivierung bei Nichtkon
.........................................+ formität
Kalendername...........................: tgCal
Evaluierungszeitraum......................: 48
Nächstes Evaluierungsdatum...................: 2005-04-09
Nächster Evaluierungszeit...................: 13:32
Letztes Evaluierungsdatum...................: 2005-04-09
Letzter Evaluierungszeit...................: 13:53
Evaluierungstypmaske...................: 196609
.........................................Periodisch
.........................................Abfrageevaluierung
.........................................Vorlagenevaluierung
SDCMD<A000000>: OK
delete – Löschen einer Software-Vorlage
Diese Aktion löscht eine vorhandene Softwarevorlage oder die gesamte
Vorlagengruppe. Die Gruppe darf nicht versiegelt sein.
Diese Aktion hat das folgende Format:
templategroup action=delete
name=Name_der_Vorlagengruppe
[swTemplate=Name_der_Software-Vorlage]
468 CLI-Referenzhandbuch
Kompatibilität
Name
Gibt Folgendes an: Name der Vorlagengruppe.
Ob die gesamte Gruppe oder nur eine angegebene Softwarevorlage gelöscht wird,
hängt von dem Parameter "swTemplate" ab.
swTemplate
Gibt Folgendes an: Namen der Softwarevorlage.
Bei Angabe dieses Parameters wird nur die angegebene Softwarevorlage gelöscht.
Die Gruppe selbst und weitere Softwarevorlagen, die möglicherweise dieser Gruppe
zugewiesen sind, bleiben erhalten.
Ist dieser Parameter nicht angegeben, werden die Gruppe und alle zugehörigen
Softwarevorlagen gelöscht.
deregister – Aufheben der Registrierung einer Vorlage
Diese Aktion hebt die Registrierung einer Softwarevorlage oder Richtlinie beim
Domänen-Manager über den Enterprise-Manager auf.
Diese Aktion ist nur für Enterprise-Manager verfügbar.
Diese Aktion hat das folgende Format:
templateGroup action=deregister
name=Name_der_Vorlagengruppe
[swTemplate=Name_der_Software-Vorlage]
cname=[Name]
{{area=Bereichsname} | {domain=Domänenname} | toAllAreas}
[sendTime=JJJJ-MM-TT HH:MM]
[haltTime=JJJJ-MM-TT HH:MM]
[distPriority={1,...,10}]
Kapitel 3: cadsmcmd-Befehle 469
Kompatibilität
area
Gibt den Namen eines Domänen-Managers an, bei dem die Registrierung einer
Vorlage aufgehoben wird. Der Parameter kann mehrfach angegeben werden, um
eine Liste von Domänen-Managern anzusprechen.
Dieser Parameter sollte nicht mit den Parametern "domain" oder "toAllAreas"
angegeben werden.
cname
Gibt Folgendes an: optionaler eindeutiger Name eines Verteilungscontainers, der
für die Übermittlung der Anforderung zur Aufhebung der Registrierung verwendet
wird.
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.
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 den Namen einer Gruppe von Domänen-Managern an, bei denen die
Registrierung einer Vorlage aufgehoben wird. Der Parameter kann mehr als einmal
gekodet werden, um sich auf eine Liste der Gruppen von Domänen-Managern zu
beziehen.
Dieser Parameter sollte nicht zusammen mit dem Parameter "area" oder dem
Parameter "toAllAreas" verwendet werden.
halttime
Gibt Datum und Uhrzeit des Zeitpunkts an, zu dem die Aufhebung der Registrierung
beendet wird, falls sie bis dahin nicht verarbeitet wurde. Die Zeitangabe erfolgt im
ISO-Format und sollte einen Zeitpunkt mindestens 1 Stunde nach der Startzeit
bezeichnen. Bei fehlender Angaben wird für "halttime" ein Wert generiert, der sich
aus dem Wert von "starttime" + 1&#160;Stunde errechnet.
Name
Gibt den Namen der Vorlagengruppe an.
470 CLI-Referenzhandbuch
Kompatibilität
sendtime
Gibt die Startzeit für die Verteilung vom Enterprise-Manager an. Das Datum wird im
ISO-Format angegeben. Wenn nicht codiert, werden das aktuelle Datum und die
aktuelle Uhrzeit verwendet.
swTemplate
Gibt den Namen der Softwarevorlage an, deren Registrierung aufgehoben werden
soll.
Bei fehlender Angabe wird der Standardname ("<Gruppenname> [$date $time]")
verwendet.
toAllAreas
Alle zurzeit beim Enterprise-Manager registrierten Domänen-Manager sind
Adressaten der angeforderten Aufhebung der Registrierung bezüglich der
angegebenen Softwarevorlage oder Richtlinie.
evaluate – Evaluieren einer Vorlage
Diese Aktion evaluiert eine versiegelte Softwarevorlage einer Gruppe.
Diese Aktion ist nur für Domänen-Manager zulässig.
Diese Aktion hat das folgende Format:
templateGroup action=evaluate
name=Name_der_Vorlagengruppe
[swTemplate=Name_der_Software-Vorlage]
Name
Gibt den Namen der Vorlagengruppe an.
swTemplate
Gibt den Namen der Softwarevorlage an, die evaluiert werden soll.
Fehlt dieser Parameter, wird die Anweisung einer Softwarevorlage mit einem
Standardnamen ("<Gruppenname> [$date $time]") zugewiesen.
list – Auflisten von Vorlagengruppen
Diese Aktion listet die verfügbaren Vorlagengruppen auf.
Diese Aktion hat das folgende Format:
templategroup action=list
Kapitel 3: cadsmcmd-Befehle 471
Kompatibilität
Die folgenden Informationen werden ausgegeben:
-------------------------------------Liste der Vorlagengruppen
-------------------------------------tg1 (lokal)
tgq1 (lokal, Abfrage)
tgqp (lokal, Abfrage)
Der Typ des Bereichs und die Abfragegruppen werden in Klammern angezeigt.
Beispiel
cadsmcmd templateGroup action=listComp name=tg
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
Verbindung zu Manager "<Standard-Manager>" als Benutzer "<Standardbenutzer>" wird
hergestellt... OK.
Manager: myManager
Domäne: myDomain
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
------------------------------------------------------------------------------Liste der der Vorlagengruppe "tgs" zugewiesenen Zielcomputer
------------------------------------------------------------------------------PPAPPGP0C
KKKKK01A
ORIONXH
SPICAYI
WWWWW01B
------------------------------------------------------------------------------Anzahl der gelesenen Zielcomputer: 5
SDCMD<A000000>: OK
472 CLI-Referenzhandbuch
Kompatibilität
listExceptions – Auflisten von Ausnahmen
Diese Aktion listet alle Zielcomputer auf, die Mitglieder dieser Softwarevorlage sind,
jedoch nicht der Jobzuweisung entsprechen ("Verletzer"), d.&#160;h., das noch nicht
alle zugewiesenen Jobs erfolgreich beendet wurden.
Diese Aktion ist nur für Domänen-Manager zulässig.
Diese Aktion hat das folgende Format:
templategroup action=listExceptions
name=Name_der_Vorlagengruppe
[swTemplate=Name_der_Software-Vorlage]
Name
Gibt Folgendes an: Name der Vorlagengruppe, für die die als Ausnahmen (d. h. als
Verletzer einer Vorlage) identifizierten Zielmitglieder aufgelistet werden.
swTemplate
Gibt Folgendes an: Namen der Softwarevorlage, für die die Ausnahmen aufgelistet
werden.
Bei fehlender Angabe wird der Standardname ("<Gruppenname> [$date $time]")
verwendet.
Folgende Informationen werden für die Zielliste zur Verfügung gestellt:
--------------------------------------------------------------------------Liste der Ausnahmemitglieder der Vorlagengruppe "<Name der Softwarevorlage>"
--------------------------------------------------------------------------<Computername>
<Computername>
<Computername>
Kapitel 3: cadsmcmd-Befehle 473
Kompatibilität
Beispiel:
Angenommen, es werden Informationen zu den Zielen benötigt, die nicht mit den
Anforderungen der Softwarevorlage "tg" konform sind. Der folgende Befehl listet alle
Ziele auf, die der Vorlage "tg" derzeit zugewiesen, jedoch nicht konform sind.
cadsmcmd templateGroup action=listExceptions name=tg
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
Verbindung zu Manager "<Standard-Manager>" als Benutzer "<Standardbenutzer>" wird
hergestellt... OK.
Manager: myManager
Domäne: myDomain
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
------------------------------------------------------------------------------Liste der Ausnahmemitglieder der Softwarevorlage "tg"
------------------------------------------------------------------------------GS_ELSEN
GS_MARIENLOH
GS_SALZKOTTEN
GS_WEWELSBURG
GS_WEWER
SDCMD<A000000>: OK
listMembership – Auflisten der Zugehörigkeiten einer Vorlagengruppe
Diese Aktion listet alle Computergruppen auf, welche die angegebene Softwarevorlage
als Untergruppe enthalten.
Diese Aktion hat das folgende Format:
templategroup action=listMembership
name=Name_der_Vorlagengruppe
474 CLI-Referenzhandbuch
Kompatibilität
Name
Gibt Folgendes an: Name der Vorlagengruppe, deren Mitgliedschaften aufgelistet
werden.
Die folgenden Informationen werden bereitgestellt:
--------------------------------------------------------------------------"<Name der Software-Vorlage >" ist Mitglied der folgenden Gruppen
--------------------------------------------------------------------------<Gruppenname> (<Gruppentyp>, <Gruppenstatus>, <Registrierungsdatum>)
<Gruppenname> (<Gruppentyp>, <Gruppenstatus>, <Registrierungsdatum>)
<Gruppenname> (<Gruppentyp>, <Gruppenstatus>, <Registrierungsdatum>)
Beispiel:
Angenommen, es werden Informationen zu den Gruppen benötigt, welche die
Softwarevorlage "tg" als Untergruppe enthalten. Der folgende Befehl listet alle Gruppen
auf, die "tg" enthalten:
cadsmcmd templateGroup action=listMembership name=tg
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
Verbindung zu Manager "<Standard-Manager>" als Benutzer "<Standardbenutzer>" wird
hergestellt... OK.
Manager: myManager
Domäne: myDomain
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
------------------------------------------------------------------------------"tg" ist Mitglied der folgenden Gruppen
------------------------------------------------------------------------------cg (Gruppe, Betriebsbereit, 08.04.05 12:08)
superTg (Vorlagengruppe, Konform, 2005-04-08 12:00)
SDCMD<A000000>: OK
Kapitel 3: cadsmcmd-Befehle 475
Kompatibilität
modify – Ändern von Attributen einer Vorlagengruppe bzw. Software-Vorlage
Dieser Befehl ändert die Attribute einer vorhandenen Softwaregruppe und -Vorlage.
Dieser Befehl hat das folgende Format:
templategroup action=modify name=Name_der_Vorlagengruppe
[newName=Name_der_Vorlagengruppe]
[swTemplate=Name_der_Software-Vorlage]
[newSwTemplate=Neuer_Name_der_Softwarevorlage]
[comment=Kommentar]
[{query="Abfrage" | queryfile=Dateiname | noquery}]
[engineName=Engine-Name
[enginePeriod=Engine-Evaluierungshäufigkeit]]
[{transaction|synchronized|nolinkage}]
[rollback[={y|n}]]
[cascade[={y|n}]]
[{nosetup | setup_jobs | setup&activate_jobs}]
| [regenerate [ = {y/n}]]
| [{adhoc_disable | adhoc_only | adhoc_always}]
[evaluationstart ="JJJJ-MM-TT hh:mm"]
[evaluationperiod=Stunden]
[calendarname=Kalendername]
[globalTime[={y|n}]]
[jcPriority={1,...,10}]
[userMessage]
{adhoc_disable | adhoc_only | adhoc_always}
Dieser Code besitzt die folgende Funktion:
adhoc_disable
Adhoc-Evaluierung ist deaktiviert.
476 CLI-Referenzhandbuch
Kompatibilität
adhoc_only
Adhoc-Evaluierung wird nur aktiviert, wenn neue oder erneut installierte Ziele
ihr Inventar melden.
adhoc_always
Adhoc-Evaluierung wird immer aktiviert, wenn Ziele ihr Inventar melden.
calendarname
Gibt Folgendes an: Name des Kalenders, der die Zeit steuert, während der die
Evaluierung ausgeführt werden kann.
Hinweis: Sie müssen auch einen Wert für "evaluationperiod" eingeben, wenn Sie
einen Eintrag für "calendarname" aktivieren möchten.
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.
Dieser Parameter sollte nur angegeben werden, wenn sich die Jobverknüpfung des
Containers im Batch-Verarbeitungs- oder Synchronisierungsmodus befindet oder
mit dieser Aktion (durch die Eingabe von "Transaktion" oder "synchronisiert") in
einen dieser Modi versetzt wird.
comment
Ein Kommentar wird durch den angegebenen Wert ersetzt.
Hinweis: Geben Sie eine leere Zeichenfolge ein (""), um einen vorhandenen
Kommentar zu löschen.
engineName
Gibt den Namen einer Engine an, die die Gruppenevaluierung verarbeitet.
Bei Angabe einer leeren Zeichenfolge kann die Abfrage von einer beliebigen Engine
verarbeitet werden.
Wenn der Gruppe derzeit keine Abfrage zugewiesen ist, wird eine Warnung
angezeigt, und der Parameter wird ignoriert.
enginePeriod
Gibt den Zeitraum in Minuten an, in dem die Engine die Gruppe neu evaluiert.
Wenn dieser Parameter nicht angegeben wird, wird von einem Zeitraum von 1
Minute ausgegangen.Wenn der Gruppe zurzeit keine Abfrage zugewiesen und keine
bestimmte Engine für die Verarbeitung der Evaluierung angegeben ist, wird eine
Warnung ausgegeben und der Parameter wird ignoriert.
Kapitel 3: cadsmcmd-Befehle 477
Kompatibilität
evaluationstart
Zeitpunkt, zu dem die Evaluierung beginnen soll. Der Zeitpunkt muss im ISO-Format
"JJJJ-MM-TT HH:MM" angegeben werden. Wenn "EvaluationStart" nicht angegeben
wird, wird der tatsächliche Zeitpunkt verwendet.
Dieser Parameter sollte nur für Abfrage- oder Vorlagengruppen verwendet werden.
evaluationperiod
Der Zeitraum, in dem die Abfrage evaluiert wird. Der Zeitraum wird in Stunden
angegeben.
Dieser Parameter kann nur für Abfrage- oder Vorlagengruppen verwendet werden.
Wenn 0 (null) angegeben wird, wird die periodische Evaluierung deaktiviert.
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änenManagers.
jcPriority
Gibt Folgendes an: neue Priorität, die dem Jobcontainer 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 die Priorität nicht geändert.
Name
Gibt Folgendes an: Name der Vorlagengruppe, der geändert werden soll.
newName
Neuer Name der Vorlagengruppe.
newSwTemplate
Gibt den neuen Namen der entsprechenden Softwarevorlage an.
nolinkage
Führt den Job unabhängig von den anderen Jobs im Container aus.
478 CLI-Referenzhandbuch
Kompatibilität
noquery
Eine eventuell angegebene Abfrage wird gelöscht.
nosetup
Wenn dieser Parameter angegeben wurde, werden nur Konformitätsprüfungen
aber keine Jobsetups ausgeführt.
query
Gibt an, dass die Vorlage ebenfalls eine Abfragegruppe ist. Die angegebene Abfrage
muss eine USD 4.0 SP1-Legacy-Abfrage sein.
queryfile
Gibt an: Die Datei, in der die Abfrage gespeichert ist. Die Größe der gespeicherten
Abfrage ist nur durch die Kapazität des Servers beschränkt. Bei der Abfrage muss es
sich um eine mit SD 4.0 SP1 kompatible zulässige Abfrage handeln.
regenerate
Bei "regenerate" oder "regenerate=y" wird eine Regenerierung der zuvor für diese
Vorlage fehlgeschlagenen Jobs durchgeführt.
Wird "regenerate=n" angegeben, erfolgt keine Regenerierung.
Bei fehlender Angabe des Parameters wird "regenerate=y" angenommen.
Rollback
Setzt die Jobverknüpfungsoption auf "Transaktion aktivieren".
Dieser Parameter sollte nur angegeben werden, wenn sich der Container bereits im
Modus Batch-Verarbeitung befindet oder durch diesen Befehl in diesen Modus
versetzt wird (Parameter "transaction").
setup_jobs
Jobs werden in Übereinstimmung mit der Konformitätsprüfung eingerichtet, jedoch
nicht aktiviert.
Kapitel 3: cadsmcmd-Befehle 479
Kompatibilität
setup&activate_jobs
Jobs werden in Übereinstimmung mit der Konformitätsprüfung eingerichtet und
aktiviert.
Hinweise: Wenn der Parameter "setup&activate_jobs" über die
Eingabeaufforderung oder die Shell-Ebene verwendet wird, muss der Parameter in
Anführungszeichen eingeschlossen werden, da das Zeichen "&" für die
Eingabeaufforderung und die Shell eine besondere Bedeutung besitzt. Bei der
Verwendung von Batch-Skripten werden die Anführungszeichen für diesen
Parameter nicht benötigt.
swTemplate
Gibt Folgendes an: Namen der Softwarevorlage, deren Attribute geändert werden.
Bei fehlender Angabe wird der Standardname ("<Gruppenname> [$date $time]")
verwendet.
synchronisiert
Die Jobverknüpfungsoption wird auf "Synchronisierte Jobausführung" gesetzt.
Transaktion
Die Jobverknüpfungsoption wird auf "Batch-Jobausführung" gesetzt.
userMessage
Ändert die benutzerdefinierte Administratormeldung, während eine
Vorlagengruppe aktualisiert wird.
Hinweis: Wenn ein Parameter nicht angegeben wird, bleibt das entsprechende Attribut
unverändert.
Beispiel:
Angenommen, eine Softwarevorlage namens "tg" wird auf einem Domänen-Manager
definiert. Diese Gruppe soll folgendermaßen geändert werden:
■
Die Verknüpfungskonvention soll auf Batch-Jobverarbeitung mit Rollback und
automatische Auflösung einer überlappenden Installation eingestellt sein.
■
Die Konformitätsprüfung soll bewirken, dass die Jobs automatisch aktiviert werden.
■
Die Softwarevorlage sollte ab 1. Oktober 2005, 01:00, alle 12 Stunden evaluiert
werden.
■
Die Zeitangaben sollen auf der Zeit des Enterprise-Managers basieren.
Diese Aktion ist nur auf Enterprise-Managern zulässig.
cadsmcmd templateGroup action=modify name=tg transaction rollback cascade
"setup&activate_jobs" evaluationstart="2005-10-01 01:00" evaluationperiod=12
GlobalTime
480 CLI-Referenzhandbuch
Kompatibilität
register – Registrieren einer Vorlage
Diese Aktion registriert eine Software-Vorlage oder Richtlinie am Domänen-Manager
vom Enterprise-Manager.
Diese Aktion ist nur für Enterprise-Manager verfügbar.
Diese Aktion hat das folgende Format:
templateGroup action=register
name=Name_der_Vorlagengruppe
[swTemplate=Name_der_Software-Vorlage]
cname=[Name]
{{area=Bereichsname} | {domain=Domänenname} | toAllAreas}
[sendTime=JJJJ-MM-TT HH:MM]
[haltTime=JJJJ-MM-TT HH:MM]
[distPriority={1,...,10}]
area
Gibt den Namen eines Domänen-Managers an, bei dem die Vorlage registriert wird.
Der Parameter kann mehrfach angegeben werden, um eine Liste von DomänenManagern anzusprechen.
Dieser Parameter sollte nicht mit den Parametern "domain" oder "toAllAreas"
angegeben werden.
cname
Gibt Folgendes an: optionaler eindeutiger Name eines Verteilungscontainers, der
für die Übermittlung der Registrierungsanforderung verwendet wird.
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.
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.
Kapitel 3: cadsmcmd-Befehle 481
Kompatibilität
domain
Gibt den Namen des Domänen-Managers ans, bei dem die Vorlage als Mitglied
verzeichnet ist. Der Parameter kann mehr als einmal gekodet werden, um sich auf
eine Liste der Gruppen von Domänen-Managern zu beziehen.
Dieser Parameter sollte nicht zusammen mit dem Parameter "area" oder dem
Parameter "toAllAreas" verwendet werden.
halttime
Gibt Datum und Uhrzeit des Zeitpunkts an, an dem die Registrierung beendet wird,
falls sie bis dahin nicht verarbeitet wurde. Die Zeitangabe erfolgt im ISO-Format und
sollte einen Zeitpunkt mindestens 1 Stunde nach der Startzeit bezeichnen. Bei
fehlender Angaben wird für "halttime" ein Wert generiert, der sich aus dem Wert
von "starttime" + 1 Stunde errechnet.
Name
Gibt den Namen der Vorlagengruppe an.
sendtime
Gibt die Startzeit für die Verteilung vom Enterprise-Manager an. Das Datum wird im
ISO-Format angegeben. Wenn nicht codiert, werden das aktuelle Datum und die
aktuelle Uhrzeit verwendet.
swTemplate
Versiegeln einer Softwarevorlage
Bei fehlender Angabe wird der Standardname ("<Gruppenname> [$date $time]")
verwendet.
toAllAreas
Alle zurzeit beim Enterprise-Manager registrierten Domänen-Manager sind
Adressaten der Registrierung bezüglich der angegebenen Software-Vorlage oder
Richtlinie.
showAttr – Attribute der Software-Vorlage anzeigen
Diese Aktion zeigt die Attribute der angegebenen Softwarevorlage an.
Diese Aktion hat das folgende Format:
templategroup action=showattr
name=Name_der_Vorlagengruppe
Name
Gibt Folgendes an: Name der Vorlagengruppe, für die die Attribute und die
Attribute der zugeordneten Software-Vorlagen angezeigt werden.
482 CLI-Referenzhandbuch
Kompatibilität
seal – Versiegeln von Software-Vorlagen
Diese Aktion versiegelt Software-Vorlagen.
Diese Aktion ist nur für Domänen-Manager zulässig.
Diese Aktion hat das folgende Format:
templategroup action=seal
name=Name_der_Vorlagengruppe
[swTemplate=Name_der_Software-Vorlage]
Name
Gibt Folgendes an: Name der Vorlagengruppe.
swTemplate
Gibt Folgendes an: Namen der Softwarevorlage, die versiegelt werden soll.
Bei fehlender Angabe wird der Standardname ("<Gruppenname> [$date $time]")
verwendet.
setupExecuteJobs – Einrichten und Ausführen von Jobs für eine Software-Vorlage
Diese Aktion legt die Jobs für die Software-Vorlage fest und aktiviert die Jobs.
Diese Aktion ist nur für Domänen-Manager zulässig.
Diese Aktion hat das folgende Format:
templategroup action=setupexecutejobs
name=Name_der_Vorlagengruppe
[swTemplate=Name_der_Software-Vorlage]
Name
Gibt Folgendes an: Name der Vorlagengruppe.
swTemplate
Gibt Folgendes an: Namen der Softwarevorlage, für die die Jobs eingerichtet und
aktiviert werden.
Bei fehlender Angabe wird der Standardname ("<Gruppenname> [$date $time]")
verwendet.
Kapitel 3: cadsmcmd-Befehle 483
Kompatibilität
setupJobs – Einrichten von Jobs für eine Software-Vorlage
Diese Aktion legt Jobs für Software-Vorlagen fest, aktiviert sie jedoch nicht.
Diese Aktion ist nur für Domänen-Manager zulässig.
Diese Aktion hat das folgende Format:
templategroup action=setupjobs
name=Name_der_Vorlagengruppe
[swTemplate=Name_der_Software-Vorlage]
Name
Gibt Folgendes an: Name der Vorlagengruppe.
swTemplate
Gibt Folgendes an: Namen der Softwarevorlage, für die die Jobs eingerichtet
werden.
Bei fehlender Angabe wird der Standardname ("<Gruppenname> [$date $time]")
verwendet.
unseal – Aufheben der Versiegelung von Software-Vorlagen
Diese Aktion hebt die Versiegelung einer Software-Vorlage auf
Diese Aktion ist nur für Domänen-Manager zulässig.
Diese Aktion hat das folgende Format:
templategroup action=unseal
name=Name_der_Vorlagengruppe
[swTemplate=Name_der_Software-Vorlage]
Name
Gibt Folgendes an: Name der Vorlagengruppe.
swTemplate
Gibt Folgendes an: Namen der Softwarevorlage, deren Versiegelung aufgehoben
werden soll.
Bei fehlender Angabe wird der Standardname ("<Gruppenname> [$date $time]")
verwendet.
484 CLI-Referenzhandbuch
Kompatibilität
Hinzufügen einer Computerliste zu einer Vorlagengruppe
Dieser Abschnitt enthält die folgenden Themen:
addComp – Hinzufügen einer Computerliste zu einer Software-Vorlage (siehe Seite 485)
listComp – Auflisten von Computern einer Vorlagengruppe (siehe Seite 488)
removeComp – Entfernen eines Computers aus einer Software-Vorlagengruppe (siehe
Seite 488)
addComp – Hinzufügen einer Computerliste zu einer Software-Vorlage
Diese Aktion fügt der Software-Vorlage eine Liste mit Computern hinzu. Die
Versiegelung der Software-Vorlage muss aufgehoben werden und die Software-Vorlage
sollte keine Abfragegruppe sein.
Diese Aktion ist nur für Domänen-Manager zulässig.
Diese Aktion hat das folgende Format:
templategroup action=addcomp
name=Name_der_Vorlagengruppe
{computer=Computername}
Name
Gibt Folgendes an: Name der Vorlagengruppe, der erweitert werden soll.
computer
Gibt Folgendes an: Name des Computers, der zur Software-Vorlage hinzugefügt
werden soll.
Dieser Parameter kann mehrmals (mindestens jedoch einmal) angegeben werden.
Kapitel 3: cadsmcmd-Befehle 485
Kompatibilität
Beispiel:
Nehmen Sie an, dass die Software-Vorlage keiner Abfrage zugewiesen ist. Um die Ziele
zu bestimmen muss der Benutzer den Zielcomputer manuell hinzufügen oder entfernen,
während die Gruppe nicht versiegelt ist Nehmen Sie an, dass die Gruppe versiegelt ist
und das Ziel HHHHH01B enthält, das entfernt werden sollt. Ein neues Ziel wird
außerdem mit dem Namen ORIONXH und SPICAYI hinzugefügt. Nach diesen
Änderungen muss die Gruppe erneut versiegelt werden.
Zuerst wird eine Liste aller der Gruppe zugewiesenen Ziele über den folgenden Befehl
angezeigt:
cadsmcmd templateGroup action=listComp name=tgs
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
Verbindung zu Manager "<Standard-Manager>" als Benutzer "<Standardbenutzer>" wird
hergestellt... OK.
Manager: myManager
Domäne: myDomain
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
------------------------------------------------------------------------------Liste der der Vorlagengruppe "tgs" zugewiesenen Zielcomputer
------------------------------------------------------------------------------PPAPPGP0C
HHHHH01B
KKKKK01A
WWWWW01B
------------------------------------------------------------------------------Anzahl der gelesenen Zielcomputer: 4
SDCMD<A000000>: OK
Um die Liste der zugewiesenen Ziele zu ändern, muss die Versiegelung der Gruppe zuvor
aufgehoben werden.
cadsmcmd templateGroup action=unseal name=tgs
486 CLI-Referenzhandbuch
Kompatibilität
Danach wird HHHHH01B von der Liste durch den folgenden Befehl entfernt:
cadsmcmd templateGroup action=removeComp name=tgs computer=HHHHH01B
Mit dem folgenden Befehl werden ORIONXH und SPICAYI zur Liste hinzugefügt:
cadsmcmd templateGroup action=addComp name=tgs computer=ORIONXH computer=SPICAYI
Die geänderte Liste wird über den folgenden Befehl angezeigt:
cadsmcmd templateGroup action=listComp name=tgs
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Verbindung zu Manager "<Standardmanager>" als Benutzer "<Standardbenutzer>" wird
hergestellt ...OK.
Manager: myManager
Domäne: myDomain
Domänentyp: Domäne
Unterstützt: CO CONF USD OSIM
------------------------------------------------------------------------------Liste der der Vorlagengruppe "tgs" zugewiesenen Zielcomputer
------------------------------------------------------------------------------PPAPPGP0C
KKKKK01A
ORIONXH
SPICAYI
WWWWW01B
------------------------------------------------------------------------------Anzahl der gelesenen Zielcomputer: 6
SDCMD<A000000>: OK
Zuletzt muss die Gruppe noch über den folgenden Befehl versiegelt werden:
sdcmd templateGroup action=seal name=tgs
Kapitel 3: cadsmcmd-Befehle 487
Kompatibilität
listComp – Auflisten von Computern einer Vorlagengruppe
Diese Aktion listet die Computer für die angegebene Softwarevorlage auf.
Diese Aktion ist nur für Domänen-Manager zulässig.
Diese Aktion hat das folgende Format:
templategroup action=listComp
name=Name_der_Vorlagengruppe
Name
Gibt Folgendes an: Name der Vorlagengruppe.
removeComp – Entfernen eines Computers aus einer Software-Vorlagengruppe
Diese Aktion entfernt eine Liste der Computer aus der angegebenen Software-Vorlage.
Die Software-Vorlage darf nicht versiegelt sein.
Diese Aktion ist nur für Domänen-Manager zulässig.
Diese Aktion hat das folgende Format:
templategroup action=removecomp
name=Name_der_Vorlagengruppe
{computer=Computername}
computer
Gibt Folgendes an: Name des Computers, der aus der Software-Vorlage entfernt
werden soll.
Der Parameter kann mehrfach angegeben werden.
Name
Gibt den Namen der Name der Vorlagengruppe an..
Beispiel:
Der Computer HHHHH01B wird aus der Software-Vorlage "tgs" über den foglenden
Befehl entfernt:
cadsmcmd templateGroup action=removeComp name=tgs computer=HHHHH01B
488 CLI-Referenzhandbuch
Kompatibilität
Vorlagengruppen: Elementverwaltung
Dieser Abschnitt enthält die folgenden Themen:
activateItem – Aktivieren eines Elements in einer Software-Vorlage (siehe Seite 489)
addItem – Hinzufügen eines Elements zu einer Software-Vorlage (siehe Seite 495)
configureItem – Zuweisen eines Konfigurationsjobs zu einer Software-Vorlage (siehe
Seite 501)
modifyItem – Ändern eines Elements in einer Software-Vorlage (siehe Seite 507)
listItem – Auflisten von Elementen einer Software-Vorlage (siehe Seite 513)
Entfernen eines Elements aus einer Softwarevorlage (siehe Seite 515)
repositionJobs – Ändern der Positionen von Jobs in einer Software-Vorlage (siehe Seite
516)
showAttrItem – Anzeigen von Attributen eines Elements in einer Software-Vorlage
(siehe Seite 517)
uninstallItem – Deinstallieren eines Elements aus einer Vorlagengruppe (siehe Seite 519)
activateItem – Aktivieren eines Elements in einer Software-Vorlage
Dieser Befehl weist der Softwarevorlage einen Aktivierungsjob zu.
Dieser Befehl hat das folgende Format:
templategroup action=activateItem
name=Name_der_Vorlagengruppe
[swTemplate=Name_der_Software-Vorlage]
item=Elementname
version=Elementversion
procedure=Prozedurname
installedWith=Name_der_Installationsprozedur
[repeat]
after={exacttime|boottime}
[calendername=Lieferungskalender]
Kapitel 3: cadsmcmd-Befehle 489
Kompatibilität
[{preaction={none|reboot|logoff}|bootbefore}]
[{postaction=
{none|reboot|logoff|rebootAtEnd|logoffAtEnd|shutdownAtEnd}
|bootafter}]
[promptUser[={y|n}]]
[allowCancel[={y|n}]]
[execTimedOut[={y|n}]]
[prompt=Tage.Stunden]
[offline[={y|n}]]
[runAtShutdown[={y|n}]]
[preventLogon[={y|n}]]
[globalTime]
[nocalendar]
[resolveQuery]
[stagingServer]
[parameters=Benutzerparameter]
[{jobTimeout=t.h|timeout=Stunden}]
[userJobMessage]
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.
490 CLI-Referenzhandbuch
Kompatibilität
calendarname
Gibt Folgendes an: Name des Kalenders, der die Zeit steuert, während der die
Evaluierung ausgeführt werden kann.
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.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert
der zugehörigen Prozedur verwendet.
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änenManagers.
installedWith
Gibt Folgendes an: Name der Installationsprozedur, die das Element auf dem
Zielsystem installiert hat.
item
Gibt Folgendes an: Name des Elements, das aktiviert werden soll.
Name
Gibt Folgendes an: Name der Vorlagengruppe, zu der der Aktivierungsauftrag
hinzugefügt wird.
jobTimeOut
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.
(Standard)
Kapitel 3: cadsmcmd-Befehle 491
Kompatibilität
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.
Wenn der Parameter nicht gecodet ist, werden standardmäßig die
Benutzerparameter durch die Prozedurdefinition angegeben.
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
492 CLI-Referenzhandbuch
Kompatibilität
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.
Gibt Folgendes an:
Prozedur
Gibt Folgendes an: Name einer Prozedur (Aktivierungsprozedur), die ausgeführt
werden soll.
prompt=d.h
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.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert
der zugehörigen Prozedur verwendet.
Kapitel 3: cadsmcmd-Befehle 493
Kompatibilität
repeat
Wenn dieser Parameter angegeben wird, wird der Job bei jeder Evaluierung
wiederholt.
resolveQuery
Wertet vor Erstellung des Jobs eine möglicherweise vorhandene Abfragegruppe
aus.
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.
swTemplate
Gibt Folgendes an: Namen der Softwarevorlage, der die Anweisung zugewiesen
wird.
Fehlt dieser Parameter, wird die Anweisung einer Softwarevorlage mit einem
Standardnamen ("<Gruppenname> [$date $time]") zugewiesen.
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".
Version
Gibt Folgendes an: Version des Elements, das aktiviert werden soll.
userJobMessage
Gibt die benutzerdefinierte Administratormeldung für einen Aktivierungsjob in
einer Vorlagegruppe 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.
494 CLI-Referenzhandbuch
Kompatibilität
Beispiel:
Angenommen, das Produkt "prod" der Version "1.0/00" und eine Softwarevorlage "tg"
sind vorhanden. Jetzt muss eine Aktivierung des Produkts der Softwarevorlage
zugewiesen werden. Die auszuführende Aktivierungsroutine heißt "act" und wird
normalerweise nur auf den Systemen ausgeführt, auf denen das Produkt mit Hilfe der
Installationsroutine "inst_2" installiert wurde. Der angegebene Job muss die folgenden
Anforderungen erfüllen:
■
Die Aktivierung der Ziele sollte sofort gestartet werden.
■
Den Zielen zugewiesene Kalender werden für den Aktivierungszeitplan ignoriert.
■
Der Benutzer sollte eine Aufforderung zur Jobausführung erhalten, kann den Job
jedoch nicht abbrechen. Der Job wird automatisch gestartet, nachdem die
Aufforderung abgelaufen ist. Das Zeitlimit für die Aufforderung wird standardmäßig
angegeben.
Der folgende Befehl weist der angegebenen Softwarevorlage den erforderlichen Job zu.
cadsmcmd templateGroup action=activateItem name=tg item=prod version=1.0/00
procedure=act installedWith=inst_2 after=exacttime nocalendar promptUser
execTimedOut
addItem – Hinzufügen eines Elements zu einer Software-Vorlage
Dieser Befehl weist der Softwarevorlage einen Installationsjob zu.
Dieser Befehl hat das folgende Format:
version=Elementversion
name=Name_der_Vorlagengruppe
[swTemplate=Name_der_Software-Vorlage]
item=Elementname
version=Elementversion
procedure=Prozedurname
after={exacttime|boottime}
[calendername=Lieferungskalender]
[{preaction={none|reboot|logoff}|bootbefore}]
Kapitel 3: cadsmcmd-Befehle 495
Kompatibilität
[{postaction=
{none|reboot|logoff|rebootAtEnd|logoffAtEnd|shutdownAtEnd}
|bootafter}]
[promptUser[={y|n}]]
[allowCancel[={y|n}]]
[execTimedOut[={y|n}]]
[prompt=Tage.Stunden]
[offline[={y|n}]]
[runAtShutdown[={y|n}]]
[preventLogon[={y|n}]]
[globalTime]
[nocalendar]
[resolveQuery]
[stagingServer]
[parameters=Benutzerparameter]
[{jobTimeout=t.h|timeout=Stunden}]
[reinstall[={y|n}]]
[userJobMessage]
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.
496 CLI-Referenzhandbuch
Kompatibilität
calendarname
Gibt Folgendes an: Name des Kalenders, der die Zeit steuert, während der die
Evaluierung ausgeführt werden kann.
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.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert
der zugehörigen Prozedur verwendet.
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änenManagers.
item
Gibt Folgendes an: Name des Elements, die hinzugefügt werden sollen.
jobTimeOut
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".
Name
Gibt Folgendes an: Name der Vorlagengruppe, zu der der Installationsauftrag
hinzugefügt wird.
nocalendar
Wenn "noCalendar" angegeben ist, wird ein möglicherweise auf dem Zielcomputer
vorhandener Kalender für die Jobausführung ignoriert.
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.
Kapitel 3: cadsmcmd-Befehle 497
Kompatibilität
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.
Wenn der Parameter nicht gecodet ist, werden standardmäßig die
Benutzerparameter durch die Prozedurdefinition angegeben.
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.
498 CLI-Referenzhandbuch
Kompatibilität
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 der Installationsprozedur, die ausgeführt werden soll.
prompt
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
Wenn "reinstall" oder "reinstall=y" festgelegt wurde, wird während jeder
Evaluierung der Richtlinie ein Jobcontainer zum Installieren des Softwarepakets
eingerichtet, unabhängig davon, ob die Richtlinie bereits zuvor mit Hilfe der
ausgewählten Installationsprozedur installiert wurde.
Hinweis: Während der Evaluierung der Richtlinie wird kein Jobcontainer
eingerichtet, wenn gerade ein anderer Installationsjob mit der ausgewählten
Installationsprozedur oder ein Deinstallationsjob ausgeführt wird, während die
Richtlinienevaluierung stattfindet.
resolveQuery
Kapitel 3: cadsmcmd-Befehle 499
Kompatibilität
Wertet vor Erstellung des Jobs eine möglicherweise vorhandene Abfragegruppe
aus.
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.
stagingServer
Liefert das zugehörige Produkt auch an die Staging-Bibliotheken der ScalabilityServer der Zielcomputer.
Dieser Parameter bezieht sich nur auf Prozeduren des Aufgabentyps "install".
swTemplate
Gibt Folgendes an: Namen der Softwarevorlage, der die Anweisung zugewiesen
wird.
Fehlt dieser Parameter, wird die Anweisung einer Softwarevorlage mit einem
Standardnamen ("<Gruppenname> [$date $time]") zugewiesen.
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".
Version
Gibt Folgendes an: Version des Elements, die hinzugefügt werden sollen.
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.
userJobMessage
Gibt die benutzerdefinierte Administratormeldung für einen Installationsjob in
einer Vorlagegruppe an.
500 CLI-Referenzhandbuch
Kompatibilität
Beispiel:
Angenommen, ein Produkt "prod" der Version "1.0/00" und eine Softwarevorlage "tg"
sind vorhanden. Das Produkt wird der Softwarevorlage zur Installation mit Hilfe der
Installationsroutine "inst" zugewiesen. Die Installationsanforderung muss die folgenden
Anforderungen erfüllen:
■
Die Lieferung des Pakets muss in dem durch den Kalender "DelCal" vorgegebenen
Zeitrahmen erfolgen.
■
Die Installation auf den Zielen sollte so schnell wie möglich gestartet werden.
■
Der Benutzer muss beim Starten der Installation abgemeldet sein.
■
Während der Installation wird jede Benutzeranmeldung zurückgewiesen.
■
Die Installation wird über den Server offline ausgeführt.
■
Den Zielen zugewiesene Kalender werden für den Zeitplan der Installation ignoriert.
■
Nach der Installation muss das System neu gestartet werden. Dies kann jedoch
aufgeschoben werden, bis alle Jobs des zugehörigen Jobcontainers verarbeitet sind.
■
Das Produkt muss an die Softwarebibliotheken der Scalability-Server geliefert
werden, die mit den adressierten Zielen verbunden sind.
■
Der Job hat nach 24&#160;Stunden das Zeitlimit erreicht.
Der folgende Befehl weist der angegebenen Softwarevorlage den erforderlichen Job zu.
cadsmcmd templateGroup action=addItem name=tg item=prod version=1.0/00
procedure=inst calendarname=DelCal after=exacttime preaction=logoff offline
PreventLogon nocalendar postaction=rebootAtEnd stagingServer JobTimeout=1.0
configureItem – Zuweisen eines Konfigurationsjobs zu einer Software-Vorlage
Dieser Befehl weist der Softwarevorlage einen Konfigurationsjob zu.
Dieser Befehl hat das folgende Format:
templategroup action=configureItem
name=Name_der_Vorlagengruppe
[swTemplate=Name_der_Software-Vorlage]
item=Elementname
version=Elementversion
procedure=Prozedurname
installedWith=Name_der_Installationsprozedur
[repeat]
after={exacttime|boottime}
[calendername=Lieferungskalender]
[{preaction={none|reboot|logoff}|bootbefore}]
Kapitel 3: cadsmcmd-Befehle 501
Kompatibilität
[{postaction=
{none|reboot|logoff|rebootAtEnd|logoffAtEnd|shutdownAtEnd}
|bootafter}]
[promptUser[={y|n}]]
[allowCancel[={y|n}]]
[execTimedOut[={y|n}]]
[prompt=Tage.Stunden]
[offline[={y|n}]]
[runAtShutdown[={y|n}]]
[preventLogon[={y|n}]]
[globalTime]
[nocalendar]
[resolveQuery]
[parameters=Benutzerparameter]
[{jobTimeout=t.h|timeout=Stunden}]
[userJobMessage]
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.
502 CLI-Referenzhandbuch
Kompatibilität
calendarname
Gibt Folgendes an: Name des Kalenders, der die Zeit steuert, während der die
Evaluierung ausgeführt werden kann.
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.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert
der zugehörigen Prozedur verwendet.
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änenManagers.
(Standard)
installedWith
Gibt Folgendes an: Name der Installationsprozedur, die das Element auf dem
Zielsystem installiert hat.
item
Gibt Folgendes an: Name des Elements, das konfiguriert werden soll.
jobTimeOut
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".
Kapitel 3: cadsmcmd-Befehle 503
Kompatibilität
Name
Gibt Folgendes an: Name der Vorlagengruppe, zu der der Konfigurationsauftrag
hinzugefügt wird.
noCalendar
Wenn "noCalendar" angegeben ist, wird ein möglicherweise auf dem Zielcomputer
vorhandener Kalender für die Jobausführung ignoriert.
Bei Angabe von "nocalendar=n" wird der Kalender nicht ignoriert.
(Standard)
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.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert
der zugehörigen Prozedur verwendet.
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.
Wenn der Parameter nicht gecodet ist, werden standardmäßig die
Benutzerparameter durch die Prozedurdefinition angegeben.
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.
504 CLI-Referenzhandbuch
Kompatibilität
logoffAtEnd
Meldet die 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 (Konfigurationsprozedur), die ausgeführt
werden soll.
prompt=d.h
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.
Kapitel 3: cadsmcmd-Befehle 505
Kompatibilität
repeat
Wenn dieser Parameter angegeben wird, wird der Job bei jeder Evaluierung
wiederholt.
resolveQuery
Wertet vor Erstellung des Jobs eine möglicherweise vorhandene Abfragegruppe
aus.
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.
swTemplate
Gibt Folgendes an: Namen der Softwarevorlage, der die Anweisung zugewiesen
wird.
Fehlt dieser Parameter, wird die Anweisung einer Softwarevorlage mit einem
Standardnamen ("<Gruppenname> [$date $time]") zugewiesen.
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".
Version
Gibt Folgendes an: Version des Elements, das konfiguriert werden soll.
userJobMessage
Gibt die benutzerdefinierte Administratormeldung für einen Konfigurationsjob in
einer Vorlagegruppe 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.
506 CLI-Referenzhandbuch
Kompatibilität
Beispiel
Angenommen, das Produkt "prod" der Version "1.0/00" und eine Softwarevorlage "tg"
sind vorhanden. Jetzt muss eine Konfiguration des Produkts der Softwarevorlage
zugewiesen werden. Die auszuführende Konfigurationsroutine heißt "conf" und wird
normalerweise nur auf den Systemen ausgeführt, auf denen das Produkt mit Hilfe der
Installationsroutine "inst_1" installiert wurde. Der angegebene Job muss die folgenden
Anforderungen erfüllen:
■
Die Konfiguration auf den Zielen sollte nach dem nächsten Neustart gestartet
werden.
■
Während der Installation wird jede Benutzeranmeldung zurückgewiesen.
■
Den Zielen zugewiesene Kalender werden für den Zeitplan der Konfiguration
ignoriert.
■
Nach der Konfiguration sollte das Systems sofort neu gestartet werden.
■
Der Job hat nach 36&#160;Stunden das Zeitlimit erreicht.
Der folgende Befehl weist der angegebenen Softwarevorlage den erforderlichen Job zu.
cadsmcmd templateGroup action=configureItem name=tg item=prod version=1.0/00
procedure=conf installedWith=inst_1 after=boottime PreventLogon nocalendar
postaction=reboot JobTimeout=1.12
modifyItem – Ändern eines Elements in einer Software-Vorlage
Dieser Befehl ändert die Attribute eines Jobs, der einer Softwarevorlage zugewiesen ist.
Dieser Befehl hat das folgende Format:
templategroup action=modifyItem name=Name_der_Vorlagengruppe
[swTemplate=Name_der_Software-Vorlage]
jobName=Name_der_Elementauftrag
[newJobName=Neuer_Name_der_Elementanweisung]
after={exacttime|boottime}
[calendername=Lieferungskalender]
[preaction={none|reboot|logoff}]
[postaction={none|reboot|logoff|rebootAtEnd|logoffAtEnd|shutdownAtEnd}]
[promptUser[={y|n}]]
[allowCancel[={y|n}]]
[execTimedOut[={y|n}]]
[prompt=Tage.Stunden]
Kapitel 3: cadsmcmd-Befehle 507
Kompatibilität
[offline[={y|n}]]
[runAtShutdown[={y|n}]]
[preventLogon[={y|n}]]
[globalTime]
[nocalendar]
[resolveQuery]
[parameters=Benutzerparameter]
[repeat={y|n}]
[stagingServer]
[jobTimeout=t.h]
[reinstall[={y|n}]]
[userJobMessage]
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.
calendarname
Gibt Folgendes an: Name des Kalenders, der die Zeit steuert, während der die
Evaluierung ausgeführt werden kann.
Bei Eingabe einer leeren Zeichenfolge ("") wird der Eintrag für den Kalendernamen
gelöscht.
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.
508 CLI-Referenzhandbuch
Kompatibilität
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änenManagers.
jobName
Gibt Folgendes an: Name des Jobs , der geändert werden soll.
jobTimeOut
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".
Name
Gibt Folgendes an: Name der Vorlagengruppe, von der ein Element geändert wird.
newJobName
Neuer Name des Jobs .
noCalendar
Wenn "noCalendar" angegeben ist, wird ein möglicherweise auf dem Zielcomputer
vorhandener Kalender für die Jobausführung ignoriert.
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.
Kapitel 3: cadsmcmd-Befehle 509
Kompatibilität
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
510 CLI-Referenzhandbuch
Kompatibilität
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.
prompt=d.h
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
Wenn "reinstall" oder "reinstall=y" festgelegt wurde, wird während jeder
Evaluierung der Richtlinie ein Jobcontainer zum Installieren des Softwarepakets
eingerichtet, unabhängig davon, ob die Richtlinie bereits zuvor mit Hilfe der
ausgewählten Installationsprozedur installiert wurde.
Hinweis: Während der Evaluierung der Richtlinie wird kein Jobcontainer
eingerichtet, wenn gerade ein anderer Installationsjob mit der ausgewählten
Installationsprozedur oder ein Deinstallationsjob ausgeführt wird, während die
Richtlinienevaluierung stattfindet.
Kapitel 3: cadsmcmd-Befehle 511
Kompatibilität
repeat
Wenn dieser Parameter angegeben wird, wird der Job bei jeder Evaluierung
wiederholt.
resolveQuery
Wertet vor Erstellung des Jobs eine möglicherweise vorhandene Abfragegruppe
aus.
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.
stagingServer
Liefert das zugehörige Produkt auch an die Staging-Bibliotheken der ScalabilityServer der Zielcomputer.
Dieser Parameter bezieht sich nur auf Prozeduren des Aufgabentyps "install".
swTemplate
Gibt Folgendes an: Namen der Softwarevorlage, zu der das zu ändernde Element
gehört.
Bei fehlender Angabe wird der Standardname ("<Gruppenname> [$date $time]")
verwendet.
Hinweis: Wenn ein Parameter nicht angegeben wird, bleibt das entsprechende
Attribut unverändert.
userJobMessage
Ändert die benutzerdefinierte Administratormeldung eines Jobs in einer
Vorlagegruppe, während er die Jobeigenschaften aktualisiert.
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.
512 CLI-Referenzhandbuch
Kompatibilität
Beispiel:
Der Deinstallationsjob der Softwarevorlage "tg" wird unter folgenden Voraussetzungen
als geändert angesehen:
■
Der Benutzerparameter "-x -Nc -ro" muss hinzugefügt werden.
■
Das Jobzeitlimit wird auf 12&#160;Stunden begrenzt.
■
Während der Deinstallation muss jede Benutzeranmeldung zurückgewiesen
werden.
■
Die Benutzer müssen beim Starten des Jobs abgemeldet sein.
■
Der Job muss eine bestimmte Gruppenabfrage auflösen, bevor er erstellt und
gestartet wird.
Der folgende Befehl erfüllt diese Anforderungen:
cadsmcmd templateGroup action=modifyItem
name=tg
jobName="prod 1.0/00:uninstall"
preaction=logoff
PreventLogon
ResolveQuery
parameters="-x -Nc -ro"
JobTimeout=0.12
listItem – Auflisten von Elementen einer Software-Vorlage
Diese Aktion listet für die angegebene Softwarevorlage die Elemente im Ordners mit
zugewiesenen Jobs auf.
Diese Aktion hat das folgende Format:
templategroup action=listItem
name=Name_der_Vorlagengruppe
[swTemplate=Name_der_Software-Vorlage]
Kapitel 3: cadsmcmd-Befehle 513
Kompatibilität
Name
Gibt den Namen der Name der Vorlagengruppe an..
swTemplate
Gibt Folgendes an: Namen der Softwarevorlage, für die die Elemente aufgelistet
werden.
Bei fehlender Angabe wird der Standardname ("<Gruppenname> [$date $time]")
verwendet.
Die folgenden Informationen werden ausgegeben:
------------------------------------------------Liste der Elemente aus Vorlagengruppe "tg1"
------------------------------------------------tstool_1 1.0:inst
tstool_1 1.0:conf
-------------------------------------------------
Beispiel:
Angenommen, es werden Informationen zu allen der Softwarevorlage "tg"
zugewiesenen Elementen benötigt. Der folgende Befehl erstellt eine Liste mit allen der
Gruppe zugewiesenen Elementen:
cadsmcmd templateGroup action=listItem name=tg
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
514 CLI-Referenzhandbuch
Kompatibilität
Verbindung zu Manager "<Standard-Manager>" als Benutzer "<Standardbenutzer>" wird
hergestellt... OK.
Manager: myManager
Domäne: myDomain
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
------------------------------------------------------------------------------Liste der Elemente aus Vorlagengruppe "tg"
------------------------------------------------------------------------------tstbase 1.0: inst <1>
tstbase 1.0: remdir <2>
tstbase 1.0: setdir <3>
------------------------------------------------------------------------------Anzahl der gelesenen zugewiesenen Elemente: 3
SDCMD<A000000>: OK
Die Auftragsnummer der Jobs wird in spitzen Klammern angezeigt (<>).
Weitere Informationen zu einem bestimmten Job finden Sie unter "showAttrItem (Siehe
Definition auf Seite 517)".
Entfernen eines Elements aus einer Softwarevorlage
Diese Aktion entfernt einen durch Element, Version und Prozedur angegebenen Job aus
einer Softwarevorlage.
Diese Aktion hat das folgende Format:
templategroup action=removeitem
name=Name_der_Vorlagengruppe
[swTemplate=Name_der_Software-Vorlage]
item=Elementname
version=Elementversion
procedure=Prozedurname
Kapitel 3: cadsmcmd-Befehle 515
Kompatibilität
item
Gibt Folgendes an: Name des Elements, auf das sich der zu entfernende Job bezieht.
Name
Gibt Folgendes an: Name der Vorlagengruppe.
Prozedur
Name der Prozedur, auf die in dem zu entfernenden Job verwiesen wird.
swTemplate
Gibt Folgendes an: Namen der Softwarevorlage, aus der das Element entfernt wird.
Bei fehlender Angabe wird der Standardname ("<Gruppenname> [$date $time]")
verwendet.
Version
Gibt Folgendes an: Version des Elements, auf das sich der zu entfernende Job
bezieht.
Beispiel:
Angenommen, die Prozedur "inst" des Produkts "prod" der Version "1.0/00" ist der
Softwarevorlage "tg" zugewiesen und soll jetzt entfernt werden. Geben Sie den
folgenden Befehl ein, um das Element zu entfernen:
cadsmcmd templateGroup action=removeItem name=tg item=prod version=1.0/00
procedure=install
repositionJobs – Ändern der Positionen von Jobs in einer Software-Vorlage
Diese Aktion ordnet die einer Softwarevorlage zugewiesenen Jobs (Elemente) neu an,
indem eine neue Auftragsnummer für ein Element festgelegt wird.
Diese Aktion hat das folgende Format:
templategroup action=repositionJobs name=Name_der_Vorlagengruppe
[swTemplate=Name_der_Software-Vorlage]
jobName=Jobname
position=neue Position
516 CLI-Referenzhandbuch
Kompatibilität
Name
Gibt Folgendes an: Name der Vorlagengruppe, deren Jobs umgruppiert werden
sollen.
jobName
Gibt Folgendes an: Name des Jobs , der umgruppiert werden soll.
position
Gibt Folgendes an: neue Position des Jobs nach der Umgruppierung.
Die angegebene Zahl muss größer als 0 und kleiner oder gleich der Anzahl der der
Vorlagengruppe zugewiesenen Jobs sein.
swTemplate
Gibt Folgendes an: Namen der Softwarevorlage, in der der angegebene Job neu
positioniert wird.
Bei fehlender Angabe wird der Standardname ("<Gruppenname> [$date $time]")
verwendet.
Beispiel:
Angenommen, der Job "prod 1.0/00:inst" ist der Software-Vorlage "tg" zugewiesen und
hat die Auftragsnummer 11. Um die richtige Jobausführung sicherzustellen, muss der
Job auf Position 4 platziert werden. Geben Sie den folgenden Befehl ein, um den Job zu
verschieben:
cadsmcmd templateGroup action=repositionJobs name=tg jobName="prod
1.0/00:install" position=4
Die Positionsnummern der Jobs, die vor der Positionsänderung die Positionen 4 bis 10
belegt haben, werden um eins erhöht.
showAttrItem – Anzeigen von Attributen eines Elements in einer Software-Vorlage
Diese Aktion zeigt die Attribute eines Jobs an, der einer Softwarevorlage zugewiesen ist.
Diese Aktion hat das folgende Format:
templategroup action=showAttrItem
name=Name_der_Vorlagengruppe
[swTemplate=Name_der_Software-Vorlage]
jobName=Name_der_Elementauftrag
Kapitel 3: cadsmcmd-Befehle 517
Kompatibilität
jobName
Gibt den Namen des anzuzeigenden Elementauftrags an.
Name
Gibt den Namen der Softwarevorlage an, die den anzuzeigenden Elementauftrag
enthält.
swTemplate
Gibt Folgendes an: Namen der Softwarevorlage, zu der der anzuzeigende Job
gehört.
Bei fehlender Angabe wird der Standardname ("<Gruppenname> [$date $time]")
verwendet.
Beispiel: Anzeigen von Attributen eines Elements in einer Softwarevorlage
Angenommen, es soll der im Folgenden dargestellte zugewiesene Deinstallationsjob
angezeigt werden. Geben Sie den folgenden Befehl ein, um die gewünschten
Informationen zu erhalten:
cadsmcmd templateGroup action=showAttrItem name=tg swTemplate=tg
jobName="prod 1.0/00:unist"
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
Verbindung zu Manager "<Standard-Manager>" als Benutzer "<Standardbenutzer>" wird
hergestellt... OK.
Manager: myManager
Domäne: myDomain
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
518 CLI-Referenzhandbuch
Kompatibilität
------------------------------------------------------------------------------Attribute des zugewiesenen Jobs "prod 1.0/00:uninst"
........aus der Vorlagengruppe "tg" anzeigen
------------------------------------------------------------------------------Jobname................................: prod 1.0/00:uninst
..Elementname........................: prod
..Elementversion.........................: 1.0/00
..Elementtyp..........................: SOFTWARE
..Prozedurname..........................: uninst
..Lieferungskalender.................:
..Zeitlimit <Tage/Stunden>.................: 7 / 0
..Jobstart..............................: Lokale Zeit/exakt
..Aktion davor.........................: Keine Aktion
..Aktion danach.......................: Keine Aktion
..Jobmaske...................: 0
.........................................Kalender auf Zielsystemen ignorieren
..Benutzerparameter...................:
..Zeitlimit für Eingabeaufforderung <Tage/Stunden>..........: 1 / 0
..Jobtask..............................: 2 - uninstall
SDCMD<A000000>: OK
uninstallItem – Deinstallieren eines Elements aus einer Vorlagengruppe
Dieser Befehl weist der Softwarevorlage einen Deinstallationsjob zu.
Dieser Befehl hat das folgende Format:
templategroup action=uninstallItem name=Name_der_Vorlagengruppe
[swTemplate=Name_der_Software-Vorlage]
item=Elementname
version=Elementversion
procedure=Prozedurname
[installedWith=Installationsprozedur]}
after={exacttime|boottime}
[calendername=Lieferungskalender]
[{preaction={none|reboot|logoff}|bootbefore}]
[{postaction={none|reboot|logoff|rebootAtEnd|logoffAtEnd|shutdownAtEnd}|boota
fter}]
[promptUser[={y|n}]]
Kapitel 3: cadsmcmd-Befehle 519
Kompatibilität
[allowCancel[={y|n}]]
[execTimedOut[={y|n}]]
[prompt=Tage.Stunden]
[offline[={y|n}]]
[runAtShutdown[={y|n}]]
[preventLogon[={y|n}]]
[globalTime]
[nocalendar]
[resolveQuery]
[parameters=Benutzerparameter]
[{jobTimeOut=t.h | timeout=Stunden}]
[userJobMessage]
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.
calendarname
Gibt Folgendes an: Name des Kalenders, der die Zeit steuert, während der die
Evaluierung ausgeführt werden kann.
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.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert
der zugehörigen Prozedur verwendet.
520 CLI-Referenzhandbuch
Kompatibilität
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änenManagers. (Standard)
installedWith
Gibt Folgendes an: Name der Installationsprozedur, die das Element auf dem
Zielsystem installiert hat.
item
Gibt Folgendes an: Name des Elements, das deinstalliert werden soll.
jobTimeOut
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".
Kapitel 3: cadsmcmd-Befehle 521
Kompatibilität
Name
Gibt Folgendes an: Name der Vorlagengruppe, zu der der Deinstallationsauftrag
hinzugefügt wird.
noCalendar
Wenn "noCalendar" angegeben ist, wird ein möglicherweise auf dem Zielcomputer
vorhandener Kalender für die Jobausführung ignoriert.
Bei Angabe von "nocalendar=n" wird der Kalender nicht ignoriert
(Standardeinstellung).
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.
Wenn der Parameter nicht gecodet ist, werden standardmäßig die
Benutzerparameter durch die Prozedurdefinition angegeben.
522 CLI-Referenzhandbuch
Kompatibilität
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.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert
der zugehörigen Prozedur verwendet.
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.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert
der zugehörigen Prozedur verwendet.
Kapitel 3: cadsmcmd-Befehle 523
Kompatibilität
Prozedur
Gibt Folgendes an: Namen der durchzuführenden "Deinstallationsprozedur"
prompt=d.h
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.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert
der zugehörigen Prozedur verwendet.
resolveQuery
Wertet vor Erstellung des Jobs eine möglicherweise vorhandene Abfragegruppe
aus.
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.
swTemplate
Gibt Folgendes an: Namen der Softwarevorlage, zu der der Deinstallationsauftrag
hinzugefügt wird.
Bei fehlender Angabe wird der Standardname ("<Gruppenname> [$date $time]")
verwendet.
524 CLI-Referenzhandbuch
Kompatibilität
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".
Version
Gibt Folgendes an: Version des Elements, das deinstalliert werden soll.
userJobMessage
Gibt die benutzerdefinierte Administratormeldung für einen Deinstallationsjob in
einer Vorlagegruppe 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.
Beispiel:
Angenommen, ein Produkt "prod" der Version "1.0/00" und eine Softwarevorlage "tg"
sind vorhanden. Zu diesem Zeitpunkt muss der Softwarevorlage eine Deinstallation des
Produkts zugeordnet werden. Die auszuführende Deinstallationsroutine heißt "uninst"
und sollte normalerweise nur auf den Systemen ausgeführt werden, auf denen das
Produkt mit der Installationsroutine "inst_3" installiert wurde. Der angegebene Job
muss die folgenden Anforderungen erfüllen:
■
Die Deinstallation auf den Zielen muss nach dem nächsten Neustart gestartet
werden.
■
Den Zielen zugewiesene Kalender sollten bei der Deinstallation nicht ignoriert
werden.
■
Der Benutzer sollte aufgefordert werden, den Job auszuführen. Außerdem kann er
den Job abbrechen. Der Job wird automatisch gestartet, nachdem die Aufforderung
abgelaufen ist. Das Zeitlimit für die Aufforderung beträgt 6&#160;Stunden.
Der folgende Befehl weist der angegebenen Softwarevorlage den erforderlichen Job zu:
cadsmcmd templateGroup action=uninstallItem name=tg item=prod version=1.0/00
procedure=uninst installedWith=inst_3 after=boottime promptUser allowCancel
execTimedOut prompt=0.6
Kapitel 3: cadsmcmd-Befehle 525
Kompatibilität
terminate – Entfernen von Verteilungen aus der Enterprise-Datenbank
Der Befehl "terminate" wird verwendet, um eine fehlgeschlagene, angehaltene oder
abgeschlossene Verteilung zu entfernen.
Diese Aktion hat das folgende Format:
terminate name= Name_des_Verteilungscontainers
Name
Gibt Folgendes an: Namen des Verteilungscontainers, die entfernt werden sollen.
uninstall – Erstellen eines Deinstallationsjobs in einem Jobcontainer
Weitere Informationen finden Sie unter dem Befehl "Install".
526 CLI-Referenzhandbuch
Kapitel 4: Der Befehl "cadsmcmd"
Die CLI bietet Unterstützung für eine Reihe von CA IT Client Manager-Komponenten wie
Common Objects (CO), Common Configuration (CCNF), Software Delivery (USD) und BSInstallationsverwaltung (OSIM).
Die CLI bietet diese Unterstützung jedoch nur dann, wenn die erforderlichen Dienste auf
dem gewünschten Manager zur Verfügung stehen. Wenn SD beispielsweise nicht beim
Manager installiert ist, verarbeitet die CLI keinen Befehl, für den SD oder OSIM-Dienste
erforderlich sind, sondern meldet einen Fehler (CMD000041).
Die CLI bietet eine Reihe verschiedener Schnittstellen, die der Benutzer entsprechend
zur Lösung seiner Automatisierungsprobleme verwenden kann. Die Syntax der CLI lautet
folgendermaßen:
cadsmcmd [local Managersystem]
{ batch Dateiname | Befehl | pipe Pipe-Name | verbose [loop] }
[login[=Anmelde-ID[:Kennwort]]]
Bei den Namen von Schlüsselwörtern, Befehlen und Parametern der CLI muss die Groß/Kleinschreibung, mit Ausnahme von "cadsmcmd" selbst, nicht beachtet werden. Bei
Parameterwerten kann die Groß-/Kleinschreibung beachtet werden.
"cadsmcmd" schreibt die eigene Ausgabe an stdout (Standardausgabe). Eine Umleitung
in eine Pipe oder Datei zur Weiterverarbeitung durch ein Skript ist problemlos möglich.
Wenn "cadsmcmd" startet, werden einige allgemeine Informationen in stdout
aufgezeichnet, die folgendermaßen aussehen:
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
Verbindung zum Manager "<Standard-Manager>" als Benutzer "<Standardbenutzer>" ...
OK.
Manager: myManager
Domäne: myDomain
Domänentyp: Enterprise
CO CCNF USD-Unterstützung
Kapitel 4: Der Befehl "cadsmcmd" 527
Kompatibilität
Die Ziffern in der zweiten Zeile geben die Build-Nummer von "cadsmcmd" an. Die Zeile
"Trace-Modus" zeigt an, ob die CLI-Verfolgung aktiv ist oder nicht. In diesem Beispiel ist
das Tracing inaktiv. Weitere Informationen zur CLI-Verfolgung finden Sie weiter unten
im Kapitel "Die Option "Trace" (siehe Seite 544)".
Die Zeile "Verbindung" zeichnet auf, wie sich die CLI beim Manager anmeldet. Weitere
Informationen finden Sie weiter unten in den Kapiteln "local (siehe Seite 529)" und
"login (siehe Seite 542)".
Der "Manager" zeichnet den Namen des Managers auf, mit dem die CLI verbunden ist,
und die "Domäne" zeigt den Namen des Systems an, in dem sich die Datenbank
befindet. Dieser Name kann identisch sein, wenn sich die Datenbank beim Manager
befindet.
Die Zeile "Domänentyp" gibt den Typ des Managers an, mit dem die CLI verbunden ist.
"Enterprise" bedeutet, dass der Manager ein CA ITCM-Enterprise-Manager ist, während
"Domain" einen CA ITCM-Domänen-Manager kennzeichnet.
Die letzte Zeile zeigt die von der CLI im Verlauf der aktuellen Sitzung zur Verfügung
gestellte Unterstützung an.
"CO" steht für Common Object-Unterstützung, und "CCNF" bedeutet Common
Configuration-Unterstützung. Da CO und CCNF Basiskomponenten von CA ITCM
darstellen, sind sie jederzeit verfügbar.
USD bedeutet SD-Unterstützung, und OSIM bedeutet Unterstützung durch die BSInstallationsverwaltung.
Das Verhalten der CLI hängt von den beim Abruf angegebenen Optionen ab. Die
Bedeutung dieser Optionen gemäß der oben dargestellten Syntaxdefinition wird im
Anschluss näher erläutert.
Dieses Kapitel enthält folgende Themen:
lokal (siehe Seite 529)
batch (siehe Seite 530)
Pipe (siehe Seite 532)
Befehl (siehe Seite 539)
Detaillierter Modus (siehe Seite 541)
loop (siehe Seite 542)
quit (siehe Seite 542)
Nichtprivilegierte Benutzer (siehe Seite 542)
login (siehe Seite 542)
Die Option "trace" (siehe Seite 544)
Schriftarten (siehe Seite 545)
Parameter (siehe Seite 546)
Längenbeschränkungen (siehe Seite 546)
Einschränkungen (siehe Seite 547)
Verwenden von Filtern (siehe Seite 547)
528 CLI-Referenzhandbuch
Kompatibilität
lokal
Während der Installation kann die CLI einem Standard-CA ITCM-Manager zugewiesen
werden. Beim Aufrufen von cadsmcmd ohne das Schlüsselwort "local" wird cadsmcmd
mit diesem Standard-Manager verbunden.
Wenn ein anderer Manager als der Standard-Manager zugeordnet werden muss oder
kein Standard-Manager vorhanden ist, muss das Schlüsselwort "local" verwendet
werden. Im Anschluss an "local" folgt, getrennt durch mindestens ein Leerzeichen, der
Name des zu adressierenden Managers (managersystem).
Angenommen, der Standard-Manager für eine CLI ist "defmgr", und ein anderer
Manager heißt "mgr_1". Um die detaillierte Schnittstelle für den Standard-Manager
aufzurufen, muss Folgendes eingegeben werden:
cadsmcmd verbose
Die CLI zeichnet diesen Standard-Manager in ihrer Meldung "Verbindung wird
hergestellt" in stdout auf.
Verbindung zum Manager "<Standard-Manager>" als Benutzer "<Standardbenutzer>"
wird hergestellt...
Um den Manager "mgr_1" aufzurufen, muss Folgendes angegeben werden:
cadsmcmd local mgr_1 verbose
Die zugehörige Meldung "Verbindung wird hergestellt" sieht folgendermaßen aus:
Verbindung zum Manager "mgr_1" als Benutzer "<Standardbenutzer>" wird
hergestellt...
Der von der Option "local" angegebene Manager kann ein Enterprise-Manager oder ein
Domänen-Manager sein, unabhängig davon, ob der Standard-Manager ein DomänenManager oder ein Enterprise-Manager ist.
Hinweis: Das bisher verwendete At-Zeichen "@" zur Angabe frei wählbarer Manager
wird nicht mehr benötigt. Wenn es angegeben wird, wird es ignoriert.
Kapitel 4: Der Befehl "cadsmcmd" 529
Kompatibilität
batch
Durch Angabe des Schlüsselwortes "batch" wird die Batch-Schnittstelle der CLI
aufgerufen. In diesem Fall erwartet die CLI einen Dateinamen (filename), der durch
mindestens ein Leerzeichen vom Schlüsselwort "batch" getrennt ist. Dieser Dateiname
kann entweder ein absoluter Dateiname oder ein relativer Dateiname sein. Er
bezeichnet eine Datei, die eine Liste mit CLI-Befehlen enthält, die durch diesen Aufruf
ausgeführt werden sollen.
Die CLI verarbeitet die Batch-Datei wie folgt. Zunächst stellt sie für den angegebenen
Benutzer eine Sitzung mit dem angegebenen Manager (beispielsweise einem StandardManager) her (vgl. login (Siehe Definition auf Seite 542)). Anschließend liest sie die
Batch-Datei Zeile für Zeile. Eine Zeile einer Batch-Datei kann mehr als einen Befehl
enthalten. Andererseits kann sich ein Befehl über mehr als eine Zeile erstrecken. Zur
besseren Lesbarkeit wird empfohlen, einen Befehl pro Zeile einzugeben. Die CLI liest die
Datei von Anfang an, bis sie den nächsten CLI-Befehl erkennt oder das Ende der Datei
erreicht, je nachdem, was zuerst eintritt. Diese gelesenen Informationen (ohne den
möglichen am Ende angegebenen Befehl) werden als CLI-Befehl mit seinen
Parametereinstellungen interpretiert und ausgeführt.
Nach einer erfolgreichen vollständigen Ausführung wird das Scannen auf den nächsten
Befehl oder das Ende der Datei fortgesetzt, und der gescannte Befehl wird ebenfalls
ausgeführt. Dies wird fortgesetzt, bis ein Fehler auftritt oder das Ende der Datei erreicht
ist. Das folgende Beispiel zeigt den Inhalt einer Batch-Datei:
regsw -item=prod_1 -version=1.0 -path=/products/prod_1
~procedures=/products/proc_1
regsw -item=prod_2 -version=1.1 -path=/products/prod_2
~procedures=/products/proc_2
Diese Batch-Datei registriert zwei Produkte bei SD. Die CLI scannt zunächst die Datei, bis
sie die zweite regsw findet. Anschließend verarbeitet sie den Befehl "regsw" für
"prod_1" mit den Parametern "Element", "Version", "Pfad" und "Prozeduren". Wenn
dieser Vorgang erfolgreich war, scannt sie den Rest der Datei bis zu deren Ende und
verarbeitet auch die zweite regsw. Wenn die erste regsw fehlschlägt, wird die zweite
regsw nicht ausgeführt, und die CLI wird beendet.
530 CLI-Referenzhandbuch
Kompatibilität
Zu Dokumentationszwecken ist es möglich, einer Batch-Datei Kommentare
hinzuzufügen. Kommentare werden durch das Hash-Zeichen "#" angegeben. Alles, was
einem Hash-Zeichen bis zum Ende der Zeile nachgestellt ist, wird von der CLI als
Kommentar verstanden und ignoriert. Aufgrund der speziellen Bedeutung von "#" sollte
dieses Zeichen in Parametereinstellungen vermieden werden. Dennoch kann es
passieren, dass ein Parameter ein Hash-Zeichen enthält. Schließen Sie in diesem Fall den
Parameterwert in Anführungszeichen ein, um zu verhindern, dass die CLI das Zeichen als
Beginn eines Kommentars interpretiert. Die Inhalte der obigen Datei können daher wie
folgt umgewandelt werden:
# Register product 1
regsw -item=prod_1 -version=1.0 -path=/products/prod_1
~procedures=/products/proc_1 -comment=”product_1 for department #1”
# Register product 2
regsw -item=prod_2 -version=1.1 -path=/products/prod_2
~procedures=/products/proc_2 -comment=”product_2 for department #100”
Übrigens sollten nicht nur Parameterwerte, die ein "#" enthalten, in Anführungszeichen
eingeschlossen werden, sondern auch Werte, die Leerzeichen enthalten.
Den Parametern in den obigen Beispielen ist ein Bindestrich "-" vorangestellt. Es wird
empfohlen, Parameter auf diese Weise anzugeben; dies ist jedoch keine Notwendigkeit.
Jedoch sollte der Bindestrich in Fällen mehrdeutiger Parameter, die irrtümlicherweise
für einen Befehl gehalten werden könnten, gesetzt werden. "stagingServer" ist ein
solcher Parameter, der auch als CLI-Befehl existiert.
Wie oben angegeben, beendet die CLI in der Regel die Batch-Verarbeitung, wenn die
Ausführung eines Befehls fehlschlägt. Manchmal sind die Befehle einer Batch-Datei aber
voneinander unabhängig. Wie im obigen Beispiel können die Produkte prod_1 und
prod_2 unabhängig sein. Wenn also die Registrierung von prod_1 fehlschlägt, hat dies
keine Auswirkungen auf die Registrierung von prod_2, und das Produkt prod_2 kann
somit registriert werden. Durch Einstellen der Umgebungsvariablen
set SDCMD_CONTINUE=ON (Windows)
export SDCMD_CONTINUE=ON (Linux, bash)
kann die CLI gezwungen werden, Fehler zu ignorieren und die Verarbeitung mit dem
nächsten Befehl aus der Datei fortzusetzen. Wenn diese Variablen eingestellt sind,
versucht die CLI, prod_2 auch dann zu registrieren, wenn die Registrierung von prod_1
fehlschlägt.
Kapitel 4: Der Befehl "cadsmcmd" 531
Kompatibilität
Die CLI zeichnet die verarbeiteten Befehle und die von den Befehlen bereitgestellte
Ausgabe in stdout auf. Diese Ausgabe kann problemlos zur weiteren Analyse durch ein
anderes Skript in eine Datei umgeleitet werden. Hier ein Beispiel:
002 regsw “item=prod_1” “version=1.0” “path=/products/prod_1”
“procedures=/products/proc_1” “comment=product_1 for department #1”
Befehl wird verarbeitet ...
SDCMD<A000000>: OK
004 regsw “item=prod_2” “version=1.1” “path=/products/prod_2”
“procedures=/products/proc_2” “comment=product_2 for department #100”
Befehl wird verarbeitet ...
SDCMD<A000000>: OK
Die CLI zeichnet die gelesenen Befehle und die Parametereinstellungen so auf, wie es
von der CLI verstanden wird. Die Ziffer vor dem Befehl bezieht sich auf die Zeile in der
Batch-Datei, in der der Befehl gefunden wurde.
Alle gültigen Befehle der CLI sind an der Batch-Schnittstelle verfügbar.
Pipe
Die Pipe-Schnittstelle bietet den Vorteil einer Batch-Verarbeitung und eines direkten
Befehlsaufrufes, d. h. es ist möglich, mehr als einen Befehl während einer Sitzung
zwischen der CLI und dem Manager auszuführen, wie dies bei der Batch-Option der Fall
ist. Andererseits besteht bei einem Skript die Möglichkeit zur Verarbeitung der
Befehlsausgabe vor dem Start des nächsten CLI-Befehls. Die Pipe-Schnittstelle wird
durch das Pipe-Schlüsselwort aktiviert, gefolgt von den Namen der Pipe, auf die die CLI
warten muss. Die angegebene Pipe ist eine Named Pipe unter Windows und eine FIFODatei unter Linux. Auf jeden Fall arbeitet die CLI als Pipe-Client, d. h., die Pipe muss von
dem aufgerufenen Skript erstellt und verwaltet werden. Wenn sie für die Verarbeitung
der Pipe-Schnittstelle aufgerufen wird, stellt die CLI die Verbindung zum angegebenen
Manager mit den angegebenen Anmeldeinformationen her und zeichnet das Ergebnis in
stdout auf. Wenn die Sitzung eingerichtet ist, wartet die CLI auf die Pipe und auf einen
zu verarbeitenden Befehl. Wenn sie einen solchen Befehl erhält, wird dieser verarbeitet
und seine Ergebnisse werden in stdout aufgezeichnet. Nach der Verarbeitung des
Befehls wartet die CLI auf den nächsten Befehl. Im Gegensatz zum Batch-Modus kehrt
die CLI im Pipe-Modus immer zur Pipe zurück, unabhängig davon, ob ein Befehl
erfolgreich verarbeitet wurde oder nicht. Die Sitzung zwischen der CLI und dem
Manager wird nicht beendet, wenn ein Befehl fehlschlägt. Dieses Verhalten entspricht
dem Batch-Modus mit SDCMD_CONTINUE=ON.
532 CLI-Referenzhandbuch
Kompatibilität
Zur Erleichterung der Kommunikation und Synchronisation zwischen der CLI und dem
gestarteten Skript bietet die CLI gewisse Eye Catcher, die ankündigen, dass eine CLIVerarbeitung beendet wird und dass die CLI nun wieder auf die Pipe wartet.
Beim Starten der CLI im Pipe-Modus startet die CLI die Nachricht in stdout.
*** SDCMD: Line up ***
, wenn die Sitzung mit dem Manager erstellt wurde und die CLI beginnt, auf die Pipe zu
warten. Ab diesem Zeitpunkt kann ein Skript damit beginnen, Befehle über die Pipe an
die CLI zu senden. Auch das Ende einer Befehlsverarbeitung wird von einem speziellen
Eye Catcher gemeldet. Jedes Mal, wenn ein Befehl beendet wird, ob erfolgreich oder
nicht, startet die CLI folgende Nachricht in stdout:
### SDCMD: -eoc ###
Wenn ein Skript diese Zeichenfolge findet, weiß es, dass der von ihm gestartete Befehl
beendet wurde und die gesamte Befehlsausgabe in stdout geschrieben wird.
Die von einer Anwendung über Pipe zu sendenden Befehle besitzen das gleiche Format
wie in Batch-Dateien. Der von der Anwendung in die Pipe geschriebene Befehlspuffer
muss den vollständigen auszuführenden Befehl enthalten. Ein Befehl kann nicht über
mehrere Sendepuffer verteilt werden.
Andererseits ist es möglich, mehr als einen Befehl innerhalb des Puffers zu senden. In
diesem Fall müssen die Befehle durch folgende Zeichenfolge getrennt werden:
-eoc
Die Sitzung zwischen einer CLI im Pipe-Modus und dem Manager wird beendet, sobald
die CLI die Zeichenfolge
-quit
über die Pipe empfängt.
Kapitel 4: Der Befehl "cadsmcmd" 533
Kompatibilität
Die CLI wird für die Pipe-Schnittstelle aufgerufen, indem das Schlüsselwort "Pipe"
angegeben wird, gefolgt vom Namen der Pipe (Pipe-Name), den die CLI für den Empfang
ihrer zu verarbeitenden Befehle verwendet. Zwischen dem Schlüsselwort und dem PipeNamen muss mindestens ein Leerzeichen stehen.
Das folgende Beispiel zeigt die Nutzung der Pipe-Schnittstelle unter Linux. Das Skript
listet alle bei der USD registrierten Zielcomputer und alle bei der USDSoftwarebibliothek registrierten Produkte auf.
#! /usr/bin/sh
proto ()
{
aa=" "
bb=`echo "$aa" | grep "SDCMD: Line up"`
while [ -z "$bb" ]
do
read aa
bb=`echo "$aa" | grep "SDCMD: Line up"`
if [ -z "$bb" ]
then
echo "$aa"
fi
done
}
prot ()
{
aa=" "
bb=`echo "$aa" | grep "SDCMD: -eoc"`
while [ -z "$bb" ]
do
read aa
bb=`echo "$aa" | grep "SDCMD: -eoc"`
if [ -z "$bb" ]
then
echo "$aa"
fi
done
}
mkfifo /ca_dsmcmd_in
mkfifo /ca_dsmcmd_out
534 CLI-Referenzhandbuch
Kompatibilität
{
cadsmcmd pipe /ca_dsmcmd_in > /ca_dsmcmd_out &
proto
echo "targetComputer action=list -eoc" > /ca_dsmcmd_in
prot
#
# ausgegebene Liste speichern und verarbeiten
#
#
...
#
# nächster Befehl
echo "swLibrary action=list -eoc" > /ca_dsmcmd_in
prot
#
# ausgegebene Liste speichern und verarbeiten
#
#
...
#
# Sitzung beenden
echo "-quit" > /ca_dsmcmd_in
} < /ca_dsmcmd_out
rm /ca_dsmcmd_*
Das Beispiel besteht aus zwei Routinen und dem Mainline-Teil. Die Routine "proto ()"
löst "###SDCMD": Line up ###" aus und gibt somit an, dass die Pipe-Schnittstelle aktiv
ist und auf Befehle wartet, und die Routine "prot ()" löst "### SDCMD: -eoc ###" aus
und gibt somit an, dass die Verarbeitung für einen Befehl abgeschlossen ist.
Der Mainline-Teil erstellt zunächst zwei Pipes. Die Pipe "/ca_dsmcmd_in" wird von der
CLI als Eingabe-Pipe verwendet, d. h., die CLI empfängt die zu verarbeitenden Befehle
über diese Pipe. Die andere Pipe "/ca_dsmcmd_out" wird zur Umleitung der stdout der
CLI an das Skript verwendet, so dass das Skript möglicherweise in der Lage ist, die
Ergebnisse zu verarbeiten. Nachdem diese Pipes erstellt wurden, wird ein Block
gestartet, der die CLI im Pipe-Modus im Batch startet, zwei Listenbefehle für
targetComputer und swLibrary startet und die Sitzung anschließend beendet. Dieser
Block empfängt seine Eingabe von der Pipe "/ca_dsmcmd_out", die die Ausgabe der CLI
aufzeichnet. Es wird dringend empfohlen, diese Pipe während der Lebensdauer der CLI
für das Skript geöffnet zu lassen. Deshalb wird sie für diesen Block als Eingabe
zugewiesen. Wenn diese Pipe beispielsweise den Prozeduren "proto" und "prot" nur als
Eingabe zugewiesen wird, führt die möglicherweise zu Laufzeitproblemen beim
Benutzer, die einen Datenverlust und möglicherweise den Absturz von Sitzungen
verursachen können.
Kapitel 4: Der Befehl "cadsmcmd" 535
Kompatibilität
Nachdem die CLI im Pipe-Modus im Batch gestartet ist, wird die Routine "proto" als
Auslöser dafür verwendet, dass die CLI handlungsbereit ist. Nach der Rückgabe startet
das Skript die Aktion "list" für "targetComputer" und verwendet anschließend die
Routine "prot", um das Ende der Befehlsverarbeitung festzulegen. Die Ausgabe dieser
Routine "prot" könnte zur anschließenden Skriptverarbeitung in eine Datei umgeleitet
werden. Daraufhin wird die Aktion "list" für "swLibrary" gestartet, und erneut wird die
Routine "prot" verwendet, um das Ende der Befehlsverarbeitung festzulegen. Wieder
könnte die Ausgabe der Prozedur "prot" zur anschließenden Skriptverarbeitung in eine
Datei umgeleitet werden. Schließlich wird der Block durch Beenden der CLI mit "-quit"
beendet.
Die letzte Zeile des Skripts dient der Wartung und der Bereinigung der Pipes.
Das folgende Beispiel arbeitet genauso wie das vorige Beispiel, verwendet jedoch DM
Scripting und gilt für Windows.
Dim hPipeIn, hPipeOut As Integer
Dim pipeIn, pipeOut As String
Dim command_1, command_2, eoc, eop, lineUp, endOfCommand, buffer As String
' ************************************************************************
' clear screen
ClrScr()
' ************************************************************************
' Konstanten festlegen
eoc = " -eoc"
eop = "-quit"
command_1 = "targetComputer action=list" + eoc
command_2 = "swLibrary action=list" + eoc
lineUp = "SDCMD: Line up"
endOfCommand = "SDCMD: -eoc"
536 CLI-Referenzhandbuch
Kompatibilität
pipeIn ="\\.\pipe\ca_dsmcmd_in"
pipeOut ="\\.\pipe\ca_dsmcmd_out"
' ************************************************************************
' Eingabe-Pipe von CLI erstellen
hPipeIn = CreatePipe(pipeIn, O_WRITE)
If (hPipeIn = -1) Then
MsgBox("Open pipe """ + pipeIn + """ failed.", "Pipe test", MB_OK +
MB_ICONSTOP + MB_SETFOREGROUND)
exit
EndIf
' ************************************************************************
' Ausgabe-Pipe von CLI erstellen
hPipeOut = CreatePipe(pipeOut, O_READ)
If (hPipeOut = -1) Then
MsgBox("Open pipe """ + pipeOut + """ failed.", "Pipe test", MB_OK +
MB_ICONSTOP + MB_SETFOREGROUND)
CloseFile(hPipeIn)
exit
EndIf
' ************************************************************************
' cadsmcmd im Pipe-Modus mit Hilfe von "pipeIn" als Eingabe-Pipe starten und
umleiten
„ stdout an pipeOut
Execute("cmd /c ""cadsmcmd pipe " + pipeIn + " > " + pipeOut + """",
FALSE, 0)
While (TRUE)
If (Not(ReadFile(hPipeOut, buffer))) Then
MsgBox("Read from pipe """ + pipeOut + """ failed.", "Pipe test",
MB_OK + MB_ICONSTOP + MB_SETFOREGROUND)
CloseFile(hPipeIn)
CloseFile(hPipeOut)
exit
EndIf
If (InStr(buffer, lineUp) = 0) Then
Print(buffer)
Else
ExitWhile
EndIf
Wend
Kapitel 4: Der Befehl "cadsmcmd" 537
Kompatibilität
' ************************************************************************
' Anforderung starten für eine targetComputer action=list
If (Not(WriteFile(hPipeIn, command_1))) Then
MsgBox("Write to pipe """ + pipeIn + """ failed.", "Pipe test", MB_OK +
MB_ICONSTOP + MB_SETFOREGROUND)
CloseFile(hPipeIn)
CloseFile(hPipeOut)
exit
EndIf
While (TRUE)
If (Not(ReadFile(hPipeOut, buffer))) Then
MsgBox("Read from pipe """ + pipeOut + """ failed.", "Pipe test",
MB_OK + MB_ICONSTOP + MB_SETFOREGROUND)
CloseFile(hPipeIn)
CloseFile(hPipeOut)
exit
EndIf
If (InStr(buffer, endOfCommand) = 0) Then
' Ergebnisse können zur Weiterverarbeitung gespeichert oder
direkt verarbeitet werden.
Print(buffer)
Else
ExitWhile
EndIf
Wend
' ************************************************************************
' Anforderung starten für eine swLibrary action=list
If (Not(WriteFile(hPipeIn, command_2))) Then
MsgBox("Write to pipe """ + pipeIn + """ failed.", "Pipe test", MB_OK +
MB_ICONSTOP + MB_SETFOREGROUND)
CloseFile(hPipeIn)
CloseFile(hPipeOut)
exit
EndIf
While (TRUE)
If (Not(ReadFile(hPipeOut, buffer))) Then
MsgBox("Read from pipe """ + pipeOut + """ failed.", "Pipe test",
MB_OK + MB_ICONSTOP + MB_SETFOREGROUND)
CloseFile(hPipeIn)
CloseFile(hPipeOut)
exit
538 CLI-Referenzhandbuch
Kompatibilität
EndIf
If (InStr(buffer, endOfCommand) = 0) Then
' Ergebnisse können zur Weiterverarbeitung gespeichert oder
direkt verarbeitet werden.
Print(buffer)
Else
ExitWhile
EndIf
Wend
' ************************************************************************
' CLI beenden
If (Not(WriteFile(hPipeIn, eop))) Then
MsgBox("Write to pipe """ + pipeIn + """ failed.", "Pipe test", MB_OK +
MB_ICONSTOP + MB_SETFOREGROUND)
CloseFile(hPipeIn)
CloseFile(hPipeOut)
exit
EndIf
' ************************************************************************
' bereinigen
CloseFile(hPipeIn)
CloseFile(hPipeOut)
Alle gültigen Befehle der CLI sind an der Pipe-Schnittstelle verfügbar.
Befehl
cadsmcmd kann direkt mit einem CLI-Befehl und seinen erforderlichen
Parametereinstellungen aufgerufen werden. Die CLI richtet eine Sitzung mit dem
angegebenen Manager ein, verarbeitet den Befehl und beendet die Sitzung. Die CLI
zeichnet die Befehlsausgabe und die Statusinformationen in stdout auf. Durch Starten
des folgenden Befehls erfolgt die nachfolgende Ausgabe:
cadsmcmd targetComputer action=list
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
Kapitel 4: Der Befehl "cadsmcmd" 539
Kompatibilität
Verbindung zu Manager "<Standard-Manager>" als Benutzer "<Standardbenutzer>" wird
hergestellt... OK.
Manager: myManager
Domäne: myDomain
Domänentyp: Domäne
Unterstützt: CO CCNF USD OSIM
-------------------------------------------------------------------------Liste der Zielcomputer
-------------------------------------------------------------------------mgr_1(Scalability-Server; Win Server&#160;2003 Intel; Boot-Server)
mgr_1/Administrator(Computerbenutzer; Win Server&#160;2003 Intel)
scal_2(Scalability-Server; Win 2000 Intel; Boot-Server)
scal_2/Administrator(Computerbenutzer; Win 2000 Intel)
comp_0(Computer; alle)
comp_1(Computer; Win XP Intel)
-------------------------------------------------------------------------Liste nicht benannter und nicht durch OSIM verwalteter Computer
-------------------------------------------------------------------------FF:FF:42:65:13:7E(---; ---; BMS nicht verwaltet, mgr_1)
FF:FF:42:65:13:83(---; ---; BMS nicht verwaltet, scal_2)
-------------------------------------------------------------------------Gesamtzahl der Zielcomputer: 6
Anzahl nicht benannter und nicht durch OSIM verwalteter angezeigter Systeme: 2
SDCMD<A000000>: OK
Die Befehle und ihre gültigen Parameter werden nachfolgend beschrieben.
540 CLI-Referenzhandbuch
Kompatibilität
Detaillierter Modus
Der detaillierte Schnittstellenmodus (verbose) bietet dem Benutzer die Möglichkeit, CLIBefehle als Dialog zu erstellen und auszuführen. Die Schnittstelle wird durch Angabe des
Schlüsselwortes "verbose" aufgerufen. Die CLI richtet eine Sitzung mit dem
angegebenen Manager ein und legt den Typ des Managers fest, d.&#160;h., ob es sich
um einen CA ITCM-Domänen-Manager oder um einen CA ITCM-Enterprise-Manager
handelt. Abhängig von diesem Typ bietet die CLI dem Benutzer eine Liste mit Befehlen,
die für diesen Manager-Typ gültig sind. Bei einem Domänen-Manager mit SD sieht das
Angebot wie folgt aus:
Gültige Befehle:
========================
activate........aregsw
cancel..........comconf
compgroup.......configure
dereg...........deregproc
install.........jobContainer
managedcomputer recover
regproc.........regsw
renewjob........setdbcredentials
stagingserver...swLibrary
targetComputer..templateGroup
uninstall
quit
========================
Geben Sie einen der oben angegebenen Befehle ein:
Der Benutzer kann einen der angebotenen Befehle auswählen, und die CLI führt den
Benutzer durch die gültigen Parameter und ihre Einstellungen. Es werden nur die
Parameter dargestellt, die aufgrund der bereits eingegebenen Informationen benötigt
werden. Wenn alle benötigten Informationen erhalten wurden, führt die CLI den Befehl
aus. Die Ausgabe des Befehls sowie die Statusinformationen werden in stdout
geschrieben.
Wenn die Option "loop" nicht angegeben ist, wird die CLI beendet, nachdem der
angegebene Befehl verarbeitet wurde. Wenn sie angegeben wurde, wird sie an die
Auswahlliste mit den Befehlen zurückgegeben, so dass der Benutzer den nächsten
Befehl festlegen und ausführen kann. Durch Eingabe des Befehls "quit" wird eine solche
Sitzung beendet. Dieser Befehl "quit" steht nur im detaillierten Modus zur Verfügung.
Alle gültigen Befehle der CLI sind an der detaillierten Schnittstelle verfügbar.
Kapitel 4: Der Befehl "cadsmcmd" 541
Kompatibilität
loop
(Optional) Normalerweise ermöglicht der ausführliche Modus die Auswahl eines Befehls
pro Aufruf von cadsmcmd. Durch die Eingabe von "loop" ist die Auswahl von mehr als
einem Befehl möglich.
Der Befehl "loop" steht nur im detaillierten Modus zur Verfügung.
quit
Bei der Verwendung von "loop" wird die CLI-Sitzung durch Eingabe des Befehls "quit"
beendet. Der Befehl "quit" steht nur im detaillierten Modus zur Verfügung.
Nichtprivilegierte Benutzer
Unter Windows kann "cadsmcmd" von nichtprivilegierten Benutzern ohne Anpassungen
verwendet werden.
In Linux muss eine Gruppe "sdadmins" zur Verfügung gestellt werden, und es sind nur
die Benutzer zur Ausführung von "cadsmcmd" berechtigt, die dieser Gruppe zugeordnet
sind. Andere Benutzer erhalten die Nachricht "Zugriff verweigert", wenn sie
"cadsmcmd" starten.
login
Mit dem Schlüsselwort "login" kann sich der Benutzer beim Manager anmelden und den
CLI-Befehl als ein anderer Benutzer als der Standardbenutzer ausführen. Der
Standardbenutzer stellt den Benutzer so dar, wie er derzeit bei der Konsole angemeldet
ist, von der aus der CLI-Befehl gestartet wird, z. B. angemeldet beim System als
Benutzer "hugo" und mit Start des folgenden Befehls:
cadsmcmd local mgr_1 verbose
Die CLI stellt für den "Standardbenutzer" eine Verbindung zum Manager "mgr_1" her.
Die CLI zeichnet dies in der Meldung "Verbindung wird hergestellt" auf:
Verbindung zum Manager "mgr_1" als Benutzer "<Standardbenutzer>" wird
hergestellt...
Sie versucht, die Sitzung mit dem Manager als aktueller Benutzer "hugo" zu erstellen.
Wenn dieser Benutzer mgr_1 nicht bekannt ist oder ein anderes Kennwort besitzt,
schlägt der Aufbau der Sitzung fehl. In diesem Fall müssen verschiedene
Anmeldeinformationen verwendet werden, um die Sitzung zu authentifizieren.
542 CLI-Referenzhandbuch
Kompatibilität
login[=Anmelde-ID[:Kennwort]]
Die mit dem Kennwort "login" übergebenen Informationen haben sich bei CA ITCM
Version 12.8 aufgrund der Verwendung einer anderen Authentifizierungsmethode in CA
ITCM Version 12.8 im Vergleich zu USD 4.0 verändert. Beim Anmeldeprozess müssen
Informationen zum Sicherheitsprovider, der Sicherheitsautorität, der Benutzer-ID und
dem Benutzerkennwort zur Verfügung gestellt werden. Das Kennwort wird mit dem
Kennwortparameter übergeben, während der Sicherheitsprovider, die
Sicherheitsautorität und die Benutzer-ID mit der Anmelde-ID übergeben werden. Die
Anmelde-ID setzt sich wie folgt zusammen:
\"<Sicherheitsprovider>://<Sicherheitsautorität>/<Benutzer-ID>\"
Hinweis: Die Anführungszeichen (") sind obligatorisch. Anderenfalls ist die CLI nicht in
der Lage, die Anmeldeinformationen korrekt zu verarbeiten. Da die Anführungszeichen
von cadsmcmd und nicht von der Shell oder der Eingabeaufforderung interpretiert
werden müssen, müssen sie durch einen vorangestellten Schrägstrich (\) geschützt
werden.
Ein Sicherheitsprovider kann ein Windows-System sein, dass mit "winnt"
gekennzeichnet ist, oder ein Linux-System, das mit "unixl" gekennzeichnet ist. Die
Sicherheitsautorität kann eine Domäne oder das angegebene System sein.
Angenommen, die CLI soll mit der detaillierten Schnittstelle am Linux-System
"lx_sy_1.myCo.com" als "root" mit dem Kennwort "5k7zpq]r" angemeldet werden. Es
muss folgender Befehl gestartet werden:
cadsmcmd local lx_sy_1 verbose login=\"unixl://lx_sy_1.myCo.com/root\":5k7zpq]r
Die CLI zeichnet dies mit folgender Meldung auf:
Verbindung zu Manager "lx_sy_1" als Benutzer "unixl://lx_sy_1.myCo.com/root" wird
hergestellt…
Falls die detaillierte Schnittstelle für den Windows-Manager "win_sy_01" und den
Benutzer "myid" für das Kennwort "7hj.98,a" gestartet werden soll, könnte der
gestartete Befehl wie folgt aussehen:
cadsmcmd local win_sy_01 verbose login=\”winnt://win_sy_01/myid\”:7hj.98,a
In diesem Fall zeichnet die CLI Folgendes auf:
Verbindung zu Manager "win_sy_01” als Benutzer “winnt://win_sy_01/myid" wird
hergestellt…
Kapitel 4: Der Befehl "cadsmcmd" 543
Kompatibilität
Wenn die Anmeldung mit Anmelde-ID, aber ohne Kennwort angegeben wird, geht die
CLI davon aus, dass es für den angegebenen Benutzer kein Kennwort gibt. Wenn die
Anmeldung ohne Benutzer-ID und Kennwort angegeben ist, startet die CLI ein kurzes
Dialogfeld zum Abruf dieser Parameter. In diesem Fall wird das Kennwort bei der
Eingabe nicht auf der Konsole angezeigt.
Hinweis: Wenn "cadsmcmd" mit dem Parameter "login" aufgerufen wird, sollte auch
der Parameter "local" codiert werden, um die Sicherheit zu verbessern.
Die Option "trace"
Die CLI bietet bei Problemen ein Trace zur Fehlerbehebung des internen Workflows der
CLI. Standardmäßig ist das Trace deaktiviert. Sie sollte nur auf Anforderung des CASupports aktiviert werden. Das Trace wird von den Umgebungsvariablen
"SDCMD_TRACE" und "SDCMD_FILE" gesteuert. Bei Windows lautet die Syntax zum
Einstellen von "SDCMD_TRACE" wie folgt:
set SDCMD_TRACE={all | file | screen}
und in Linux für die Bash:
export SDCMD_TRACE={all | file | screen}
Wenn "screen" angegeben ist, zeichnet die CLI ihre Protokolleinträge in stdout auf,
d.&#160;h. in der Konsole, von der sie gestartet wurde.
Wenn "file" für die Umgebungsvariable angegeben ist, zeichnet die CLI in eine Datei auf.
Diese Datei wird von der Variablen "SDCMD_FILE" festgelegt und kann wie folgt
definiert werden:
set SDCMD_FILE=<Dateiname>
unter Windows
and
export SDCMD_FILE=<Dateiname>
in Linux Bash
Wenn "SDCMD_FILE" nicht eingestellt ist, schreibt die CLI in die Datei "cadsmcmd.log"
des aktuellen CA ITCM-Protokollverzeichnisses.
Im Fall von "all" wird das Trace in die angegebene Datei und in stdout geschrieben.
544 CLI-Referenzhandbuch
Kompatibilität
Geben Sie folgende Befehle ein, um ein aktiviertes Trace zu deaktivieren:
set SDCMD_TRACE=
set SDCMD_FILE=
für Windows und
unset SDCMD_TRACE
unset SDCMD_FILE
für Linux Bash.
Ob ein Trace für die CLI aktiviert ist, wird beim Start der CLI aufgezeichnet.
c:\>cadsmcmd verbose
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: DATEI
Name der Trace-Datei: C:\TEMP\tst.txt
Verbindung zu Manager "<Standardmanager>" als Benutzer "<Standardbenutzer>" wird
hergestellt ...OK.
Im Falle des "Trace-Modus" "SCREEN" wird der "Name der Trace-Datei" ausgelassen.
Wenn kein Trace aktiviert ist, wird Folgendes aufgezeichnet:
c:\>cadsmcmd verbose
CA IT Client Manager r12
ITCM Command Line-Version 12.8.0.xxxx
Copyright (c) 2013 CA. Alle Rechte vorbehalten.
Trace-Modus: Aus
Verbindung zu Manager "<Standardmanager>" als Benutzer "<Standardbenutzer>" wird
hergestellt ...OK.
Schriftarten
Wenn die Ausgabe eines CLI-Befehls lokale Zeichen enthält, muss die Shell, die diesen
Befehl verarbeitet, für eine korrekte Anzeige dieser Zeichen aktiviert werden,
z.&#160;B. muss die Schrift zur Unterstützung deutscher Zeichen unter Windows in
Lucida Console geändert werden.
Kapitel 4: Der Befehl "cadsmcmd" 545
Kompatibilität
Parameter
Bei den Parameternamen der Befehle muss die Groß- und Kleinschreibung nicht
beachtet werden, für die ihnen zugewiesenen Werte gilt dies unter Umständen jedoch
nicht. Bei einem Pfadnamen auf Windows spielt die Groß- und Kleinschreibung keine
Rolle, auf Linux jedoch schon.
Wie bereits weiter oben im Kapitel zur Batch-Schnittstelle erwähnt, kann Parametern
ein Bindestrich (-) vorangestellt werden; dies ist jedoch optional. Beim Codieren einer
Batch-Datei wird empfohlen, diesen vorangestellten Bindestrich zu verwenden, um
Mehrdeutigkeiten zu vermeiden.
Die CLI verwendet das Leerzeichen als Trennzeichen für Parameter, Optionen und
Befehle. Wenn ein Parameterwert ein Leerzeichen enthält, sollte der Parameterwert in
Anführungszeichen eingeschlossen werden. Da diese Anführungszeichen nicht von einer
Shell oder Befehlszeile, sondern von der CLI interpretiert werden sollen, ist es
gegebenenfalls erforderlich, sie aus einer Shell oder einer Befehlszeile durch
vorangestellte Schrägstriche (\) zu entfernen.
Hinweis: Die CLI meldet Fehler nur bei Parametern, die ihr unbekannt sind, oder bei
inkonsistenten Parametern. Wenn ein Parameter mit einem Befehl oder einer Aktion
codiert ist, der bzw. die in der Syntaxbeschreibung nicht angegeben, jedoch ein
definierter Parameter der CLI ist und von anderen Befehlen verwendet wird, wird der
Parameter für den codierten Befehl bzw. die Aktion ignoriert. Es wird weder ein Fehler
noch eine Warnung angezeigt.
Längenbeschränkungen
In der folgenden Tabelle sind die Längenbeschränkungen zusammengefasst, die bei der
Eingabe von Werten für die einzelnen Befehlszeilenparameter gelten:
Parameter
Maximallänge
Verteilungsname
129
Fehlermeldung
512
Softwarename
129
Softwareversion
129
Elementprozedurname
129
Bereichs- oder Domänenname
129
Computername
129
Computergruppenname
129
Herstellertext
255
546 CLI-Referenzhandbuch
Kompatibilität
Kommentar
255
Quellpfad
255
Abfragename
255
Computergruppenkommentar
255
Domänenkommentar
255
Einschränkungen
Um Mehrdeutigkeiten mit der CLI zu vermeiden, sollten folgende Namen oder
Bezeichnungen, die mit den folgenden Objekten verwendet werden, eindeutig sein:
■
Zielcomputer
■
Computergruppen
■
Softwarerichtlinien oder Vorlagen
■
Servergruppen
Verwenden von Filtern
Filter werden in einigen Auflistungsmethoden verwendet, um den Umfang der
aufgelisteten Informationen einzugrenzen.
Sie sind Ausdrücke, die aus Atomic-Ausdrücken mit Operatoren der Aussagenlogik, wie
&& (und), || (oder) und ! (nicht) zusammengesetzt werden. Dabei gelten folgende
Regeln:
■
Jeder elementare Ausdruck ist ein Filterausdruck.
■
Wenn exp ein Filterausdruck ist, ist auch !exp ein Filterausdruck.
■
Wenn "exp1" und "exp2" Filterausdrücke sind, sind auch "(exp1 && exp2)" und
"(exp1 || exp2)" Filterausdrücke.
Welche elementaren Ausdrücke gültig sind, ist von den aufzulistenden Objekten
abhängig. Die elementaren Ausdrücke haben die folgende Syntax:
attributename operand value
Gültige Attributnamen für neue und bereits vorhandene Auflistungsmethoden finden
Sie in den folgenden Kapiteln.
Kapitel 4: Der Befehl "cadsmcmd" 547
Kompatibilität
Es gibt verschiedene Attributarten:
Typ
Bedeutung
Zeichenfolge
Der Attributwert ist eine Zeichenfolge.
Long
Der Attributwert ist eine 4-Byte-Ganzzahl.
Datum
Der Attributwert ist ein Datum mit der Struktur JJJJ-MM-TT wobei JJJJ für das Jahr,
MM für den Monat und TT für den Tag steht.
Uhrzeit
Der Attributwert ist eine Uhrzeit mit der Struktur "HH:MM", wobei HH die Stunden im
24-Stunden-Format und MM die Minuten bezeichnet.
DateTime
Der Attributwert ist eine zusammengesetzte Angabe von Uhrzeit und Datum nach ISOStandard mit der Struktur JJJJ-MM-TT HH:MM.
Die folgenden Operanden sind gültig und wahr:
Operand
Zeichenfolge
Long
=
Wenn der Attributwert mit dem angegebenen
Wert übereinstimmt.
Wenn der Attributwert mit dem
angegebenen Wert identisch ist.
!=
Wenn der Attributwert mit dem angegebenen
Wert nicht übereinstimmt.
Wenn der Attributwert mit dem
angegebenen Wert nicht identisch
ist.
"<"
Wenn der Attributwert lexikografisch geringer
als der angegebene Wert ist.
Wenn der Attributwert geringer
als der angegebene Wert ist.
">"
Wenn der Attributwert lexikografisch größer als
der angegebene Wert ist.
Wenn der Attributwert größer als
der angegebene Wert ist.
Bei Verwendung der Operanden "=" oder "!=" darf der angegebene Wert das
Platzhalterzeichen '*' enthalten, um die Zeichenfolge als beliebig oder leer zu
kennzeichnen.
548 CLI-Referenzhandbuch
Kompatibilität
Attribute des Typs Date, Time und DateTime werden wie Attribute des Typs string
behandelt.
In einigen Fällen sind für Attribute nur Kombinationen eindeutiger Werte zulässig.
Sofern nichts Gegenteiliges festgelegt ist, werden diese Attribute wie Attribute des Typs
"string" behandelt.
Verwendung:
cadsmcmd compgroup action=list filter="(Group type=Group && Scope=local)"
Falls der Filter mit einem einzelnen Ausdruck erstellt wird, müssen keine Klammern
verwendet werden.
Hinweis: Falls ein Attribut in einem elementaren Ausdruck fehlerhaft ist oder ein
Attribut nicht für ein Objekt gilt, ist der Wert des elementaren Ausdrucks TRUE, sofern
nichts Gegenteiliges festgelegt ist.
Kapitel 4: Der Befehl "cadsmcmd" 549
Kapitel 5: dmsweep-Befehle
dmsweep-Befehle sind auf Windows-Plattformen (außer Windows NT 4.0, Windows 98
und Windows 95) sowie Linux-Plattformen gültig.
"dmsweep" ist die Befehlszeilenschnittstelle zu den Infrastructure DeploymentKomponenten von DSM. Mit "dmsweep" können Sie die Bereitstellung von DSMAgenten- und -Serverpaketen auf Zielcomputern starten und auf Zielcomputern nach
DSM-Software suchen. Sie können "dmsweep" auch verwenden, um DSM-Agenten- und
-Serverpakete auf Scalability-Servern zu verwalten.
Die dmsweep-Befehlszeile hat das folgende Format:
dmsweep <Unterbefehl> [{</Option> [<Argument>]}*]
Unterbefehl
Einer der folgenden Unterbefehle:
deploy (siehe Seite 553)
help (oder usage) (siehe Seite 552)
packages (siehe Seite 559)
scan (siehe Seite 562)
sspack (siehe Seite 566)
stage (siehe Seite 568)
Version (siehe Seite 572)
Informationen zu den gültigen Werten für Unterbefehle und Optionen finden Sie
unter " dmsweep-Unterbefehle (siehe Seite 552)".
Kapitel 5: dmsweep-Befehle 551
dmsweep-Unterbefehle
Option
Eine Option für den Unterbefehl. Allen Optionen wird ein Schrägstrich (/) oder
Bindestrich (-) vorangestellt.
Die meisten Optionen verfügen über eine Lang- und eine Kurzform, die Sie synonym
verwenden können, beispielsweise können Sie "/tu" anstatt "/tusername"
verwenden. Weitere Informationen finden Sie unter "Abkürzungen für dmsweepArgumente (siehe Seite 576)".
Argument
Ein Argument für diese Option.
Optionen mit einem Argument haben die folgenden Formate:
</Option> <Argument> (Trennen Sie die Argumente durch ein Komma voneinander.)
</Option>=<Argument>
</Option>:<Argument>
Wenn ein Argument Leerzeichen enthält, müssen Sie es in Anführungszeichen
einschließen, wie z.&#160;B.
/Option="Mein Argument"
Unterstützt eine Option mehrere Argumente, müssen diese durch Kommas (ohne
Leerzeichen) voneinander abgetrennt werden:
dmsweep scan /ip=10.0.0.1,10.0.0.2,10.0.0.3
dmsweep-Unterbefehle
Die dmsweep-Unterbefehle werden in den folgenden Abschnitten beschrieben. Die
Beschreibungen der einzelnen Unterbefehle enthalten Einzelheiten zu gültigen
Optionen für die Unterbefehle.
dmsweep help, dmsweep usage
Zeigt eine Meldung an, die die dmsweep-Unterbefehle mit der entsprechenden Syntax
beschreibt. Diese Meldung wird auch ausgegeben, wenn der Befehl "dmsweep" ohne
Argumente ausgeführt wird.
Der Unterbefehl hat das folgende Format:
help
Verwendung
552 CLI-Referenzhandbuch
dmsweep-Unterbefehle
Beispiel:
Das folgende Bespiel zeigt, wie Sie mit dem Befehlszeilen-Hilfsprogramm "dmsweep
help" Optionen, Unterbefehle und Argumente anzeigen können.
Um die Optionen für den Befehl "dmsweep" anzuzeigen, geben Sie einen der folgenden
Befehle ein:
dmsweep
dmsweep help
dmsweep usage
dmsweep deploy
Der Befehl "dmsweep deploy" versucht, das angegebene Paket auf den angegebenen
Zielcomputern bereitzustellen.
Der Unterbefehl hat das folgende Format:
deploy
[/manager <Manager-Computer>]
[/musername <Manager-Benutzername> /mpassword <Manager-Kennwort>]
[/mfilename <Manager-Dateiname>]
{/ip <Platzhalter für Adresse> [/toip <End-Adresse>] | /ipfilename <IPDateiname> | /domain <Domänenname> (nur WinNT)
| /uri <Uniform Resource Identifier>
| /targetcred <Datei mit Zielanmeldeinformationen>
| /query <Abfragename>}
[/tusername <Ziel-Benutzername> /tpassword <Ziel-Kennwort> | /epassword
<verschlüsseltes_Kennwort>]
[/tfilename <Zieldatei>] |
{/packagenum <Paketnummer> | /product <Produktname> /package <Paketname>
[/version <Version>] [/platform <Plattform>] [/language <Sprache>]}
[/pparams <Paketparameter>]
[/jobname <Jobname>]
[/sserver <Scalability-Server-Computer>
/ssusername <Scalability-Server-Benutzername> /sspassword <ScalabilityServer-Kennwort>]
[/primerargs <Primer-Installationsargumente>]
/manager
Gibt den Namen des Managers an, von dem die Paketliste abgerufen werden soll.
Wenn Sie die Option "/manager" nicht angeben, ist der aktuelle Computer das Ziel.
/musername
Gibt den Benutzernamen für den Manager-Computer an.
Kapitel 5: dmsweep-Befehle 553
dmsweep-Unterbefehle
/mpassword
Gibt das Kennwort für den Manager-Computer an.
Wenn kein <Manager-Kennwort> angegeben wird, fordert "dmsweep" bei der
Ausführung des Befehls dazu auf, den Wert einzugeben.
/mfilename
Hiermit können Sie den Namen des Managers und Details zu dessen Benutzername
und Kennwort aus einer Datei lesen.
Das Format dieser Datei wird im Abschnitt zum Befehl "packages" beschrieben.
/ip
Startadresse, ab der gescannt werden soll.
Sie können als Adresse einen Computernamen angeben, wenn er erfolgreich
aufgelöst werden kann (beispielsweise mit DNS), oder eine IP-Adresse
(beispielsweise 10.0.0.1) angeben. Das Argument <Platzhalter für Adresse>
ermöglicht die Verwendung von Sternchen. (Die Angabe "10.0.0.*" deckt
beispielsweise den Bereich von 10.0.0.1 bis 10.0.0.254 und die Angabe "10.0.*.*"
den Bereich von 10.0.0.1 bis 10.0.255.254 ab).
Sie können für <Platzhalter für Adresse> eine einzelne Adresse oder eine durch
Kommas getrennte Liste mit Adressen angeben.
/toip
Endadresse für den zu scannenden Bereich.
Wenn Sie "/toip" zusammen mit "/ip" angeben, beginnt der Scan an der durch
<Platzhalter für Adresse> angegebenen Adresse und endet nach der angegebenen
<End-Adresse>.
554 CLI-Referenzhandbuch
dmsweep-Unterbefehle
/ipfilename
Wenn Sie "/ipfilename" angeben, liest der Befehl die Liste der Zielcomputer aus der
Datei, die mit <IP-Dateiname> angegeben wird. Jede Zeile in der Datei enthält eine
einzelne Zieladresse oder mehrere durch Kommas getrennte Adressen,
beispielsweise:
Computer1
Computer2, Computer3, 10.0.0.1
Computer5
/domain
Wenn sich ein Bereitstellungs-Manager auf einem Windows-basierten Computer
befindet, können Sie mit Hilfe von "/domain" die Computer in den angegebenen
Domänen scannen.
/uri
Bei Verwendung von "/uri" können Sie über einen Uniform Resource Identifier
Zielcomputer angeben, die aus einem externen Verzeichnis gelesen werden.
/targetcred
Wenn Sie "/targetcred" angeben, liest der Befehl die Liste der Zielcomputer und die
Anmeldeinformationen für die Verbindung aus der angegebenen Datei mit
<Zielanmeldeinformationen>.
/query
Bei Angabe von "/query" wird eine Liste der Ziele erstellt, wenn die Abfrage für
nicht verwaltete Assets, erkennbar durch <Abfragename>, ausgeführt wird.
/packagenum
Paketnummer, nach der gescannt werden soll. Die Ausgabe des Befehls "dmsweep
packages" beschreibt die gültigen Werte.
Hinweis: Durch die Verwendung der Option "/packagenum" können Pakete schnell
angegeben werden. Achten Sie jedoch darauf, dass die Paketnummern variieren, da
der Bibliothek für Bereitstellungspakete neue Pakete hinzugefügt werden. Wenn Sie
Pakete ohne Abweichungen identifizieren möchten (beispielsweise beim Schreiben
von Batch-Skripten), verwenden Sie die folgenden Optionen zur
Paketidentifizierung.
/product
Der Produktname (beispielsweise "CA Unicenter DSM"), nach dem gescannt werden
soll. Die Ausgabe des Befehls "dmsweep packages" beschreibt die gültigen Werte.
Kapitel 5: dmsweep-Befehle 555
dmsweep-Unterbefehle
/package
Der Paketname (beispielsweise "Agent + Alle Agenten-Plugins"), nach dem gescannt
werden soll. Die Ausgabe des Befehls "dmsweep packages" beschreibt die gültigen
Werte.
/version
Version des Paketes (beispielsweise "11.2.0.1234"), nach der gescannt werden soll.
Die Ausgabe des Befehls "dmsweep packages" beschreibt die gültigen Werte. Dies
ist optional, wenn die eingegebenen Informationen für eine eindeutige
Identifikation des Paketes jedoch nicht ausreichen, wird ein Fehler angezeigt.
/platform
Plattformeigenschaft des Paketes (beispielsweise "Linux&#160;x86"), nach der
gescannt werden soll. Die Ausgabe des Befehls "dmsweep packages" beschreibt die
gültigen Werte. Dies ist optional, wenn die eingegebenen Informationen für eine
eindeutige Identifikation des Paketes jedoch nicht ausreichen, wird ein Fehler
angezeigt.
/language
Spracheigenschaft des Paketes (beispielsweise "ENU"), nach der gescannt werden
soll. Die Ausgabe des Befehls "dmsweep packages" beschreibt die gültigen Werte.
Dies ist optional, wenn die eingegebenen Informationen für eine eindeutige
Identifikation des Paketes jedoch nicht ausreichen, wird ein Fehler angezeigt.
/tusername
Gibt den Benutzernamen für die Verbindung zum Ziel an. Wenn Ihr BereitstellungsManager bereits Pakete auf dem Zielcomputer bereitgestellt hat, werden
möglicherweise keine Anmeldeinformationen benötigt.
/tpassword
Gibt das Kennwort für die Verbindung zum Ziel an. Wenn Ihr BereitstellungsManager bereits Pakete auf dem Zielcomputer bereitgestellt hat, werden
möglicherweise keine Anmeldeinformationen benötigt.
Wenn Sie "/tusername" angeben, den <Ziel-Benutzernamen> jedoch auslassen,
wird der Benutzer zur Eingabe des Benutzernamens aufgefordert. Wenn Sie
"/tpassword" angeben, das <Ziel-Kennwort> jedoch auslassen, wird der Benutzer
zur Eingabe des Kennworts aufgefordert. Dies wird nicht auf dem Bildschirm
angezeigt.
/epassword
Legt das Kennwort in verschlüsselter Form fest. Diese Option macht dmsweep auf
dieses Format aufmerksam und das Kennwort wird vor der Verwendung
verschlüsselt. Siehe Verschlüsselte Kennwörter (siehe Seite 573).
556 CLI-Referenzhandbuch
dmsweep-Unterbefehle
/tfilename
Wenn für ein Ziel eine Authentifizierung erforderlich ist und "/tfilename"
angegeben wurde, wird die angegebene <Zieldatei> durchsucht. Wenn ein Eintrag
vorhanden ist, werden die in der Datei angegebenen Anmeldeinformationen für das
Ziel verwendet; anderenfalls werden "tusername" und "/tpassword" verwendet.
Die <Zieldatei> enthält ein Ziel pro Zeile, wobei jede Zeile den Zielcomputernamen
(oder IP-Adresse), den Benutzernamen und das Kennwort enthält. Beispiele:
10.0.0.1 Benutzername1 Kennwort1
10.0.0.2 Benutzername2 Kennwort2
* Benutzername3 Kennwort3
Ein Eintrag mit "*" als Zielname bezeichnet Standardanmeldeinformationen für
jedes nicht explizit in der Datei aufgeführte Ziel.
/pparamsT
Gibt eine durch Kommas getrennte Liste mit Parametern an, um "$1$", "$2$" usw.
in der Befehlszeile für die Paketinstallation zu ersetzen. Um die Befehlszeile
zusammen mit dem erwarteten Format und der Beschreibung der einzelnen
Parameter anzuzeigen, verwenden Sie den Befehl "packages" von "dmsweep". Eine
Liste mit Installationsoptionen, die für die verschiedenen Agenten- und ServerBereitstellungspakete gelten, finden Sie im CA ITCM-Implementierungshandbuch.
/primerargs
Gibt nicht standardmäßige Installationsargumente (beispielsweise nicht
standardmäßige Installationspeicherorte) für die dmprimer-Installation (jedoch
nicht für die Installation von Agent oder Server) an. Die Installationsargumente
werden unverändert an die Installationsbefehlszeile des Computers weitergegeben,
auf dem ein Primer installiert werden soll. Eine Liste mit gültigen
Installationsoptionen finden Sie im CA ITCM-Implementierungshandbuch.
/jobname
Gibt an, dass als Name für den Jobs der vom Argument <Jobname> angegebene
Wert verwendet wird. Anderenfalls wird der Name basierend auf dem aktuelle
Datum und der Uhrzeit automatisch generiert.
/sserver
Erzwingt, dass die Zielcomputer ihre Pakete von einem Scalability-Server erhalten.
Wird dieser Befehl nicht angegeben, erhalten sie das Paket von dem ManagerComputer.
Kapitel 5: dmsweep-Befehle 557
dmsweep-Unterbefehle
/ssuserame
Gibt den Benutzernamen für die Verbindung zu dem Scalability-Server an.
/sspassword
Gibt den Benutzernamen für die Verbindung zu dem Scalability-Server an.
Hinweis: Wenn Sie "/ssusername" angeben, den <Scalability-ServerBenutzernamen> jedoch auslassen, wird der Benutzer zur Eingabe des
Benutzernamens aufgefordert. Wenn Sie "/sspassword" angeben, jedoch
<Scalability-Server-Kennwort> auslassen, wird der Benutzer zur Eingabe des
Kennworts aufgefordert. Dies wird nicht auf dem Bildschirm angezeigt.
Hinweis: Sie können die <Datei mit Zielanmeldeinformationen> anstelle der über <IPDateiname> und <Ziel-Dateiname> angegebenen Dateien verwenden. Details zu
"/targetcred" finden Sie unter "Datei mit Zielanmeldeinformationen".
Beispiele:
Im Folgenden finden Sie einige Beispiele für die verschiedenen Möglichkeiten des
Unterbefehls "deploy":
■
Um ein Ziel über einen lokalen Manager bereitzustellen, verwenden Sie den
folgenden Befehl:
dmsweep deploy /ip <Zielcomputer> /pn 2 /pparams <myserver>,,
■
Um ein Paket über einen lokalen Manager auf einem Zielcomputer bereitzustellen,
der Anmeldeinformationen benötigt, geben Sie den folgenden Befehl ein:
dmsweep deploy /ip <Computername> /pn 2 /pparams <myserver>,, /tu
<Zielbenutzername> /tp <Zielkennwort>
■
Um ein Paket auf einem Zielcomputer bereitzustellen, der Anmeldeinformationen
benötigt, jedoch das Kennwort möglicherweise verschlüsselt ist, geben Sie den
folgenden Befehl ein:
dmsweep deploy /ip <Computername> /pn 2 /pparams <myserver>,, /tu
<Zielbenutzername> /ep <verschlüsseltes Kennwort>
■
Das folgende Beispiel zeigt, wie mit dem Befehlszeilen-Hilfsprogramm "dmsweep"
der Benutzername und das Kennwort abgefragt werden können.
"dmsweep" verfügt über eine Funktion zum Abfragen des Kennworts, mit deren
Hilfe Sie Kennwörter eingeben können, ohne dass diese auf dem Bildschirm
angezeigt werden. Sie können auch Benutzernamen abfragen, diese werden jedoch
beim Eingeben angezeigt. Um Benutzernamen oder Kennwort abzufragen, geben
Sie die Option, aber keinen Wert ein, wie im folgenden Beispiel dargestellt.
Um ein Paket über einen lokalen Manager auf einem Zielcomputer bereitzustellen,
der Kennwort und Benutzername abfragt, geben Sie den folgenden Befehl ein:
dmsweep deploy /ip <Zielcomputer> /pn 2 /pparams <myserver>,,
558 CLI-Referenzhandbuch
/tu
/tp
dmsweep-Unterbefehle
■
Um ein Paket auf einer Reihe von Computern bereitzustellen, die keine
Anmeldeinformationen erfordern, geben Sie den folgenden Befehl ein:
dmsweep deploy /ip 192.0.25.1 /toip 192.0.25.9 /pn 3 /pparams <myserver>,,
■
Für die Bereitstellung auf allen Computern in einem Subnetz (192.0.45) mithilfe
eines Platzhalters geben Sie den folgenden Befehl ein:
dmsweep deploy /ip 192.0.45.* /pn 3 /pparams <myserver>,,
Sie können Platzhalter auch für die Bereitstellung in mehreren Subnetzen
verwenden. Geben Sie dazu den folgenden Befehl ein:
dmsweep deploy /ip 192.0.*.* /pn 1 /pparams <myserver>,,
■
Um die Bereitstellung über einen Remote-Mangager durchzuführen, verwenden Sie
den folgenden Befehl:
dmsweep deploy /ip <Zielcomputer> /pn 3 /mgr <Remote-Manager> /mu <RemoteManager-Benutzer> /mp <Remote-Manager-Kennwort> /tu <Zielbenutzer> /tp
<Zielkennwort>
■
Für eine Bereitstellung auf einem Ziel über einen Remote-Manager, bei der
Benutzernamen und Kennwort für Manager und Zielcomputer abgefragt werden,
geben Sie den folgenden Befehl ein:
dmsweep deploy /ip <Zielcomputer> /pn 3 /mgr <Remote-Manager> /mu
/tp
/mp
/tu
Hinweis: Ersetzen Sie Werte wie Paketnummer, Zielcomputer und Manager-Computer
durch geeignete Werte.
dmsweep packages
Der Unterbefehl "dmsweep packages" zeigt die Liste mit Paketen an, die auf dem
angegebenen Bereitstellungs-Manager zur Bereitstellung verfügbar sind.
"packages" kann abgekürzt werden. Sie können beispielsweise auch den Befehl
"dmsweep pack" verwenden.
Der Unterbefehl hat das folgende Format:
packages
[/manager <Manager-Computer>]
[/musername <Manager-Benutzername> /mpassword <Manager-Kennwort>]
[/mfilename <Manager-Dateiname>]
/manager
Gibt den Namen des Managers an, von dem die Paketliste abgerufen werden soll.
Wenn Sie die Option "/manager" nicht angeben, ist der aktuelle Computer das Ziel.
Kapitel 5: dmsweep-Befehle 559
dmsweep-Unterbefehle
/musername
Gibt den Benutzernamen für den Manager-Computer an.
Der Benutzer wird zur Eingabe des Benutzernamens aufgefordert, falls /musername
ohne <Manager-Benutzernamen> angegeben wird.
/mpassword
Gibt das Kennwort für den Manager-Computer an.
Wird kein <Manager-Kennwort> angegeben, fordert "dmsweep" dazu auf, den Wert
einzugeben.
Hinweis: "/musername" und "/mpassword" können nur in Verbindung mit "/manager"
angegeben werden.
/mfilename
Hiermit können Sie den Namen des Managers und Details zu dessen Benutzername
und Kennwort aus einer Datei lesen.
Wenn für den Manager eine Authentifizierung erforderlich ist und "/mfilename"
angegeben wurde, wird die durch <Manager-Dateiname> angegebene Datei durchsucht.
Existiert ein Eintrag für den Manager, werden die Anmeldeinformationen in der Datei
verwendet. Anderenfalls werden <Manager-Benutzername> und <Manager-Kennwort>
verwendet. In der Datei <Manager-Dateiname> wird pro Zeile ein Manager aufgeführt,
wobei jede Zeile den Computernamen des Managers, den Benutzernamen und das
Kennwort enthält:
Manager1 Benutzername1 Kennwort1
Manager2 Benutzername2 Kennwort2
* Benutzername3 Kennwort3
Ein Eintrag mit einem "*" als Manager-Name bezeichnet
Standardanmeldeinformationen, die für jeden nicht explizit in der Datei aufgeführten
Manager-Namen verwendet werden.
Wenn die Option "/mpassword" angegeben ist, das <Manager-Kennwort> jedoch
ausgelassen wird, wird das Kennwort beim Ausführen des Befehls abgefragt.
560 CLI-Referenzhandbuch
dmsweep-Unterbefehle
Beispiel:
Das folgende Bespiel zeigt, wie Sie das Befehlszeilen-Hilfsprogramm "dmsweep"
verwenden können. Ersetzen Sie Werte wie Paketnummer, Zielcomputer und ManagerComputer durch geeignete Werte.
Um die Pakete aufzulisten, die auf dem lokalen Computer zur Bereitstellung verfügbar
sind, geben Sie einen der folgenden Befehle ein:
dmsweep packages
dmsweep pack
Die Ausgabe des Befehls wird angezeigt. Der folgende Auszug ist ein Teil der
Beispielausgabe und zeigt die Paketnummern an, die Sie mit den Optionen zu
"/packagenumber" (oder "/pn") in nachfolgenden Befehlen verwenden können.
Verbindung zum Bereitstellungs-Manager auf ASTEROID wird hergestellt.
Die neue Job-ID ist 13191950.
Paketliste wird abgerufen.
Im Bereitstellungs-Manager "ASTEROID" wurden 5 Pakete gefunden:
Paket 1:
Produkt CA DMS
....Paket..........: Agent + Asset Management Plugin
....Version.....: 11.1.8124.2426
....Plattform...: Windows_x86
Sprache: ENU
....Beschreibung: Agenten mit Asset Management-Plugin bereitstellen.
....Befehl............: AgtAM.msi" AGENT_SERVER=$1$ ALLUSERS=1
ENSURE_CAF_STOPPED=1 CAF_COMMON_CONFIG=1 CAF_INSTALL_SERVICE=1
CAF_START_SERVICE=1 /qn /l*v %TEMP%\ITRMSetupAgtAM.log EXITFILE=$E$ $2$
....UNIX-Befehl: installdsm" -r $P$/install.rsp /REXITFILE=$E$ /RITRM_SERVER=$1$
$3$
....Parameter 1: Geben Sie die Adresse des Scalability-Servers ein, zu dem eine
Verbindung hergestellt werden soll
....Validierung regulärer Ausdrücke: ^[^<>`~!/@\#}$%:;)(_^{*=|'+]{1,255}$
Kapitel 5: dmsweep-Befehle 561
dmsweep-Unterbefehle
....Parameter 2: Geben Sie alle zusätzlichen Installationsoptionen für Windows
ein
....Validierung regulärer Ausdrücke: .*
Paket 2:
........
........:
In der Beispiel-Ausgabe werden zwei Parameter für Paket 1 aufgeführt. Falls Sie dieses
Paket für die Bereitstellung verwenden möchten, müssen Sie diese beiden Parameter
mithilfe der Option "/pparams" angeben. Trennen Sie die Parameterwerte durch
Kommas voneinander.
Beispiel: Zum Auswählen von Paket&#160;1 sollten Sie den folgenden Befehl
verwenden:
dmsweep deploy /pn 1 /ip 192.0.2.5.9 /pparams <Mein Server>,"CA=D:\DSM"
Hierbei erhält Parameter&#160;1 (die Adresse des Scalability-Servers) den Wert
<myserver> und Parameter&#160;2 (die Windows-Installationsoptionen) den Wert
"CA=D:\DSM" hat, der angibt, dass das Paket an einem nicht standardmäßigen
Speicherort installiert werden soll.
Die Parameter werden im DSM-Explorer in drei separaten Feldern auf der Seite
"Agentenkonfiguration" angezeigt, wenn Sie den DSM-Explorer für die Bereitstellung
eines Pakets verwenden.
Die Zeichenfolge zum Validieren regulärer Ausdrücke gibt an, welcher Zeichenbereich
für den verbundenen Parameter gültig ist. Die Validierungszeichenfolge "*" bedeutet,
dass für den Parameterwert keine Syntaxbeschränkungen bestehen.
dmsweep scan
Mit dem Befehl "dmsweep scan" werden die angegebenen Zieladressen gescannt, und
es wird festgestellt, welche Adressen für die Bereitstellung aktiv und verfügbar sind und
ob auf den Zielcomputern die erforderlichen Pakte installiert sind.
Der Unterbefehl hat das folgende Format:
scan [/manager <Manager-Computer>]
[/musername <Manager-Benutzername> /mpassword <Manager-Kennwort>]
[/mfilename <Manager-Dateiname>]
{/ip <Platzhalter für Adresse> [/toip <End-Adresse>]
562 CLI-Referenzhandbuch
dmsweep-Unterbefehle
| /ipfilename <IP-Dateiname>
| /domain <Domänenname> (nur WinNT)
| /uri <Uniform Resource Identifier>
| /targetcred <Datei mit Zielanmeldeinformationen>
| /query <Abfragename>}
{/packagenum <Paketnummer>
| /product <Produktname> /package <Paketname>
[/version <Version>]
[/platform <Plattform>]
[/language <Sprache>]}
/manager
Gibt den Namen des Managers an, von dem die Paketliste abgerufen werden soll.
Wenn Sie die Option "/manager" nicht angeben, ist der aktuelle Computer das Ziel.
/musername
Gibt den Benutzernamen für den Manager-Computer an.
Falls <Manager-Benutzername> nicht angegeben wird, wird der Benutzer zur
Eingabe aufgefordert.
/mpassword
Gibt das Kennwort für den Manager-Computer an.
Wird kein <Manager-Kennwort> angegeben, fordert "dmsweep" dazu auf, den Wert
einzugeben.
/mfilename
Hiermit können Sie den Namen des Managers und Details zu dessen Benutzername
und Kennwort aus einer Datei lesen.
Kapitel 5: dmsweep-Befehle 563
dmsweep-Unterbefehle
/ip
Startadresse oder -adressen für den Scan-Vorgang.
Sie können als Adresse einen Computernamen angeben, wenn er erfolgreich
aufgelöst werden kann (beispielsweise mit DNS), oder eine IP-Adresse
(beispielsweise 10.0.0.1) angeben. Das Argument <Platzhalter für Adresse>
ermöglicht die Verwendung von Sternchen. (Die Angabe "10.0.0.*" deckt
beispielsweise den Bereich von 10.0.0.1 bis 10.0.0.254 und die Angabe "10.0.*.*"
den Bereich von 10.0.0.1 bis 10.0.255.254 ab).
Sie können für <Platzhalter für Adresse> eine einzelne Adresse oder eine durch
Kommas getrennte Liste mit Adressen angeben.
Hinweis: Dieser Parameter wird nur dann als Startadresse verwendet, wenn die
Option "/toip" verwendet wird.
/toip
Endadresse für den zu scannenden Bereich.
Diese Option kann nur in Verbindung mit "/ip" verwendet werden. In diesem Fall
beginnt der Scan-Vorgang mit der unter <Platzhalter für Adresse> angegebenen
Adresse und endet nach dem Scannen von <End-Adresse>.
/ipfilename
Wenn Sie "/ipfilename" angeben, liest der Befehl die Liste der Zielcomputer aus der
Datei, die mit <IP-Dateiname> angegeben wird. Jede Zeile in der Datei enthält eine
einzelne Zieladresse oder mehrere durch Kommas getrennte Adressen,
beispielsweise:
Computer1
Computer2, Computer3, 10.0.0.1
Computer5
/domain
Wenn sich ein Bereitstellungs-Manager auf einem Windows-basierten Computer
befindet, können Sie mit Hilfe von "/domain" die Computer in den angegebenen
Domänen scannen.
/uri
Bei Verwendung von "/uri" können Sie über einen Uniform Resource Identifier
Zielcomputer angeben, die aus einem externen Verzeichnis gelesen werden.
/targetcred
Wenn Sie "/targetcred" angeben, liest der Befehl die Liste der Zielcomputer und die
Anmeldeinformationen für die Verbindung aus der angegebenen Datei mit
<Zielanmeldeinformationen>.
564 CLI-Referenzhandbuch
dmsweep-Unterbefehle
/query
Bei Angabe von "/query" wird eine Liste der Ziele erstellt, wenn die Abfrage für
nicht verwaltete Assets, erkennbar durch <Abfragename>, ausgeführt wird.
/packagenum
Paketnummer, nach der gescannt werden soll. Die Ausgabe des Befehls "dmsweep
packages" beschreibt die gültigen Werte.
/product
Eigenschaft des Paketes, nach dem gescannt werden soll. Die Ausgabe des Befehls
"dmsweep packages" beschreibt die gültigen Werte.
/package
Eigenschaft des Paketes, nach dem gescannt werden soll. Die Ausgabe des Befehls
"dmsweep packages" beschreibt die gültigen Werte.
/version
Version des Paketes, nach dem gescannt werden soll. Die Ausgabe des Befehls
"dmsweep packages" beschreibt die gültigen Werte. Dies ist optional, wenn die
eingegebenen Informationen jedoch für die Identifikation des Paketes nicht
ausreichend sind, wird ein Fehler angezeigt.
/platform
Plattformeigenschaft für das Paket, nach dem gescannt werden soll. Die Ausgabe
des Befehls "dmsweep packages" beschreibt die gültigen Werte. Dies ist optional,
wenn die eingegebenen Informationen jedoch für die Identifikation des Paketes
nicht ausreichend sind, wird ein Fehler angezeigt.
/language
Spracheigenschaft für das Paket, nach dem gescannt werden soll. Die Ausgabe des
Befehls "dmsweep packages" beschreibt die gültigen Werte. Dies ist optional, wenn
die eingegebenen Informationen jedoch für die Identifikation des Paketes nicht
ausreichend sind, wird ein Fehler angezeigt.
Beispiel:
Das folgende Bespiel zeigt, wie Sie das Befehlszeilen-Hilfsprogramm "dmsweep"
verwenden können. Ersetzen Sie Werte wie Paketnummer, Zielcomputer und ManagerComputer durch geeignete Werte.
Um einen Zielcomputer zu scannen, um herauszufinden, ob ein Paket bereits installiert
ist, geben Sie den folgenden Befehl ein:
dmsweep deploy /ip <Zielcomputer> /pn 2
Kapitel 5: dmsweep-Befehle 565
dmsweep-Unterbefehle
dmsweep sspack
Verwenden Sie diesen Befehl, um die Liste der auf einem oder mehreren ScalabilityServern gefundenen Pakete anzuzeigen.
Der Befehl wird folgendermaßen verwendet:
dmsweep sspack [/manager <Manager-Computer>]
[/musername <Manager-Benutzername> /mpassword <Manager-Kennwort>]
[/mfilename <Manager-Dateiname>]
{/ip <Platzhalter für Adresse> [/toip <End-Adresse>] |
/ipfilename <IP-Dateiname> |
/domain <Domänenname> |
(nur WinNT)
/uri <Uniform Resource Identifier> |
/targetcred <Datei mit Zielanmeldeinformationen> |
/query <Abfragename> }
Die Beschreibungen für /manager, /musername, /mpassword und /mfilename finden
Sie unter 'Dmsweep-Pakete (siehe Seite 559)'.
Die Beschreibungen für /ip, /toip, /ipfilename, /targetcred, /domain, /uri und /query
finden Sie unter "dmsweep scan (siehe Seite 562)".
/manager
Gibt den Namen des Managers an, von dem die Paketliste abgerufen werden soll.
Wenn Sie die Option "/manager" nicht angeben, ist der aktuelle Computer das Ziel.
/musername
Gibt den Benutzernamen für den Manager-Computer an.
Der Benutzer wird zur Eingabe des Benutzernamens aufgefordert, falls /musername
ohne <Manager-Benutzernamen> angegeben wird.
566 CLI-Referenzhandbuch
dmsweep-Unterbefehle
/mpassword
Gibt das Kennwort für den Manager-Computer an.
Wird kein <Manager-Kennwort> angegeben, fordert "dmsweep" dazu auf, den Wert
einzugeben.
Hinweis: "/musername" und "/mpassword" können nur in Verbindung mit "/manager"
angegeben werden.
/ip
Startadresse oder -adressen für den Scan-Vorgang.
Sie können als Adresse einen Computernamen angeben, wenn er erfolgreich
aufgelöst werden kann (beispielsweise mit DNS), oder eine IP-Adresse
(beispielsweise 10.0.0.1) angeben. Das Argument <Platzhalter für Adresse>
ermöglicht die Verwendung von Sternchen. (Die Angabe "10.0.0.*" deckt
beispielsweise den Bereich von 10.0.0.1 bis 10.0.0.254 und die Angabe "10.0.*.*"
den Bereich von 10.0.0.1 bis 10.0.255.254 ab).
Sie können für <Platzhalter für Adresse> eine einzelne Adresse oder eine durch
Kommas getrennte Liste mit Adressen angeben.
Hinweis: Dieser Parameter wird nur dann als Startadresse verwendet, wenn die
Option "/toip" verwendet wird.
/toip
Endadresse für den zu scannenden Bereich.
Diese Option kann nur in Verbindung mit "/ip" verwendet werden. In diesem Fall
beginnt der Scan-Vorgang mit der unter <Platzhalter für Adresse> angegebenen
Adresse und endet nach dem Scannen von <End-Adresse>.
/ipfilename
Wenn Sie "/ipfilename" angeben, liest der Befehl die Liste der Zielcomputer aus der
Datei, die mit <IP-Dateiname> angegeben wird. Jede Zeile in der Datei enthält eine
einzelne Zieladresse oder mehrere durch Kommas getrennte Adressen,
beispielsweise:
Computer1
Computer2, Computer3, 10.0.0.1
Computer5
Kapitel 5: dmsweep-Befehle 567
dmsweep-Unterbefehle
/domain
Wenn sich ein Bereitstellungs-Manager auf einem Windows-basierten Computer
befindet, können Sie mit Hilfe von "/domain" die Computer in den angegebenen
Domänen scannen.
/uri
Bei Verwendung von "/uri" können Sie über einen Uniform Resource Identifier
Zielcomputer angeben, die aus einem externen Verzeichnis gelesen werden.
/targetcred
Wenn Sie "/targetcred" angeben, liest der Befehl die Liste der Zielcomputer und die
Anmeldeinformationen für die Verbindung aus der angegebenen Datei mit
<Zielanmeldeinformationen>.
/query
Bei Angabe von "/query" wird eine Liste der Ziele erstellt, wenn die Abfrage für
nicht verwaltete Assets, erkennbar durch <Abfragename>, ausgeführt wird.
Beispiel:
dmsweep sspack /ip ScalServ
Verbindung zum Bereitstellungs-Manager auf XXXXX06-CCSTEST wird hergestellt.
Die neue Job-ID ist 6432350.
Scan nach Scalability-Server-Paketen wird durchgeführt.
100.100.00.0 ScalServ 2 Pakete gefunden (1 von 1)
Scan abgeschlossen.
SCAN-ZUSAMMENFASSUNG
=========================================================================
100.100.00.0 ScalServ 2 Pakete gefunden
CA Unicenter DSM Agent + Basic Inventory Plugin 11.1.8160.410 Windows_x86 ENU
CA Unicenter DSM Agent + Software Delivery Plugin 11.1.8160.410 Windows_x86 ENU
=========================================================================
dmsweep stage
Der Befehl "dmsweep stage" überträgt ein Agenten- oder Serverpaket zu einem oder
mehreren Scalability-Servern, über die es anschließend mit dem Befehls "dmsweep
deploy" auf Zielcomputern bereitgestellt werden kann.
Der Unterbefehl hat das folgende Format:
stage [/manager <Manager-Computer>]
[/musername <Manager-Benutzername> /mpassword <Manager-Kennwort>]
[/mfilename <Manager-Dateiname>]
{/ip <Platzhalter für Adresse> [/toip <End-Adresse>] |
/ipfilename <IP-Dateiname> |
/targetcred <Datei mit Zielanmeldeinformationen> |
/query <Abfragename> }
568 CLI-Referenzhandbuch
dmsweep-Unterbefehle
[/tusername <Ziel-Benutzername> /tpassword <Ziel-Kennwort> | /epassword
<verschlüsseltes_Kennwort>] ]
[/tfilename <Ziel-Dateiname>]
{/packagenum <Paketnummer> |
/product <Produktname> /package <Paketname>
[/version <Version>] [/platform <Plattform>] [/language <Sprache>]}
[/jobname <Jobname>]
/manager
Gibt den Namen des Managers an, von dem die Paketliste abgerufen werden soll.
Wenn Sie die Option "/manager" nicht angeben, ist der aktuelle Computer das Ziel.
/musername
Gibt den Benutzernamen für den Manager-Computer an.
Wird kein <Manager-Benutzername> angegeben, fordert "dmsweep" dazu auf, den
Wert einzugeben.
/mpassword
Gibt das Kennwort für den Manager-Computer an.
Wenn kein <Manager-Kennwort> angegeben wird, fordert "dmsweep" bei der
Ausführung des Befehls dazu auf, den Wert einzugeben.
/mfilename
Hiermit können Sie den Namen des Managers und Details zu dessen Benutzername
und Kennwort aus einer Datei lesen.
/ip
Startadresse oder -adressen für den Scan-Vorgang.
Sie können als Adresse einen Computernamen angeben, wenn er erfolgreich
aufgelöst werden kann (beispielsweise mit DNS), oder eine IP-Adresse
(beispielsweise 10.0.0.1) angeben. Das Argument <Platzhalter für Adresse>
ermöglicht die Verwendung von Sternchen. (Die Angabe "10.0.0.*" deckt
beispielsweise den Bereich von 10.0.0.1 bis 10.0.0.254 und die Angabe "10.0.*.*"
den Bereich von 10.0.0.1 bis 10.0.255.254 ab).
Sie können für <Platzhalter für Adresse> eine einzelne Adresse oder eine durch
Kommas getrennte Liste mit Adressen angeben.
Kapitel 5: dmsweep-Befehle 569
dmsweep-Unterbefehle
/toip
Endadresse für den zu scannenden Bereich.
Muss gemeinsam mit "/ip" angegeben werden. Der Scan-Vorgang beginnt mit der
unter <Platzhalter für Adresse> angegebenen Adresse und endet nach dem Scannen
von <End-Adresse>.
/ipfilename
Wenn Sie "/ipfilename" angeben, liest der Befehl die Liste der Zielcomputer aus der
Datei, die mit <IP-Dateiname> angegeben wird. Jede Zeile in der Datei enthält eine
einzelne Zieladresse oder mehrere durch Kommas getrennte Adressen,
beispielsweise:
Computer1
Computer2, Computer3, 10.0.0.1
Computer5
/targetcred
Wenn Sie "/targetcred" angeben, liest der Befehl die Liste der Zielcomputer und die
Anmeldeinformationen für die Verbindung aus der angegebenen Datei mit
<Zielanmeldeinformationen>.
/query
Bei Angabe von "/query" wird eine Liste der Ziele erstellt, wenn die Abfrage für
nicht verwaltete Assets, erkennbar durch <Abfragename>, ausgeführt wird.
/packagenum
Paketnummer, nach der gescannt werden soll. Die Ausgabe des Befehls "dmsweep
packages" beschreibt die gültigen Werte.
/product
Eigenschaft des Paketes, nach dem gescannt werden soll. Die Ausgabe des Befehls
"dmsweep packages" beschreibt die gültigen Werte.
/package
Eigenschaft des Paketes, nach dem gescannt werden soll. Die Ausgabe des Befehls
"dmsweep packages" beschreibt die gültigen Werte.
570 CLI-Referenzhandbuch
dmsweep-Unterbefehle
/version
Version des Paketes, nach dem gescannt werden soll. Die Ausgabe des Befehls
"dmsweep packages" beschreibt die gültigen Werte. Dies ist optional, wenn die
eingegebenen Informationen jedoch für die Identifikation des Paketes nicht
ausreichend sind, wird ein Fehler angezeigt.
/platform
Plattformeigenschaft für das Paket, nach dem gescannt werden soll. Die Ausgabe
des Befehls "dmsweep packages" beschreibt die gültigen Werte. Dies ist optional,
wenn die eingegebenen Informationen jedoch für die Identifikation des Paketes
nicht ausreichend sind, wird ein Fehler angezeigt.
/language
Spracheigenschaft für das Paket, nach dem gescannt werden soll. Die Ausgabe des
Befehls "dmsweep packages" beschreibt die gültigen Werte. Dies ist optional, wenn
die eingegebenen Informationen jedoch für die Identifikation des Paketes nicht
ausreichend sind, wird ein Fehler angezeigt.
/tusername
Gibt den Benutzernamen für die Verbindung zum Ziel an. Wenn Ihr BereitstellungsManager bereits Pakete auf dem Zielcomputer bereitgestellt hat, werden
möglicherweise keine Anmeldeinformationen benötigt.
/tpassword
Gibt das Kennwort für die Verbindung zum Ziel an. Wenn Ihr BereitstellungsManager bereits Pakete auf dem Zielcomputer bereitgestellt hat, werden
möglicherweise keine Anmeldeinformationen benötigt.
Wenn Sie "/tusername" angeben, den <Ziel-Benutzernamen> jedoch auslassen,
werden Sie zur Eingabe des Benutzernamens aufgefordert. Wenn Sie "/tpassword"
angeben, das <Ziel-Kennwort> jedoch auslassen, wird der Benutzer zur Eingabe des
Kennworts aufgefordert. Dieses wird nicht auf dem Bildschirm angezeigt.
/epassword
Legt das Kennwort in verschlüsselter Form fest. Diese Option macht dmsweep auf
dieses Format aufmerksam und das Kennwort wird vor der Verwendung
verschlüsselt. Siehe Verschlüsselte Kennwörter (siehe Seite 573).
Kapitel 5: dmsweep-Befehle 571
dmsweep-Unterbefehle
/tfilename
Wenn für ein Ziel eine Authentifizierung erforderlich ist und "/tfilename"
angegeben wurde, wird die angegebene <Zieldatei> durchsucht. Wenn ein Eintrag
vorhanden ist, werden die in der Datei angegebenen Anmeldeinformationen für das
Ziel verwendet; anderenfalls werden "tusername" und "/tpassword" verwendet.
Die <Zieldatei> enthält ein Ziel pro Zeile, wobei jede Zeile den Zielcomputernamen
(oder IP-Adresse), den Benutzernamen und das Kennwort enthält. Beispiele:
10.0.0.1 Benutzername1 Kennwort1
10.0.0.2 Benutzername2 Kennwort2
* Benutzername3 Kennwort3
Ein Eintrag mit "*" als Zielname bezeichnet Standardanmeldeinformationen für
jedes nicht explizit in der Datei aufgeführte Ziel.
/jobname
Gibt an, dass als Name für den Jobs der vom Argument <Jobname> angegebene
Wert verwendet wird. Anderenfalls wird der Name basierend auf dem aktuelle
Datum und der Uhrzeit automatisch generiert.
Beispiel:
Im folgenden Beispiel wird dargestellt, wie Sie das Befehlszeilen-Hilfsprogramm
"dmsweep" verwenden können, um ein Paket durch Staging auf einem Scalability-Server
bereitzustellen. Ersetzen Sie Werte wie Paketnummer, Zielcomputer und ManagerComputer durch geeignete Werte. Geben Sie den folgenden Befehl ein, um die Pakete
durch Staging auf Scalability-Servern bereitzustellen:
dmsweep stage /ip <Zielcomputer> /pn 2 /tu /tp
Der Benutzer wird zur Eingabe des Zielbenutzernamens und des Zielkennworts
aufgefordert.
dmsweep version
Zeigt Versionsinformationen für "dmsweep" an.
Der Unterbefehl hat das folgende Format:
Version
Geben Sie Folgendes ein, um die dmsweep-Version anzuzeigen:
dmsweep version
572 CLI-Referenzhandbuch
Verschlüsselte Kennwörter
Verschlüsselte Kennwörter
Um die verschlüsselten Kennwörter für die Verwendung mit "dmsweep deploy" und
"dmsweep stage" zu erstellen, müssen Sie den Befehl "caf savecreds" verwenden.
Dieser Befehl wird an eine Datei mit Namen "cafcreds.txt" im DSM-Ordner "Bin"
ausgegeben; von dort aus können Sie die Informationen kopieren und in die
"dmdeploy"-Zielanmeldeinformationsdatei einfügen oder in der "dmsweep"Befehlszeile verwenden.
Beispiel
caf savecreds "dummy" user "administrator" password "secret" host "machine4"
Dieses Beispiel resultiert in einer cafcreds.txt-Datei mit der Zeile ‘machine4’ ‘dummy’ ‘
machine4\administrator’ ‘4DDzqKuSJN5Ml6RsEY+o5Q'.
dmsweep - Datei mit Zielanmeldeinformationen
In der Datei mit Zielanmeldeinformationen können Sie Ziele und ihre Kennwörter
zusammen angeben. Die Datei enthält eine Gruppe von Zielen pro Zeile.
Sie können die Optionen "/ip", "/toip", "/uri", "/domain", "/tu", "/tp" und "/query" in
der Datei in beliebiger Reihenfolge verwenden. Wenn ein Benutzername und ein
Kennwort ohne Ziel angegeben werden, gelten diese als Standardbenutzername und
Standardkennwort, anderenfalls muss mindestens ein Ziel vorhanden sein. Die
Standardwerte werden in jeder Zeile mit einem Ziel, jedoch ohne die Option "/tu" bzw.
"/tp" verwendet. Wenn für die Option "/tu" oder "/tp" kein Wert angegeben ist, wird
der Benutzer aufgefordert, einen Wert einzugeben. Wenn die Option "/tu" (oder "/tp")
nicht vorhanden ist, wird der Standardbenutzername (oder das Standardkennwort)
verwendet. Wenn weder die Option "/tu" noch ein Standardkennwort vorhanden ist,
wird ein leeres Kennwort verwendet.
Hinweis: Sie können auch die Option "/ep" (verschlüsseltes Kennwort) in der Datei mit
Zielanmeldeinformationen verwenden.
Kapitel 5: dmsweep-Befehle 573
dmsweep - Datei mit Zielanmeldeinformationen
Beispiele für Einträge in der Datei:
/ip
/tu
/ip
/ip
<Rechner1,Rechner2> /tu /tp
defaultUser /tp defauLtPassword
130.119.3.* /tu administrator /tp pass3472773
130.119.9.5 /toip 130.119.9.12 /tu administrator /tp
Mit Hilfe der Datei mit Zielanmeldeinformationen können Kunden Bereitstellungen
"offline" planen, bevor die eigentlichen Bereitstellungsjobs gestartet werden. Die
Dateien können als Reaktion auf Ereignisse und andere externe Faktoren generiert
werden und dann zu vorgegebenen Zeiten an den Bereitstellungsprozess übergeben
werden. Die Bereitstellung in verschiedenen "Bereichen" eines Netzwerks könnte auch
durch die Erstellung von entsprechenden Dateifamilien für verschiedene Abteilungen
oder Niederlassungen des Unternehmens angegeben werden. Beispiel:
Die Datei mit Zielanmeldeinformationen verwendet eine ähnliche Syntax wie die
dmsweep-Befehlszeile, die Konsistenz gewährleistet und problemlos erweitert werden
kann, um zusätzliche Funktionen (über die Syntax für neue Optionen) in zukünftigen
Versionen zur Verfügung zu stellen.
Syntax der Datei mit Anmeldeinformationen
Jede Zeile in der Datei mit Anmeldeinformationen, die mit "#'"beginnt, wird als
Kommentar interpretiert und ignoriert.
Die Datei mit Anmeldeinformationen besteht aus einer Reihe von Zielangaben, die
jeweils in einer separaten Zeile stehen. Alle Zielangaben haben folgendes Format:
[<Ziele>] [/tu [Benutzer]] [/tp [Kennwort] | /ep [verschlüsseltes Kennwort]]
Die Reihenfolge der Elemente in einer Zielangabe ist unwichtig.
<Ziele>
Dieser Parameter gibt die Zielcomputer an, auf denen eine Bereitstellung versucht
werden soll. Für diese Angabe sind folgende Formate möglich:
/ip <Adresse>
Ein einzelner Computername oder eine einzelne IP-Adresse.
/ip <Adresse>,<Adresse>, …
Eine durch Kommas getrennte Liste mit Computernamen oder IP-Adressen in
beliebiger Kombination.
/ip <IP> /toip <IP> [/domain <Domäne>]
Der Beginn und das Ende eines Bereichs numerischer IP-Adressen. Wenn die Option
"domain" angegeben ist, wird die Bereitstellung nur bei Adressen im IP-Bereich
versucht, die Computern in der genannten Domäne entsprechen. Die
Domänenevaluierung wird nur unterstützt, wenn Sie einen Bereitstellungs-Manager
auf einer Windows-Plattform verwenden.
574 CLI-Referenzhandbuch
dmsweep - Datei mit Zielanmeldeinformationen
/domain <Domäne>
Eine Windows-Domäne, deren Computer die Bereitstellungsziele sein sollen. Die
Domänenevaluierung wird nur unterstützt, wenn Sie einen Bereitstellungs-Manager
auf einer Windows-Plattform verwenden.
/uri <URI>
Eine URI (Universal Resource Indicator), die einen Verzeichniscontainer angibt,
dessen Computer die Bereitstellungsziele sein sollen.
/query <Abfragename>
Bei Angabe von "/query" wird eine Liste der Ziele erstellt, wenn die Abfrage für
nicht verwaltete Assets, erkennbar durch <Abfragename>, ausgeführt wird.
/tu [Benutzer]
Dieser Parameter gibt den Ziel-Benutzernamen an. Dies ist die ID, über die eine
Verbindung zu Zielcomputern hergestellt wird, wenn die erste Übertragung von
DMPrimer ausgeführt wird. Der Wert für die Benutzer-ID wird für alle Adressen
verwendet, die durch das Element <Ziele> der Zielangabe angegeben werden.
Wenn der Benutzername weggelassen wird, wird der Wert von "dmsweep" oder
vom Bereitstellungsassistenten angefordert, wenn eine Bereitstellung mit Hilfe der
Datei mit Anmeldeinformationen versucht wird.
/tp [Kennwort]
Dieser Parameter gibt das Kennwort des Zielbenutzers an. Wenn das Kennwort
weggelassen wird, wird der Wert von "dmsweep" oder vom
Bereitstellungsassistenten angefordert, wenn eine Bereitstellung mit Hilfe der Datei
mit Anmeldeinformationen versucht wird. Wenn die Option "/tp" bei einer
Zielangabe ganz weggelassen wird, wird ein Standardkennwort verwendet (siehe
unten).
/ep [verschlüsseltes Kennwort]
Dieser Parameter gibt das Kennwort des Zielbenutzers in verschlüsseltem Format
an. Diese Option macht dmsweep auf diese Tatsache aufmerksam und das
Kennwort wird vor der Verwendung verschlüsselt.
Wenn in einer Zeile keine <Ziele> angegeben werden, werden die Werte für "/tu" und
"/tp", die in dieser Zeile angegeben werden, als Standardwerte interpretiert, die immer
dann verwendet werden sollen, wenn die Optionen "/tu" und "/tp" in den Zeilen für die
Zielangabe weiter unten in der Datei mit Anmeldeinformationen fehlen. In einer Datei
mit Anmeldeinformationen können mehrere Standardwerte für Benutzer und Kennwort
angegeben werden, es gelten jedoch immer nur die Werte, die (beim Lesen der Datei
von oben nach unten) zuletzt gefunden werden.
Kapitel 5: dmsweep-Befehle 575
Abkürzungen für dmsweep-Argumente
Abkürzungen für dmsweep-Argumente
Die folgenden dmsweep-Argumente sind austauschbar:
/domain und /sd
/ip und /a1
/ipfilename und /if
/jobname und /jn
/language und /pl
/manager und /mgr
/mfilename und /mf
/mpassword und /mp
/musername und /mu
/package und /pk
/packagenum und /pn
/platform und /pt
/pparams und /pp
/primerargs und /pri
/product und /pd
/sserver und /ss
/sspassword und /ssp
/ssusername und /ssu
/targetcred und /tc
/tfilename und /tf
/toip und /a2
/tpassword und /tp
/epassword und /ep
/tusername und /tu
/version und /pv
576 CLI-Referenzhandbuch
dmdFtpUpload: FTP-Upload für DMPrimer
dmdFtpUpload: FTP-Upload für DMPrimer
Gültig für Linux
Wenn Sie einen Linux-Manager verwenden, können Sie die DMPrimer nach der
Installation auf einen FTP-Server hochladen. Das Skript "dmdFtpUpload" lädt alle
DMPrimer hoch, die in der Bereitstellungsbibliothek für alle Plattformen gefunden
werden.
Das Skript befindet sich unter "$CABIN/dmdFtpUpload" (oder
"$CA_ITRM_BASEDIR/dmdeploy/scripts/dmdFtpUpload") und verwendet
Umgebungsvariablen für die Steuerung der FTP-Parameter.
Standardmäßig verwendet das Skript Eigenschaften, die während der Installation
festgelegt wurden. Sie können die folgenden Umgebungsvariablen verwenden, um die
Installationseinstellungen außer Kraft zu setzen.
DMFTPSERVER
Der Hostname des FTP-Servers. Der Standardwert ist der Name des lokalen Hosts.
DMFTPUSER
Ein FTP-Serverkonto mit Schreibrechten. Der Standardwert ist "anonymous".
DMFTPPWD
Kennwort von $DMFTPUSER. Der Standardwert ist "root".
DMFTPHOMEDIR
Der Pfad auf dem FTP-Server zum Hochladen der Pakete (Anzeige auf diesem
Client). Wenn ein relativer Pfad angegeben wird, ist er relativ zum
Stammverzeichnis des $DMFTPUSER-Kontos. Bei einem anonymen Konto ist das
(ch)root-Verzeichnis das Stammverzeichnis des anonymen Kontos. Der
Standardwert ist "/pub/dmprimer".
Kapitel 5: dmsweep-Befehle 577
Kapitel 6: Befehl "DSMPGM" - Steuern der
Daemon-Prozesse unter Linux und UNIX
Mit dem Befehl "DSMPGM" können Sie CA ITCM-Daemon-Prozesse unter Linux und
UNIX starten, herunterfahren und deren Status abfragen. Dieser Befehl ist im
Wesentlichen ein Wrapper für den Befehl "CAF", der als primäre
Befehlszeilenoberfläche für die Steuerung der CA ITCM-Daemons dient. Allerdings stellt
dsmpgm sicher, dass externe erforderliche Prozesse vor dem Aufruf der CAFFunktionalität verfügbar sind.
Der Befehl hat das folgende Format:
dsmpgm {start | restart | stop | status}
start
Daemon-Prozesse starten.
stop
Daemon-Prozesse beenden.
restart
Daemon-Prozesse starten und beenden.
status
Status der Daemon-Prozesse abfragen.
Status beim Beendigen:
Zeigt den Status der Befehlsausführung an. Der Wert Null (0) bedeutet OK. Alle Werte
ungleich Null kennzeichnen Fehler.
Kapitel 6: Befehl "DSMPGM" - Steuern der Daemon-Prozesse unter Linux und UNIX 579
Kapitel 7: Das Tool "dsmPush"
Mit dem Tool "dsmPush" werden Installationspakete für CA ITCM-Komponenten von der
Installations-DVD auf den Domänen-Manager importiert bzw. "gepusht". Mit dem Tool
"dsmPush" können Pakete importiert werden, die zur Verwendung durch Infrastructure
Deployment oder Software Delivery geeignet sind.
Auf der Installations-DVD stehen sprachunabhängige Basispakete für den BHI-Agenten
(Basis-Hardware-Inventar), den AM-Agenten (Asset Management), den RC-Agenten
(Remote Control) und den SD-Agenten (Software Delivery) zur Verfügung. Diese
sprachunabhängigen Basispakete enthalten bereits das englische Sprachpaket (ENU),
darum gibt es kein separates ENU-Paket.
Mit dem dsmPush-Tool können Sie Ihren eigenen Satz an Agentenpaketen erstellen. Sie
können auswählen, welche Agenten und Sprachen Ihr Paket enthalten sollen. Sie
können z. B. ein Paket mit Software Delivery und Remote Control sowie den
Sprachpaketen Spanisch und Koreanisch erstellen.
Weitere Informationen finden Sie im Abschnitt "Informationen zur Erstellung und
Installation von Agenten-Sprachpaketen" im Implementierungshandbuch.
Während des Setups werden mehrere vordefinierte Pakete auf den CA ITCM-Manager
gepusht. Mit dem dsmPush-Tool können Sie diese Pakete erneut pushen oder neue
Pakete erstellen und anschließend pushen.
Das Tool "dsmPush" ist in der CA ITCM-Skriptsprache geschrieben und bietet eine
Prüffunktion zum Validieren und Auflisten bestehender Pakete im CA ITCM-Manager
sowie eine Kopierfunktion zum Erstellen bzw. Pushen der Pakete an den CA ITCMManager.
Unter Windows wird "dsmPush" folgendermaßen aufgerufen:
dmscript.exe Pfadname\dsmPush.dms {copy | check} [-I imagelocation]
[Parameter ...]
Mit dem Parameter "-?" wird dem Benutzer die zu verwendende Syntax angezeigt.
Kapitel 7: Das Tool "dsmPush" 581
dsmPush -? - Syntax -
dsmPush -? - Syntax Mit dem Parameter "-?" wird dem Benutzer die zu verwendende Syntax angezeigt. Die
Syntax wird auch angezeigt, wenn Sie "dsmPush" ohne Angabe von Parametern
aufrufen, oder falls ein schwerwiegender Parameterfehler vorliegt. Das
Programmverhalten kann auch durch den Parameter "-silent" gesteuert werden.
dmscript.exe pathname\dsmPush.dms { check <check-parameters> | -? |
copy [-I imagelocation] [<copy-parameters>] [-silent] }
<copy-parameters>=
{ [-single] [<os-parameters>] [<sd/dm-Parameters>] }
[<pack-parameters>] [<lang-parameters>]
<os-parameters>
=
[-win] [-hp] [-sun] [-ibm] [-linux] [mac] [unixware]
<sd/dm-Parameters>=
[-REGSD] [-REGDM]
<pack-parameters> =
[-rc] [-sd] [-am]
<lang-parameters>=
[-P nls,enu,chs,deu,esn,fra,jpn,kor]
[-L nls,enu,chs,deu,esn,fra,jpn,kor]
<check-parameters> = [-f Name_von_check-output-file]
582 CLI-Referenzhandbuch
Funktion "dsmPush check"
Funktion "dsmPush check"
dsmPush check
Prüft, ob auf dem lokalen System Bereitstellungspakete vorhanden sind und listet die
gefundenen Pakete auf. Das Tool "dsmPush" prüft nicht, ob Software Delivery-Pakete
vorhanden sind. Die Liste der von "dsmPush" gefundenen Pakete enthält folgende
Informationen:
■
Produktname
■
Paket
■
Betriebsumgebung
■
Sprache
■
Version
■
Beschreibung
Die Informationen werden in diese Ausgabedatei geschrieben. Die Datei hat den Namen
"DSM_dsmPush_check_output.txt".
Unter Windows befindet sie sich im temporären Ordner (%TEMP%).
Unter Linux befindet sie sich unter "$CA_ITRM_BASEDIR/logs", wenn die Variable
eingestellt ist, bzw. unter "/tmp", wenn sie nicht gesetzt ist.
Skript "dsmPush copy": Pakete in Bibliotheken importieren
Über das Skript "dsmPush copy" werden mehrere Pakete für die angegebenen Produkte
und Betriebssystemumgebungen in die Infrastructure Deployment-Bibliothek auf dem
lokalen System oder in die Software Delivery-Bibliothek importiert.
Hinweis: Um die Syntaxhilfe des dsmPush-Skripts anzuzeigen, geben Sie zusammen mit
dem dsmPush-Skript ein Fragezeichen als Parameter ein. Das Skript muss vom CD-Image
aus wie folgt ausgeführt werden:
■
Unter Windows:
dmscript dsmPush -?
■
Unter Linux:
dmscript dsmPush.dms -?
Unter Windows wird die Hilfe zu den einzelnen Befehlen in einem Popup-Meldungsfeld
angezeigt, unter Linux wird die Syntax an die Standardausgabe (stdout) gesendet. Die
Syntaxhilfe wird im Falle von falsch angegebenen Parametern automatisch angezeigt.
Sie wird jedoch nicht aufgerufen, wenn der Parameter "-silent" zusammen mit
"dsmPush" verwendet wird.
Kapitel 7: Das Tool "dsmPush" 583
Skript "dsmPush copy": Pakete in Bibliotheken importieren
-I "imagespeicherort"
Gibt den Stammordner des Image an. Der Standardspeicherort ist das Verzeichnis,
in dem sich das Skript "dsmPush.dms" befindet.
Betriebsumgebung
Gibt die Betriebssystemumgebung der zu importierenden Pakete an. Es gibt
folgende Optionen:
-win
Windows-Plattformen
-linux
Linux-Plattformen
-sun
Sun Solaris-Plattformen
-ibm
IBM AIX-Plattformen
-hp
HP UX-Plattform
-mac
MAC OS X-Plattformen
-unixware
SCO UnixWare-Plattformen
product
Gibt an, welche Produkte in den einzelnen importierten Agentenpaketen enthalten
sein sollen. Folgende Werte sind gültig:
-am
Asset Management
-rc
Remote Control
-sd
Software Delivery
registration
Gibt an, in welche Bibliotheken die Pakete importiert werden sollen. Folgende
Werte sind gültig:
-REGDM
Gibt an, dass die Pakete in die Infrastructure Deployment-Bibliothek auf dem lokalen
System importiert werden sollen.
-REGSD
Gibt an, dass die Pakete in die Software Delivery-Bibliothek importiert werden sollen.
Wenn kein Wert für registrierung festgelegt wird, werden die Pakete in beide
Bibliotheken importiert.
-P {Liste_der_Sprachpakete}
Gibt die zu importierenden Sprachpakete an.
Die Liste_der_Sprachpakete ist eine kommagetrennte Aufstellung ohne
Leerzeichen, über die Sie die gewünschten Sprachpakete festlegen können. Es gibt
folgende Optionen:
nls
Mehrsprachige Pakete
enu
Sprachpakete für Englisch (USA)
chs
Sprachpakete für vereinfachtes Chinesisch
584 CLI-Referenzhandbuch
Skript "dsmPush copy": Pakete in Bibliotheken importieren
deu
Sprachpakete für Deutsch
esn
Sprachpakete für Spanisch
fra
Sprachpakete für Französisch
jpn
Sprachpakete für Japanisch
kor
Sprachpakete für Koreanisch
Hinweise:
Die Liste enthält alle Sprachen, die zum Zeitpunkt der Veröffentlichung unterstützt
wurden. Möglicherweise wurden zwischenzeitlich noch weitere Sprachen
hinzugefügt.
Die Option "nls" wird lediglich aus Gründen der Kompatibilität bereitgestellt. Sie
sollte nur in Kombination mit dem englischen Sprachpaket verwendet werden. Die
nls-Option steht für die drei Sprachen Französisch (fra), Deutsch (deu) und
Japanisch (jpn).
Bei Angabe von "nls" wird ein veraltetes NLS-Paket in die Bibliothek kopiert. (nur
Windows!).
Beispiele:
-P deu,fra,kor
Importiert Pakete, die so konfiguriert werden können, dass sie in Deutsch,
Französisch oder Koreanisch ausgeführt werden.
-P enu
Gibt an, dass nur die englischen Basispakete kopiert werden.
-L {enu|chs|deu|esn|fra|jpn|kor}
Gibt die vom Infrastructure Deployment-Assistenten und den Software DeliveryRegistrierungsinformationen verwendete Sprache an. Hierbei handelt es sich
normalerweise um die Sprache, in der der CA ITCM-Domänen-Manager ausgeführt
wird. Sie können eine der aufgeführten Optionen verwenden, um die gewünschte
Sprache anzugeben. Fehlt der Parameter "-L", wird standardmäßig "enu" (Englisch
(USA)) verwendet.
Beispiel: -L deu
Kapitel 7: Das Tool "dsmPush" 585
Skript "dsmPush copy": Pakete in Bibliotheken importieren
-single
Erzwingt, dass nur ein Paket (Agenten- oder Sprachpaket) in die Software Deliveryund Infrastructure Deployment-Bibliotheken importiert wird. Alle anderen Pakete,
die normalerweise importiert werden, werden ausgelassen. Dies gilt für die
angegebene Betriebssystemumgebung oder bei fehlendem Parameter
Betriebsumgebung für alle Betriebssystemumgebungen.
Wenn Sie mehrere Betriebsumgebungen angeben, wird nicht nur ein einzelnes
Paket, sondern ein Paket pro Betriebsumgebung bereitgestellt.
Beispiele:
-single -P chs
Importiert das chinesische Sprachpaket.
-single -am
Importiert das Asset Management-Agentenpaket (nur Englisch).
-single -am -rc -P deu,fra
Importiert ein zusammengefasstes Remote Control- und Asset ManagementAgentenpaket für Englisch, Deutsch und Französisch.
-silent
Deaktiviert den dsmPush-Statusbericht (aus Gründen der Rückwärtskompatibilität).
dsmPush stellt standardmäßig einen Statusbericht zur Verfügung, durch den die
Benutzer über durchgeführte Vorgänge informiert werden. Die erste Information in
dem Bericht ist der Name der Protokolldatei. Unter Linux wird der Statusbericht an
die Standardausgabe (stdout) gesendet; unter Windows wird er im SkriptInterpreter-Fenster angezeigt. Das Fenster wird 10 Sekunden, nachdem das Skript
für den Statusbericht beendet ist, geschlossen.
586 CLI-Referenzhandbuch
dsmPush-Beispiele
Kombinationsmöglichkeiten der Parameter
Im Folgenden finden Sie einige wichtige Hinweise zu Kombinationsmöglichkeiten der
oben beschriebenen Parameter:
■
Wird der Parameter Betriebssystemumgebung nicht festgelegt, werden die
angegebenen Pakete für alle unterstützten Betriebssystemumgebungen importiert
– ungeachtet der Option "-single".
■
Wird der Parameter Produkt nicht festgelegt und fehlt die Option "-single", werden
alle Agentenpakete importiert, die auf der CD für die über den Parameter "-P"
angegebenen Sprachen verfügbar sind. Wird die Option "-single" festgelegt, wird
das ausgewählte Sprachpaket installiert.
■
Ist keine Sprache definiert (Parameter "-P" fehlt), so wird für alle angegebenen
Pakete lediglich die NLS-Version (= enu, deu, fra, jpn) importiert.
■
Ist die Option "-single" festgelegt, fehlen aber die Produkt- und "-P"-Parameter,
wird kein Paket importiert.
Weitere Syntaxbeispiele für das dsmPush-Skript unter Windows und Linux zum
Importieren von Paketen in die Software Delivery- und Infrastructure DeploymentBibliotheken finden Sie im Abschnitt "dsmPush-Beispiele".
dsmPush-Beispiele
Die Verwendung von dsmPush anzeigen
Starten Sie vom obersten Ordner der DVD aus das dsmPush-Skript, zum Beispiel:
C:\DSM_11_2_226_1042_CD> dmscript dsmPush -?
Bestimmte Produktpakete mit Sprachpaketen unter Verwendung der deutschen
Version des Infrastructure Deployment-Assistenten und der reginfo-Dateien von
Software Delivery importieren
In diesem Beispiel werden Asset Management- und Software Delivery-Produktpakete
mit deutschen und französischen Sprachpaketen in die Bibliotheken importiert. Hierzu
wird die deutsche Version des Infrastructure Deployment-Assistenten und der reginfoDateien von Software Delivery verwendet. Das Beispiel bezieht sich auf eine WindowsUmgebung:
...\Programme\CA\DSM\Bin\dmscript.exe "pfadname\dsmPush.dms" copy
-I "imagespeicherort" -am -sd -REGDM -REGSD -P enu,deu,fra -L deu
Windows-Pakete zur Unterstützung aller Sprachen importieren
dmscript c:\DSM_11_2_226_1042_CD\dsmPush.dms copy
-I c:\DSM_11_2_226_1042_CD -win -P fra,chs,deu,esn,kor,jpn -L enu
Kapitel 7: Das Tool "dsmPush" 587
dsmPush-Beispiele
Windows-Pakete für Asset Management in Französisch in die Software Delivery- und
Infrastructure Deployment-Bibliotheken importieren
dmscript c:\DSM_11_2_226_1042_CD\dsmPush.dms copy
-I c:\DSM_11_2_226_1042_CD -win -am -P fra -L enu
Windows-Pakete für Remote Control in Spanisch in die Software Delivery- und
Infrastructure Deployment-Bibliotheken importieren
dmscript c:\DSM_11_2_226_1042_CD\dsmPush.dms copy
-I c:\DSM_11_2_226_1042_CD -win -rc -P esn -L enu
Windows-Pakete für Remote Control und Software Delivery in Chinesisch und
Japanisch in die Software Delivery- und Infrastructure Deployment-Bibliotheken
importieren
dmscript c:\DSM_11_2_226_1042_CD\dsmPush.dms copy
-I c:\DSM_11_2_226_1042_CD -win -rc -sd -P chs,jpn -L enu
Windows-Pakete für Asset Management und Software Delivery in Chinesisch,
Koreanisch, Deutsch und Japanisch in die Software Delivery- und Infrastructure
Deployment-Bibliotheken importieren
dmscript c:\DSM_11_2_226_1042_CD\dsmPush.dms copy
-I c:\DSM_11_2_226_1042_CD -win -am -sd -P kor,jpn,chs,deu -L enu
Linux-Pakete für Asset Management und Software Delivery in Chinesisch, Koreanisch,
Deutsch und Japanisch in die Software Delivery- und Infrastructure DeploymentBibliotheken importieren
dmscript c:\DSM_11_2_226_1042_CD\dsmPush.dms copy
-I c:\DSM_11_2_226_1042_CD -Linux -am -sd -P kor,jpn,chs,deu -L enu
Alle Windows-Pakete in allen Sprachen in die Software Delivery-Bibliothek
importieren
dmscript c:\DSM_11_2_226_1042_CD\dsmPush.dms copy
-I c:\DSM_11_2_226_1042_CD -win -REGSD -P kor,jpn,chs,deu,esn,fra -L enu
Alle Windows-Pakete in allen Sprachen in die Infrastructure Deployment-Bibliothek
importieren
dmscript c:\DSM_11_2_226_1042_CD\dsmPush.dms copy
-I c:\DSM_11_2_226_1042_CD -win -REGDM -P kor,jpn,chs,deu,esn,fra -L enu
588 CLI-Referenzhandbuch
dsmPush-Beispiele
Automatisch alle Windows-Pakete in allen Sprachen in die Software Delivery- und
Infrastructure Deployment-Bibliotheken importieren
dmscript c:\DSM_11_2_226_1042_CD\dsmPush.dms copy
-I c:\DSM_11_2_226_1042_CD -win -P fra,chs,deu,esn,kor,jpn,nls -L enu
-silent
Kapitel 7: Das Tool "dsmPush" 589
Kapitel 8: intellisigcmd - Befehlszeilen-Tool
intellisigcmd ist ein Befehlszeilen-Tool für Intellisigs. Dieses Tool hat das folgende
Format:
intellisigcmd <cmd> param1=value1 param2=value2 ... [<DB_Credentials>]
cmd
Gibt den Import-, Export- oder genuuid-Befehl an.
DB_credentials
Gibt die Datenbankanmeldeinformationen der MDB an. Standardmäßig werden die
Anmeldeinformationen aus comstore abgerufen.
Verwenden Sie das folgende Beispielformat, um die DB-Anmeldeinformationen
anzugeben:
Beispiel: Format für SQLServer-DB-Anmeldeinformationen
dbvendor=mssql dbhost=myhost dbname=mdb dbuser=ca_itrm dbpassword=mypwd
dbinstance=inst
Beispiel: Format für Oracle-DB-Anmeldeinformationen
dbvendor=oracle dbhost=myhost dbname=orcl dbuser=ca_itrm dbpassword=mypwd
dbinstance=1521
Kapitel 8: intellisigcmd - Befehlszeilen-Tool 591
intellisigcmd export – Exportieren von Intellisigs
intellisigcmd export – Exportieren von Intellisigs
Der intellisigcmd-Exportbefehl lässt Sie Intellisigs exportieren. Sie können entweder den
DSM-Explorer oder den Befehl verwenden, um Intellisigs zu exportieren.
Dieser Befehl hat das folgende Format:
intellisigcmd export file=<export name> [type=xml|zip]
[platform=all|windows|unix]
export name
Gibt den Namen der Intellisig XML- oder ZIP-Datei an, die Sie exportieren möchten.
Wenn Sie keine Dateierweiterung angeben und der Typ XML ist, erstellt der Befehl
einen Ordner mit dem angegebenen Namen.
type
Gibt an, ob Sie eine XML- oder ZIP-Datei exportieren möchten. Wenn Sie den
Typparameter nicht einschließen, übernimmt der Befehl den Exporttyp
entsprechend der Exportdateierweiterung.
Gültige Werte: xml, zip
platform
Gibt die Plattform an, um zu bestimmen, welche Intellisigs exportiert werden.
Gültige Werte: all, windows, unix
Standard: all
592 CLI-Referenzhandbuch
intellisigcmd import – Importieren von Intellisigs
intellisigcmd import – Importieren von Intellisigs
Der intellisigcmd-Importbefehl lässt Sie Intellisigs importieren. Sie können entweder den
DSM-Explorer oder den Befehl verwenden, um Intellisigs zu importieren.
Dieser Befehl hat das folgende Format:
intellisigcmd import [file=<import source>] [type=xml|zip]
[mode=replace|mergenew|mergeall] [updateactive=yes|no] [delete=yes|no]
import source
Gibt den Namen der XML- oder ZIP-Datei an, in die Sie das Intellisig importieren
möchten. Wenn Sie die Dateierweiterung nicht angeben, übernimmt der Befehl die
Dateierweiterung je nach Typ.
Hinweis: Wenn Sie in eine XML-Datei importieren möchten, überprüfen Sie, dass
die unterstützenden Verzeichnisse im gleichen Ordner wie die XML-Datei
vorhanden sind.
type
Gibt an, ob Sie als XML- oder ZIP-Datei importieren möchten. Wenn Sie diesen
Parameter nicht einschließen, übernimmt der Befehl den Importtyp entsprechend
der Importdateierweiterung.
Gültige Werte: xml, zip
mode
Legt den Importmodus fest. Folgende Importmodi werden unterstützt:
Standard: mergenew
replace
Ersetzt vorhandene Definitionen durch die Definition, die importiert wird.
Vorhandene Definitionen gehen verloren.
mergenew
Hängt neue Intellisig-Versionen an die Definitionen auf dem Manager an.
Vorhandene Definitionen werden nicht geändert.
mergeall
Hängt neue Intellisig-Versionen an und aktualisiert die vorhandenen Definitionen,
die in die Importdatei eingeschlossen sind. Intellig-Versionen, die nicht in den
Importdateien definiert sind, werden nicht geändert.
updateactive
Gibt an, ob aktiven Intellisig-Versionen während des Imports aktualisiert werden
können.
Gültige Werte: Yes, Y, true, 1 oder No, N, false, 0
Standard: Yes (Ja)
Kapitel 8: intellisigcmd - Befehlszeilen-Tool 593
intellisigcmd genuuid – Generieren von UUIDs
delete
Gibt an, ob Sie Intellisigs vor dem Import löschen möchten. Wenn Sie den
Löschschalter nicht einschließen, wird kein Intellisigs vor dem Import gelöscht.
Standardwert: Nein
intellisigcmd genuuid – Generieren von UUIDs
Der intellisigcmd genuuid-Befehl lässt Sie eindeutige UUIDs generieren, die Sie
verwenden können, wenn Sie benutzerdefinierte Intellisigs erstellen.
Dieser Befehl hat das folgende Format:
intellisigcmd genuuid [num=<count>]
num
Gibt die zu generierende Anzahl von UUIDs an. Wenn Sie diesen Parameter nicht
angeben, wird eine einzelne UUID generiert. Andernfalls werden <count> UUIDs
generiert.
Gültige Werte: 1 bis 1000
594 CLI-Referenzhandbuch
Kapitel 9: MDB-Admin-Konsolen-CLI
Die MDB-Admin-Konsole ist eine Befehlszeilenschnittstelle (CLI) für das Exportieren und
Importieren von mit CA IT Client Manager verknüpften Daten von einer MDB zur
nächsten. Zum Beispiel können Sie Daten aus Ihrer Testumgebung exportieren und sie
mithilfe der MDB-Admin-Konsole in Ihre Produktionsumgebung importieren.
Dieses Kapitel enthält folgende Themen:
MDB-Admin-Konsole (siehe Seite 595)
Dateien und Ordner der MDB-Admin-Konsole (siehe Seite 597)
Konfigurieren von Datenbankverbindungen (siehe Seite 598)
Verwenden der MDB-Admin-Konsole (siehe Seite 600)
Fehlerbehebung (siehe Seite 610)
MDB-Admin-Konsole
Mit der MDB-Admin-Konsole können Sie CA ITCM-Daten aus einer Quell-MDB in einer
Ziel-MDB bereitstellen und bestimmte Datenbank-Verwaltungs-Tasks ausführen. CA
ITCM zeigt die MDB-Admin-Konsole als Befehlszeilenschnittstelle an (CLI).
Sie können die MDB-Admin-Konsole für die folgenden Tasks verwenden:
■
Mit CA ITCM verknüpfte Daten von einer MDB zur anderen exportieren bzw.
importieren. Zum Beispiel können Sie Daten aus Ihrer Testumgebung exportieren
und sie mithilfe der MDB-Admin-Konsole in Ihre Produktionsumgebung
importieren.
■
Datenbankeinträge neu konfigurieren, um sie an eine Änderung im Netzwerk-(IP)Namen des DSM-Managers anzupassen.
■
Datenbankeinträge neu konfigurieren, um sie an eine Änderung im Netzwerk-(IP)Namen des DBSM-Managers anzupassen.
Kapitel 9: MDB-Admin-Konsolen-CLI 595
MDB-Admin-Konsole
Hinweise zum Exportieren und Importieren
Die folgenden Hinweise treffen zu, wenn Sie die MDB-Admin-Konsole zum Exportieren
oder Importieren von Daten verwenden:
■
Die MDB-Admin-Konsole kann die folgenden MDB-Objekte exportieren und
importieren:
–
Sicherheitsprofile und Bereichsdefinitionen
–
Asset-Gruppen
–
Abfragen
–
Abfrage- und ereignisbasierte Asset-Richtlinien
–
Konfigurationsrichtlinien
–
Software-Gruppen, Vorgangs-Gruppen, und Software-Richtlinien
–
Softwaredefinitionen
Hinweis: Eine detaillierte Beschreibung der unterstützten MDB-Objekte finden Sie
im Anhang "Unterstützte MDB-Objekttypen".
■
Sie können den Export und Import als zwei getrennte Tasks ausführen. Mit diesem
Ansatz können Sie die exportierten, in XML-Dateien gespeicherten MDB-Daten
überprüfen, bevor Sie die Daten in die Ziel-MDB importieren.
Hinweis: Ändern Sie die Inhalte der XML-Datei nicht, wenn Sie planen, die XMLDatei dafür zu verwenden, später Daten ins Ziel MDB zu importieren.
■
Die MDB-Admin-Konsole löscht kein Objekt aus der Ziel-MDB, wenn Sie Daten
importieren.
Exportieren und Importieren von Daten über MDB-Plattformen und -Versionen
hinweg
Sie können die MDB-Admin-Konsole in den folgenden Szenarien zum Exportieren und
Importieren von Daten verwenden:
CA ITCM r11.2 SP4, r12, r12 SP01, r12.5 oder r12.8 mit gleichwertigen oder höheren CA
ITCM-Versionen
Sie können die MDB-Objekte aus einer CA ITCM r11.2 SP4, r12 oder r12 SP01-, r12.5
oder r12.8-MDB exportieren und sie in die MDB einer gleichwertigen oder höheren
Version von CA ITCM importieren. Zum Beispiel können Sie die MDB-Objekte aus einer
CA ITCM r11.2 SP4-MDB exportieren und sie in eine CA ITCM r12-MDB importieren.
Unternehmen zu Unternehmen
Sie können die MDB-Objekte aus einer DSM-Enterprise-Manager-MDB exportieren und
sie in eine andere CA ITCM-Enterprise-Manager-MDB importieren.
596 CLI-Referenzhandbuch
Dateien und Ordner der MDB-Admin-Konsole
Domäne zu Domäne
Sie können die MDB-Objekte aus einer Domänen-Manager-MDB exportieren und sie in
eine andere importieren.
SQL Server zu Oracle
Sie können die MDB-Objekte aus einer SQL Server-MDB exportieren und sie in eine
Oracle-MDB importieren. Gleichermaßen können Sie die MDB-Objekte aus einer OracleMDB exportieren und sie in eine SQL Server-MDB importieren.
Hinweis: Sie können die Export- und Importszenarien verbinden. Sie können
beispielsweise die MDB-Objekte aus einer CA ITCM-r11.2-SP4-Enterprise-Manager-MDB
exportieren und in eine CA ITCM-r12-Enterprise-Manager-MDB importieren.
Dateien und Ordner der MDB-Admin-Konsole
Das Installationsprogramm erstellt bei erfolgreicher Installation die folgenden, mit der
MDB-Admin-Konsole verbundenen Dateien und Ordner:
■
.\mdbac.bat – Ausführbare Batch-Datei, die die Befehlszeilenschnittstelle darstellt.
■
.\log – Ordner, der Protokolldateien aus der MDB-Admin-Konsole enthält. Weitere
Details zum Ordner "\log" finden Sie im Abschnitt "Fehlerbehebung".
■
.\cfg – Ordner mit den Konfigurationsdateien.
■
.\sample*.bat – Es sind einige Dateien vorhanden, die Sie als Beispiele für die
Nutzung der MDB-Admin-Konsole-Befehlszeile verwenden können.
Kapitel 9: MDB-Admin-Konsolen-CLI 597
Konfigurieren von Datenbankverbindungen
Konfigurieren von Datenbankverbindungen
Die MDB-Admin-Konsole verwendet Verbindungsnamen, um die MDB-Datenbanken für
ihre Vorgänge zu referenzieren. Bevor Sie die MDB-Admin-Konsole verwenden, müssen
Sie daher die Verbindungsnamen für die in den Export- und Importvorgang
einbezogenen MDBs definieren. Sie stellen diese Verbindungsnamen der MDB-AdminKonsolen-Befehlszeilenschnittstelle als Argument bereit.
Gehen Sie folgendermaßen vor:
1.
Öffnen Sie die sich im Ordner ".\cfg" befindliche Datei "mdbac.properties". Der
Ordner ".\cfg-Ordner" befindet sich im MDB-Admin-KonsolenInstallationsverzeichnis.
2.
Suchen Sie nach "Verbindungen definieren", und ändern Sie entweder die
vorhandene Datenbankverbindungseinträge, oder fügen Sie für neue
Datenbankverbindungen neue Einträge hinzu. Definieren Sie die neuen
Datenbankverbindungszeichenfolgen im folgenden Format:
Oracle-MDB
connection.connection_name=jdbc:oracle:thin:@Host:Port:SID
SQL Server-MDB
connection.connection_name=jdbc:sqlserver://Host\[Instance_name]:Port;Databas
eName=database_name
Um eine vertrauenswürdige Verbindung zur SQL Server-MDB zu konfigurieren,
verwenden Sie das folgende Format:
connection.mssql-test
=jdbc:sqlserver://Host\[instance_name]:Port;DatabaseName=database_name;integr
atedSecurity=true
Connection_name
Definiert den Verbindungsnamen. Sie geben diesen Verbindungsnamen als
einen Parameter in der MDB-Admin-Konsolen-CLI an, um sich auf die MDB zu
beziehen.
Host
Definiert den Namen des Computers, der die MDB hostet.
598 CLI-Referenzhandbuch
Konfigurieren von Datenbankverbindungen
Instance_name
(Optional) Definiert den Instanzennamen, zu dem eine Verbindung hergestellt
wird.
Standard: Standardinstanz
Hinweis: Wenn Ihr Instanzenname mit "n", "r" oder "t" beginnt, müssen Sie das
Escape-Zeichen "\" vor dem Zeichen hinzufügen, da diese Zeichen als
Endmarken fungieren, wenn ihnen ein "\" vorangestellt ist. Wenn der
Instanzenname beispielsweise "nonname" lautet, muss die
Verbindungszeichenfolge folgendermaßen sein:
MyMachine\\nonname:1488
Hinweis: Der Parameter "instance_name" ist obligatorisch für die Methode
"adjustmdbcfg", auch wenn Sie die Standardinstanz verwenden. Der
Standardinstanzenname muss als "MSQLSERVER" angegeben werden.
Port
Definiert die Portnummer der MDB.
Database_name
Definiert den Datenbanknamen der MDB.
SID
Definiert die SID der MDB.
IntegratedSecurity=true
Zeigt an, dass eine vertrauenswürdige Verbindung zur SQL Server-MDB
erforderlich ist. Sie benötigen eine vertrauenswürdige Verbindung zur SQL
Server-MDB für die Ausführung der Methode "adjustmdbcfg" (siehe Seite 606).
Beispiele:
connection.mssql-test =jdbc:sqlserver://lab_test:1433;DatabaseName=mdb
connection.mssql-test
=jdbc:sqlserver://lab_test\\MSQLSERVER:1433;DatabaseName=mdb;integratedSecuri
ty=true
Connection.oracle-test=jdbc:oracle:thin:@lab-test:1521:orcl
3.
Stellen Sie sicher, dass die Datenbankverbindung zur MDB-Admin-Konsole
funktioniert. Gehen Sie dazu folgendermaßen vor:
a.
Öffnen Sie die Eingabeaufforderung, und navigieren Sie mithilfe des folgenden
Befehls zum MDB-Admin-Konsolen-Installationsverzeichnis:
cd MDBAC_Installation_Directory
b.
Führen Sie folgenden Befehl aus:
mdbac –testcon –target Connection_name -user username –pwd password
Überprüft die Datenbankverbindung und gibt das Ergebnis zurück.
Kapitel 9: MDB-Admin-Konsolen-CLI 599
Verwenden der MDB-Admin-Konsole
Beispiele:
mdbac –testcon –target mssql-test -user ca_itrm –pwd password123
mdbac –testcon –target oracle-test -user mdbadmin –pwd password123
Sie können jetzt die Verbindungsnamen in Ihrer MDB-Admin-Konsolen-CLI
verwenden.
Weitere Informationen:
MDB-Admin-Konsolen-CLI (siehe Seite 601)
Verwenden der MDB-Admin-Konsole
Befehlszeilenargumente
Die folgenden Befehlszeilenargumente sind allen oder den meisten MDB-AdminKonsolen-Befehlen gemein:
Anwender
Gibt den Benutzernamen für die Verbindung mit der Datenbank an. Der
Standardbenutzername ist für die Microsoft SQL Server-MDB lautet "ca_itrm" und
"mdbadmin" für die Oracle-MDB.
pwd
Gibt das Kennwort für die Verbindung zur Datenbank an.
wallet
Gibt den Pfad zur Wallet-Datei an, die den Benutzernamen und das Kennwort für
die Verbindung zur Datenbank enthält. Verwenden Sie dieses Argument als
Alternative zu den Argumenten "user" und "pwd". Bevor Sie das Argument "wallet"
an die MDB-Admin-Konsolen-CLI weitergeben, müssen Sie mithilfe der Methode
"createwallet" die Datei erstellen, die die Anmeldeinformationen enthält.
Work_folder
Gibt den relativen oder absoluten Pfad zu einem Ordner für die Speicherung von
Daten an, beispielsweise exportierte XML-Datendateien. Sie müssen sicherstellen,
dass der Ordner im angegebenen Pfad vorhanden ist.
Connection name
Gibt den Verbindungsnamen an, den Sie beim Konfigurieren der
Datenbankverbindungen in der Datei "mdbac.properties" definiert haben.
600 CLI-Referenzhandbuch
Verwenden der MDB-Admin-Konsole
Weitere Informationen:
Methode "createwallet" – Erstellen eines Wallet-Elements (siehe Seite 602)
MDB-Admin-Konsolen-CLI
In diesem Abschnitt werden die Methoden beschrieben, die die MDB-Admin-Konsole für
verschiedene Datenbank-Verwaltungs-Tasks bietet.
Hinweis: Um die MDB-Admin-Konsolen-CLI auszuführen, ändern Sie die Verzeichnisse
für den MDB-Admin-Konsolen-Installationsordner in der Eingabeaufforderung.
Export- und Importreihenfolge bei MDB-Objekten
Wenn Sie die MDB-Admin-Konsole zum Exportieren von MDB-Objekten aus einer QuellMDB und zum Importieren in eine Ziel-MDB verwenden, müssen Sie der im Folgenden
aufgeführten Reihenfolge folgen:
1.
Sicherheitsprofile
2.
Bereiche
3.
Abfragen
4.
Asset-Gruppen
5.
Abfragebasierte Richtlinien
6.
Ereignisbasierte Richtlinien
7.
Softwaregruppen
8.
Prozedurgruppen
9.
Softwarebasierte Richtlinien
10. Softwaredefinitionen
11. Konfigurationsrichtlinien
Kapitel 9: MDB-Admin-Konsolen-CLI 601
Verwenden der MDB-Admin-Konsole
Methode "createwallet" – Erstellen eines Wallet-Elements
Ein Wallet ist eine Datei, die den Benutzernamen und das Kennwort für die Verbindung
zur Datenbank enthält. Sie können ein Wallet als Argument für die MDB-AdminKonsolen-CLI bereitstellen.
Dieser Befehl hat das folgende Format:
mdbac.bat –createwallet
Sie werden über diesen Befehl aufgefordert, den Benutzernamen und das Kennwort für
die Verbindung zur Datenbank in einem Dialogfeld einzugeben. Klicken Sie auf "Save
Wallet" (Wallet speichern), um die Anmeldeinformationen in einer Datei zu speichern.
Wenn die angegebene Datei bereits vorhanden ist, wird die Datei durch Klicken auf die
Option "Save Wallet" überschrieben.
Methode "export" – Exportieren von MDB-Objekten
Die Methode "export" exportiert MDB-Objekte aus einer Quell-MDB. Sie erstellt für
jedes Objekt, das mit dem angegebenen Objektnamen oder Muster übereinstimmt, eine
XML-Datei. Die XML-Dateien sind wie folgt benannt:
ObjectType__ObjectName__(counter).xml
Beispiel: XML-Dateiname
BoQueryDef__Asset is a Virtual Machine - MS Virtual PC__(1).xml
Dieser Befehl hat das folgende Format:
mdbac.bat –export MDB_Object_Type -name Object_Name - work workfolder -source
Connection_Name {–user User_Name –pwd Password | -wallet wallet_file_name}
MDB_Object_Types
Gibt den MDB-Objekttyp an, den Sie exportieren möchten.
Hinweis: Eine Liste mit unterstützten MDB-Objekttypen finden Sie im Anhang
"Unterstützte MDB-Objekttypen".
Object_Name
Gibt den Objektnamen im angegebenen Objekttyp an, den Sie exportieren
möchten. Sie können Platzhalterzeichen verwenden, um eine Übereinstimmung zu
erzielen. Zum Beispiel können Sie "Asset%" angeben, um alle Objekte zu
verarbeiten, die im angegebenen Objekttyp mit dem Namen "Asset" beginnen.
602 CLI-Referenzhandbuch
Verwenden der MDB-Admin-Konsole
Beispiel: Exportieren von MDB-Objekten
Dieser Beispielbefehl exportiert Abfragen, die mit dem Objektnamen "Asset is a Virtual
Machine" beginnen aus einer angegebenen SQL-MDB:
mdbac.bat -export BoQueryDef -name "Asset is a Virtual Machine%" -work
C:\TEMP\work -source mssql -user ca_itrm -pwd password123
Beispiel: Verwenden des Wallet-Arguments
mdbac.bat -export BoQueryDef -name "Asset is a Virtual Machine%" -work
C:\TEMP\work -source mssql -wallet dbwallet
Methode "import" – Importieren von MDB-Objekten
Die Methode "import" importiert MDB-Objekte in eine Ziel-MDB. Sie erstellt neue
Objekte und aktualisiert vorhandene Objekte in der Ziel-MDB. Für jeden unterstützten
MDB-Objekttyp wird der Objektname als eindeutige Referenz verwendet, um zu
bestimmen, ob das Objekt neu oder vorhanden ist.
Hinweis: Wenn Sie die importierten Objekte nicht im DSM-Explorer finden, starten Sie
CAF neu.
Dieser Befehl hat das folgende Format:
mdbac.bat –import –file file_or_folder_name -target Connection_Name {–user
User_Name –pwd Password | -wallet wallet_file_name}
Hinweis: Während Sie die "ca_itrm"-Benutzeranmeldeinformationen verwenden
können, um Daten in die SQL Server-MDB zu importieren, benötigen Sie die
Anmeldeinformationen des "mdbadmin"-Benutzers, um Daten in die Oracle-MDB zu
importieren.
File_or_Folder_Name
Gibt den Namen der Datei oder des Ordners an, der die exportierten Daten enthält.
Hinweis: Sie können die Methode "import" verwenden, um gleichzeitig mehrere
Dateien zu importieren. Vermeiden Sie jedoch, mehrere Dateien vom selben MDBObjekttyp und Objektnamen in einem Ordner zu speichern, da die Sequenz der
Verarbeitung dieser Dateien und die Ergebnisse der Methode "import" nicht
bestimmt werden können.
Beispiel: Importieren von MDB-Objekten
Dieser Beispielbefehl importiert MDB-Objekte aus dem Ordner "work" in die Ziel-MDB:
mdbac.bat –import -file C:\TEMP\work -target mssql -user ca_itrm -pwd password123
Kapitel 9: MDB-Admin-Konsolen-CLI 603
Verwenden der MDB-Admin-Konsole
Methode "compare" – Vergleichen von MDB-Objekten in Quell- und Ziel-MDBs
Der Methode "compare" vergleicht MDB-Objekte in Quell- und Ziel-MDBs. Sie liest
Objekte aus Quell- und Zieldatenbanken und erstellt entsprechende XML-Dateien im
Ordner "work". Jeder unterstützte MDB-Objekttyp weist bestimmte Regeln auf, die
bestimmen, wann die Objekte als gleich erachtet werden. Eine Liste dieser Regeln
finden Sie im Anhang "Regeln für den MDB-Objektvergleich".
Hinweis: Die Quell- und Ziel-MDBs müssen dieselben Datenbankanmeldeinformationen
aufweisen.
Dieser Befehl hat das folgende Format:
mdbac.bat -compare MDB_Object_Type -name Object_Name - work work_folder -source
Connection_Name –target Connection_Name {–user User_Name –pwd Password | -wallet
wallet_file_name}
MDB_Object_Type
Gibt den MDB-Objekttyp an, den Sie vergleichen möchten. Dieser Parameter
akzeptiert nur einen einzelnen Objekttyp. Wenn Sie mehrere Objekttypen
einschließen, gibt der Befehl ungültige Ergebnisse zurück.
Hinweis: Eine Liste mit unterstützten MDB-Objekttypen finden Sie im Anhang
"Unterstützte MDB-Objekttypen".
Object_Name
Gibt den Objektnamen im angegebenen Objekttyp an, den Sie vergleichen
möchten. Sie können Platzhalterzeichen verwenden, um eine Übereinstimmung zu
erzielen. Zum Beispiel können Sie "Asset%" angeben, um alle Objekte zu
verarbeiten, die im angegebenen Objekttyp mit dem Namen "Asset" beginnen.
Beispiel: Vergleichen von MDB-Objekten in Quell- und Ziel-MDBs
Dieser Beispielbefehl vergleicht die Abfragen, die mit "Asset is a Virtual Machine" in
Test- und Produktionsdatenbanken beginnen:
mdbac.bat –compare BoQueryDef -name "Asset is a Virtual Machines" -work
C:\TEMP\work -source mssql-test - target mssql-production -user ca_itrm -pwd
password123
Hinweis: Weitere Details zu den Gründen eines fehlerhaften "compare"-Befehls finden
Sie in der Datei "diff.log". Die Datei "diff.log" befindet sich in dem im Parameter "-work"
des Befehls "compare" angegebenen Ordner.
604 CLI-Referenzhandbuch
Verwenden der MDB-Admin-Konsole
Methode "view" – Anzeigen von Eigenschaften eines exportierten MDB-Objekts
Die Methode "view" zeigt die Eigenschaften eines exportierten MDB-Objekts (in einer
XML-Datei enthalten) in der Konsole an. Sie liest die Eigenschaften der XML-Datei und
zeigt sie in der Konsole an. Die Eigenschaftsnamen, die die Exportmethode generiert
hat, müssen nicht unbedingt mit den Eigenschaftsnamen im DSM-Explorer
übereinstimmen.
Dieser Befehl hat das folgende Format:
mdbac.bat –view –file file_name
File_name
Gibt den Namen einer einzelnen Datei an; die Eigenschaften, die Sie anzeigen
möchten.
Beispiel: Anzeigen von Eigenschaften eines exportierten MDB-Objekts
Dieser Beispielbefehl liest die Eigenschaften der Datei "BoQueryDef__Asset is a Virtual
Machine - VMWare__(0).xml" und zeigt sie in der Konsole an:
mdbac.bat -view –file C:\TEMP\work\BoQueryDef__Asset is a Virtual Machine VMWare__(0).xml
Methode "unregman" – Aufheben der Registrierung eines DSM-Managers
Die Methode "unregman" hebt die Registrierung eines DSM-Managers aus einer DSM
auf. Nachdem Sie die Registrierung eines DSM-Managers aufgehoben haben, können Sie
einen neuen DSM-Manager installieren und ihn auf diese MDB verweisen. Beim ersten
Start wird der DSM-Manager für die MDB registriert, auf die Sie verwiesen haben. Die
DSM-Domäne und Enterprise-Manager ermöglichen Registrierungen nur mit der
entsprechenden Domänen- und den Enterprise-MDBs. Beispielsweise können Sie einen
Domänen-Manager nur für eine Domänen-MDB registrieren.
Hinweis: Stellen Sie vor dem Ausführen des Befehls sicher, dass die Ziel-MDB über keine
geöffneten Sitzungen verfügt.
Dieser Befehl hat das folgende Format:
mdbac.bat –unregman -target connection_name {-user User_Name -pwd password |
wallet wallet_file_name}
-
Beispiel: Aufheben der Registrierung eines DSM-Managers
Dieser Beispielbefehl hebt die Registrierung des DSM-Managers auf, der der Test-MDB
zugeordnet ist:
mdbac.bat –unregman -target mssql-test -user ca_itrm -pwd password123
Kapitel 9: MDB-Admin-Konsolen-CLI 605
Verwenden der MDB-Admin-Konsole
Methode "adjustmdbcfg" – Konfigurieren eines DSM-Managers für die Verwendung einer
anderen MDB
Die Methode "adjustmdbcfg" konfiguriert einen DSM-Manager neu, um eine andere
MDB zu verwenden. Sie müssen sicherstellen, dass die neue MDB keinem anderen DSMManager zugeordnet wird.
Sie müssen die folgenden Faktoren berücksichtigen, wenn Sie die Methode
"adjustmdbcfg" verwenden:
■
Diese Methode ist nur für SQL Server-MDBs verfügbar.
■
Um diese Methode auszuführen, installieren Sie die MDB-Admin-Konsole auf dem
DSM-Manager, den Sie neu konfigurieren möchten.
■
Mit dieser Methode können Sie nur die Komponenten des DSM-Managers neu
konfigurieren. Sie schließt keine erneute Konfiguration für andere Komponenten
wie CCE oder DTS ein.
■
Die Methode ermöglicht nur die erneute Konfiguration von Domänen- und
Enterprise-Managern für die entsprechenden Domänen- und Enterprise-MDBs. Zum
Beispiel können Sie einen Domänen-Manager neu konfigurieren, dass er nur auf
eine Domänen-MDB zeigt.
■
Stellen Sie mithilfe einer vertrauenswürdigen Verbindung sicher, dass die Ziel-MDB
erreichbar ist.
Der Befehl für diese Methode hat das folgende Format:
mdbac.bat –adjustmdbcfg -target connection_name –file rules_properties_file
Hinweis: Die Verbindungszeichenfolge des für diese Methode von Ihnen verwendeten
Verbindungsnamens muss den Datenbankinstanznamen ausdrücklich angeben, auch
wenn Sie die Standardinstanz verwenden. Weitere Informationen finden Sie unter
Konfigurieren von Datenbankverbindungen (siehe Seite 598).
file
Gibt den Pfad zur Datei "Rules.Properties" an, die die Schritte und Aktionen für die
erneute Konfiguration enthält. Weitere Informationen finden Sie in der Datei
Rules.Properties (siehe Seite 607).
606 CLI-Referenzhandbuch
Verwenden der MDB-Admin-Konsole
Bei der Ausführung aktualisiert dieser Befehl die folgenden MDB-Verbindungsparameter
in der comstore-Datei des DSM-Managers:
■
Host
■
Port
■
Datenbankname
Hinweis: Wenn Sie die Datei "Rules.Properties" konfiguriert haben, um den ca_itrmBenutzer in der Ziel-MDB zu erstellen, müssen Sie sicherstellen, dass das Kennwort des
ca_itrm-Benutzers in der comstore-Datei und in der Datei "Rules.Properties"
übereinstimmen. Der Grund hierfür ist, dass die Methode "adjustmdbcfg" die ca_itrmBenutzer und -Kennwortparameter in der comstore-Datei nicht aktualisiert.
Datei "Rules.Properties"
Die Datei "Rules.Properties" ist eine Konfigurationsdatei, mit der Sie die von der
Methode "adjustmdbcfg" durchgeführten Schritte für eine MDB-Verschiebung
konfigurieren können. Eine Beispieldatei mit dem Namen "mdbmove.properties"
befindet sich im Ordner "MDB_Install_Directory\cfg".
Kapitel 9: MDB-Admin-Konsolen-CLI 607
Verwenden der MDB-Admin-Konsole
Die folgende Abbildung zeigt die Inhalte der Beispieldatei an:
Die folgenden Parameter und Aktionen sind in der Datei "Rules.Properties" verfügbar:
reconfigure.sequence
Gibt die Ausführung der Schrittabfolge an, die die Methode "adjustmdbcfg"
befolgen muss. Die Abfolge enthält die Schrittnamen in einer kommagetrennten
Liste. Jeder Schritt hat einen Aktionsnamen und Parameter, die im folgenden
Format definiert sind:
stepn.action
stepn.argm
createlogin (login_name, password)
Erstellt eine Datenbankanmeldung mit dem angegebenen Benutzernamen und
Kennwort in der SQL Server-MDB.
608 CLI-Referenzhandbuch
Verwenden der MDB-Admin-Konsole
droplogin (login_name)
Entfernt die angegebene Datenbankanmeldung aus der SQL Server-MDB.
repairlogin (login_name)
Richtet die SID der SQL Server-Anmeldung nach dem Benutzer der MDB aus.
updatecomstore
Aktualisiert die comstore-Datei des lokalen DSM-Managers mit den DatenbankVerbindungseigenschaften der aktuellen SQL Server-MDB (Hostname, Instanzname,
Port).
updatedomain([label])
Aktualisiert die ca_n_tier-Tabelle der MDB anhand der Eigenschaften des Server,
auf dem die SQL Server-MDB gehostet wird. Wenn Sie eine Bezeichnung angegeben
haben, wird es als die Bezeichnung für die Domäne verwendet.
Methode "testcon" – Testen der Datenbankverbindung
Die Methode "testcon" versucht, mit dem angegebenen Benutzernamen und Kennwort
eine Verbindung zur Zieldatenbank herzustellen und Erfolgs- bzw. Fehlermeldungen in
die Konsole zu schreiben.
Dieser Befehl hat das folgende Format:
mdbac.bat –testcon –target Connection_name {–user User_name –pwd password | wallet wallet_file_name}
Beispiel: Testen der Datenbankverbindung
Dieser Beispielbefehl testet die Verbindung zur Zieldatenbank – mssql-test:
mdbac.bat –testcon –target mssql-test –user ca_itrm –pwd password123
Kapitel 9: MDB-Admin-Konsolen-CLI 609
Fehlerbehebung
Methode "createschema" – Erstellen von Klontabellen
Die Methode "createschema" erstellt Klontabellen und Vorgänge in der Zieldatenbank.
Die Methode "import" ruft wiederum die Methode "createschema" auf und erstellt
automatisch Klontabellen und Vorgänge. Sie können die Methode "createschema"
jedoch manuell aufrufen, wenn es beim Importieren von Daten Probleme gibt.
Dieser Befehl hat das folgende Format:
mdbac.bat –createschema -target connection_name {–user user_name –pwd password
wallet wallet_file_name}
-
Beispiel: Erstellen von Klontabellen
Dieser Beispielbefehl erstellt Klontabellen in der Zieldatenbank – mssql-test:
mdbac.bat –createschema -target mssql-test –user ca_itrm –pwd password123
Methode "dropschema" – Entfernen von Klontabellen
Die Methode "dropschema" entfernt die durch die Methode "import" erstellten
Klontabellen und Vorgänge aus der Zieldatenbank. Die Methode "import" erstellt
Klontabellen für den Importvorgang. Hierbei handelt es sich um temporäre Tabellen,
und Sie können diese entfernen, nachdem der Importvorgang abgeschlossen ist.
Dieser Befehl hat das folgende Format:
mdbac.bat –dropschema -target connection_name {–user user_name –pwd password | wallet wallet_file_name}
Beispiel: Entfernen von Klontabellen
Dieser Beispielbefehl entfernt Klontabellen aus der Zieldatenbank – mssql-test:
mdbac.bat –dropschema -target mssql-test –user ca_itrm –pwd password123
Fehlerbehebung
Fehlerprotokollierung
Die MDB-Admin-Konsole verwendet Log4J für das Erstellen der Protokolldateien.
Standardmäßig werden MDB-Admin-Konsolen-Protokolldateien in einem Ordner mit
dem Namen "log" erstellt. Der Ordner "log" wird als Unterordner unter Ihrem aktuellen
Arbeitsordner erstellt. Die Standardprotokollebene lautet ERROR. Für jeden Aufruf des
Befehls "mdbac.bat" wird eine getrennte Protokolldatei erstellt.
610 CLI-Referenzhandbuch
Fehlerbehebung
Konfigurieren der Protokollierung
Sie können Log4J konfigurieren, um den Speicherort der Protokolldateien oder die
Protokollebene zu ändern.
Um die Protokollierung zu konfigurieren, bearbeiten Sie die Datei
"Installation_folder\cfg\log4j.properties", und geben Sie den Speicherort der
Protokolldatei oder die Protokollebene an.
Der folgende Ausschnitt zeigt die Inhalte der Datei "log4j.properties" an:
#********************************************************************************
#********************************************************************************
# configure "MDB Admin Console" FILE logger
#********************************************************************************
#********************************************************************************
# Configure FILE log appender
log4j.appender.FILE = org.apache.log4j.FileAppender
log4j.appender.FILE.File =${user.dir}/log/mdbac_${log4j.dateTime}.log
log4j.appender.FILE.Append=true
….
#********************************************************************************
#********************************************************************************
# mdbac logging options
#********************************************************************************
#********************************************************************************
log4j.logger.ca.itcm.mdbac.api=ERROR, FILE
log4j.logger.ca.itcm.mdbac.console=ERROR, FILE
log4j.logger.ca.itcm.mdbac.cmd.ccnfregdb=ERROR, FILE
Kapitel 9: MDB-Admin-Konsolen-CLI 611
Fehlerbehebung
Fehlermeldungen
Die MDB-Admin-Konsole gibt die folgenden Fehlermeldungen zurück, wenn eine
Anforderung nicht verarbeitet werden kann:
MDBAC-0=[MDBAC-0] no error detected (kein Fehler erkannt)
MDBAC-1=general command line error.
MDBAC-2=command line error (Befehlszeilenfehler)
MDBAC-3=business class name unknown (Unbekannter Geschäftsklassenname)
MDBAC-4=no working folder given (kein Arbeitsordner angegeben)
MDBAC-5=internal error: the business class does not support the IBOExport interface
(interner Fehler: Die IBOExport-Schnittstelle wird von der Geschäftsklasse nicht
unterstützt)
MDBAC-6=configuration/connection not found (nicht gefundene
Konfiguration/Verbindung)
MDBAC-7=input file not found (nicht gefundene Eingabedatei)
MDBAC-101=[MDBAC-101] feature is not supported at this level of implementation
(Funktion wird auf dieser Implementierungsstufe nicht unterstützt)
MDBAC-102=[MDBAC-102] internal error: no import interfaces found (keine
Importschnittstelle gefunden)
MDBAC-103=[MDBAC-103] unable to create database session (Datenbanksitzung konnte
nicht erstellt werden)
MDBAC-104=[MDBAC-104] cannot create Object (Objekt konnte nicht erstellt werden)
MDBAC-105=[MDBAC-105] Stored procedure for pushing data failed (Gespeicherte
Prozedur für den Push-Vorgang von Daten fehlgeschlagen)
MDBAC-106=[MDBAC-106] constrain violation during import (Beschränkungsverletzung
während des Imports)
MDBAC-107=[MDBAC-107] verification of target schema failed (Überprüfung des
Zielschemas fehlgeschlagen)
MDBAC-108=[MDBAC-108] failed to generate transaction id (Transaktions-ID konnte
nicht generiert werden)
MDBAC-109=[MDBAC-109] illegal XML file format detected during import/view (Illegales
XML-Dateiformat beim Importieren/Anzeigen erkannt)
MDBAC-110=[MDBAC-110] failed to read name ids form the database (Fehler beim
Lesen der Namen-IDs aus der Datenbank)
MDBAC-111=[MDBAC-111] failed to transform business object (Fehler beim Umwandeln
des Geschäftsobjekts)
MDBAC-112=[MDBAC-112] failed to import inventory name ids (Fehler beim
Importieren der Inventarnamens-IDs)
612 CLI-Referenzhandbuch
Fehlerbehebung
MDBAC-113=[MDBAC-113] one or more files are failed during import of a folder (Beim
Importieren eines Ordners ist mindestens eine Datei fehlgeschlagen)
MDBAC-114=[MDBAC-114] cannot create connection to source database (Es konnte
keine Verbindung zur Quelldatenbank hergestellt werden)
MDBAC-115=[MDBAC-115] cannot create connection to source database (Es konnte
keine Verbindung zur Quelldatenbank hergestellt werden)
MDBAC-116=[MDBAC-116] connection name not found (Verbindungsname nicht
gefunden)
MDBAC-117=[MDBAC-117] database type no supported (Datenbanktyp wird nicht
unterstützt)
MDBAC-118=[MDBAC-118] illegal connection configuration, failed to setup a
configuration to connect to the database (Illegale Verbindungskonfiguration, Fehler
beim Einrichten einer Konfiguration für die Verbindung zur Datenbank)
MDBAC-119=[MDBAC-119] error detected when reading the data from the database
(Fehler beim Lesen der Daten der Datenbank erkannt)
MDBAC-120=[MDBAC-120] not all objects are exported, one or more object failed to get
it exported (nicht alle Objekte werden exportiert, mindestens ein Objekt konnte nicht
exportiert werden)
MDBAC-121=[MDBAC-121] deletion of one or more business objects failed (Löschung
von mindestens einem Geschäftsobjekt fehlgeschlagen)
MDBAC-125=[MDBAC-125] database connection does not exists (Datenbankverbindung
ist nicht vorhanden)
MDBAC-126=[MDBAC-126] failed to adjust MDB configuration (Fehler beim Anpassen
der MDB-Konfiguration)
MDBAC-127=[MDBAC-127] connection name not found in properties file containing the
adjust rule (Verbindungsname konnte nicht in der Eigenschaftendatei mit der
Anpassungsregel gefunden werden)
MDBAC-128=[MDBAC-128] failed to adjust manager with MDB (Fehler beim Anpassen
des Managers mit der MDB)
MDBAC-129=[MDBAC-129] adjust properties file does not exist (Datei zum Anpassen der
Eigenschaften ist nicht vorhanden)
MDBAC-201=[MDBAC-201] missing one or more command line arguments (mindestens
ein Befehlszeilenargument fehlt)
MDBAC-202=[MDBAC-202] configuration undefined (nicht definierte Konfiguration)
MDBAC-203=[MDBAC-203] configuration file/name not found (Konfigurationsdatei/name konnte nicht gefunden werden)
MDBAC-204=[MDBAC-204] missing SQL file (fehlende SQL-Datei)
MDBAC-205=[MDBAC-205] SQL folder does not exist (SQL-Ordner nicht vorhanden)
MDBAC-206=[MDBAC-206] SQL file does not exist (SQL-Datei nicht vorhanden)
Kapitel 9: MDB-Admin-Konsolen-CLI 613
Fehlerbehebung
MDBAC-207=[MDBAC-207] missing name of database user (Fehlender Name von
Datenbankbenutzer)
MDBAC-208=[MDBAC-208] missing password of the database user (Fehlendes Kennwort
von Datenbankbenutzer)
MDBAC-209=[MDBAC-209] cannot connect to database (Keine Verbindung zur
Datenbank möglich)
MDBAC-210=[MDBAC-210] command aborted (Befehl abgebrochen)
MDBAC-211=[MDBAC-211] error in SQL script (Fehlerhaftes SQL-Skript)
MDBAC-212=[MDBAC-212] creation of tables failed to extend the target schema
(Erstellung von Tabellen zum Erweitern des Zielschemas fehlgeschlagen)
MDBAC-213=[MDBAC-213] failed to delete the target schema extension (Fehler beim
Löschen der Zielschemaerweiterung)
MDBAC-214=[MDBAC-214] failed to verify the target schema extension (Fehler beim
Überprüfen der Zielschemaerweiterung)
MDBAC-215=[MDBAC-215] failed to align the collation settings of the target schema
extension (Fehler beim Ausrichten der Sortierungseinstellungen der
Zielschemaerweiterung)
MDBAC-216=[MDBAC-216] failed to create target schema (Fehler beim Erstellen des
Zielschemas)
MDBAC-217=[MDBAC-217] failed to align target schema, schema configuration problem
(Fehler beim Ausrichten des Zielschemas, Schemakonfigurationsproblem)
MDBAC-218=[MDBAC-218] session exists but failed to read connection information
(Sitzung vorhanden, Verbindungsinformationen konnten jedoch nicht gelesen werden)
MDBAC-219=[MDBAC-219] failed to export data via CcnfRegDb command (Fehler beim
Exportieren von Daten über den Befehl "CcnfRegDb")
MDBAC-220=[MDBAC-220] CcnfRegDb command not found (Befehl "CcnfRegDb" wurde
nicht gefunden)
MDBAC-221=[MDBAC-221] failed to import data via CcnfRegDb command (Fehler beim
Importieren von Daten über den Befehl "CcnfRegDb")
MDBAC-222=[MDBAC-222] policy data not found (Richtliniendaten wurden nicht
gefunden)
MDBAC-223=[MDBAC-223] Security profile rejected. Security profile of this type is
disabled (Sicherheitsprofil abgelehnt. Sicherheitsprofil dieses Typs ist deaktiviert)
MDBAC-224=[MDBAC-224] Software definition rejected. Software definition of this type
is disabled (Softwaredefinition abgelehnt. Softwaredefinition dieses Typs ist deaktiviert)
MDBAC-225=[MDBAC-225] Warning: not all matched objects are exported (Warnung:
Nicht alle übereinstimmenden Objekte werden exportiert)
MDBAC-227=[MDBAC-227] Save or Update of an database object(s) failed (Speichern
oder Aktualisieren von mindestens einem Datenbankobjekt fehlgeschlagen)
614 CLI-Referenzhandbuch
Fehlerbehebung
MDBAC-228=[MDBAC-228] failed to read database object(s) (Fehler beim Lesen von
mindestens einem Datenbankobjekt)
MDBAC-229=[MDBAC-229] creation of database user failed (Fehler beim Erstellen des
Datenbankbenutzers)
Kapitel 9: MDB-Admin-Konsolen-CLI 615
Anhang A: cadsmcmd-Meldungen
Dieses Kapitel enthält folgende Themen:
Rückgabecodes (siehe Seite 618)
BMS-Fehler (siehe Seite 639)
CSM-Fehler (siehe Seite 643)
Anhang A: cadsmcmd-Meldungen 617
Rückgabecodes
Rückgabecodes
Wenn cadsmcmd ein Problem feststellt, wird in der Standardausgabe eine Meldung mit
einer Problembeschreibung ausgedruckt. Die Überschrift der Meldung lautet
"SDCMDxxxxxx>: " oder "SDCMD<Axxxxxx>: ".
■
Ein "A" bedeutet, dass das Problem von der SD API gemeldet wurde, und die
folgende Zahl ist der von der API gemeldete Fehlercode.
■
"CMD" gibt an, dass das Problem festgestellt wurde, und die nachfolgende Zahl gibt
den cadsdcmd-Fehlercode an.
Im Falle des CMD-Codes ist dieser Code gleichzeitig der cadsmcmd-Rückgabecode.
Alle API-Codes werden dem cadsmcmd-Rückgabecode cadsmcmd_API_ERROR (32)
zugeordnet.
Dieser Abschnitt enthält die folgenden Themen:
CMD000000 (siehe Seite 622)
CMD000001 (siehe Seite 622)
CMD000002 (siehe Seite 622)
CMD000003 (siehe Seite 622)
CMD000004 (siehe Seite 622)
CMD000005 (siehe Seite 622)
CMD000006 (siehe Seite 622)
CMD000007 (siehe Seite 622)
CMD000008 (siehe Seite 622)
CMD000009 (siehe Seite 622)
CMD000010 (siehe Seite 623)
CMD000011 (siehe Seite 623)
CMD000012 (siehe Seite 623)
CMD000013 (siehe Seite 623)
CMD000014 (siehe Seite 623)
CMD000015 (siehe Seite 623)
CMD000016 (siehe Seite 623)
CMD000017 (siehe Seite 623)
CMD000018 (siehe Seite 623)
CMD000019 (siehe Seite 623)
CMD000020 (siehe Seite 623)
CMD000021 (siehe Seite 624)
CMD000022 (siehe Seite 624)
CMD000023 (siehe Seite 624)
CMD000024 (siehe Seite 624)
CMD000025 (siehe Seite 624)
CMD000026 (siehe Seite 624)
CMD000027 (siehe Seite 624)
CMD000028 (siehe Seite 624)
CMD000029 (siehe Seite 624)
CMD000030 (siehe Seite 624)
CMD000031 (siehe Seite 625)
618 CLI-Referenzhandbuch
Rückgabecodes
CMD000032 (siehe Seite 625)
CMD000033 (siehe Seite 625)
CMD000034 (siehe Seite 625)
CMD000035 (siehe Seite 625)
CMD000036 (siehe Seite 625)
CMD000037 (siehe Seite 625)
CMD000038 (siehe Seite 625)
CMD000039 (siehe Seite 625)
CMD000040 (siehe Seite 625)
CMD000041 (siehe Seite 625)
CMD000042 (siehe Seite 626)
CMD000043 (siehe Seite 626)
CMD000044 (siehe Seite 626)
CMD000045 (siehe Seite 626)
CMD000046 (siehe Seite 626)
CMD000047 (siehe Seite 626)
CMD000048 (siehe Seite 626)
CMD000049 (siehe Seite 626)
CMD000050 (siehe Seite 626)
CMD000051 (siehe Seite 626)
CMD000052 (siehe Seite 626)
CMD000053 (siehe Seite 626)
CMD000054 (siehe Seite 627)
CMD000055 (siehe Seite 627)
CMD000056 (siehe Seite 627)
CMD000057 (siehe Seite 627)
CMD000058 (siehe Seite 627)
CMD000059 (siehe Seite 627)
CMD000060 (siehe Seite 627)
CMD000061 (siehe Seite 627)
CMD000062 (siehe Seite 627)
CMD000063 (siehe Seite 627)
CMD000064 (siehe Seite 627)
CMD000065 (siehe Seite 627)
CMD000066 (siehe Seite 628)
CMD000067 (siehe Seite 628)
CMD000068 (siehe Seite 628)
CMD000069 (siehe Seite 628)
CMD000070 (siehe Seite 628)
CMD000071 (siehe Seite 628)
CMD000072 (siehe Seite 628)
CMD000073 (siehe Seite 628)
CMD000074 (siehe Seite 628)
CMD000075 (siehe Seite 628)
CMD000076 (siehe Seite 628)
CMD000077 (siehe Seite 628)
CMD000078 (siehe Seite 629)
CMD000079 (siehe Seite 629)
CMD000080 (siehe Seite 629)
Anhang A: cadsmcmd-Meldungen 619
Rückgabecodes
CMD000081 (siehe Seite 629)
CMD000082 (siehe Seite 629)
CMD000083 (siehe Seite 629)
CMD000084 (siehe Seite 629)
CMD000085 (siehe Seite 629)
CMD000086 (siehe Seite 629)
CMD000087 (siehe Seite 629)
CMD000088 (siehe Seite 629)
CMD000089 (siehe Seite 630)
CMD000090 (siehe Seite 630)
CMD000091 (siehe Seite 630)
CMD000092 (siehe Seite 630)
CMD000093 (siehe Seite 630)
CMD000094 (siehe Seite 630)
CMD000095 (siehe Seite 630)
CMD000096 (siehe Seite 630)
CMD000097 (siehe Seite 630)
CMD000098 (siehe Seite 630)
CMD000099 (siehe Seite 630)
CMD000100 (siehe Seite 631)
CMD000101 (siehe Seite 631)
CMD000102 (siehe Seite 631)
CMD000103 (siehe Seite 631)
CMD000104 (siehe Seite 631)
CMD000105 (siehe Seite 631)
CMD000106 (siehe Seite 631)
CMD000107 (siehe Seite 631)
CMD000108 (siehe Seite 631)
CMD000109 (siehe Seite 631)
CMD000110 (siehe Seite 631)
CMD000111 (siehe Seite 631)
CMD000112 (siehe Seite 632)
CMD000113 (siehe Seite 632)
CMD000114 (siehe Seite 632)
CMD000115 (siehe Seite 632)
CMD000116 (siehe Seite 632)
CMD000117 (siehe Seite 632)
CMD000118 (siehe Seite 632)
CMD000119 (siehe Seite 632)
CMD000120 (siehe Seite 632)
CMD000121 (siehe Seite 632)
CMD000122 (siehe Seite 632)
CMD000123 (siehe Seite 633)
CMD000124 (siehe Seite 633)
CMD000125 (siehe Seite 633)
CMD000126 (siehe Seite 633)
CMD000127 (siehe Seite 633)
CMD000128 (siehe Seite 633)
CMD000129 (siehe Seite 633)
620 CLI-Referenzhandbuch
Rückgabecodes
CMD000130 (siehe Seite 633)
CMD000131 (siehe Seite 633)
CMD000132 (siehe Seite 633)
CMD000133 (siehe Seite 633)
CMD000134 (siehe Seite 634)
CMD000135 (siehe Seite 634)
CMD000136 (siehe Seite 634)
CMD000137 (siehe Seite 634)
CMD000138 (siehe Seite 634)
CMD000139 (siehe Seite 634)
CMD000140 (siehe Seite 634)
CMD000141 (siehe Seite 634)
CMD000142 (siehe Seite 634)
CMD000143 (siehe Seite 634)
CMD000144 (siehe Seite 634)
CMD000145 (siehe Seite 634)
CMD000146 (siehe Seite 635)
CMD000147 (siehe Seite 635)
CMD000148 (siehe Seite 635)
CMD000149 (siehe Seite 635)
CMD000150 (siehe Seite 635)
CMD000151 (siehe Seite 635)
CMD000152 (siehe Seite 635)
CMD000153 (siehe Seite 635)
CMD000154 (siehe Seite 635)
CMD000155 (siehe Seite 635)
CMD000156 (siehe Seite 635)
CMD000157 (siehe Seite 635)
CMD000158 (siehe Seite 636)
CMD000159 (siehe Seite 636)
CMD000160 (siehe Seite 636)
CMD000161 (siehe Seite 636)
CMD000162 (siehe Seite 636)
CMD000163 (siehe Seite 636)
CMD000164 (siehe Seite 636)
CMD000165 (siehe Seite 636)
CMD000166 (siehe Seite 636)
CMD000167 (siehe Seite 636)
CMD000168 (siehe Seite 636)
CMD000169 (siehe Seite 637)
CMD000170 (siehe Seite 637)
CMD000171 (siehe Seite 637)
CMD000172 (siehe Seite 637)
CMD000173 (siehe Seite 637)
CMD000174 (siehe Seite 637)
CMD000175 (siehe Seite 637)
CMD000176 (siehe Seite 637)
CMD000177 (siehe Seite 637)
CMD000178 (siehe Seite 637)
Anhang A: cadsmcmd-Meldungen 621
Rückgabecodes
CMD000179 (siehe Seite 637)
CMD000180 (siehe Seite 637)
CMD000181 (siehe Seite 638)
CMD000182 (siehe Seite 638)
CMD000183 (siehe Seite 638)
CMD000000
Erfolgreich abgeschlossen
CMD000001
ATTIME-Format nicht korrekt.
CMD000002
TIMEOUT-Wert ist nicht numerisch.
CMD000003
Einem Schlüsselwort wurde ein ungültiger Wert zugewiesen.
CMD000004
Syntaxfehler
CMD000005
Prozedurdatei konnte nicht geöffnet werden.
CMD000006
Der Befehl ist nur auf dem Enterprise-Manager zulässig.
CMD000007
Der Befehl ist nur auf dem Domänen-Manager zulässig.
CMD000008
Reserviert.
CMD000009
Kein Parameter für "batch" angegeben. Das Schlüsselwort "batch" wurde angegeben,
jedoch keine Batch-Datei.
622 CLI-Referenzhandbuch
Rückgabecodes
CMD000010
Kein Parameter für "local". Das Schlüsselwort "local" wurde angegeben, jedoch kein
Name eines Domänen-Managers.
CMD000011
Batch-Datei konnte nicht geöffnet werden.
CMD000012
Fehler in Prozedurdatei gefunden. Details werden in der Standardausgabe aufgelistet.
CMD000013
Parameter zu lang.
CMD000014
Zu viele Bereiche/Domänen, Computer/Computergruppen oder Prozeduren.
CMD000015
Externe Prozedur und Softwareerkennungsskript können nicht kombiniert werden.
CMD000016
SENDTIME-Format nicht korrekt. (JJJJ-MM-TT HH:MM)
CMD000017
HALTTIME-Format ist falsch. (JJJJ-MM-TT HH:MM)
CMD000018
Filter: Ungerade Anzahl von Anführungszeichen.
CMD000019
Filter: Ungerade Anzahl von Klammern.
CMD000020
Filter: Logischer Operator erwartet, aber nicht gefunden.
Anhang A: cadsmcmd-Meldungen 623
Rückgabecodes
CMD000021
Filter: Vergleichsoperator erwartet, aber nicht gefunden.
CMD000022
Filter: Ungültiger Vergleichsoperator gefunden.
CMD000023
Filter: Einem numerischen Attribut wurde ein nicht numerischer Wert zugewiesen.
CMD000024
Filter: Ein numerischer Wert ist zu groß.
CMD000025
Beim angegebenen System handelt es sich nicht um einen Scalability-Server.
CMD000026
Keine Benutzer-ID eingegeben, Anmeldung verweigert.
CMD000027
ECHO/UNECHO-Konsoleneingabe fehlgeschlagen. Das System kann nicht zwischen den
Konsolenmodi "echo" und "unecho" wechseln. Daher ist es nicht möglich, zur Eingabe
eines Kennwortes aufzufordern und dieses ohne "echo" einzugeben oder den Modus zu
wechseln.
CMD000028
Anwendung läuft im Stapelverarbeitungsmodus. Das Dialogfeld zum Anmelden kann
nicht angezeigt werden.
CMD000029
Unbekannten Fehlercode empfangen.
CMD000030
cadsmcmd wurde aufgrund eines zuvor gemeldeten Fehlers nicht standardmäßig
beendet.
624 CLI-Referenzhandbuch
Rückgabecodes
CMD000031
Ungültige Zeitangabe.
CMD000032
API-Fehler gemeldet. Über API-Fehler ist früher auf standardmäßiger Ausgabe berichtet
worden. "cadsmcmd" gab diesen Code zurück.
CMD000033
Nicht genügend Speicher.
CMD000034
Interner Fehler.
CMD000035
Unbekannter Parameter "...".
CMD000036
Ungültiger Task
CMD000037
Auftrag nicht gefunden.
CMD000038
Das Argument ... fehlt.
CMD000039
Das Argument ...=... fehlt.
CMD000040
Nur eines der Argumente ... oder ... sollte angegeben werden.
CMD000041
Unbekannter Befehl ...
Anhang A: cadsmcmd-Meldungen 625
Rückgabecodes
CMD000042
DELIVERYTIME-Format nicht korrekt.
CMD000043
Keine wiederherstellbaren Jobs gefunden.
CMD000044
Kein wiederherstellbarer Job für die Computer gefunden.
CMD000045
Erneuern nicht zulässig.
CMD000046
Falscher Status.
CMD000047
Die angegebene Softwarevorlage wurde nicht gefunden.
CMD000048
Der angegebene Job wurde nicht gefunden.
CMD000049
Entweder fehlt das Argument ... oder ....
CMD000050
Entweder fehlt das Argument ... oder .... oder ....
CMD000051
Interner Fehler: Stammverzeichnis von Computergruppen nicht gefunden.
CMD000052
Angegebene Aktion wird von Domänen-Manager nicht unterstützt.
CMD000053
Angegebene Aktion wird von Enterprise-Manager nicht unterstützt.
626 CLI-Referenzhandbuch
Rückgabecodes
CMD000054
Die übergeordnete Gruppe ist keine Softwaregruppe.
CMD000055
Mehr als ein Namensparameter ist angegeben.
CMD000056
Ungültige Syntax von "itemList"
CMD000057
Die Gruppe ist keine Prozedurgruppe.
CMD000058
Die Gruppe ist keine Kataloggruppe.
CMD000059
Der Jobcontainer ist versiegelt.
CMD000060
Die Gruppe ist eine Kataloggruppe.
CMD000061
Anführungszeichenfehler in Zeile %d.
CMD000062
Zeile %d unklar.
CMD000063
Ungültiger Gruppentyp
CMD000064
Softwarevorlagen und Computergruppen eines anderen Typs wurden gemischt.
CMD000065
Softwarevorlage bereits versiegelt.
Anhang A: cadsmcmd-Meldungen 627
Rückgabecodes
CMD000066
Unzureichende Berechtigungen
CMD000067
Die Berechtigungen des Jobcontainers sind unzureichend.
CMD000068
Der Jobcontainername ist nicht eindeutig.
CMD000069
Die Verteilung weist einen anderen Status auf als ""WIRD ERSTELLT"".
CMD000070
Diese Gruppe ist keine Abfragegruppe.
CMD000071
Diese Gruppe ist nicht mit einer Softwarerichtlinie verknüpft.
CMD000072
Diese Gruppe ist versiegelt.
CMD000073
Diese Gruppe ist nicht versiegelt.
CMD000074
Diese Gruppe ist eine Abfragegruppe.
CMD000075
Fehlende Leseberechtigung
CMD000076
Fehlende Schreibberechtigung
CMD000077
Das Objekt kann nicht entfernt werden.
628 CLI-Referenzhandbuch
Rückgabecodes
CMD000078
Während der Stapelverarbeitung wurden Fehler gemeldet.
CMD000079
Doppelter Eintrag "<Eintrags-ID>" in "<Pfad #1>" und "<Pfad #2>". Der letzte Eintrag
wird ignoriert.
CMD000080
Element "<Elementname>" der Version "<Elementversion>" konnte unter den verteilten
Elementen des Bereichs "<Bereichsname>" nicht gefunden werden.
CMD000081
Objekt nicht gefunden.
CMD000082
Falsches Datums-/Uhrzeitformat (JJJJ-MM-TT HH:MM).
CMD000083
Im aktuellen Status ist die Änderung durch "<Methode>" nicht zulässig.
CMD000084
Parameter "<Parametername>" ungültig in diesem Kontext.
CMD000085
Parameterposition liegt außerhalb des Bereichs.
CMD000086
Keine zu erneuernden Jobs gefunden.
CMD000087
<Zeichenfolge>" ist kein Schlüsselwort.
CMD000088
Ziel nicht gefunden.
Anhang A: cadsmcmd-Meldungen 629
Rückgabecodes
CMD000089
Batch-Datei leer.
CMD000090
Erneuerung ist für diesen Container nicht zulässig.
CMD000091
Die Gruppe ist leer.
CMD000092
Ungültiger Computername
CMD000093
Zu viele Argumente
CMD000094
BMS-Fehler gemeldet.
Weitere Details finden Sie unter "BMS-Fehler (Siehe Definition auf Seite 639)".
CMD000095
BMS-Datenbankzugriffsfehler gemeldet.
Weitere Details finden Sie unter "CSM-Fehler (Siehe Definition auf Seite 643)".
CMD000096
BMSCAPI-Anforderung fehlgeschlagen.
CMD000097
Die Liste ist leer.
CMD000098
Listenende (interner Code)
CMD000099
MAC-Adresse verweist auf ein System, das bereits BMS-verwaltet ist.
630 CLI-Referenzhandbuch
Rückgabecodes
CMD000100
Produkt ist nicht installiert.
CMD000101
Der Computer ist bereits BMS-verwaltet.
CMD000102
Der Computer wurde vom Netzwerk noch nicht registriert.
CMD000103
Es ist kein übereinstimmender PXE-Computereintrag in OSIM vorhanden.
CMD000104
Die Eigenschaften oder der Status des Objekts lassen diese Aktion nicht zu.
CMD000105
Fehler "<Fehler>" bei der Ausführung der Abfrage.
CMD000106
Zugriff auf Abfrageliste fehlgeschlagen. Gefundener Fehlercode: "<Code>".
CMD000107
CO API-Anforderung fehlgeschlagen: "<Code>" - "<Text>".
CMD000108
CO API gibt NULL-Wert in Datenbankfeld an.
CMD000109
Sitzung konnte nicht hergestellt werden .
CMD000110
CO API-Anforderung fehlgeschlagen: Element "<Nummer>": "<Code>" - "<Text>"
CMD000111
Angegebener Boot-Server nicht gefunden.
Anhang A: cadsmcmd-Meldungen 631
Rückgabecodes
CMD000112
Computerbenutzer wurde im falschen Format angegeben.
CMD000113
Computer nicht eindeutig.
CMD000114
Benutzer nicht eindeutig.
CMD000115
Softwarevorlagen nicht gefunden.
CMD000116
Abfrageobjekt nicht gefunden.
CMD000117
Computergruppe existiert nicht.
CMD000118
Warnung: Funktion ist veraltet.
CMD000119
Richtlinie "<Name>" nicht vorhanden.
CMD000120
Richtlinie: "<Name>" Typ "<Typ>" entspricht nicht dem Zieltyp "<Typ>"
CMD000121
Vorgang nicht zulässig: Konfiguration "<uuid>" nicht im Status "Geplant".
CMD000122
Vorgang nicht zulässig: Konfiguration "<uuid>" weder im Status "Geplant" noch im
Status "Fehler".
632 CLI-Referenzhandbuch
Rückgabecodes
CMD000123
Vorgang nicht zulässig: Konfiguration "<uuid>" im Status "Geplant" oder "Fehler" oder
im Status "Abbruch erfolgt" oder "Aktiv".
CMD000124
Vorgang nicht zulässig: Richtlinie "<Name>" nicht im Status "ENTSIEGELT".
CMD000125
Wert des Parameters ist für den Parametertyp ungültig.
CMD000126
Fehler beim Erstellen der USD-Abfrage: Code = "<Code>" - Text = "<Text>".
CMD000127
Fehler beim Initialisieren der USD-Abfrage: Code = "<Code>".
CMD000128
Konfigurations-ID "<uuid>" nicht gefunden.
CMD000129
Fehler in Prozedurdatei gefunden.
CMD000130
Keine Parameter angegeben, Befehl nicht verarbeitet.
CMD000131
Scalability-Servergruppe "<Name>" nicht gefunden.
CMD000132
Filterevaluierung fehlgeschlagen: <Filter>
CMD000133
Scalability-Server "<Name>" nicht gefunden.
Anhang A: cadsmcmd-Meldungen 633
Rückgabecodes
CMD000134
Gruppe "<Name>" ist keine Servergruppe.
CMD000135
Gruppe "<Name>" ist keine Computer- oder Vorlagengruppe.
CMD000136
Parameterinformationen nicht gefunden.
CMD000137
Parameter "<Name>" nicht vorhanden.
CMD000138
Abschnitt "<Name>" nicht vorhanden.
CMD000139
Abschnittsinformationen nicht gefunden.
CMD000140
Richtlinieninformationen nicht gefunden.
CMD000141
Konfigurationsinformationen nicht gefunden.
CMD000142
Fehler, Objektinformationen nicht gefunden.
CMD000143
Mindestens einer von mehreren Vorgängen ist fehlgeschlagen.
CMD000144
Operation fehlgeschlagen.
CMD000145
CCNF API-Anforderung fehlgeschlagen: "<Code>" - "<Text>"
634 CLI-Referenzhandbuch
Rückgabecodes
CMD000146
Vorgang für Standard-Computerrichtlinie nicht zulässig.
CMD000147
Engine-Name "<Name" nicht gefunden.
CMD000148
Engine-UUID "<uuid"> nicht gefunden.
CMD000149
Ziel ist bereits registriert. Dieser Vorgang ist nicht zulässig.
CMD000150
MAC-Adresse fehlt. System nicht OSIM-fähig.
CMD000151
Die folgenden Argumente verursachen Konflikte: <Argument1> und <Argument2>
CMD000152
Ungültiger Auftragsname
CMD000153
Softwarerichtlinie bereits verknüpft.
CMD000154
Softwarerichtlinie ist nicht mit der angegebenen Computergruppe verknüpft.
CMD000155
Computergruppe nicht gefunden.
CMD000156
Das System ist ein ADS-Gerät.
CMD000157
Software-Richtlinie ist nicht versiegelt.
Anhang A: cadsmcmd-Meldungen 635
Rückgabecodes
CMD000158
Keine weiteren adressierbaren Ziele vorhanden.
CMD000159
Angegebene MAC-Adresse stimmt nicht überein.
CMD000160
Computer/Benutzer nicht gefunden.
CMD000161
Nicht alle Jobs wurden aus der Software-Richtlinie entfernt.
CMD000162
Keine Installationsprozedur gefunden.
CMD000163
Keine standardmäßige Installationsprozedur gefunden.
CMD000164
Software-Richtlinie wird für Legacy-Manager "<Name>" nicht unterstützt.
CMD000165
Warnung: Software-Richtlinie sollte versiegelt sein, jedoch ist kein Ziel und/oder keine
Software zugewiesen.
CMD000166
Software-Richtlinie kann nicht versiegelt werden - keine Zielgruppe zugewiesen.
CMD000167
Abfrageobjekt "<Abfragename>" nicht gefunden.
CMD000168
Abfrage "<Abfragename>" ist nicht eindeutig.
636 CLI-Referenzhandbuch
Rückgabecodes
CMD000169
Domäne "<Domänenname>" nicht gefunden.
CMD000170
Abfrage "<Abfragename>" für Domäne "<Domänenname>" nicht gefunden.
CMD000171
Manager "<Managername>" nicht gefunden.
CMD000172
Manager "<Managername>" ist nicht eindeutig.
CMD000173
AMAPI-Fehler - <AMAPI-Fehlercode> - <AMAPI-Fehlermeldung>
CMD000174
Keine Aktion verfügbar, da AM vom entsprechenden Manager nicht unterstützt wird.
CMD000175
Klassenname oder Klassen-ID "<Klassenname>" ist nicht vorhanden.
CMD000176
Sicherheitsbereich "<Sicherheitsbereich>" nicht gefunden.
CMD000177
Sicherheitsobjekt "<Sicherheitsobjekt>" nicht gefunden.
CMD000178
Ordner "<Ordnername>" nicht gefunden.
CMD000179
Ordner-ID "<Ordner-ID>" nicht gefunden.
CMD000180
Für die Klassen-ID "SoftwareJob" fehlt das Argument "foldername=".
Anhang A: cadsmcmd-Meldungen 637
Rückgabecodes
CMD000181
Für die Klassen-ID "SoftwareJob" fehlt das Argument "folderclassid=".
CMD000182
Ordner "__SD_Software Templates" nicht gefunden.
CMD000183
Domänenname "<Domänenname>" ist ungültig.
638 CLI-Referenzhandbuch
BMS-Fehler
BMS-Fehler
Dieser Abschnitt enthält die folgenden Themen:
BMS 000000 (siehe Seite 639)
BMS 000001 (siehe Seite 639)
BMS 000002 (siehe Seite 640)
BMS 000003 (siehe Seite 640)
BMS 000004 (siehe Seite 640)
BMS 000005 (siehe Seite 640)
BMS 000006 (siehe Seite 640)
BMS 000007 (siehe Seite 640)
BMS 000008 (siehe Seite 640)
BMS 000009 (siehe Seite 640)
BMS 000010 (siehe Seite 640)
BMS 000010 (siehe Seite 640)
BMS 000012 (siehe Seite 640)
BMS 000013 (siehe Seite 641)
BMS 000014 (siehe Seite 641)
BMS 000015 (siehe Seite 641)
BMS 000016 (siehe Seite 641)
BMS 000017 (siehe Seite 641)
BMS 000018 (siehe Seite 641)
BMS 000019 (siehe Seite 641)
BMS 000020 (siehe Seite 641)
BMS 000021 (siehe Seite 641)
BMS 000022 (siehe Seite 641)
BMS 000023 (siehe Seite 641)
BMS 000024 (siehe Seite 641)
BMS 000025 (siehe Seite 642)
BMS 000026 (siehe Seite 642)
BMS 000027 (siehe Seite 642)
BMS 000028 (siehe Seite 642)
BMS 000029 (siehe Seite 642)
BMS 000030 (siehe Seite 642)
BMS 000031 (siehe Seite 642)
BMS 000032 (siehe Seite 642)
BMS 000033 (siehe Seite 642)
BMS 000034 (siehe Seite 642)
BMS 000100 (siehe Seite 642)
BMS 000000
Methode erfolgreich abgeschlossen.
BMS 000001
Speichermangel
Anhang A: cadsmcmd-Meldungen 639
BMS-Fehler
BMS 000002
Servername fehlt.
BMS 000003
Es wurde noch keine Verbindung zu einem Server hergestellt.
BMS 000004
Es wurde noch keine Sitzung für den Server eingerichtet.
BMS 000005
Diese Methode wurde noch nicht implementiert.
BMS 000006
Die angegebene MAC-Adresse entspricht nicht der MAC-Adresse des angegebenen
Systems.
BMS 000007
Interner Fehler.
BMS 000008
Der Boot-Server ist noch mit einer geplanten Konfiguration für diesen Computer belegt.
BMS 000009
Änderung des Bootstatus fehlgeschlagen.
BMS 000010
Der Computer konnte in der Datenbank nicht gefunden werden.
BMS 000010
Ungültige Parameter.
BMS 000012
Der Computer ist bereits benannt.
640 CLI-Referenzhandbuch
BMS-Fehler
BMS 000013
Eigenschaft nicht gefunden.
BMS 000014
Der Boot-Status ist für diese Methode nicht geeignet.
BMS 000015
Keine geplante Konfiguration verfügbar.
BMS 000016
Eine aktive Konfiguration ist bereits vorhanden.
BMS 000017
Ungültige Angabe für Datum/Uhrzeit.
BMS 000018
Image ist nicht verfügbar, wurde nur erkannt.
BMS 000019
Keine geplante Konfiguration verfügbar.
BMS 000020
Ungültiger Konfigurationsstatus
BMS 000021
Ungültige Konfiguration angegeben.
BMS 000022
Keine aktuelle Konfiguration verfügbar.
BMS 000023
Die MAC-Adresse ist bereits vorhanden.
BMS 000024
Der Computername ist nicht eindeutig.
Anhang A: cadsmcmd-Meldungen 641
BMS-Fehler
BMS 000025
Image nicht gefunden.
BMS 000026
Parameter nicht gefunden.
BMS 000027
Verwenden Sie zum Ändern von BS-Images die Methode modifyOS.
BMS 000028
Dieser Parameter ist obligatorisch und besitzt keinen Standardwert.
BMS 000029
"userParam" und "userValue" sollten nicht gemeinsam angegeben werden.
BMS 000030
Benutzerparameter nicht gefunden.
BMS 000031
Der Parameterwert entspricht nicht den Spezifikationen des Parameters.
BMS 000032
Die MAC-Adresse wird bereits von einem anderen BMS-verwalteten Computer
verwendet.
BMS 000033
Der Wert ist kein Mitglied der Liste.
BMS 000034
Der Zielcomputer wird nicht von OSIM verwaltet. Ihm sind keine Konfigurationen
zugewiesen.
BMS 000100
Der Boot-Server wurde nicht in der Datenbank gefunden.
642 CLI-Referenzhandbuch
CSM-Fehler
CSM-Fehler
Dieser Abschnitt enthält die folgenden Themen:
CSM 000000 (siehe Seite 643)
CSM 000001 (siehe Seite 643)
CSM 000002 (siehe Seite 643)
CSM 000003 (siehe Seite 643)
CSM 000004 (siehe Seite 643)
CSM 000005 (siehe Seite 643)
CSM 000006 (siehe Seite 643)
CSM 000007 (siehe Seite 643)
CSM 000008 (siehe Seite 644)
CSM 000009 (siehe Seite 644)
CSM 000010 (siehe Seite 644)
CSM 000000
Fehler in CSM-Methode gemeldet.
CSM 000001
Verbindung nicht initialisiert.
CSM 000002
Funktion ist bereits abgeschlossen.
CSM 000003
Funktionsargument ungültig.
CSM 000004
Speicherzuordnungsfehler.
CSM 000005
Lokaler Fehler beim Senden von Nachricht.
CSM 000006
Keine Antwort von Server.
CSM 000007
Ungültige Antwort von Server.
Anhang A: cadsmcmd-Meldungen 643
CSM-Fehler
CSM 000008
Keine (weiteren) Daten verfügbar.
CSM 000009
Anforderung fehlgeschlagen.
CSM 000010
Unzureichende Zugriffsberechtigungen.
644 CLI-Referenzhandbuch
Anhang B: Unterstützte MDB-Objekttypen
Die folgende Tabelle enthält die von der MDB-Admin-Konsole unterstützten MDBObjekte:
MDB-Objekttyp
Titel
Hinweise
BoAreaDef
Bereichsdefinitionen
Beim Import werden Bereichsdefinitionen nicht mit
Sicherheitsprofilen verbunden. Die Beziehung zwischen
den Bereichsdefinitionen und den Sicherheitsprofilen
wird demnach nicht in die Ziel-MDB importiert.
BoSecurityProfile
Sicherheitsprofile
Der Export enthält die entsprechenden
Sicherheitsklassenberechtigungen für jedes
Sicherheitsprofil.
BoQueryDef
Abfragen
Der Export enthält die entsprechenden
Objektberechtigungen in Bezug auf die
Sicherheitsprofile. Falls die Sicherheitsprofile in der
Ziel-MDB vorhanden sind, wendet der Import diese
Berechtigungen auf die importierten Objekte an.
Der Bezug der Abfrage zu ihrem übergeordneten
Abfrageordner wird in der Zieldatenbank mit dem
Import verwaltet. Dies erfordert, dass der
übergeordnete Abfrageordner bereits in der
Zieldatenbank vorhanden ist.
Sie müssen den Abfrageordner manuell erstellen. Beim
Importvorgang wird dieser Ordner nicht erstellt.
BoGroupDef
Asset-Gruppen
Der Export enthält die entsprechenden Objekt- und
Gruppenmitgliederberechtigungen in Bezug auf die
Sicherheitsprofile. Falls die Sicherheitsprofile in der
Ziel-MDB vorhanden sind, wendet der Import diese
Berechtigungen auf die importierten Objekte an.
Bei einer dynamischen Gruppe wird die Beziehung zu
der Abfrage in der Zieldatenbank mit dem Import
verwaltet. Dies erfordert jedoch, dass in der
Zieldatenbank bereits eine Abfrage mit demselben
Namen vorhanden ist.
Der Bezug der Gruppe zu ihren übergeordneten
Gruppen wird in der Zieldatenbank mit dem Import
verwaltet. Dies erfordert, dass die übergeordneten
Gruppen bereits in der Zieldatenbank vorhanden sind.
Anhang B: Unterstützte MDB-Objekttypen 645
CSM-Fehler
MDB-Objekttyp
Titel
Hinweise
BoPolicyQuery-basiert
Abfragebasierte Richtlinien
Der Export enthält die entsprechenden
Objektberechtigungen in Bezug auf die
Sicherheitsprofile. Falls die Sicherheitsprofile in der
Ziel-MDB vorhanden sind, wendet der Import diese
Berechtigungen auf die importierten Objekte an.
Die Beziehung der abfragebasierten Richtlinie zur
Abfrage wird in der Zieldatenbank mit dem Import
verwaltet. Dies erfordert jedoch, dass in der
Zieldatenbank bereits eine Abfrage mit demselben
Namen vorhanden ist.
Die Beziehung der abfragebasierten Richtlinie zu einer
Aktion wird durch den Export/Import nicht verwaltet.
Unterordner des abfragebasierten Richtlinienordners
werden nicht verwaltet.
BoPolicyEvent-basiert
Ereignisbasierte Richtlinien
Der Export enthält die entsprechenden
Objektberechtigungen in Bezug auf die
Sicherheitsprofile. Falls die Sicherheitsprofile in der
Ziel-MDB vorhanden sind, wendet der Import diese
Berechtigungen auf die importierten Objekte an.
Die Beziehung der ereignisbasierten Richtlinie zu einer
Aktion wird durch den Export/Import nicht verwaltet.
Unterordner des ereignisbasierten Richtlinienordners
werden nicht verwaltet.
646 CLI-Referenzhandbuch
CSM-Fehler
MDB-Objekttyp
Titel
Hinweise
BoPolicySoftware
Softwarebasierte Richtlinien
Der Export enthält die entsprechenden
Objektberechtigungen in Bezug auf die
Sicherheitsprofile. Falls die Sicherheitsprofile in der
Ziel-MDB vorhanden sind, wendet der Import diese
Berechtigungen auf die importierten Objekte an.
Die Beziehung der softwarebasierten Richtlinie zu den
Software Delivery-Jobs wird in der Zieldatenbank mit
dem Import verwaltet. Hierfür müssen die
entsprechenden Software Delivery-Pakete und Prozeduren bereits in der Zieldatenbank vorhanden
sein.
Durch softwarebasierte Richtlinien der Quell-MDB
referenzierte Software Delivery-Bibliothekspakete
sollten vor dem Import bereits in der Ziel-MDB zur
Verfügung stehen. Software DeliveryBibliothekspakete können exportiert und mithilfe der
entsprechenden in der EGC-GUI angegebenen
Methoden oder mithilfe der CADSMCMDBefehlszeilenschnittstelle importiert werden.
Der Bezug der softwarebasierten Richtlinie zur
Ressourcengruppe wird in der Zieldatenbank mit dem
Import verwaltet. Dies erfordert jedoch, dass die
entsprechenden Ressourcengruppen bereits in der
Zieldatenbank vorhanden sind.
BoSoftware Group
Softwaregruppen
Der Export enthält die entsprechenden
Objektberechtigungen in Bezug auf die
Sicherheitsprofile. Falls die Sicherheitsprofile in der
Ziel-MDB vorhanden sind, wendet der Import diese
Berechtigungen auf die importierten Objekte an.
Der Bezug der Softwaregruppe zu ihren
übergeordneten Gruppen wird in der Zieldatenbank
mit dem Import verwaltet.
Dies erfordert, dass die übergeordneten Gruppen
bereits in der Zieldatenbank vorhanden sind.
BoProcedure Group
Prozedurgruppen
Der Export enthält die entsprechenden
Objektberechtigungen in Bezug auf die
Sicherheitsprofile. Falls die Sicherheitsprofile in der
Ziel-MDB vorhanden sind, wendet der Import diese
Berechtigungen auf die importierten Objekte an.
Der Bezug der Prozedurgruppe zu ihren
übergeordneten Gruppen wird in der Zieldatenbank
mit dem Import verwaltet. Dies erfordert, dass die
übergeordneten Gruppen bereits in der Zieldatenbank
vorhanden sind.
Anhang B: Unterstützte MDB-Objekttypen 647
CSM-Fehler
MDB-Objekttyp
Titel
Hinweise
BoSoftwareDef
Softwaredefinitionen
Der Export enthält die entsprechenden
Objektberechtigungen in Bezug auf die
Sicherheitsprofile. Falls die Sicherheitsprofile in der
Ziel-MDB vorhanden sind, wendet der Import diese
Berechtigungen auf die importierten Objekte an.
Der Export enthält die Softwaredefinitionen, aber nicht
die zugehörigen Daten, beispielsweise
Softwaresignaturen, Herstellerinformationen und
Kategorien. Sie müssen das in den CA ITCM-Versionen
r11.2 SP4, r12, r12 SP01, r12.5 und 12.8 verfügbare
Hilfsprogramm "Content" in Kombination mit der
MDB-Admin-Konsole verwenden, um alle diese Daten
zu exportieren bzw. zu importieren.
Hinweis: Nur benutzerdefinierte Softwaredefinitionen
werden vom Exportvorgang unterstützt.
Sie müssen das Hilfsprogramm "Content" zunächst
verwenden, um Daten aus der Quell-MDB zu
exportieren und sie in die Ziel-MDB zu importieren.
Verwenden Sie dann die MDB-Admin-Konsole für die
Softwaredefinitionen. Der MDB-Admin-Konsolenexport
enthält die entsprechenden Objektberechtigungen in
Bezug auf die Sicherheitsprofile. Falls die
Sicherheitsprofile in der Ziel-MDB vorhanden sind,
wendet der Import diese Berechtigungen auf die
importierten Objekte an.
Hinweis: Softwaredefinitionen können nur zwischen
MDB-Datenbanken der gleichen CA ITCM-Version
exportiert und importiert werden. Zum Beispiel
können Sie Daten einer r11.2 SP4-MDB exportieren
und diese Daten in eine r11.2 SP4-MDB importieren.
Sie können Daten auch aus einer r12- oder r12 SP01MDB exportieren und sie in eine r12- oder r12 SP01MDB importieren.
648 CLI-Referenzhandbuch
CSM-Fehler
MDB-Objekttyp
Titel
Hinweise
BoPolicy-Computer
Konfigurationsrichtlinien
Für den Export von Konfigurationsrichtlinien müssen
Sie die MDB-Admin-Konsole auf dem DSM-ManagerRechner installieren, auf dem Sie planen, den Export
auszuführen. Der Grund hierfür ist, dass die MDBAdmin-Konsole die im Manager verfügbare
Funktionalität verwendet.
Der Export enthält die entsprechenden
Objektberechtigungen in Bezug auf die
Sicherheitsprofile. Falls die Sicherheitsprofile in der
Ziel-MDB vorhanden sind, wendet der Import diese
Berechtigungen auf die importierten Objekte an.
Hinweis: Das Exportieren und Importieren von
Konfigurationsrichtlinien wird nur unterstützt, wenn
Sie CA ITCM r12- und r12 SP01-Manager verwenden.
Auch wenn der Import das Erstellen neuer Richtlinien
zulässt, erlaubt er nicht das Aktualisieren einer
vorhandenen Richtlinie.
Anhang B: Unterstützte MDB-Objekttypen 649
Anhang C: Regeln für den MDBObjektvergleich
Die folgende Tabelle enthält die von der Methode "compare" zum Vergleichen von zwei
MDB-Objekten verwendeten Regeln:
MDB-Objekttyp
Titel
Zu vergleichende Attribute
BoAreaDef
Bereichsdefinitionen
Sicherheitsbereichsname
BoSecurityProfile
Sicherheitsprofile
■
Sicherheitsprofilname
■
Sicherheitsprofiltyp
■
Abfragename
■
Abfragetyp
■
Gruppenname
■
Mitglieder übernehmen Berechtigungen
■
Gruppentyp
■
Richtlinienname
■
Richtlinienbeschreibung
■
Schweregrad der Richtlinie
■
Richtlinienname
■
Richtlinienbereich
■
Schweregrad der Richtlinie
■
Softwarerichtlinienname
■
Priorität
■
Typ
■
Softwaregruppenname
■
Typ
■
Sicherheitsgruppe
■
Prozedurgruppenname
■
Typ
■
Sicherheitsgruppe
BoQueryDef
BoGroupDef
BoPolicyQuery-basiert
BoPolicyEvent-basiert
BoPolicySoftware
BoSoftware Group
BoProcedure Group
Abfragen
Asset-Gruppen
Abfragebasierte Richtlinien
Ereignisbasierte Richtlinien
Softwarebasierte Richtlinien
Softwaregruppen
Prozedurgruppen
Anhang C: Regeln für den MDB-Objektvergleich 651
CSM-Fehler
MDB-Objekttyp
Titel
Zu vergleichende Attribute
BoSoftwareDef
Softwaredefinitionen
■
Name
■
Sprache
■
SW-Versionsbezeichnung
■
SW-Versionsnummer
■
Softwaretyp-ID
■
Quelltyp-ID
■
Sprachcode
■
Klassen-ID
BoPolicy-Computer
Konfigurationsrichtlinien
Richtlinienname
Hinweis: Die Parameter und Parameterwerte der
Richtlinie sind nicht abhängig vom Vergleich.
652 CLI-Referenzhandbuch