legacy-knowledge-base
公開されました Sep. 10, 2025

ポートレットを手動で削除する方法

written-by

Phil Chapman

How To articles are not official guidelines or officially supported documentation. They are community-contributed content and may not always reflect the latest updates to Liferay DXP. We welcome your feedback to improve How To articles!

While we make every effort to ensure this Knowledge Base is accurate, it may not always reflect the most recent updates or official guidelines.We appreciate your understanding and encourage you to reach out with any feedback or concerns.

legacy-article

learn-legacy-article-disclaimer-text

問題

  • ポートレットを完全に削除して、古いバージョンを再デプロイするにはどうしたら良いですか?
  • アプリケーションマネージャからポートレットをアンインストールしても、ブラックリストに登録されるだけで、アンインストールされません
  • Liferay のカスタムモジュールを削除するには、どうすればよいですか?

環境

  • DXP 7.0 DXP 7.1 DXP 7.2

解決

  • ポートレットを完全にアンインストールするには、ファイルシステムから .jar を削除するだけです。例えば、 ${liferay.home}/osgi/modulesからファイルを削除します。

  • 具体例

    A.) モジュールをデプロイする場合、 ${liferay.home}/deploy フォルダに配置することで、モジュールがデプロイされます。ログに STARTED メッセージが表示されています

    INFO [com.liferay.portal.kernel.deploy.auto.AutoDeployScanner][AutoDeployDir:271] Processing my-example-portlet.jar
    ................ STARTED my-example-portlet.jar


    B.) また、コントロールパネル > アプリ > アプリケーションマネージャー のUIでも、デプロイメントを確認できます

    port1.png

    C.) 三点ボタンをクリックすると無効にする またはアンインストールのオプションが表示されます

    アンインストール を選択すると、確認のためにOKボタンが表示されます

    ログでは、ポートレットがブラックリストに登録され、
    停止したことがわかります。

    INFO [CM Event Dispatcher (Fire ConfigurationEvent: pid=com.liferay.portal.bundle.blacklist.internal.BundleBlacklistConfiguration)][BundleBlacklist:188] Stopping blacklisted bundle my-example-portlet.jar

    INFO [CM Event Dispatcher (Fire ConfigurationEvent: pid=com.liferay.portal.bundle.blacklist.internal.BundleBlacklistConfiguration)][BundleStartStopLogger:49] STOPPED my-example-portlet.jar


    D.) コントロールパネル > 設定 > システム設定 > モジュール・コンテナー > バンドルブラックリスト に移動すると、ポートレットブラックリストのエントリが見つかります。

    port2.png

    バンドルシンボリック名をブラックリストに追加からmy-example-portletエントリを削除して 保存を押下すると、ポートレットが再インストールされて起動します。

    INFO [CM Event Dispatcher (Fire ConfigurationEvent: pid=com.liferay.portal.bundle.blacklist.internal.BundleBlacklistConfiguration)][BundleBlacklist:120] Reinstalling bundle my-example-portlet.jar

    INFO [CM Event Dispatcher (Fire ConfigurationEvent: pid=com.liferay.portal.bundle.blacklist.internal.BundleBlacklistConfiguration)][BundleStartStopLogger:46] STARTED my-example-portlet.jar

    これは ${liferay.home}/osgi/modules直下に my-example-portlet.jar がまだ存在しているためです

    Screen_Shot_2020-11-11_at_14.07.48.png

    さらに、 ${liferay.home}/osgi/state の内容を削除しても、ポートレットは上記の場所に存在している間は STOPPED のままです。


    まとめ
    ポートレットをアンインストールするには、 ${liferay.home}/osgi/modules から.jarファイルを削除してください。

 

追加情報

 

did-this-article-resolve-your-issue

legacy-knowledge-base