Befehlszeilenargumente für Installation Manager

Anhand der folgenden Tabelle können Sie mehr über die Befehlszeilenargumente von IBM Installation Manager erfahren.

Installation Manager-Befehle

Befehlszeilenargumente setzen sich aus Befehlen und Optionen zusammen. Sie können Befehle verwenden, ohne eine Option anzugeben. In den meisten Befehlen wird kein Gedankenstrich verwendet. Einige Befehle beginnen mit einem Gedankenstrich, um die Kompatibilität mit früheren Versionen von Installation Manager sicherzustellen. Bei Verwendung einer Option müssen Sie einen Befehl angeben. Optionen beginnen mit einem Gedankenstrich.
Anmerkung: In der Befehlszeile von Installation Manager sind keine Sterne (*) zulässig. Bei Eingabe eines Sterns kann Installation Manager das Befehlszeilenargument nicht erkennen und gibt einen Fehler aus.

Tabelle 1 enthält eine Liste der Befehle und Tabelle 2 eine Liste der Optionen.

Tabelle 1: Installation Manager-Befehle

Befehle Beschreibung
encryptString zu_verschlüssende_zeichenfolge
Verschlüsselt die eingegebene Zeichenfolge.

Öffnen Sie in der Befehlszeilenschnittstelle das Verzeichnis eclipse und geben Sie den Befehl encryptString und eine Zeichenfolge mit der Option -nosplash ein, um eine verschlüsselte Zeichenfolge zu erhalten. Im Fenster String Encryption Utility (Dienstprogramm zur Zeichenfolgeverschlüsselung) enthält das Feld String to be encrypted (Zu verschlüsselnde Zeichenfolge) die Zeichenfolge, die verschlüsselt werden soll. Das Feld Encrypted version of the string (Verschlüsselte Version der Zeichenfolge) enthält den verschlüsselten Wert, der in die Antwortdatei kopiert werden muss. Im Dienstprogramm zur Zeichenfolgeverschlüsselung können Sie den Inhalt des Felds String to be encrypted (Zu verschlüsselnde Zeichenfolge) ändern und dann auf OK klicken, um eine neue verschlüsselte Zeichenfolge zu generieren.

Verwenden Sie encryptString mit -passwordKey, um die Verschlüsselungssicherheit zu verbessern.

Beim Aufzeichnen einer Antwortdatei werden verschlüsselte Zeichenfolgen für Kennwörter erstellt und in der Antwortdatei gespeichert. Ein Beispiel einer verschlüsselten Zeichenfolge aus einer Antwortdatei für Rational ClearCase:

profile installLocation='C:\Programme\IBM\RationalSDLC' id="IBM Rational SDLC'
data key='user.CC_ServerProcessPassword,com.ibm.rational.clearcase.nt_i386' value='1ML/Coqkg33e5616BcUnYg=='
/profile

Nach der Aufzeichnung der Antwortdatei verwenden Sie encryptString, um verschiedene verschlüsselte Zeichenfolgen zu generieren und in die Antwortdatei einzufügen. Angenommen, Sie zeichnen eine Antwortdatei auf. Sie müssen auf fünf Computern ein IBM Produkt unter Verwendung einer Antwortdatei installieren. Jede der fünf Computer erfordert einen anderen Kennwortwert für einen Datenschlüssel in der Antwortdatei. Bevor Sie die Installation auf einem der Computer ausführen, generieren Sie die verschlüsselte Zeichenfolge für das Kennwort, das auf dem Computer verwendet werden soll. Kopieren Sie die verschlüsselte Zeichenfolge in die Antwortdatei. Starten Sie die unbeaufsichtigte Installation mit der aktualisierten Antwortdatei.

exportInstallData Ausgabedateiname
Exportiert Installationsdaten im Archivformat (.zip) in die angegebene Datei. Dabei steht Ausgabedateiname für den Namen der generierten Datei, die die exportierten Daten enthält.

