Befehl installUtility

Mit dem Befehl installUtility können Sie Assets in einem verzeichnisbasierten Repository, in einer Instanz von Liberty Asset Repository Service oder in IBM® WebSphere Liberty Repository suchen, installieren und Informationen zu diesen Assets abrufen.

Assetquellen

Der Befehl installUtility kann auf Assets in den folgenden Repositorys zugreifen:
  • IBM WebSphere Liberty Repository ist ein öffentliches von IBM gehostetes Repository, das über das Internet zugänglich ist. Weitere Informationen finden Sie unter Liberty Repository.
  • Liberty Asset Repository Service ist ein Open-Source-Service, den Sie verwenden können, um ein lokales Repository zu erstellen, das hinter einer Firewall eines Unternehmens über Fernzugriff zugänglich ist. Weitere Informationen finden Sie unter dem Projekt "WASdev/tool.lars" auf GitHub.
  • Lokale verzeichnisbasierte Repositorys, die Sie mit der Aktion installUtility download oder durch Herunterladen der Datei wlp-featureRepo-<Version>.zip, die alle entsprechenden Features und Add-ons enthält, erstellen können. Weitere Informationen finden Sie unter Assets mit dem Befehl "installUtility" herunterladen.

Sie können den Befehl installUtility verwenden, um direkt mit Assets aus komprimierten Repositorys, wie z. B. wlp-featureRepo-<Version>.zip, zu arbeiten, ohne die Archive entpacken zu müssen. Weitere Informationen zur Datei wlp-featureRepo-<Version>.zip finden Sie unter Assets mit dem Befehl "installUtility" herunterladen.

Syntax

Die Befehlssyntax ist 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.
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
Schablone für die Konfiguration von Repositorys für einen Proxy oder Einstellungen für die konfigurierten Repositorys oder den konfigurierten Proxy anzeigen und validieren.
help
Zeigt Hilfeinformationen für eine angegebene Aktion an.

Optionen

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, um die vorhandenen Dateien beim Download in das lokale Verzeichnis zu überschreiben. 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
Geben Sie Asset-IDs an, um eine oder mehrere der folgenden Assets herunterzuladen. Wenn Sie mehrere Anlagen-IDs angeben, trennen Sie sie durch Leerzeichen voneinander:
  • Features
  • Add-ons
  • Open-Source-Integrationen
  • Beispiele

Die folgenden Optionen sind für den Befehl installUtility find verfügbar:
--from
Geben Sie ein einzelnes verzeichnisbasiertes Repository als Assetquelle für den Befehl installUtility an.

Das verzeichnisbasierte Repository kann ein nicht komprimierter Ordner oder eine komprimierte Archivdatei sein.

Wenn Sie Assets in mehreren verzeichnisbasierten Repositorys suchen möchten, müssen Sie die Repositorys in der Datei repositories.properties konfigurieren. Weitere Informationen finden Sie unter Repositorys und Proxy-Einstellungen für den Befehl installUtility konfigurieren.

--showDescriptions
Die Beschreibung für jede der beim Suchvorgang gefundenen Features anzeigen.
--type=[feature|sample|opensource|addon|all*]
Nach dem angegeben Assettyp suchen.
--name
Sucht den Assetnamen für den angegebenen Suchbegriff.
--verbose
Verwenden Sie diese Option, um alle verfügbaren zusätzlichen Informationen während der Ausführung der Aktion anzuzeigen.
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 install verfügbar:
--to=Installationsoption
Die Option install_option kann einen der folgenden Werte annehmen:
  • usr: Das Feature ist 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.
--from
Geben Sie ein einzelnes verzeichnisbasiertes Repository als Assetquelle für den Befehl installUtility an.

Das verzeichnisbasierte Repository kann ein nicht komprimierter Ordner oder eine komprimierte Archivdatei sein.

Wenn Sie Assets aus mehreren verzeichnisbasierten Repositorys installieren möchten, müssen Sie die Repositorys in der Datei repositories.properties konfigurieren. Weitere Informationen finden Sie unter Repositorys und Proxy-Einstellungen für den Befehl installUtility konfigurieren.

