Liberty: BefehlfeatureManager

featureManager action [options]

Für Aktion kann einer der folgenden Werte verwendet werden:

Installieren

Stabilisiertes Feature: Diese Aktion wurde stabilisiert. Verwenden Sie den Befehl installUtility install, sofern Sie keine .esa-Dateien installieren. Verwenden Sie den Befehl featureManager , um .esa -Dateien zu installieren.

Installiert ein Feature oder eine Unternehmenssubsystemarchivdatei (ESA) in der Laufzeitumgebung.

Der Befehl featureManager kann Assets aus Liberty Repositoryherunterladen. Weitere Informationen finden Sie unter Liberty Repository-Assets installieren.

deinstallieren

Stabilisiertes Feature: Diese Aktion wurde stabilisiert. Verwenden Sie stattdessen den Befehl installUtility uninstall.

Deinstalliert Features unter Verwendung des Featurekurznamens oder des symbolischen Featurenamens.

Hinweis:

• Stellen Sie sicher, dass alle Serverprozesse gestoppt wurden, bevor Sie ein Feature deinstallieren.
• Mit der Aktion uninstall können keine Benutzerfeatures, wie z. B. webCacheMonitor-1.0, deinstalliert werden.

featureList

Generiert eine XML-Datei, die einen Bericht die einen Bericht mit Details zu allen installierten Features enthält.

find

Stabilisiertes Feature: Diese Aktion wurde stabilisiert. Verwenden Sie stattdessen den Befehl installUtility find.

Generieren Sie eine Liste aller Assets in Liberty Repository, suchen Sie Assets in Liberty Repository , die auf Ihre Konfiguration anwendbar sind, oder zeigen Sie detaillierte Informationen an.

Klassenpfad

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.

Hilfe

Zeigt Hilfeinformationen für eine angegebene Aktion an.

Die folgenden Optionen sind für den Befehl featureManager install verfügbar:

--acceptLicense

Akzeptiert die Lizenzbedingungen automatisch.

--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.

Hinweis : Sie können diese Option nicht verwenden, wenn Sie den Speicherort des Subsystemarchivs mit einem Dateinamen oder URL angeben.

--location=Verzeichnispfad

Bei der Installation eines Features gibt diese Option ein lokales Quellenverzeichnis, aus dem Sie Features installieren können. 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.

Hinweis : Sie können diese Option nicht verwenden, wenn Sie den Speicherort des Subsystemarchivs mit einem Dateinamen oder URL angeben.

--offlineOnly

Verwenden Sie diese Option, um keine Verbindung zu Liberty Repositoryherzustellen. Stattdessen installiert der Befehl nur Features aus dem lokalen Verzeichnis. Das lokale Verzeichnis wird mit der Option --location angegeben.

Hinweis : Sie können diese Option nicht verwenden, wenn Sie den Speicherort des Subsystemarchivs mit einem Dateinamen oder URL angeben.

--to=install_option

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

Zeigt die Lizenzvereinbarung an.

--viewLicenseInfo

Zeigt die Lizenzinformationen an.

--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.

--verbose

Verwenden Sie diese Option, um alle verfügbaren zusätzlichen Informationen während der Ausführung der Aktion anzuzeigen.

Name

Gibt die zu installierenden Features durch Leerzeichen oder Kommas voneinander getrennt an. Sie können die Features wie folgt angeben:

Feature-ID

• Geben Sie den Kurznamen des Features an, z. B. adminCenter-1.0.
• Geben Sie den symbolischen Namen des Features an, z. B. com.ibm.websphere.appserver.adminCenter-1.0.

.esa-Datei

• Geben Sie einen Dateinamen an, z. B. my_feature.esa.
• Geben Sie eine URL an, z. B. http://myhost.ibm.com/liberty/assets/my_feature.esa.

Dies Aktion verwendet die Datei OSGI-INF/SUBSYTEM.MF aus der ESA-Datei als ein neues Featuremanifest, 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 extrahiert und in {bundle symbolic name}_{bundle version}.jarumbenannt. Lizenzdateien, Kontrollsummendateien, Lokalisierungsdateien und andere Subsysteminhalte werden ebenfalls an der im Subsystemmanifest definierten Position entpackt.

Die folgenden Optionen sind für den Befehl featureManager uninstall verfügbar:

--noPrompts

Deinstalliert Features ohne Benutzerinteraktionen oder Bestätigungsnachrichten.

--verbose

Verwenden Sie diese Option, um alle verfügbaren zusätzlichen Informationen während der Ausführung der Aktion anzuzeigen.