Öffnen Sie in der Befehlszeilenschnittstelle das Verzeichnis eclipse und geben Sie den Befehl exportInstallData und den Dateinamen mit den Optionen -noSplash und -silent ein, um Installationsdaten zu exportieren.

help, -help, -h, ?, -? 
	help Befehl
	help all
Zeigt eine Kurzbeschreibung der Befehlszeilenargumente von Installation Manager an.

Wenn der Befehl help zusammen mit einem anderen Befehl verwendet wird, wird eine Kurzbeschreibung des Befehls angezeigt. Bei Verwendung mit der Option all werden Beschreibungen für alle Befehle angezeigt.

Dieser Befehl kann aus Gründen der Kompatibilität mit früheren Versionen mit einem Gedankenstrich verwendet werden: -help.

input Antwortdatei 
Gibt eine XML-Antwortdatei als Eingabe für Installation Manager oder für das Installationsprogramm von Installation Manager an. Die Antwortdatei enthält Befehle, die Installation Manager und das Installationsprogramm von Installation Manager für die Ausführung benötigen.
Verwenden Sie input nicht zusammen mit den folgenden Befehlen:
  • installAll, -installAll
  • updateAll, -updateAll
Als Wert für Antwortdatei können Sie einen Dateipfad oder eine URL verwenden. Die folgenden Beispiele zeigen Zeichenfolgen für Dateipfade und URLs:
  • Dateipfad:
    • Windows: input C:\response_files\myresponsefile.xml
    • Linux und UNIX: input /response_files/myresponsefile.xml
  • URL: input http://server/response_files/myresponsefile.xml
Berechtigungsnachweise müssen in einer Schlüsselringdatei gespeichert werden, nicht in Scripts für die unbeaufsichtigte Installation.
Hinweis: Sie können eine Antwortdatei aufzeichnen, eine Beispielantwortdatei bearbeiten oder eine Antwortdatei manuell erstellen.

Dieser Befehl kann aus Gründen der Kompatibilität mit früheren Versionen mit einem Gedankenstrich verwendet werden: -input.

installAll
Wichtig: Ab Version 1.4.4 von Installation Manager wird der Befehl installAll nicht weiter unterstützt. Sie sollten diesen Befehl nicht verwenden, da die gleichzeitige Installation mehrerer Produkte eine Reihe potenzieller Probleme mit sich bringt. Beispiel:
  • Wenn Pakete dasselbe Standardinstallationsverzeichnis aufweisen, jedoch nicht in dieselbe Paketgruppe installiert werden können, schlägt die Installation fehl.
  • Bei der Installation von Paketen, zu deren Installation zusätzliche Informationen erforderlich sind, kann es zu Problemen kommen. Der Benutzer muss erforderliche Daten mithilfe der Option -properties angeben, was zu Datenkollisionen unter den Paketen führen kann.
  • Sie haben keinen Einfluss darauf, an welcher Position Erweiterungspakete installiert werden.
  • Die gleichzeitige Installation vieler Pakete kann sehr viel Plattenspeicherplatz beanspruchen und viel Zeit in Anspruch nehmen.
Installiert alle Pakete in einem angegebenen Repository.

Dieser Befehl installiert alle Pakete aus allen zugänglichen Repositorys in den jeweiligen Standardinstallationsverzeichnissen. Der Befehl kann nur diejenigen Paketkomponenten installieren, die standardmäßig ausgewählt sind.

Verwenden Sie installAll nicht zusammen mit den folgenden Befehlen:
  • input, -input
  • updateAll, -updateAll
updateAll
Aktualisiert alle installierten Pakete aus den Service-Repositorys und den Repositorys, die in den Benutzervorgaben von Installation Manager definiert sind.
Verwenden Sie den Befehl updateAll zusammen mit den folgenden Optionen:
  • -installFixes: Fixes installieren.
  • -properties: Profileigenschaften der Paketgruppe definieren.
  • -repositories: Die Liste der Repositorys in Installation Manager überschreiben und die Position der Pakete angeben.
