![[8.5.5.6 oder höher]](../ng_v8556.gif)
Befehl installUtility
Verwenden Sie den Befehl installUtility, um Informationen zu Assets, die sich in einem lokalen Repository, einem fernen Repository oder in IBM® WebSphere Liberty Repository befinden, zu finden, abzurufen und zu installieren.
Syntax
Die Befehlssyntax lautet wie folgt:
installUtility Aktion [Optionen]
Für die Variable Aktion kann einer der folgenden Werte verwendet werden:
- download
- Assets aus den Repositorys herunterladen.
- find
- Assets in den Repositorys finden, die für Ihre Konfiguration gültig sind, oder ausführliche Informationen zu Assets anzeigen.
- help
- Hilfeinformationen für eine angegebene Aktion anzeigen.
- install
- Installiert Assets oder eine ESA-Datei (Enterprise Subsystem Archive) in der Laufzeitimplementierung oder implementiert ein Serverpaket und installiert die erforderlichen Features des Pakets.
- testConnection
- Repository-Verbindung testen.
- uninstall
- Features unter Angabe des Kurznamens oder des symbolischen Namens deinstallieren. Sie können mehrere Features, durch Leerzeichen voneinander getrennt, angeben.
- Anmerkung: Stellen Sie sicher, dass alle Serverprozesse gestoppt wurden, bevor Sie ein Feature deinstallieren.
- viewSettings
- Repository und Proxy-Einstellungen für den Befehl installUtility anzeigen.
Bei Verwendung dieser Aktionen kann der Befehl installUtility in den folgenden Repositorys auf Assets zugreifen:
- IBM WebSphere Liberty-Repository, ein von IBM gehostetes öffentliches Repository, das über das Internet zugänglich ist. Weitere Informationen finden Sie unter Liberty Repository.
- Liberty Asset Repository Service, ein Open-Source-On-Premise-Repository, das hinter der Firewall eines Unternehmens über Fernzugriff zugänglich ist. Siehe Repository WASdev/tool.lars auf GitHub.
- Lokale verzeichnisbasierte Repositorys, die mit der Aktion installUtility download erstellt werden. Weitere Informationen finden Sie unter Assets mit dem Befehl installUtility herunterladen.
Optionen
Die folgenden Optionen sind für den
Befehl installUtility install verfügbar:
- --acceptLicense
- Annahme der Lizenzbedingungen angeben.
- --to=Installationsoption
- Die Option install_option kann
einen der folgenden Werte annehmen:
- user: Das Feature wird als Benutzerfeature installiert. Dies ist der Standardwert.
- Erweiterung: Die Installationsposition für das Feature. Sie können das Feature an jeder beliebigen konfigurierten Produkterweiterungsposition installieren.
- --viewLicenseAgreement
- Lizenzvereinbarung anzeigen.
- --viewLicenseInfo
- Lizenzinformationen anzeigen.
- --verbose
- Verwenden Sie diese Option, um alle verfügbaren zusätzlichen Informationen während der Ausführung der Aktion anzuzeigen.
- Name
- Gibt die Assets an, die Sie installieren möchten. Sie können die Assets auf folgende Weise angeben:
- Asset-IDs
- Sie können Asset-IDs angeben, um mindestens eines der folgenden Assets zu installieren:
- Features
- Add-ons
- Open-Source-Integrationen
- Beispiele
- Servername
- Sie können alle fehlenden Features für einen vorhandenen Server durch die Verwendung des Servernamens installieren. Die erforderlichen Features, die in der Datei server.xml definiert sind, werden über die Repositorys installiert.
- Serverpaket
- Sie können ein Serverpaket angeben, das Sie mit dem Befehl server package --include=usr erstellt haben. Das Serverpaket wird implementiert und die erforderlichen Features, die in der Datei server.xml definiert sind, werden über die Repositorys installiert.
- .esa-Datei
- Installieren Sie ein Feature aus einer .esa-Datei auf Ihrem lokalen Dateisystem. Diese Aktion verwendet die Manifestdatei OSGI-INF/SUBSYTEM.MF aus der .esa-Datei als ein neues Feature-Manifest. Die Manifestdatei gibt den Namen, die Inhalte und die Abhängigkeiten eines Features an. Wenn Sie die Option --to angeben, kopiert installUtility die Manifestdatei in das Verzeichnis ${wlp.user.dir}/extensions/lib/features oder in das Verzeichnis für Produkterweiterungen. Alle Bundles für das Subsystem werden im Verzeichnis ${wlp.user.dir}/extensions/lib entpackt und in {symbolischer_Bundlename}_{Bundleversion}.jar umbenannt. Lizenzdateien, Kontrollsummendateien, Lokalisierungsdateien und andere Subsysteminhalte werden ebenfalls an der im Subsystemmanifest definierten Position entpackt.
Die folgenden Optionen sind für den
Befehl installUtility find verfügbar:
- --showDescriptions
- Die Beschreibung für jede der beim Suchvorgang gefundenen Features anzeigen.
- --type=[feature|sample|opensource|addon|all*]
- Nach dem angegeben Asset-Typ suchen.
- --name
- Sucht den Assetnamen für den angegebenen Suchbegriff.
- Suchbegriff
- Assets suchen, die auf Ihre Konfiguration anwendbar sind. Wenn Sie keinen Suchbegriff angeben, sucht der Befehl nach allen gültigen Assets.
Die folgenden Optionen sind für den
Befehl installUtility download verfügbar:
- --acceptLicense
- Lizenzvereinbarung akzeptieren.
- --viewLicenseAgreement
- Lizenzvereinbarung anzeigen.
- --viewLicenseInfo
- Lizenzvereinbarung anzeigen.
- --location=Verzeichnispfad
- Das Zielverzeichnis für die heruntergeladenen Assets angeben. Diese Option ist erforderlich.
- --overwrite
- Verwenden Sie diese Option, wenn vorhandene Dateien beim Download in das lokale Verzeichnis überschrieben werden sollen. Das Standardverhalten ohne die Option besteht darin, alle vorhandenen Dateien zu ignorieren.
- --verbose
- Verwenden Sie diese Option, um weitere Informationen während des Downloads anzuzeigen.
- Name
- Sie können Asset-IDs angeben, um mindestens eines der folgenden Assets herunterzuladen:
- Features
- Add-ons
- Open-Source-Integrationen
- Beispiele
Die folgende Option ist für den Befehl installUtility testConnection verfügbar:
- Repository-Name
- Gibt den Namen des zu testenden Repositorys an. Wird der Name nicht angegeben, werden alle in der Datei repositories.properties angegebenen Repositorys getestet.
Die folgende Option ist für den Befehl installUtility uninstall verfügbar:
- --noPrompts
- Deinstalliert das Feature ohne Eingabeaufforderungen. Der Standardwert ist "false".
- --verbose
- Verwenden Sie diese Option, um weitere Informationen während der Deinstallation anzuzeigen.
- Name
- Gibt das zu deinstallierende Feature an. Sie können das Feature wie folgt angeben:
- mit dem Kurznamen des Subsystemarchivs (ESA-Datei), z. B. adminCenter-1.0
- mit dem symbolischen Namen des Subsystemarchivs (ESA-Datei), z. B. com.ibm.websphere.appserver.adminCenter-1.0
Verwendungsbeispiele
Verwenden Sie das folgende Beispiel, um Hilfeinformationen für die Aktion install anzuzeigen:
installUtility help install
Verwenden Sie den folgenden Befehl, um ein Benutzerfeature zu installieren:
installUtility install my_feature --to=usr
Verwenden
Sie den folgenden Befehl, um ein Benutzerfeature an der Produkterweiterungsposition my_extension zu installieren:
installUtility install my_feature --to=my_extension
Verwenden Sie den folgenden Befehl, um mehrere Features zu installieren:
installUtility install Feature1 Feature2 Feature3
Verwenden Sie den folgenden Befehl, um ein Beispiel zu installieren:
installUtility install mongoDBSample
Verwenden Sie den folgenden Befehl, um einen Server zu installieren:
installUtility install myServer
Verwenden Sie den folgenden Befehl, um eine komprimierte JAR-Datei mit einem Serverpaket zu installieren:
installUtility install c:\temp\myServer.jar
Verwenden Sie den folgenden Befehl, um eine lokale ESA-Datei zu installieren:
installUtility install c:\temp\myFeature.esa
Verwenden Sie den folgenden Befehl, um eine ZIP-Datei mit einem Serverpaket zu installieren:
installUtility install c:\temp\myServer.zip
Verwenden Sie den folgenden Befehl, um Assets zu finden, die auf Ihre Konfiguration anwendbar sind:
installUtility find Suchbegriff
Verwenden Sie den folgenden Befehl, um Beispiele zu finden, die auf Ihre Konfiguration anwendbar sind:
installUtility find Suchbegriff --type=Beispiel
Verwenden Sie den folgenden Befehl, um ein bestimmtes Feature zu finden, das auf Ihre Konfiguration anwendbar ist:
installUtility find webCacheMonitor-1.0 --name --type=Feature
Verwenden Sie den folgenden Befehl, um detaillierte Informationen aufzulisten:
installUtility find Suchbegriff --showDescriptions
Verwenden Sie den folgenden Befehl, um erforderliche Abhängigkeiten aus den Repositorys in ein lokales Verzeichnis herunterzuladen:
installUtility download Kurzname_des_Features --location=c:\temp\download --acceptLicense
Verwenden Sie den folgenden Befehl, um die Verbindung zum Liberty-Repository zu testen:
installUtility testConnection default
Verwenden Sie den folgenden Befehl, um ein Feature zu deinstallieren:
installUtility uninstall adminCenter-1.0
Verwenden Sie den folgenden Befehl, um mehrere Features zu deinstallieren:
installUtility uninstall Feature1 Feature2 Feature3
Verwenden Sie den folgenden Befehl, um mehrere Features ohne Eingabeaufforderungen zu deinstallieren:
installUtility uninstall --noPrompts Feature1 Feature2 Feature3
Rückgabecodes
Rückgabecode | Erläuterung |
---|---|
0 | Der Befehl hat die angeforderte Operation erfolgreich ausgeführt. |
20 | Mindestens ein Argument ist nicht gültig. |
21 | Aufgrund mindestens einer der folgenden Bedingungen ist eine Laufzeitausnahme eingetreten:
|
22 | Das zu installierende Feature ist bereits vorhanden. |
23 | Die Featuredefinition ist aus den folgenden Gründen nicht gültig:
|
24 | In der ESA-Subsystemarchivdatei fehlen Inhalte. |
25 | Eine zu installierende Datei ist bereits vorhanden. |
26 | Das Produkt ist kein Basisprodukt und die Produkterweiterungsdateien konnten nicht gefunden werden. |
27 | Das Produkt ist kein Basisprodukt und die Produkterweiterung ist nicht in der Datei ${wlp.install.dir}/etc/extensions/Erweiterungsname.properties definiert. |
28 | Die Manifestdateien für die Features in der Produkterweiterung konnten nicht gefunden werden. |
29 | Das Feature ist für das aktuelle Produkt nicht gültig. |
33 | Das Herstellen der Verbindung zum Repository ist fehlgeschlagen. |
34 | Der Repository-Name wurde nicht gefunden. Der angegebene Repository-Name ist in der Konfigurationsdatei nicht vorhanden. |
35 | Die Aktion wurde durch den Benutzer abgebrochen. |