Name

Gibt die zu deinstallierenden Features durch Leerzeichen oder Kommas getrennt an. 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

Die folgenden Optionen sind für den Befehl featureManager featureList verfügbar:

--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. Wenn diese Option nicht angegeben ist, wird die Aktion in WebSphere® Application Server Liberty Coreausgeführt.

Name_der_XML-Berichtsdatei

Gibt den Namen der zu erstellenden XML-Berichtsdatei an.

--verbose

Verwenden Sie diese Option, um alle verfügbaren zusätzlichen Informationen während der Ausführung der Aktion anzuzeigen.

Die folgenden Optionen sind für den Befehl featureManager find verfügbar:

--viewInfo

Zeigt detaillierte Informationen an.

--verbose

Verwenden Sie diese Option, um alle verfügbaren zusätzlichen Informationen während der Ausführung der Aktion anzuzeigen.

searchString

Generiert eine Liste von Liberty Repository -Assets, die auf Ihre Konfiguration anwendbar sind.

Die folgenden Optionen sind für den Befehl featureManager classpath verfügbar:

-- 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.

fileName

Der Name der generierten JAR-Datei.

Das folgende Beispiel installiert das Subsystemarchiv my_feature.esa als Benutzerfeature:

featureManager install my_feature.esa --to=usr

Das folgende Beispiel installiert das Subsystemarchiv my_feature.esa an der Produkterweiterungsposition my_extension:

featureManager install my_feature.esa --to=my_extension

Im folgenden Beispiel wird ein Bericht für alle installierten Features generiert. Der Bericht wird in der Sprache Portugiesisch (Brasilien) in die Datei my_feature_report.xml geschrieben:

featureManager featureList my_feature_report.xml --locale=pt_BR

Im folgenden Beispiel wird ein Bericht generiert, der alle installierten, in der Produkterweiterung definierten Features enthält. Die Produkterweiterung ist an der Standardbenutzerposition wlp/usr/extension installiert und wird von der Laufzeitumgebung als Produkterweiterung usr erkannt. Der Bericht wird in die Datei my_feature_report.xml geschrieben:

featureManager featureList --productExtension=usr my_feature_report.xml

Das folgende Beispiel generiert einen Bericht, der alle in der Produkterweiterung definierten Features enthält. Die Produkterweiterung ist in dem Verzeichnis installiert, das vom Inhalt in der Datei "Produkterweiterungsname.properties" im Produktinstallationsverzeichnis etc/extensions referenziert wird. Der Bericht wird in die Datei my_feature_report.xml geschrieben:

featureManager featureList --productExtension=productExtensionName my_feature_report.xml

Im folgenden Beispiel werden Hilfeinformationen für die Installationsaktion angezeigt:

featureManager help install

Der folgende Beispielbefehl installiert ein Feature und enthält zusätzliche Informationen:

featureManager install extendedPackage-1.0 --verbose

Der folgende Beispielbefehl sucht Assets, die für Ihre Konfiguration gültig sind:

featureManager find searchString

Im folgenden Beispiel werden ausführliche Informationen aufgelistet:

featureManager find searchstring --viewInfo

Der folgende Beispielbefehl sucht ein Feature und enthält zusätzliche Informationen:

featureManager find "adminCenter-1.0" --verbose

Im folgenden Beispiel werden erforderliche Abhängigkeiten von Liberty Repository in ein lokales Verzeichnis heruntergeladen und nicht installiert:

featureManager install feature_shortName --downloadOnly --location=c:\temp\download --acceptLicense

Im folgenden Beispiel werden alle Abhängigkeiten aus Liberty Repositoryheruntergeladen:

featureManager install feature_shortName --downloadOnly=all --location=c:\temp\download --acceptLicense

Im folgenden Beispiel werden Features installiert, die sich in einem lokalen Verzeichnis befinden. Wenn Abhängigkeiten fehlen, werden sie aus Liberty Repositoryinstalliert:

featureManager install feature_shortName --location=c:\temp\download --acceptLicense

Im folgenden Beispiel werden Assets aus einem lokalen Verzeichnis installiert, ohne fehlende Abhängigkeiten aus Liberty Repositoryherunterzuladen:

featureManager install feature_shortName --location=c:\temp\download --offlineOnly

featureManager classpath --features=servlet-3.0 classpath.jar
javac -cp classpath.jar TestServlet.java

Im folgenden Beispiel wird ein Feature deinstalliert:

featureManager uninstall adminCenter-1.0