Befehlszeilenargumente für Installation Manager
Anhand der folgenden Tabelle können Sie mehr über die Befehlszeilenargumente von IBM Installation Manager erfahren.
Installation Manager-Befehle
Tabelle 1 enthält eine Liste der Befehle und Tabelle 2 eine Liste der Optionen.
Tabelle 1: Installation Manager-Befehle
Befehle | Beschreibung |
---|---|
|
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' 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. |
|
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. |
|
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. |
|
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:
Als Wert für
Antwortdatei können Sie einen Dateipfad oder eine URL verwenden.
Die folgenden Beispiele zeigen Zeichenfolgen für Dateipfade und URLs:
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. |
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:
|
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:
|
|
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:
Verwenden Sie updateAll nicht zusammen mit den folgenden Befehlen:
|
|
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 |
---|---|
|
Schließen Sie die Option -acceptLicense in Ihren Befehl ein, wenn das zu installierende Paket erfordert, dass die Lizenzvereinbarung aktzeptiert wird. |
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:
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. |
|
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:
Beispiele für Fälle, bei denen dieselbe Verzeichnisposition für die Option -datalocation verwendet werden muss:
Informationen zu den Datei- und Informationstypen, die unter der Agentendatenposition gespeichert sind, finden Sie unter Position der Agentendaten. |
|
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.
Beispiele:
|
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:
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 Beispiel einer Datei silent-install.ini aus dem Verzeichnis von Installation Manager:
-accessRights 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 |
|
Unterdrückt den Fehlerdialog der virtuellen Java™-Maschine (JVM). |
|
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.
|
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. |
|
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:
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.
|
|
Unterdrückt die Eingangsanzeige. |
|
Verwendet Kennwortschlüssel zur Verschlüsselung und Entschlüsselung von Kennwörtern. |
|
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. |
|
Zeigt eine Fortschrittsleiste in der Konsole an. |
|
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.
|
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 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.
|
|
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. |
|
Gibt das Java-Startprogramm an. Verwenden Sie im unbeaufsichtigten Modus immer java.exe unter Windows und java unter Linux und UNIX. |