ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、こちらまでご連絡ください。

アプリのブラックリスト登録

バンドルブラックリストは、複数のアプリ、OSGiバンドル（モジュール）、WARプラグインを一度にアンインストールまたは再インストールする便利な方法です。これにより、アプリケーションマネージャーまたは Gogo シェルを使用して、アプリ、モジュール、プラグインのインストールを個別に管理する手間が省けます。

重要

ブラックリストは、DXP がアプリをアンインストールするために使用する OSGi 構成です。これを使用すると、リストされているアプリは削除されるまでインストールされなくなります。

リストは、コントロールパネルで設定するか、または OSGi 構成 (.config) ファイルを使用して (コントロールパネルからエクスポートして) 設定することができます。

ブラックリスト登録

DXPは、ブラックリストにあるインストール済みのアプリ、モジュール、プラグインをすべて削除します。ブラックリストに登録されている間はインストールできません。ログには、各アンインストールが記録されます。

注

LPKGをブラックリストに登録すると、その内部モジュールがすべてアンインストールされます。

コントロールパネルを介したブラックリスト登録

次の手順に従って、アプリ、モジュール、プラグインをブラックリストに登録します。

コントロールパネルで、構成 → システム設定 → モジュールコンテナーに移動します。［Bundle Blacklist］画面が表示されます。
バンドルブラックリスト画面で、アンインストールするアプリ、LPKG ファイル、モジュール JAR、または WAR のバンドルシンボリック名を追加します。各項目について、[追加] ボタン () をクリックし、項目のバンドルシンボリック名を入力します ( 下の表を参照)。完了したら、［保存］ボタンをクリックします。 DXPはブラックリストに登録された項目をすぐにアンインストールします。

構成ファイルによるブラックリスト登録

ブラックリストは、コントロールパネルからOSGi構成（.config）ファイルにエクスポートすることもできます。ファイルを変更してDXPにデプロイすると、次のような追加の効果があります。

DXPサーバーの起動時の変更を保持します
ローカルクラスターノードから他のすべてのノードに変更を伝播します。

次の手順に従って、構成ファイルを使用してブラックリストに登録します。

現在使用中のブラックリストをエクスポートするには、そのアクションボタン () をクリックし、 エクスポートをクリックします。ブラックリスト構成ファイルがダウンロードされます（com.liferay.portal.bundle.blacklist.internal.configuration.BundleBlacklistConfiguration.config）。次に、サンプルのブラックリストをエクスポートしたときのファイルの内容を示します。
```
blacklistBundleSymbolicNames=[ \
  "classic-theme", \
  "Liferay\ Collaboration\ -\ Liferay\ Blogs\ -\ API", \
  "com.acme.greeter", \
]
```
アンインストールして以降のDXPサーバーの起動時にインストールしないようにする、リストにまだないアプリ、モジュール、またはプラグインのバンドルシンボリック名を追加します。

警告

構成値に余分なスペースを含めることはできません。余分なスペースがあると、リストが短絡したり、構成エントリが無効になったりする可能性があります。
構成ファイルをデプロイするには、フォルダ[Liferay Home]/osgi/configsにコピーします。 Liferay Home フォルダは通常、アプリケーションサーバーの親フォルダです。

バンドルシンボリック名をブラックリストに追加

種類	バンドルのシンボリック名
アプリ	アプリマネージャーに表示されるアプリ名
LPKG	拡張子`.lpkg`なしのLPKGファイル名
モジュール/バンドルJAR	`bnd.bnd`または`MANIFEST.MF`ファイルの`Bundle-SymbolicName`
WAR	`liferay-plugin-package.properties`ファイル内のサーブレットコンテクスト名、またはサーブレットコンテクスト名プロパティがない場合はWARファイル名（`.war`を削除）

ブラックリスト登録されているアイテムの再インストール

ブラックリストに登録されたアイテムを再インストールするには、次の手順に従います。

構成ファイルcom.liferay.portal.bundle.blacklist.internal.configuration.BundleBlacklistConfiguration.configを開きます。
LPKG、モジュールJAR、またはWARのシンボリック名をblacklistBundleSymbolicNamesリストから削除し、ファイルを保存します。

ブラックリスト登録されているすべてのアイテムを再インストールするには、次のいずれかのオプションを実行します。

構成ファイルを削除します。
アプリケーションマネージャまたは Felix Gogo Shellを使用して、モジュール com.liferay.portal.bundle.blacklist をアンインストールします。

ヒント

ブラックリストに登録されたアイテムを一時的に再インストールするには、 システム設定 のバンドルブラックリストモジュールからそのシンボリック名を削除し、更新ボタンをクリックします。ブラックリスト設定ファイル（ [Liferay Home]/osgi/configs フォルダ内）を使用していて、次回のサーバー起動時にアイテムをインストールする場合は、ファイルからアイテムのシンボリック名を必ず削除してください。

ログには、各アイテムのインストールが記録されます。

　簡単なリストを使用して、複数のアプリ、モジュール、プラグインのインストールを管理できるようになりました。

Capability: