多くのお客様にとって、Liferayプラットフォームのアップグレードは、ユーザー、管理者、開発者にとって大きな前進となります。 アップグレードは、最新機能を備えた「最新・最高」バージョンのLiferayプラットフォームを提供するだけでなく、お客様のLiferay環境に対する継続的なサポートを保証します。
Liferayサポートは、アップグレードには時間、計画、リソースの多大な投資が必要であり、複数のチームの調整と厳しいスケジュールが必要になる可能性が高いことを認識しています。 この記事は、Liferay Portal 6.2へのアップグレードの準備と実行を支援するためのもので、Liferayユーザーガイドよりも迅速な（包括的ではないものの）記事とすることを意図しています。
解像度
ほとんどの場合、Liferayプラットフォームのアップグレードで最も要求の高いタスクは、すべてのカスタムフック、テーマ、プラグインの開発、再構築、テストです。 Liferay Portalの新バージョンにはLiferay APIへの変更があり、それに伴うアップデートには数週間、数ヶ月、またはそれ以上かかることがあります。
この再構築に最も時間がかかるため、多くのお客様はすぐにカスタマイズの更新作業を開始し、同時にデータベースとコアデータを使用してテスト環境でアップグレードの手順を実行します。
プリアップグレード
以下は、Liferay Portalのアップグレードの準備と実行の手順です。 本番で使用する前に、テスト環境でこれらの手順を検証することを強くお勧めします。 なお、スムーズなアップグレードのためには、環境に応じた計画や分析が重要です。
1. データのバックアップ
アップグレードの準備として最も重要なことは、データベース、ドキュメント、メディア、その他アップグレード前の状態に環境を復元するために必要なデータをバックアップしておくことです。 これは、テストアップグレードと本番環境のアップグレード時の両方で行う必要があります。
データのバックアップに加え、データベース、ドキュメント・ライブラリ、その他ポータルのあらゆる側面を元に戻すためのロールバック・プランがチームにあることを確認してください。 また、サーバーのキャッシュをクリアすることも、ロールバックプランの一部として覚えておいてください。
2. ポータルの動作確認
現在の環境におけるデータの問題は、アップグレードを試みる前に、当社のサブスクリプションサービスチームの助けを借りて解決してください。
3. アクティベーションキーを取得する
オーダーIDを使用して6.2インスタンス を登録する予定の場合、ステップ4までスキップできます。 Liferay の 6.1 以前のバージョンからアップグレードする場合、 アクティベーションキーをリクエストする必要があります。
4. Liferay 6.2 のダウンロード
アップグレードは、お客様のご要望に応じて、以下の2つの方法で行うことができます。
- Liferay 6.2 Bundle
- Liferay 6.2 WAR (および依存関係)
各オプションのアップグレード方法は、以下に記載します。
5. アップグレードの権限アルゴリズム（6.0以前からのアップグレードの場合）
Liferay 6.2にアップグレードする前に、Liferayインスタンスがパーミッションのアルゴリズムが6で動作している必要があります。 Liferay 6.0または6.1からアップグレードした場合、デフォルトのアルゴリズムは6なので設定されているはずです（不明な場合は、 portal-ext と portal.properties を確認してください。）。
ただし、6.0以前からのアップグレードの場合は、追加の手順が必要です：
- (オプション)パーミッションのアップグレードを高速化するために、マルチバリューマップをディスクではなく、メモリに保存するように切り替えます。 詳細はこちらでご確認ください： Permission Algorithm 6へのアップグレードについて.
- Liferay 6.0へのアップグレード
- システムを見直し、権限が正しく機能していることを確認する。
- 管理者として、 コントロールパネル > サーバー管理 > データ移行に移動します。
- (必要に応じて) レガシーな権限アルゴリズムの変換の下に、 カスタムロールの生成をチェックします。
- Generate Custom Roles チェックボックスは、特定のユーザーに付与される権限をシミュレートするために存在します（アルゴリズム5と6は、ユーザーレベルでの権限追加をサポートしていないため）。
- 実行 をクリックし、パーミッションのアップグレードを実行させます。
- サーバーを再起動します。
この時点で、役割をテストして "クリーンアップ "するのは、 必須の。
5.5 イメージギャラリーのアップグレードに関する注意事項
Liferay 6.1からは、イメージギャラリーとドキュメントライブラリが統合され、 Documents and Media ポートレットとなりました。 イメージのアップグレードに特別な操作は必要ありません。 6.2 portal-ext.properties ファイルに、以前の画像保存方法に適したポータルプロパティが含まれていることを確認するだけでよいでしょう：
image.hook.impl=com.liferay.portal.image.DatabaseHook
image.hook.impl=com.liferay.portal.image.DLHook
image.hook.impl=com.liferay.portal.image.FileSystemHook
デフォルトでは、Liferay 6.0 は FileSystemHookを使用しました。 このプロパティをインストール用にカスタマイズしたことがない場合は、上記の FileSystemHook プロパティを使用することになります。 プロパティをカスタマイズした場合、どのプロパティを使用したかわかるはずで、それは portal-ext.properties ファイルにすでに含まれていると思われます。
FileSystemHookを使用している場合は、 portal-ext.properties ファイルに画像のルートディレクトリも指定する必要があります。 これにより、 FileSystemHook で、他のフックからのデータ移行が可能になります。 ここでは、デフォルトのプロパティ設定を紹介します：
code>image.hook.file.system.root.dir=${liferay.home}/data/images
6. portal-ext.propertiesを用意する。
過去に設定されたプロパティによっては、古い portal-ext.properties を新しいバンドル/アプリサーバーにコピーするだけで良い場合もあります。 しかし、Liferay 6.2のデフォルトのプロパティ設定に対するいくつかの変更を確認する価値はあります（詳しくは、 Developer Network セクション、 Review the Liferay 6.2 Properties Defaults、を参照してください）。 legacy.properties のプロパティが新バージョンで変更または削除されている場合には、旧バージョンから追加する必要があるかもしれません。
7. アプリケーションサーバーを準備する
a.) バンドル
- data」フォルダの中身を新しいバンドルにコピーします。
- ドキュメントがここに保存されている場合、または他のファイルストアを使用している場合は、この必要はありません。
- 以前の環境でインストールされた、追加の必要な.jarをインストールします。
- Patching Toolを使用して、カスタマーポータルから最新のフィックスパックを導入します。
b.) WARファイル（マニュアル）
- アプリケーションサーバーが Liferay 6.2 に対応していることを確認してください。
- 注：特定のアプリケーションサーバーがLiferay 6.2をサポートしておらず、サポートを受け続けたい場合は、社内のITスタッフおよびアカウントマネージャーと協力して、受け入れ可能な解決を図ってください。
- アプリケーションサーバーが変わらないのであれば、 アンデプロイ 旧バージョンのLiferay Portal
- 依存関係
.jarsを配置します。 - 同じアプリケーションサーバーを使用している場合、アプリケーションサーバーから古い依存ファイルを削除する必要があります。
- アプリサーバーに関連するその他の手順を完了します（この記事の範囲外です）。
- 新しい Liferay Portal
.warファイルをデプロイする。 - Patching Toolを使用して、カスタマーポータルから最新のフィックスパックを導入します。
アップグレード
8. Liferayの開始
portal-ext.propertiesを介して古いデータベースを指すと、Liferay Portal は自動的に以前のバージョンを検出し、適切なアップグレードクラスを実行してデータベースを Liferay Portal 6.2 に変換します。
ポストアップグレード
9. 再インデクス
コントロールパネル → サーバー管理 に移動し、 すべての検索インデックスの再作成をクリックします。
10. プラグインの再デプロイ
- Liferay Marketplaceに移動します。
- 過去にインストールしたすべてのプラグインの6.2バージョンをダウンロードする。
- すべての（カスタマイズされた、マーケットプレイスの）6.2プラグインをLiferayにデプロイする。
11. 新しい6.2バージョンのテスト
ポータルを最初に閲覧した後、QAチームにテストを実行させ、すべてがアップグレードに耐え、機能していることを確認します。 また、期待通りの環境を実現するためには、パフォーマンステストも重要です。 なお、この新しいバージョンのLiferayでは、チューニングが必要になる場合があります。
ゲストが閲覧可能なウェブコンテンツについて： 6.2 SP9より、これまでゲストが閲覧可能だったウェブコンテンツが、ゲストが閲覧できなくなりますのでご注意ください。 ゲストがウェブコンテンツを再度閲覧できるようにするには、以下の記事の手順に従ってください。Web Content Permission Change Starting With 6.2 SP9
追加情報
アップグレードに失敗した場合、同じデータベースでアップグレードを続行しないでください。 まず根本的な問題を解決し、バックアップしたバージョンのデータベースでもう一度アップグレードを試みてください。
*quartz_ tablesにデータがある場合、Liferay Portal 6.0 ユーザーは Quartz Portlet を利用して、スケジュールされたジョブをアップグレードバージョンに移行することができます。
アップグレードでお困りですか？ Liferay Global Servicesは、お客様のニーズに合わせたソリューションを提供します。 無料相談はこちらから.