Docker経由のアップグレード

自動アップグレードを有効にしてLiferay Dockerイメージを実行すると、Liferay起動時にデータベースアップグレードツールを使用して明白にデータベースをアップグレードします。 アップグレードが完了した後、そのDockerコンテナを介してLiferayの使用を継続するか、またはアップグレードされたデータベースに新しいLiferayオンプレミスインストールを指定できます。

important

Dockerをお持ちではありませんか？ まずは以下をご確認ください：

• Linux
• Windows
• OSX

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

important

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

important

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

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

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

1. 新しいLiferay Dockerイメージで使用する任意のフォルダを作成し、filesとdeployというサブフォルダを作成します。 例えば、

   mkdir -p new-version/files
   

   mkdir -p new-version/deploy
   

   • files: Dockerコンテナはこのフォルダからコンテナの Liferay Home フォルダにファイルをコピーします。

   • deploy: Dockerコンテナは、このフォルダからコンテナの自動デプロイ用フォルダにアーティファクトをコピーします。

2. Commerce を使用している場合は、Commerceをアップグレードする準備をしてください。 詳細については、 Liferay Commerceのアップグレード を参照してください。

3. Liferayデータベースのアップグレードと一緒にマーケットプレイスアプリのデータをアップグレードする場合は、新しいLiferayバージョンの対象となる各アプリの最新バージョンをダウンロードして、new-version/deployフォルダにコピーします。 それ以外の場合は、 アップグレード後の考慮事項 で説明されているように、データベースのアップグレード後にアプリをインストールし、データをアップグレードできます。

4. 組み込みのElasticsearchエンジンまたはローカルのファイルストア\（ドキュメントライブラリ\）を使用している場合は、[Liferay Home]/dataフォルダを新しいfilesフォルダにコピーしてnew-version/files/dataを作成します。

5. Liferay Homeのファイル と アプリケーションサーバーファイル をバックアップからfilesフォルダ内の対応する場所（新しい[Liferay Home]）にコピーしてマージします。 例えば、アクティベーションキーをnew-version/files/license/にコピーします。 ファイルには次のものが含まれる場合がありますが、これらに限定されません。

   • /license/*：アクティベーションキー。 (サブスクリプション)

   • /log/*：ログファイル。

   • /osgi/configs/*.config：OSGiの設定ファイル。

   • portal-*.properties：ポータルプロパティファイル（例：portal-ext.properties）。

   • setenv.sh、startup.shなど：アプリケーションサーバーの設定スクリプト。

   • web.xml：ポータルWebアプリケーション記述子。

6. 7.2にアップグレードする場合は、[Liferay Home]/files/osgi/config/フォルダにある構成ファイルを使用して検索インデックスを無効にします。 例えば、

   echo "indexReadOnly=\"true\"" >> new-version/files/osgi/config/com.liferay.portal.search.configuration.IndexStatusManagerConfiguration.config
   

7. 高度なファイルシステムストアまたは簡易ファイルシステムストアを使用していて、保存場所を変更している場合は、ファイルストアの設定を .configファイル にエクスポートして、new-version/osgi/configsフォルダにコピーします。

   important

   高度なファイルシステムストアを使用している場合は、データベースをアップグレードする前に、新しいインストールで.configファイルを使って設定する必要があります。

   以下に例を示します。com.liferay.portal.store.file.system.configuration.AdvancedFileSystemStoreConfiguration.config file with the required rootDir parameter:

   rootDir="data/document_library"

8. データベースベンダーが推奨するJDBCデータベースドライバーを使用していることを確認してください。 たとえば、MySQLを使用している場合は、new-version/files/portal-ext.propertiesで<0>jdbc.default.driverClassName=com.mysql.cj.jdbc.Driver</0>を設定し、アプリケーションサーバーが使用するMySQL JDBCドライバーのJARを置き換えます。 詳細は、 Database Drivers を参照してください。

9. (オプション) JDBCプロパティを portal-ext.propertiesファイルに追加して、 バッチインサートを有効 にしてください。

10. 新しいバージョンのフォルダにマウントされた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 パラメータを指定すると、データベースのアップグレードが起動時に自動的に実行されます。

    オプションとして、 アップグレードレポート は、パラメータ -e LIFERAY_UPGRADE_PERIOD_REPORT_PERIOD_ENABLED=true で有効にでき、 アップグレードログコンテキスト は、パラメータ LIFERAY_UPGRADE_PERIOD_LOG_PERIOD_CONTEXT_PERIOD_ENABLED=trueで有効にできます。

11. コンソールまたはログで、データベースのアップグレードとサーバーの起動が成功したことを確認します。 アップグレードメッセージに、各アップグレードプロセスの開始と完了が表示されます。 次のようなメッセージは、サーバーの起動が完了したことを示しています。

    org.apache.catalina.startup.Catalina.start Server startup in [x] milliseconds
    

    アップグレードの失敗やエラーが発生した場合は、コンソールやログに出力されます。 Gogo Shellコマンドを使用して、それらの問題をトラブルシューティングし、アップグレードを完了できます。

    さらに、起動時に実行されるこれらのアップグレードは、MBeansで監視することができる。

12. 障害やエラーを解決した後、アップグレード後の検討事項を調べます。

13. 新しいインストール先で ポータルのプロパティを更新 します。

14. アップグレードしたデータベースを検証します。

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

新しいLiferayバージョンをDocker経由で使い続けたい場合は、 -e LIFERAY_UPGRADE_PERIOD_DATABASE_PERIOD_AUTO_PERIOD_RUN=true環境設定を、新しいコンテナの作成に使用するdocker run ...コマンドから外してください。

note

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

まとめ

アップグレードされたデータベースで十分な場合は、新しいLiferayインスタンスを使用してください。 アップグレードを完了するためにまだ必要なものがある場合は、これらの記事を参考にしてください。

• アップグレードの基本では、アップグレードに関するすべてのトピックについて説明しています。 まだ対処しなければならないトピックが見つかるかもしれません。

• データベースアップグレードオプション では、さまざまな DXP/Portal インストール タイプのコンテキストで、データベースをアップグレードするすべての方法について説明されています。

• データベースアップグレードツールの使用では、Liferayサーバーのオフライン時にデータベースをアップグレードする方法を示しています。 アップグレードに時間がかかりすぎる場合は、データベースの調整、 不要なデータの削除、データベース アップグレード ツールの使用を検討してください。

• カスタム開発のアップグレードでは、カスタムプラグインコードを新しいLiferayバージョンに適応させる方法を示しています。

• クラスター化されたインストールの維持では、クラスター環境でアップグレードする方法について説明しています。

• アップグレードのトラブルシューティング