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

以前のバージョンへのパッチのインストール

購読者

パッチツールは、Liferay DXP 7.3 SP3 より前のバージョンにフィックスパック (セキュリティフィックスパックおよびサービスパックを含む) を適用します。また、任意のDXPバージョンのホットフィックスも適用されます。

注

Liferay DXP 7.3 SP3+ にアップデート (またはセキュリティアップデート) を適用する場合は、 Liferay のアップデートを参照してください。

DXPバンドルとDXPアプリケーションサーバーのインストールのパッチ適用手順は似ています。 DXPバンドルには事前設定されたパッチツールが含まれているため、パッチをすぐに適用できます。ただし、DXPアプリケーションサーバーのインストールでは、パッチを適用する前にパッチツールをインストールして構成する必要があります。

警告

パッチを適用する前に、必ず データベースとインストールをバックアップしてください。

注

DockerコンテナでDXPを実行している場合は、 DockerでのDXPのパッチ適用の手順に従ってください。

DXPバンドルにパッチを適用する場合は、以下の基本的なパッチ適用手順に進んでください。アプリケーションサーバーで DXP にパッチを適用する場合は、パッチ適用手順を実行する前に、追加の準備を 行ってください。

パッチ適用手順

パッチを patching-tool/patches フォルダ—にダウンロードしてください。パッチを解凍しないでください。
- 修正パックとサービスパックは、ヘルプセンターのダウンロードページにあります。
- ホットフィックスはヘルプセンターのチケットにあります。
アプリケーションサーバーをシャットダウンします。 Unixスタイルのシステムでは、通常、実行中のファイルを置き換えることができますが、古いファイルはメモリに常駐します。 Windowsシステムでは、使用中のファイルはロックされており、パッチを適用できません。

patching-tool フォルダーからパッチングツールの install コマンドを実行して、パッチをインストールします。

cd patching-tool
./patching-tool.sh install

出力は次のようになります。

There's no configuration available. Running auto-discovery in the parent folder.
Directory is not set in command line, using ../
Auto discovery looks for portal segments. The selected directory is "/home/russell/liferay-bundles/cross-cluster-replication_7.2_LRDOCS-8715/liferay-dxp-7.2.10.3-sp3".
Configuration has been written into the default.properties:
patching.mode=binary
war.path=../tomcat-9.0.33/webapps/ROOT/
global.lib.path=../tomcat-9.0.33/lib/ext/
liferay.home=../
One patch is ready to be installed. Applying dxp-10...
Cleaning up: [1%..10%..20%..30%..40%..50%..60%..70%..80%..90%..100%]
Installing patches: [1%..10%..20%..30%..40%..50%..60%..70%..80%..90%..100%]
Syncing...
The patches contain database index modification. Run the patching tool with the index-info parameter for more information.
The installation was successful. One patch is installed on the system.

info コマンドを実行し、現在インストールされているパッチの情報を確認して、インストールされているパッチを確認します。

./patching-tool.sh info

出力には、現在インストールされているパッチが一覧表示されます。

Loading product and patch information...
Product information:
* installation type: binary
* build number: 7210
* service pack version:
   - available SP version: 3
   - installable SP version: 3
* patching-tool version: 2.0.15
* time: 2021-01-21 18:02Z
* host: russell-pc (8 cores)
* plugins: no plugins detected
Currently installed patches: dxp-10-7210
Available patches: dxp-8-7210, dxp-10-7210
Detailed patch list:
[ -] dxp-8-7210 :: Currently not installed; Won't be installed: dxp-10 contains the fixes included in this one :: Built for LIFERAY
[*I] dxp-10-7210 :: Installed; Will be installed. :: Built for LIFERAY

全てのDXPキャッシュを消去します。

[Liferay Home]/osgi/stateフォルダーを削除します。
```
cd [Liferay Home]
rm -rf osgi/state
```
[Liferay Home]/work フォルダーを空にします。
```
rm -rf work/*
```
アプリケーションサーバーのキャッシュを削除します。キャッシュの場所については、アプリケーションサーバーベンダーのドキュメントを参照してください。

注

モジュールの変更が内部のみである場合、変更はOSGiフレームワークからは見えず、モジュールはインストールされたままであり、モジュールの状態は保持されます。次のDXP起動の前にOSGiバンドルの状態情報をクリアすると、そのようなモジュールが適切な状態で再インストールされます。
パッチのリリースノートにマイクロまたはマイナーなスキーマ/データの変更が記載されている場合は、データベースアップグレードツールを使用して、マイナーな変更 (必須) と必要なマイクロの変更を適用します。

重要

Liferay DXP 7.2 GA1またはフィックスパック1からDXP 7.2 SP1 / フィックスパック2（またはそれ以降）に更新する場合は、データベースアップグレードツールを使用してデータとデータベースを更新する必要があります。
DXPの web.xml ファイルをカスタマイズした場合は、カスタマイズ内容をフィックスパックに含まれる新しい web.xml ファイルにマージします。フィックスパックは常に既存の web.xml ファイルを上書きします。
パッチにインデックスの更新がある場合は、起動時にインデックスを更新するようにDXPを構成します。

info コマンドを使用して、インデックスの更新を確認します。
```
cd patching-tool
./patching-tool.sh info
```
インデックスの更新がある場合は、 database.indexes.update.on.startup ポータルプロパティを true に portal-ext.properties ファイルで設定します。
```
database.indexes.update.on.startup=true
```
LIFERAY_ OR IX_ で始まるインデックスのみが更新されます。カスタムインデックスがこの命名規則を使用していないことを確認してください。
DXP 7.3 をアプリケーションサーバーに再インストールする場合は、パッチを適用した DXP アプリケーションを一時的な場所から ZIP して .war ファイルに戻し、そのファイルをアプリケーションサーバーにコピーします。アプリケーションサーバーについては、 DXP インストール手順を参照してください。
アプリケーションサーバーを再度起動します。

　 DXPインスタンスにパッチが適用され、実行されています。

注

パッチがインストールされない場合、または発生したエラーを解決できない場合は、ヘルプセンターチケットを開き、 ./patching-tool.sh info > output.txt を実行して完全なパッチツール info 出力を提供し、 output.txt ファイルをチケットに添付してください。

アプリケーションサーバーでDXPにパッチを適用する準備

アプリケーションサーバーにDXPをインストールした場合は、以下の準備を行ってください。

DXP 7.3 にパッチを適用する場合、それが .war ファイルとして展開されている場合は、 .war をパッチ適用用の一時的な場所に解凍してください。
パッチツールをまだインストールしていない場合はインストールしてください。
auto-discovery コマンドを実行して、DXP インストール用にパッチングツールを構成します。
```
cd patching-tool
./patching-tool.sh auto-discovery
```
DXP 7.3にパッチを適用する場合は、パッチツールのwar.pathプロパティ（たとえば、default.properties）を解凍したDXP .warの場所に設定します。
前のセクションのパッチ適用手順を続行します。