Liberty: featureManager コマンド

featureManager action [options]

ここで、action は、次のいずれかの値です。

install

安定化されたフィーチャー: このアクションは安定化されました。 .esa ファイルをインストールしない場合は、 installUtility install コマンドを使用します。 featureManager コマンドを使用して、 .esa ファイルをインストールします。

フィーチャーまたはエンタープライズ・サブシステム・アーカイブ (ESA) ファイルをランタイム環境にインストールします。

featureManager コマンドは、 Liberty Repositoryからアセットをダウンロードできます。 詳しくは、 Liberty Repository アセットのインストールを参照してください。

アンインストール

安定化されたフィーチャー: このアクションは安定化されました。 代わりに installUtility uninstall コマンドを使用してください。

フィーチャーのショート・ネームまたはフィーチャーのシンボル名のいずれかを使用してフィーチャーをアンインストールします。

注:

• フィーチャーをアンインストールする前には、必ず、すべてのサーバー・プロセスを停止してください。
• uninstall アクションは、ユーザー・フィーチャー (例えば、webCacheMonitor-1.0) をアンインストールできません。

featureList

インストールされているすべてのフィーチャーについて詳述するレポートを含む XML ファイルを生成します。

find

安定化されたフィーチャー: このアクションは安定化されました。 代わりに installUtility find コマンドを使用してください。

Liberty Repositoryのすべてのアセットのリストを生成するか、ご使用の構成に該当するアセットを Liberty Repository で検索するか、または詳細情報を表示します。

クラスパス

フィーチャー・リストからの API を使用するために、コンパイラー・クラスパスに追加できる JAR ファイルを生成します。 このアクションにより、フィックスパックの適用時に変更される可能性がある特定の JAR 名を参照することなく、製品に含まれている API JAR に対してビルド・スクリプトをコンパイルできます。 出力された JAR ファイルには、製品内の API JAR への相対パスが含まれます。 そのため、出力された JAR を別のディレクトリーに移動してはなりません。

注: このアクションでは、 --features オプションを指定する必要があります。

ヘルプ

指定したアクションのヘルプ情報を表示します。

featureManager install コマンドで使用可能なオプションは、以下のとおりです。

--acceptLicense

ライセンス条項に同意することを自動的に示します。

--downloadOnly=[all | required* | none]

要求したフィーチャーをインストールすることなくローカル・ディレクトリーにダウンロードします。 このオプションは、すべての依存関係フィーチャーをダウンロードするか、このランタイムに必要な依存関係フィーチャーをダウンロードするか、または依存関係フィーチャーを一切ダウンロードしないように構成できます。 デフォルトでは、必須の依存関係フィーチャーをダウンロードします。 --location オプションを使用してディレクトリーを指定します。

注： サブシステムのアーカイブの場所をファイル名または URL で指定した場合は、このオプションを使用できません。

- -location=directoryPath

フィーチャーのインストール時に、このオプションで、フィーチャーのインストール元として使用できるローカル・ソース・ディレクトリーを指定します。 --downloadOnly オプションとともに使用した場合、このオプションは、ダウンロードしたフィーチャーの宛先ディレクトリーを指定します。 --downloadOnly オプションおよび --offlineOnly オプションを使用する場合は、このオプションは必須です。

注： サブシステムのアーカイブの場所をファイル名または URL で指定した場合は、このオプションを使用できません。

--offlineOnly

Liberty Repositoryに接続しない場合は、このオプションを使用します。 このコマンドを使用した場合、ローカル・ディレクトリーからのフィーチャーのみがインストールされます。 ローカル・ディレクトリーは、--location オプションを使用して指定します。

注： サブシステムのアーカイブの場所をファイル名または URL で指定した場合は、このオプションを使用できません。

--to=install_option

ここで、install_option は、次のいずれかの値です。

• usr: フィーチャーはユーザー・フィーチャーとしてインストールされます。 これはデフォルト値です。
• extension: フィーチャーをインストールするロケーション。 構成済みの任意の製品拡張ロケーションにフィーチャーをインストールできます。

--viewLicenseAgreement

ご使用条件を表示します。

--viewLicenseInfo

ライセンス情報を表示します。

--when-file-exists=exist_option

インストールするファイルが既に存在している場合の処置を指定します。 exist_option は、次のいずれかの値です。

• fail: インストールを取り消します。
• ignore: インストールを続行し、既存のファイルは無視します。
• replace: 既存のファイルを上書きします。

--verbose

アクションの実行中に使用可能な追加情報を表示するには、このオプションを使用します。

名前

インストールする 1 つ以上のフィーチャーを、スペースまたはコンマで区切って指定します。 フィーチャーは以下の方法で指定できます。

フィーチャー ID

• フィーチャーのショート・ネームを指定します (例: adminCenter-1.0)。
• フィーチャーのシンボル名を指定します (例: com.ibm.websphere.appserver.adminCenter-1.0)。

.esa ファイル

