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

Docker経由のアップグレード

自動アップグレードを有効にしてLiferay Dockerイメージを実行すると、Liferay起動時にデータベースアップグレードツールを使用して明白にデータベースをアップグレードします。アップグレードが完了したら、その Docker コンテナ経由で Liferay を引き続き使用していくか、新しい Liferay オンプレミスインストールをアップグレードしたデータベースにポイントすることができます。

重要

Dockerをお持ちでない場合、まずここにアクセスしてください: https://docs.docker.com/get-docker

DXP版	イメージ	タグ
Liferay DXP（サブスクリプション）	`dxp`	ここ
Liferay Portal	`portal`	ここ

重要

エンタープライズサブスクライバーのインストールおよびクリティカルインストールへのアップグレードは、データベースアップグレードツールを使用して行う必要があります。詳細については、「データベースアップグレードツールの使用」を参照してください。

重要

アップグレードする前に、必ずデータベースと既存のインストールを バックアップしてください。バックアップコピーでアップグレードプロセスをテストすることをお勧めします。

最新のDockerイメージによるアップグレード

Dockerイメージを使用してアップグレードする手順は次のとおりです。

新しいLiferay Dockerイメージで使用する任意のフォルダを作成し、filesとdeployというサブフォルダを作成します。例えば、
```
mkdir -p new-version/files
```
```
mkdir -p new-version/deploy
```
- ファイル: Dockerコンテナは、このフォルダからコンテナの Liferay Home フォルダにファイルをコピーします。
- deploy: Dockerコンテナは、このフォルダからコンテナの自動デプロイ用フォルダにアーティファクトをコピーします。
Liferay Commerce を使用している場合は、アップグレードの準備をしてください。詳細については、「 Liferay Commerce のアップグレード」を参照してください。
Liferay データベースのアップグレードと同時に Marketplace アプリのデータをアップグレードする場合は、新しい Liferay バージョンを対象とする各アプリの最新バージョンをダウンロードし、それを new-version/deploy フォルダにコピーします。それ以外の場合は、データベースのアップグレード後にアプリをインストールし、「アップグレード後の考慮事項」の説明に従ってデータをアップグレードできます。
埋め込みの Elasticsearch エンジンまたはローカルのファイルストア（ドキュメントライブラリ）を使用している場合は、 [Liferay Home]/data フォルダを新しい files フォルダにコピーして、 new-version/files/dataを作成します。
バックアップから Liferay Home ファイルとアプリケーションサーバーファイルをコピーして、 ファイル フォルダ（新しい [Liferay Home]）内の対応する場所にマージします。例えば、アクティベーションキーをnew-version/files/license/にコピーします。ファイルには次のものが含まれる場合がありますが、これらに限定されません。
- /license/*：アクティベーションキー。 (サブスクリプション)
- /log/*：ログファイル。
- /osgi/configs/*.config: OSGi 構成ファイル。カスタム構成ファイルのみをコピーします。 Liferay によって生成された *-default.config ファイルは含めないでください。
- portal-*.properties: ポータルプロパティファイル ( portal-ext.propertiesなど)。
- setenv.sh、startup.shなど：アプリケーションサーバーの設定スクリプト。
- web.xml：ポータルWebアプリケーション記述子。
7.2 にアップグレードする場合は、 [Liferay Home]/files/osgi/config/ フォルダ内の設定ファイルを使用して、検索インデックスを無効にします。例えば、
```
echo "indexReadOnly=\"true\"" >> new-version/files/osgi/config/com.liferay.portal.search.configuration.IndexStatusManagerConfiguration.config
```
変更された保存場所を持つ Advanced File System Store または Simple File System Store を使用している場合は、ファイルストア設定を .config ファイルにエクスポートし、それを new-version/osgi/configs フォルダーにコピーします。

重要

Advanced File System Storeを使用している場合は、データベースをアップグレードする前に、新しいインストールで .config ファイルを使用して構成する必要があります。

以下は、必要な rootDir パラメータを含む com.liferay.portal.store.file.system.configuration.AdvancedFileSystemStoreConfiguration.config ファイルの例です。

rootDir="data/document_library"
データベースベンダーが推奨するJDBCデータベースドライバーを使用していることを確認してください。たとえば、MySQLを使用している場合は、new-version/files/portal-ext.propertiesで<0>jdbc.default.driverClassName=com.mysql.cj.jdbc.Driverを設定し、アプリケーションサーバーが使用するMySQL JDBCドライバーのJARを置き換えます。詳細については、データベースドライバーを参照してください。
(オプション) JDBC プロパティを portal-ext.properties ファイルに追加して、バッチ挿入を有効にします。
次のコマンドを使用して、新しいバージョンのフォルダーにマウントされた Docker イメージを実行します。必要に応じて、イメージ名、タグ、環境値を差し替えてください。
```
docker run -it -m 8g -p 8080:8080 \
 -v $(pwd)/new-version:/mnt/liferay \
 -e LIFERAY_UPGRADE_PERIOD_DATABASE_PERIOD_AUTO_PERIOD_RUN=true \
 liferay/[place image name here]:[place tag here]
```
-v new-version:/mnt/liferayの引数は、ホストのnew-versionフォルダをコンテナの/mnt/liferayフォルダにバインドマウントします。コンテナの Liferay ホームへのファイルのマッピングの詳細については、コンテナへのファイルの提供を参照してください。

パラメータ -e LIFERAY_UPGRADE_PERIOD_DATABASE_PERIOD_AUTO_PERIOD_RUN=true は、起動時にデータベースのアップグレードが自動的に実行されるようにトリガーします。

オプションで、アップグレードレポートはパラメータ -e LIFERAY_UPGRADE_PERIOD_REPORT_PERIOD_ENABLED=true で有効にでき、アップグレードログコンテキストはパラメータ LIFERAY_UPGRADE_PERIOD_LOG_PERIOD_CONTEXT_PERIOD_ENABLED=trueで有効にできます。アップグレードレポートの出力ディレクトリを定義するには、パラメータ LIFERAY_UPGRADE_PERIOD_REPORT_PERIOD_DIR={your_directory} を使用します。何も設定されていない場合は、 Liferay_Home/reports がデフォルトのレポートディレクトリになります。
コンソールまたはログで、データベースのアップグレードとサーバーの起動が成功したことを確認します。アップグレードメッセージに、各アップグレードプロセスの開始と完了が表示されます。次のようなメッセージは、サーバーの起動が完了したことを示しています。
```
org.apache.catalina.startup.Catalina.start Server startup in [x] milliseconds
```
アップグレードの失敗やエラーが発生した場合は、コンソールやログに出力されます。 Gogo Shell コマンドを使用して、問題をトラブルシューティングし、アップグレードを完了できます。

さらに、起動時に実行されるこれらのアップグレードは、MBeans で監視できます。
障害やエラーを解決したら、アップグレード後の考慮事項を調べてください。
新しいインストールでポータルのプロパティを更新します
アップグレードしたデータベースを検証します。

データベースのアップグレードが完了しました。

Docker経由で新しいLiferayバージョンを引き続き使用したい場合は、 -e LIFERAY_UPGRADE_PERIOD_DATABASE_PERIOD_AUTO_PERIOD_RUN=true 環境設定を docker run ...から削除します。新しいコンテナを作成するために使用したコマンド。

注

Liferay Docker イメージの使用では、Docker コンテナの作成、停止、再起動について説明します。

アップグレードされたデータベースで十分な場合は、新しいLiferayインスタンスを使用してください。アップグレードを完了するための手順がさらにある場合は、以下の関連トピックを参照してください。