Upgrading to Liferay Portal 6.1 EE GA1

Liferay Portalの最新版にアップグレードする際には、注意すべき点がたくさんあります。このガイドは、アップグレードプロセスを支援するために設計されています。アップグレードを実行する前に、必ずお読みになり、環境が整っていることを確認してください。

決議

これらの手順は、何らかの方法でポータルをカスタマイズした場合に使用する必要があります。アップグレードプロセスを完了するには、各コンポーネントを更新する必要があります。

これらは、最初に完成させるべきものから順に記載しています。

アクティベーションキー - バージョン6.0.x以下の場合、バージョン6.1 EEにアップグレードするには新しいキーが必要です。詳しくは、 Liferayポータルのアクティベーションキーを要求するを参照してください。
バックアップ - 次の手順に記載されているすべてのコンポーネントがバックアップされていることを確認してから作業を進めてください。
パーミッション・アルゴリズム - ユーザーガイドの指示に従って、アップグレードする前に、 パーミッション・アルゴリズムをアップグレードしてください。
Liferay Portal - 最新のリリースされた EE Portal WAR、EE Portal Dependencies、EE Plugins をダウンロードできます。古いEE Portal WAR、EE Portal Dependencies、EE Pluginsを削除します。最新リリースのEE Portal WAR、EE Portal Dependencies、EE Pluginsを導入します。
修正パック - パッチツールを使用して、最新のリリースされた EE Portal に修正パックをすべてインストールして、既知の問題を排除してください。
Portal-ext.properties - 古い portal-ext.properties の設定を新しいバージョンにコピーします。メジャーアップグレードを行う場合は、 legacy.x.x.x.properties の設定も確認してください。後方互換性のために望ましい legacy.x.x.properties 設定のみをコピーします。
サポートされているアップグレードパス - portal-ext.properties でどのような upgrade.processes を使用するかについてはアップグレードチャートを参照してください。
ドキュメントライブラリ/イメージギャラリー - ポータルが同じフックを使用し、ファイルが保存されている古い場所(image.hook.impl、image.hook.file.system.root.dir、dl.hook.impl、dl.hook.file.system.root.dir)を指していることを確認してください。
データベース - アプリケーションサーバは同じデータソースを指しているはずです。サーバーを再起動すると、Liferayデータベーススキーマが自動的に更新され、新しいバージョンと同期します。
チェックポイント - ここで停止し、上記のコンポーネントが正常にアップグレードされたことを確認します。 (データベースが正常にアップグレードされている場合は、portal-ext.propertiesからこのupgrade.process=を削除してください！)
カスタマイズ - 最新のプラグインSDKをダウンロードして使用してください。コード（カスタマイズ、ポートレット、フック、テーマ、レイアウトテンプレートなど）をPlugins SDK環境にコピーしてコンパイルします。すべてのエラーと API の変更が調整されたときに、カスタマイズをデプロイします。 (6.0EEは旧EXT環境には対応していません。新しい ext-plugin への移行方法については、この拡張環境の移行のヒントを参照してください)
ポータルの動作の変更 - 主なポータルのアップグレードには、使用方法の変更が含まれる場合があります。以下のポイントがあなたのポータルに影響を与えるかどうかを確認してください。
コントロールパネルへのアクセス - 6.1では、コントロールパネルを見るための新しいメカニズムが導入されました。これは、新たな許可を得ることで実現します。アップグレードプロセス中に自動的に追加されない可能性があります。ユーザーがコントロールパネルにアクセスできるようにする最も簡単な方法は、（新しい6.1の展開では、それはユーザーの役割に割り当てられています）VIEW_CONTROL_PANEL権限をあなたのために適したものであれば何でもロールに追加することです。あなたは、コントロールパネルからロールを編集して、ポータルを選択することでそれを行うことができます > 一般的な > コントロールパネルの権限に移動します。

ベストプラクティス

現在の環境にすでに明らかな問題がある場合は、アップグレードを試みないでください。現在の問題は、あなたが醜悪化しようとすれば、雪だるま式に大きな問題になるでしょう。まずはすべての問題を解決しましょう。
アップグレードの試行に失敗した場合、同じデータベースでアップグレードを継続して試行しないでください。アップグレードの問題を修正してから、まだ一度もアップグレードを試みたことのないデータベースで新しいアップグレードを試みてください。
まずはテスト環境でアップグレードをテストします。
本番サーバーに直接デプロイしないでください。その代わりに、テスト環境上にライブサイトのコピーを構築する必要があります。アップグレードが成功したら、環境全体を本番環境にコピーすることができます。この手法を用いることで、ダウンタイムを最小限に抑え、実際の生産環境へのリスクを軽減することができます。

5.2.3 CEから6.1 EEまで

アクセス許可アルゴリズムが5よりも低い場合は、アクセス許可アルゴリズム5にアップグレードしてください。
5.2.3 CE用アプリケーションサーバのシャットダウン
Liferay 6.0 SP2 バンドル portal-ext.properties に、5.2.3 で使用したデータベースを指すデータベース設定を配置します。
その他の設定は、以前の portal-ext.properties にあったものを配置してください。ドキュメントライブラリの場所)を6.0 SP2のportal-ext.propertiesに追加しました。
6.0 SP2用のアプリケーションサーバーを起動すると、アップグレードログが表示されます。
6.0 SP2用のライセンスファイルをデプロイします。ホットデプロイフォルダにドロップするライセンス.xmlファイルが必要です。 Liferayのデフォルトのバンドルでは、このホットデプロイフォルダは $LIFERAY_HOME/deployにあります。 .xmlファイルを展開した後、ブラウザをリフレッシュします。
パーミッションアルゴリズムをパーミッションアルゴリズムにアップグレードする 6.
6.1.10 の portal-ext.properties に、5.2.3/6.0 SP2 で使用したデータベースを指すデータベース設定を配置します。
その他の設定は、以前の portal-ext.properties にあったものを配置してください。ドキュメントライブラリの場所)を6.1.10のportal-ext.propertiesに追加しました。
6.1.10用のアプリケーションサーバを起動すると、アップグレードログが表示されます。
6.1.10のデプロイライセンス

5.2 EE SP5～6.1 EE

お使いのアクセス許可アルゴリズムが6よりも低い場合は、アクセス許可アルゴリズム6にアップグレードしてください。
5.2.9のアプリケーションサーバをシャットダウンします。

6.1.10 バンドルの portal-ext.properties に、5.2.9 で使用したデータベースを指すデータベース設定を配置し、以下の行を追加します。

upgrade.processes=\
com.liferay.portal.upgrade.UpgradeProcess_5_2_9_to_6_0_11,\
com.liferay.portal.upgrade.UpgradeProcess_6_0_12,\
com.liferay.portal.upgrade.UpgradeProcess_6_0_12_to_6_1_0,\
com.liferay.portal.upgrade.UpgradeProcess_6_1_1

その他の設定は、以前の portal-ext.properties にあったものを配置してください。ドキュメント・ライブラリの場所) を新しいLiferayバージョンのportal-ext.propertiesに追加します。
6.1.10用のアプリケーションサーバを起動すると、アップグレードログが表示されます。
ポータルが起動すると、「このサーバーは登録されていません」と通知されます。ホットデプロイフォルダにドロップするライセンス.xmlファイルが必要です。 Liferayのデフォルトのバンドルでは、このホットデプロイフォルダは $LIFERAY_HOME/deployにあります。 .xmlファイルをデプロイした後、ブラウザをリフレッシュすると、6.1 EE基本構成のページに移動します。

6.0.6 CEから6.1 EEまで

6.0.6のアプリケーションサーバをシャットダウンします。
6.1.10 の portal-ext.properties に、6.0.6 で使用したデータベースを指すデータベース設定を配置します。
その他の設定は、以前の portal-ext.properties にあったものを配置してください。ドキュメント・ライブラリの場所) を新しいLiferayバージョンのportal-ext.propertiesに追加します。
6.1.10用のアプリケーションサーバを起動すると、アップグレードログが表示されます。
ポータルが起動すると、6.1 EE基本構成ページに移動します。

6.0～6.1 EE

6.0.10のアプリケーションサーバをシャットダウンします。
6.1.10のportal-ext.propertiesに、6.0.10で使用したデータベースを指すデータベース設定を配置し、以下のプロパティを追加します。

upgrade.processes=\
com.liferay.portal.upgrade.UpgradeProcess_6_0_12,\
com.liferay.portal.upgrade.UpgradeProcess_6_0_12_to_6_1_0,\
com.liferay.portal.upgrade.UpgradeProcess_6_1_1

その他の設定は、以前の portal-ext.properties にあったものを配置してください。ドキュメント・ライブラリの場所) を新しいLiferayバージョンのportal-ext.propertiesに追加します。
6.1.10用のアプリケーションサーバを起動すると、アップグレードログが表示されます。
ポータルが起動すると、6.1 EE基本構成ページに移動します。

6.0 SP1～6.1 EE

6.0.11のアプリケーションサーバをシャットダウンします。
6.1.10のportal-ext.propertiesに、6.0.11で使用したデータベースを指すデータベース設定を配置し、以下のプロパティを追加します。

upgrade.processes=\
com.liferay.portal.upgrade.UpgradeProcess_6_0_12,\
com.liferay.portal.upgrade.UpgradeProcess_6_0_12_to_6_1_0,\
com.liferay.portal.upgrade.UpgradeProcess_6_1_1

その他の設定は、以前の portal-ext.properties にあったものを配置してください。ドキュメント・ライブラリの場所) を新しいLiferayバージョンのportal-ext.propertiesに追加します。
6.1.10用のアプリケーションサーバを起動すると、アップグレードログが表示されます。
ポータルが起動すると、6.1 EE基本構成ページに移動します。

6.0 EE SP2～6.1 EE

6.0.12のアプリケーションサーバをシャットダウンします。
6.1.10のportal-ext.propertiesに、6.0.12で使用したデータベースを指すデータベース設定を配置し、以下のプロパティを追加します。

upgrade.processes=\
com.liferay.portal.upgrade.UpgradeProcess_6_0_12_to_6_1_0,\
com.liferay.portal.upgrade.UpgradeProcess_6_1_1

その他の設定は、以前の portal-ext.properties にあったものを配置してください。ドキュメント・ライブラリの場所) を新しいLiferayバージョンのportal-ext.propertiesに追加します。
6.1.10用のアプリケーションサーバを起動すると、アップグレードログが表示されます。
ポータルが起動すると、6.1 EE基本構成ページに移動します。

以前の6.1バージョンから6.1 EEへ

シャットダウンLiferay 6.1.0.
6.1.10 の portal-ext.properties に、6.1.0 で使用したデータベースを指すデータベース設定を配置します。
その他の設定は、以前の portal-ext.properties にあったものを配置してください。ドキュメント・ライブラリの場所) を新しいLiferayバージョンのportal-ext.propertiesに追加します。
6.1.10用のアプリケーションサーバを起動すると、アップグレードログが表示されます。
ポータルが起動すると、6.1 EE基本構成ページに移動します。