• ファイル名を指定します (例: my_feature.esa)。
• URL を指定します (例: http://myhost.ibm.com/liberty/assets/my_feature.esa)。

このアクションは、ESA ファイルから OSGI-INF/SUBSYTEM.MF ファイルを新しいフィーチャー・マニフェストとして使用します。 フィーチャーは ${wlp.user.dir}/extensions/lib/features ディレクトリー (または、--to プロパティーの値が指定されている場合は製品拡張ディレクトリー) にコピーでき、サブシステムのシンボル名にちなんで名前変更されます。 サブシステムのすべてのバンドルが ${wlp.user.dir}/extensions/lib ディレクトリーに抽出され、{bundle symbolic name}_{bundle version}.jar と名前変更されます。 ライセンス・ファイル、チェックサム・ファイル、ローカリゼーション・ファイル、およびその他のサブシステム・コンテンツも、サブシステム・マニフェストで定義されたロケーションに抽出されます。

featureManager uninstall コマンドで使用可能なオプションは、以下のとおりです。

--noPrompts

ユーザーとの対話や確認メッセージなしでフィーチャーをアンインストールします。

--verbose

アクションの実行中に使用可能な追加情報を表示するには、このオプションを使用します。

名前

アンインストールする 1 つ以上のフィーチャーを指定します。名前はスペースまたはコンマで区切ります。 以下のオプションを指定できます。

• サブシステム・アーカイブ (ESA ファイル) のショート・ネーム。例: adminCenter-1.0
• サブシステム・アーカイブ (ESA ファイル) のシンボル名。例: com.ibm.websphere.appserver.adminCenter-1.0

featureManager featureList コマンドで使用可能なオプションは、以下のとおりです。

--encoding=文字コード

ここで、charset は、XML レポート・ファイルの作成時に使用する文字セットです。

--locale=言語

ここで、language は、XML レポート・ファイルの作成時に使用する言語を指定します。 これは、ISO-639 の小文字 2 文字の言語コードと、オプションで、その後に下線と ISO-3166 の大文字 2 文字の国別コードから構成されます。

- -productExtension=name

ここで name は、フィーチャーをリストする製品拡張の名前です。 製品拡張がデフォルト・ユーザー・ロケーションにインストールされている場合は、キーワード usrを使用します。 このオプションを指定しない場合、アクションは WebSphere® Application Server Liberty Coreに対して実行されます。

XML_report_file_name

作成する XML レポート・ファイルの名前を指定します。

--verbose

アクションの実行中に使用可能な追加情報を表示するには、このオプションを使用します。

featureManager find コマンドで使用可能なオプションは、以下のとおりです。

--viewInfo

詳細情報を表示します。

--verbose

アクションの実行中に使用可能な追加情報を表示するには、このオプションを使用します。

searchString

ご使用の構成に適用可能な Liberty Repository アセットのリストを生成します。

featureManager classpath コマンドで使用可能なオプションは、以下のとおりです。

-- features=feature1、feature2、...

API JAR ファイルのリストが含まれているフィーチャーのリスト。 classpath アクションでは、このオプションは必須です。

fileName

生成される JAR ファイルの名前。

以下の例では、 サブシステム・アーカイブ my_feature.esa をユーザー・フィーチャーとしてインストールします。

featureManager install my_feature.esa --to=usr

以下の例では、 サブシステム・アーカイブ my_feature.esa を my_extension の製品拡張ロケーションにインストールします。

featureManager install my_feature.esa --to=my_extension

以下の例では、 インストールされているすべてのフィーチャーに関するレポートを生成します。 このレポートは、ブラジル・ポルトガル語を使用してファイル my_feature_report.xml に作成されます。

featureManager featureList my_feature_report.xml --locale=pt_BR

以下の例では、ランタイム環境で usr 製品拡張と呼ばれる、デフォルトのユーザー・ロケーション wlp/usr/extensionにインストールされている製品拡張で定義されているすべてのインストール済みフィーチャーを含むレポートを生成します。 このレポートは、ファイル my_feature_report.xml に作成されます。

featureManager featureList --productExtension=usr my_feature_report.xml

次の例は、xml-ph-0000@deepl.internal ディレクトリにある製品インストール用の .properties ファイル内のコンテンツが指し示す場所にインストールされた製品拡張で定義されているすべての機能を含むレポートを生成します。 productExtensionName。プロダクトインストールディレクトリ内の etc/extensions ディレクトリにある.propertiesファイル内のコンテンツが指し示す場所にインストールされている製品拡張で定義されているすべての機能が含まれています。 このレポートは、ファイル my_feature_report.xml に作成されます。

featureManager featureList --productExtension=productExtensionName my_feature_report.xml

以下の例では、 install アクションのヘルプ情報を表示します。

featureManager help install

以下の例では、フィーチャーをインストールし、追加情報を組み込みます。

featureManager install extendedPackage-1.0 --verbose

以下の例では、ご使用の構成に適用可能なアセットを検索します。

featureManager find searchString

以下の例では、詳細情報をリストします。

featureManager find searchstring --viewInfo

以下の例では、フィーチャーを検索し、追加情報を組み込みます。

featureManager find "adminCenter-1.0" --verbose

以下の例では、必要な依存関係を Liberty Repository からローカル・ディレクトリーにダウンロードしますが、インストールしません。

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

以下の例では、 Liberty Repositoryからすべての依存関係をダウンロードします。

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

以下の例では、ローカル・ディレクトリーにあるフィーチャーをインストールします。 欠落している依存関係がある場合、それらは Liberty Repositoryからインストールされます。

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

以下の例では、欠落している依存関係を Liberty Repositoryからダウンロードせずに、ローカル・ディレクトリーからアセットをインストールします。

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

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

以下の例では、フィーチャーをアンインストールします。

featureManager uninstall adminCenter-1.0