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

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 ファイルを使用して構成する必要があります。

以下は、com.liferay.portal.store.file.system.configuration.AdvancedFileSystemStoreConfiguration.configurationファイルの例で、rootDirパラメータが必要です：

rootDir="data/document_library"
データベースベンダーが推奨するJDBCデータベースドライバーを使用していることを確認してください。たとえば、MySQLを使用している場合は、new-version/files/portal-ext.propertiesで<0>jdbc.default.driverClassName=com.mysql.cj.jdbc.Driverを設定し、アプリケーションサーバーが使用するMySQL JDBCドライバーのJARを置き換えます。詳細については、データベースドライバを参照してください。
(オプション) 2026.Q1 より前のバージョンでは、を portal-ext.properties ファイルに追加して、バッチ挿入を有効にします。 2026年第1四半期以降、アップグレードツールはバッチ挿入の最適化のためにJDBC URLを自動的に再構成します。
以下のコマンドを使って、新しいバージョンのフォルダにマウントした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 Home へのファイルのマッピングの詳細については、コンテナへのファイルの提供を参照してください。

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

オプションとして、これらのパラメータを docker run コマンドに追加することで、アップグレードレポートおよびアップグレードログコンテキストを有効にできます。
```
-e LIFERAY_UPGRADE_PERIOD_REPORT_PERIOD_ENABLED=true \
-e LIFERAY_UPGRADE_PERIOD_LOG_PERIOD_CONTEXT_PERIOD_ENABLED=true \
-e LIFERAY_UPGRADE_PERIOD_REPORT_PERIOD_DIR={your_directory} \
```
REPORT_DIR パラメータは、アップグレードレポートの出力ディレクトリを定義します。何も設定されていない場合は、 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インスタンスを使用してください。アップグレードを完了するために他に何か必要なことがある場合は、以下の関連トピックを参照してください。