Verwenden Sie updateAll nicht zusammen mit den folgenden Befehlen:
  • input, -input
  • installAll, -installAll
version
Zeigt die Version und die interne Version von Installation Manager.

Dieser Befehl kann aus Gründen der Kompatibilität mit früheren Versionen mit einem Gedankenstrich verwendet werden: -version.

Tabelle 2: Installation Manager-Optionen

Optionen Beschreibung
-acceptLicense
Schließen Sie die Option -acceptLicense in Ihren Befehl ein, wenn das zu installierende Paket erfordert, dass die Lizenzvereinbarung aktzeptiert wird.
-accessRights, -aR Modus

Dabei ist Modus=[admin, nonAdmin, group]

Definiert, ob Installation Manager im Administratormodus, im Modus für Benutzer ohne Administratorberechtigung oder im Gruppenmodus arbeitet. Verwenden Sie für den Administratormodus —accessRights mit dem Parameter admin: -accessRights admin. Verwenden Sie für den Modus für Benutzer ohne Administratorberechtigung das Argument —accessRights mit dem Parameter nonAdmin: -accessRights nonAdmin. Verwenden Sie für den Gruppenmodus —accessRights mit dem Parameter group: -accessRights group

Es kann nur eine Administratorinstanz von Installation Manager installiert werden. Bei einem Benutzer ohne Administratorberechtigung darf nur eine einzige Instanz von Installation Manager für jeden Benutzer installiert werden.

Wenn —accessRights nicht verwendet wird, wird der Standardwert auf der Basis der aktuellen Benutzerberechtigungen definiert.
Anmerkung:
  • Für Benutzer von Microsoft Windows XP Professional, die Mitglieder der Administratorgruppe sind, ist der Standardwert immer -accessRights admin. Für diese Benutzer muss zur Ausführung im Modus für Benutzer ohne Administratorberechtigung das Argument -accessRightsnonAdmin explizit übergeben werden.

Installation Manager gibt einen Fehler aus, wenn der Benutzer nicht über die erforderlichen Systemberechtigungen verfügt.

Achtung: Ändern Sie dieses Argument nicht, wenn Sie installieren, ändern, aktualisieren, ein Rollback durchführen oder dieselbe Instanz von Installation Manager entfernen. Angenommen, User1 installiert Installation Manager im Verzeichnis C:\user1\InstallationManager mit Administratorzugriffsrechten. Wenn User1 einen Befehl zum Ändern von Installation Manager im Verzeichnis C:\user1\InstallationManager ausführt, darf er nicht das Argument -accessRights nonAdmin verwenden.

Informationen zur Installation als Administrator, als Benutzer ohne Administratorberechtigung oder als Gruppe finden Sie in Installation als Administrator oder als Benutzer ohne Administratorberechtigung durchführen.

-dataLocation, -dL Datenposition
Gibt die Verzeichnisposition für das Datenverzeichnis von Installation Manager an. Diese Position dient zur Speicherung von Informationen zu installierten Paketen. Geben Sie diese Position beim Installieren von Installation Manager an. Die über -datalocation festgelegte Verzeichnisposition darf kein Unterverzeichnis des Installationsverzeichnisses von Installation Manager sein.
Achtung:
  • Nach der Installation von Installation Manager darf dieses Argument nicht mehr geändert werden. Wenn Sie dieses Argument ändern, können Installationsdaten beschädigt werden. Dies kann dazu führen, dass Sie installierte Pakete nicht mehr ändern, aktualisieren oder deinstallieren können bzw. kein Rollback mehr durchführen können.
  • Wenn Sie für -dataLocation eine Verzeichnisposition angeben, die nicht dem Standardwert entspricht, muss diese Position bei jeder Verwendung von Installation Manager und bei jeder Verwendung des Installationsprogramms von Installation Manager verwendet werden. Bei jedem Start des Installationsprogramms von Installation Manager müssen Sie über die Option -dataLocation dieselbe Verzeichnisposition angeben. Die installierte Instanz von Installation Manager verwendet die angegebene Position automatisch.