--acceptLicense
Annahme der Lizenzbedingungen angeben.
--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
Geben Sie 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. Wenn Sie mehrere Asset-IDs angeben, müssen Sie diese durch Leerzeichen voneinander trennen.
  • Features
  • Add-ons
  • Open-Source-Integrationen
  • Beispiele
Servername
Sie können Features basierend auf einem vorhandenen Server in derselben Liberty-Umgebung installieren, indem Sie den Servernamen angeben. Der Befehl installiert alle gültigen Features, die in der Datei server.xml dieses Servers definiert und noch nicht in der Liberty-Umgebung installiert sind.
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.
Datei server.xml
Wenn Sie Features basierend auf einer Serverkonfigurationsdatei installieren möchten, können Sie einen Pfad zu einer beliebigen lokalen Datei server.xml, wie z. B. C:\localDir\server.xml, angeben. Der Befehl installiert alle gültigen Features, die in der Datei server.xml definiert und noch nicht in der Liberty-Umgebung installiert sind.
.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 Featuremanifest. 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 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:
--force
Deinstalliert das angegebene Feature unabhängig davon, ob andere installierte Features von diesem Feature abhängig sind.
Anmerkung: Die Deinstallation eines Features, das von anderen installierten Features benötigt wird, kann dazu führen, dass diese Features nicht mehr ordnungsgemäß funktionieren und dass Server nicht mehr ordnungsgemäß ausgeführt werden.
--noPrompts
Deinstalliert das Feature ohne Eingabeaufforderungen. Der Standardwert ist "false".
--verbose
Verwenden Sie diese Option, um weitere Informationen während der Deinstallation anzuzeigen.
Name
Geben Sie die zu deinstallierenden Features an. Wenn Sie mehrere Features angeben, müssen Sie die Namen durch Leerzeichen voneinander trennen. Sie können die folgenden Optionen 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

Sie können Benutzerfeatures und Produkterweiterungen deinstallieren, indem Sie dem Featurenamen die Erweiterung von einem Doppelpunkt gefolgt als Präfix voranstellen, z. B. usr:webCacheMonitor-1.0.


Die folgende Option ist für den Befehl installUtility viewSettings verfügbar:
--viewValidationMessages
Verwenden Sie diese Option, um die detaillierten Nachrichten der Validierung der konfigurierten Datei repositories.properties anzuzeigen. Jede Nachricht enthält einen Fehlercode, die Nummer der Zeile, in der der Fehler gefunden wurde, und die Fehlerursache.

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 ein Feature-Bundle-Add-on aus einem einzigen lokalen verzeichnisbasierten Repository zu installieren:
installUtility install ndMemberBundlelibertyCoreBundle --from=c:\download\wlp-featureRepo-16.0.0.2
Verwenden Sie den folgenden Befehl, um ein Feature-Bundle-Add-on aus einem einzigen komprimierten verzeichnisbasierten Repository-Archiv zu installieren:
installUtility install ndMemberBundlelibertyCoreBundle --from=c:\download\wlp-featureRepo-16.0.0.2.zip
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=sample
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 ein Benutzerfeature oder eine Produkterweiterung zu deinstallieren:
installUtility uninstall usr:webCacheMonitor-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

Tabelle 1. Rückgabecodes und Erläuterungen
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:
  • Während der Installation der ESA-Subsystemarchivdatei ist eine Laufzeitausnahme eingetreten.
  • Eine Lizenz wurde nicht akzeptiert oder bestätigt.
  • Die ESA-Subsystemarchivdatei wurde nicht ordnungsgemäß entpackt.
22 Das zu installierende Feature ist bereits vorhanden.
23 Die Featuredefinition ist aus den folgenden Gründen nicht gültig:
  • Das Feature hat keine gültige Manifestdatei.
  • Die Version des Features wird in dieser Liberty-Umgebung nicht unterstützt.
  • Die ZIP- oder JAR-Datei, die die Featuredateien enthält, ist nicht vorhanden.
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.
30 Die Validierung der Datei repositories.properties ist fehlgeschlagen.
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.

Symbol das den Typ des Artikels anzeigt. Referenzartikel



Symbol für Zeitmarke Letzte Aktualisierung: 01.12.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-libcore-mp&topic=rwlp_command_installutility
Dateiname: rwlp_command_installutility.html