Befehl featureManager
Sie können mit dem Befehl featureManager Features suchen, installieren und deinstallieren oder Details zu Features abrufen.
Das Feature, das Sie installieren möchten, muss als Subsystemarchiv gepackt werden (ESA-Datei).
Sie können
mit dem Befehl featureManager über einen Proxy-Server auf das Liberty-Repository zugreifen. Weitere Informationen hierzu enthält der Abschnitt
Proxy-Server-Unterstützung für den Befehl featureManager im Liberty-Profil konfigurieren.
Wenn Sie weitere Assettypen verwalten und Assets in mehreren Repositorys installieren, suchen oder aus diesen herunterladen möchten, verwenden Sie den Befehl installUtility anstelle des Befehls
featureManager. Weitere Informationen finden Sie unter Assetss mit dem Befehl "installUtility" installieren.
Syntax
Die Befehlssyntax lautet wie folgt:
featureManager Aktion [Optionen]
classpath
- Generiert eine JAR-Datei, die einem Compilerklassenpfad hinzugefügt werden kann,
um APIs aus einer Liste von Features zu verwenden.
Diese Aktion ermöglicht Ihnen, Build-Scripts für die
im Produkt enthaltenen API-JARs zu kompilieren, ohne auf bestimmte JAR-Namen zu verweisen, die sich ändern können, wenn ein Fixpack angewendet wird.
Die JAR-Ausgabedatei enthält relative Pfade zu den API-JARs im Produkt. Deswegen dürfen Sie die JAR-Ausgabedatei nicht in ein anderes Verzeichnis verschieben. Anmerkung: Die Option --features muss mit dieser Aktion angegeben werden.
- install
- Installiert ein Feature unter Verwendung einer ESA-Datei (Enterprise Subsystem Archive), einer URL mit einer ESA-Datei, einem Featurekurznamen oder einem symbolischen Featurenamen.
Wenn Sie einen Featurekurznamen oder einen symbolischen Namen angeben, wird das Feature aus einem von IBM gehosteten Onlinerepository heruntergeladen.
Die Aktion install verwendet die Datei OSGI-INF/SUBSYSTEM.MF aus der ESA-Datei als ein neues Feature-Manifest, das in das Verzeichnis ${wlp.user.dir}/extensions/lib/features (bzw. in das Verzeichnis für Produkterweiterungen, falls ein Wert für die Eigenschaft --to angegeben ist) kopiert werden kann, das entsprechend dem symbolischen Namen des Subsystems umbenannt wird. Alle Bundles für das Subsystem werden in das 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.
Mit dem Befehl featureManager können Sie Assets aus dem Liberty-Repository herunterladen. Weiter Informationen finden Sie unter Liberty Repository-Assets installieren.
- featureList
- Generiert eine XML-Datei, die einen Bericht die einen Bericht mit Details zu allen installierten Features enthält.
find
- Sucht Assets im Liberty-Repository, die auf Ihre Konfiguration anwendbar sind.
- help
- Zeigt Hilfeinformationen für eine angegebene Aktion an.
uninstall
Deinstalliert Features unter Verwendung des Featurekurznamens oder des symbolischen Featurenamens.
Anmerkung:- Stellen Sie sicher, dass alle Serverprozesse gestoppt wurden, bevor Sie ein Feature deinstallieren.
- Mit dem Befehl uninstall können keine Benutzerfeatures, wie z. B. webCacheMonitor-1.0, deinstalliert werden.
Optionen
![[8.5.5.4 oder höher]](../ng_v8554.gif)
- --features=Feature1,Feature2,...
- Die Liste der Features, die die Liste der API-JAR-Dateien enthält. Diese Option ist für die Aktion classpath erforderlich.
- --acceptLicense
- Mit dieser Option können Sie angeben, ob die Lizenzbedingungen automatisch akzeptiert werden sollen.
--downloadOnly=[all | required* | none]
- Lädt das angeforderte Feature in ein lokales Verzeichnis herunter, ohne das Feature zu installieren. Sie können diese Option so konfigurieren, dass alle abhängigen Features, die für diese Laufzeit erforderlichen abhängigen Features oder keine der abhängigen Features heruntergeladen werden. Standardmäßig werden die erforderlichen abhängigen Features heruntergeladen. Geben Sie das Verzeichnis mit der Option --location an.
Anmerkung: Sie können diese Option nicht verwenden, wenn Sie die Position des Subsystemarchivs mit einem Dateinamen oder einer URL angeben.
--location=Verzeichnispfad
- Gibt die Position des Subsystemarchivs an, das Sie installieren möchten. Bei Verwendung der Option --downloadOnly wird ein Zielverzeichnis für heruntergeladene Features angegeben. Diese Option ist erforderlich,
wenn Sie die Optionen --downloadOnly und --offlineOnly verwenden. Anmerkung: Sie können diese Option nicht verwenden, wenn Sie die Position des Subsystemarchivs mit einem Dateinamen oder einer URL angeben.
--offlineOnly
- Verwenden Sie diese Option, wenn Sie keine Verbindung zum Liberty-Repository herstellen möchten. Stattdessen installiert der Befehl nur Features aus dem lokalen Verzeichnis. Das lokale Verzeichnis wird mit der Option --location angegeben.
Anmerkung: Sie können diese Option nicht verwenden, wenn Sie die Position des Subsystemarchivs mit einem Dateinamen oder einer URL angeben.
- --to=Installationsoption
- Installationsoption steht für einen der folgenden Werte:
- usr: Das Feature ist als Benutzerfeature installiert. Dies ist der Standardwert.
- extension: Die Position, an der Sie das Feature installieren möchten. Sie können das Feature an jeder beliebigen konfigurierten Produkterweiterungsposition installieren.
- --viewLicenseAgreement
- Lizenzvereinbarung anzeigen.
- --viewLicenseInfo
- Lizenzinformationen anzeigen.
- --when-file-exists=exist-Option
- Gibt die Aktion an, die ausgeführt werden soll, wenn eine zu installierende Datei bereits vorhanden ist.
Für exist-Option kann einer der folgenden Werte verwendet werden:
- fail: Die Installation wird abgebrochen.
- ignore: Die Installation wird fortgesetzt und die vorhandene Datei ignoriert.
- replace: Die vorhandene Datei wird überschrieben.
- Subsystemarchiv
- Gibt die Position des Subsystemarchivs an, das Sie installieren möchten. Sie können die Position wie folgt angeben:
- mit einem Dateinamen, z. B. my_feature.esa.
- mit einer URL, z. B.
http://myhost.ibm.com/liberty/assets/my_feature.esa
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
Weitere Informationen finden Sie auf der Downloadseite auf WASdev.net.
- --encoding=Zeichensatz
- Zeichensatz ist der Zeichensatz, der bei der Erstellung der XML-Berichtsdatei verwendet werden soll.
- --locale=Sprache
- Sprache ist die Sprache, die bei der Erstellung der XML-Berichtsdatei verwendet werden soll. Die Angabe besteht aus dem zweistelligen ISO-639-Sprachencode in Kleinbuchstaben, dem optional ein Unterstreichungszeichen und der zweistellige ISO-3166-Landescode in Großbuchstaben folgen kann.
- --productExtension=Name
- Name ist der Name der Produkterweiterung, deren Features aufgelistet werden sollen. Wenn die Produkterweiterung an der Standardbenutzerposition installiert wird, verwenden Sie das Schlüsselwort usr. Wird diese Option nicht angegeben, wird die Aktion in WebSphere Application Server Liberty Core ausgeführt.
- Name_der_XML-Berichtsdatei
- Gibt den Namen der zu erstellenden XML-Berichtsdatei an.
Suchbegriff
- Verwenden Sie die Option Suchbegriff, um anwendbare Features im WebSphere-Liberty-Repository zu suchen.
--viewInfo
- Zeigt detaillierte Informationen an.
![[8.5.5.5 oder höher]](../ng_v8555.gif)
- 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
- --noPrompts
- Deinstalliert Features ohne Benutzerinteraktionen oder Bestätigungsnachrichten.
Verwendungsbeispiele
featureManager install my_feature.esa --to=usr
featureManager install my_feature.esa --to=my_extension
featureManager featureList my_feature_report.xml --locale=pt_BR
featureManager featureList --productExtension=usr my_feature_report.xml
featureManager featureList --productExtension=Produkterweiterungsname my_feature_report.xml
featureManager help install