Beispiele für Fälle, bei denen dieselbe Verzeichnisposition für die Option -datalocation verwendet werden muss:
  • Installation Manager ist nicht installiert und Sie verwenden das Installationsprogramm von Installation Manager. Bei jedem Start des Installationsprogramms müssen Sie für -dataLocation dieselbe Verzeichnisposition angeben. Wenn nicht dieselbe Position verwendet wird, werden mehrere Datenpositionen (dataLocations) erstellt. Dies kann zu Beschädigungen führen.
  • Installation Manager ist installiert und verwendet die angegebene Verzeichnisposition. Wenn Sie das Installationsprogramm von Installation Manager verwenden, müssen Sie über die Option -dataLocation dieselbe Verzeichnisposition angeben.

Informationen zu den Datei- und Informationstypen, die unter der Agentendatenposition gespeichert sind, finden Sie unter Position der Agentendaten.

-keyring Datei [-password Kennwort]
Diese Angabe veranlasst Eclipse, eine Schlüsselringdatei zu erstellen, wenn eine solche Datei noch nicht vorhanden ist. Das Argument -password Kennwort ist optional. Wenn das Kennwort nicht angegeben wird, verwendet Eclipse ein Standardkennwort. Sie können eine stärkere Verschlüsselung einrichten, indem Sie ein Kennwort zum Öffnen der Schlüsselringdatei angeben.

Der Inhalt einer Schlüsselringdatei wird verschlüsselt. Sie müssen über Schreibzugriff auf die Schlüsselringdatei verfügen.

Installation Manager verwendet die Infrastruktur von Eclipse, um Berechtigungsnachweise in einer Schlüsselringdatei zu speichern. Weitere Informationen zu Schlüsselringdateien enthält das Benutzerhandbuch für die Eclipse-Workbench.

Achtung: Ab Installation Manager Version 1.4.3 wird --launcher.ini .ini-Datei nicht weiter unterstützt. Sie können die folgenden Befehle ohne Angabe einer Datei '.ini' verwenden: install,installc, userinst, userinstc, groupinst, groupinstc, uninstallc und uninstall.
--launcher.ini .ini-Datei
Beispiele:
  • --launcher.ini silent-install.ini
  • --launcher.ini silent-uninstall.ini
  • --launcher.ini user-silent-install.ini
  • --launcher.ini user-silent-uninstall.ini
Gibt die Position der zu verwendenden .ini-Datei des Produkts an. Wenn dieses Argument nicht angegeben ist, sucht Installation Manager nach einer Datei mit demselben Namen und der Erweiterung .ini im Verzeichnis des Startprogramms. Wird beispielsweise installc als Startprogramm verwendet, sucht Installation Manager nach installc.ini.

Die Datei silent-install.ini enthält die Initialisierungsparameter für die unbeaufsichtigte Installation. Die Datei silent-install.ini befindet sich in demselben Verzeichnis wie die Datei installc und muss vorhanden sein.

Die Datei user-silent-install.ini wird für die Installation durch einen Benutzer ohne Administratorberechtigung verwendet. Die Datei user-silent-uninstall.ini wird für die Deinstallation durch einen Benutzer ohne Administratorberechtigung verwendet.

Wichtig: Die Version der Dateien silent-install.ini und user-silent-install.ini, die in den Installationsdateien für Installation Manager zur Verfügung gestellt wird, verwendet das Befehlszeilenargument input. Um installAll oder updateAll mit diesen .ini-Dateien zu verwenden, müssen Sie zwei Zeilen entfernen: die Zeile -input und die Zeile, die auf die Antwortdatei verweist. Beispiel für die beiden zu entfernenden Zeilen:
-input
@osgi.install.area\install.xml
Wenn die Zeile -input und die Zeile mit dem Verweis auf die Antwortdatei nicht entfernt werden, können die Befehlszeilenargumente installAll und updateAll nicht verwendet werden.

