Liferay Portalを正しくシャットダウンせずにパッチをインストールすると、Portalのファイルが破損する。

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

patching-tool version 20以下を使用する場合、ポータルが完全にシャットダウンされていない状態でパッチをインストールすると、ポータルファイルの破損が発生することがあります。

このため、パッチをインストールする前に、必ずポータルを完全にシャットダウンすることが重要です。

注）パッチツールバージョン21で解決します。

解像度

万が一、この問題が発生した場合、一般的なケースでは、以下のような回避策があります。

1. クリーンバンドルをダウンロードする。
2. 影響を受ける環境にインストールされていたパッチと同じものを適用する。
3. アプリケーションサーバーをシャットダウンする
4. クリーンバンドル（パッチが適用された状態）から、以下のファイルを対象環境にコピーします：

   TOMCAT_HOME/webapps/ROOT/WEB-INF/patching-backup-deps.zip

   TOMCAT_HOME/webapps/ROOT/WEB-INF/patching-backup.zip

5. ./patching-tool.sh revert を対象環境で実行し、元のファイルを復元します。

   Windows マシンの環境の場合、 patching-tool revert を実行してください。

6. 実行 ./patching-tool.sh install

   patching-tool install for Windows を実行します。

7. サーバーを起動し、問題が解決していることを確認します。

追加情報

本現象の具体的な発生例と、より具体的な解決策については、以下の記事をご参照ください： パッチツールでパッチインストール後にDockbar表示エラーが発生する.