![[8.5.5.4 oder höher]](../ng_v8554.gif)
featureManager find Suchbegriff

![[8.5.5.4 oder höher]](../ng_v8554.gif)
featureManager find Suchbegriff --viewInfo

![[8.5.5.4 oder höher]](../ng_v8554.gif)
featureManager install Kurzname_des_Features --downloadOnly --location=c:\temp\download --acceptLicense

![[8.5.5.4 oder höher]](../ng_v8554.gif)
featureManager install Kurzname_des_Features --downloadOnly=all --location=c:\temp\download --acceptLicense

![[8.5.5.4 oder höher]](../ng_v8554.gif)
featureManager install Kurzname_des_Features --location=c:\temp\download --acceptLicense

![[8.5.5.4 oder höher]](../ng_v8554.gif)
featureManager install Kurzname_des_Features --location=c:\temp\download --offlineOnly

![[8.5.5.4 oder höher]](../ng_v8554.gif)
featureManager classpath --features=servlet-3.0 classpath.jar
javac -cp classpath.jar TestServlet.java

![[8.5.5.5 oder höher]](../ng_v8555.gif)
featureManager uninstall adminCenter-1.0
![[Aktualisierung Mai 2014]](../delta.gif)
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 Feature, das Sie installieren möchten, ist bereits vorhanden. |
23 | Die Featuredefinition ist aus den folgenden Gründen nicht gültig:
|
24 | In der ESA-Subsystemarchivdatei fehlen Inhalte. |
25 | Eine Datei, die Sie installieren wollten, ist bereits vorhanden und Sie haben die Option when-file-exists=fail angegeben. |
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. |
![[Aktualisierung Mai 2014]](../deltaend.gif)