Die .ini-Dateien im Installationsverzeichnis von Installation Manager verwenden das Befehlszeilenargument -input nicht.

Beispiel einer Datei silent-install.ini aus den Installationsdateien für Installation Manager:

-toolId
isilentInstall
-accessRights
admin
-vm
jre_5.0.4.sr11_20091106a\jre\bin\java.exe
-nosplash
--launcher.suppressErrors
-silent
-input
@osgi.install.area\install.xml
-vmargs
-Xquickstart
-Xgcpolicy: gencon

Beispiel einer Datei silent-install.ini aus dem Verzeichnis von Installation Manager:

-accessRights
admin
-vm
C:\Programme\IBM\Installation Manager\eclipse\jre_5.0.3.sr8a_20080811b\jre\bin\java.exe
-nosplash
--launcher.suppressErrors
-silent
-vmargs
-Xquickstart
-Xgcpolicy: gencon

Wenn Sie einen Befehl ausführen, der das Argument -input verwendet und die verwendete .ini-Datei auch das Argument -input enthält, wird die Antwortdatei verwendet, die im Argument -input im Befehl angegeben wird. Die Antwortdatei im Argument -input in der .ini-Datei wird ignoriert. Beispiel eines Befehls, der das Argument -input verwendet: ./install --launcher.ini silent-install.ini -input Pfad und Name der Eingabedatei

--launcher.suppressErrors
Unterdrückt den Fehlerdialog der virtuellen Java™-Maschine (JVM).
-log, -l Protokolldatei
Gibt eine Protokolldatei an, die das Ergebnis der unbeaufsichtigten Installation aufzeichnet. Bei der Protokolldatei handelt es sich um eine XML-Datei.

Wenn die unbeaufsichtigte Installation abgeschlossen wurde, enthält die Protokolldatei das Stammelement result/result. Wenn bei der Installation Fehler auftreten, enthält die Protokolldatei für die unbeaufsichtigte Installation Fehlerelemente und Nachrichten.

Verwenden Sie -log nicht, wenn Sie eine Antortdatei aufzeichnen.

Achtung: Ab Installation Manager Version 1.4.4 wird -mode wizard nicht weiter unterstützt.
-mode wizard
Führt den Installationsassistenten mit der angegebenen Antwortdatei aus. Sie müssen input angeben, wenn Sie -mode wizard verwenden.

Verwenden Sie in Version 1.4.4 die Syntax IBMIM input Antwortdatei -acceptlicense, um den Installationsassistenten zu starten.

-nl Wert
Wenn Sie die Option nl und einen Sprachencode in einem Befehl angeben, passt sich das Verhalten der Befehlszeile an die Einstellungen für die jeweilige Sprache an.
Die folgende Liste enthält die gegenwärtig unterstützten Sprachencodes, die als Werte für die Ländereinstellung aufgeführt werden können:
  • Arabisch (ar)
  • Tschechisch (cs)
  • Dänisch (da)
  • Englisch (en)
  • Französisch (fr)
  • Deutsch (de)
  • Griechisch (el)
  • Ungarisch (hu)
  • Italienisch (it)
  • Japanisch (ja)
  • Koreanisch (ko)
  • Litauisch (li)
  • Polnisch (pl)
  • Portugiesisch (pt_BR)
  • Russisch (ru)
  • Vereinfachtes Chinesisch (zh_CN)
  • Slowenisch (sl)
  • Spanisch (es)
  • Traditionelles Chinesisch (Taiwan) (zh_TW)
  • Türkisch (tr)
Anmerkung: Bei einigen Sprachen werden nur Teilübersetzungen unterstützt. Wenn eine Sprache teilweise übersetzt ist, wird für den nicht übersetzten Inhalt standardmäßig Englisch verwendet.
-nosplash
Unterdrückt die Eingangsanzeige.
-passwordKey, -pK Kennwortschlüssel
Verwendet Kennwortschlüssel zur Verschlüsselung und Entschlüsselung von Kennwörtern.
-record Antwortdatei
Generiert eine Antwortdatei aus den Aktionen in der Benutzerschnittstelle, in der Befehlszeile oder im Konsolenmodus von Installation Manager und gibt die Position der Antwortdatei an.
-showProgress, -sP
Zeigt eine Fortschrittsleiste in der Konsole an.
-showVerboseProgress, -sVP
Zeigt einen Fortschrittstext in der Konsole an. Zum Beispiel wird der Text Computer wird neu gestartet, um die Installation abzuschließen. angezeigt, wenn der Computer neu gestartet werden muss.
Achtung: Ab Version 1.4.4 wird -silent nicht weiter unterstützt.
-silent, -s
  • -silent -installAll -nosplash --launcher.suppressErrors
  • -silent -updateAll -nosplash --launcher.suppressErrors
Gibt an, dass das Installationsprogramm von Installation Manager bzw. Installation Manager im Modus für unbeaufsichtigte Installation ausgeführt wird.
Mit den Befehlen IBMIM, install, userinst und groupinst:
  • Verwenden Sie zur unbeaufsichtigten Installation aller verfügbaren Pakete -silent -installAll -nosplash --launcher.suppressErrors.
  • Verwenden Sie zur unbeaufsichtigten Aktualisierung aller installierten Pakete -silent -updateAll -nosplash --launcher.suppressErrors.

Verwenden Sie den Befehl input nicht mit den Befehlen installAll und updateAll. Mit installAll werden die Standardkomponenten eines Pakets installiert. Um anzugeben, welche Komponenten installiert werden, müssen Sie input Antwortdatei verwenden. Die Antwortdatei enthält die Informationen zu den zu installierenden Komponenten.
Anmerkung: Bei der Aufzeichnung einer Antwortdatei können Sie die zu installierenden Komponenten auswählen.
Wichtig: Ab Version 1.4.4 von Installation Manager wird der Befehl installAll nicht weiter unterstützt. Sie sollten diesen Befehl nicht verwenden, da die gleichzeitige Installation mehrerer Produkte eine Reihe potenzieller Probleme mit sich bringt. Weitere Informationen finden Sie in der Beschreibung des Befehls installAll.
-skipInstall, -sI Datenposition
Zeichnet eine Antwortdatei auf, ohne das IBM Produkt zu installieren. Der Wert Datenposition gibt die Verzeichnisposition für die Installationsordner und -dateien an. Obwohl das IBM Produkt nicht installiert wird, werden die für eine Installation erforderlichen Dateien und Ordner in dem angegebenen Verzeichnis erstellt und gespeichert. Für das Verzeichnis muss Schreibzugriff bestehen.

Stellen Sie sicher, dass die im Argument angegebenen Dateipfade vorhanden sind. Installation Manager erstellt keine Verzeichnisse für Antwortdateien.

Achtung: Geben Sie für den neuen Positionswert von Datenposition kein bereits als Datenposition vorhandenes Verzeichnis an. Informationen zu Standardpositionen des Verzeichnisses Datenposition finden Sie in Position der Agentendaten.
Wichtig: Wenn Sie eine Antwortdatei mit dem Argument -skipInstall aufzeichnen, müssen Sie das Verzeichnis, die Ordner und die Dateien, die erstellt werden, beibehalten. Wenn Sie das Verzeichnis Datenposition beibehalten, können Sie die Installation zu einem späteren Zeitpunkt ändern. Wenn Sie eine neue Antwortdatei aufzeichnen, um die Installation zu ändern, geben Sie dasselbe Verzeichnis für Datenposition an.

Verwenden Sie für jede Version eines IBM Produkts, das von Ihnen installiert wird, einen anderen Wert für Datenposition.

Sie müssen zuerst eine Installation eines IBM Produkts mit -skipInstall aufzeichnen, bevor Sie eine Aktualisierung aufzeichnen.

-vm
Gibt das Java-Startprogramm an. Verwenden Sie im unbeaufsichtigten Modus immer java.exe unter Windows und java unter Linux und UNIX.

Feedback