Upgrading to Liferay Portal 6.0 EE SP1

最新のLiferay Portalにアップグレードする場合、考慮しなければならないことがたくさんあります。本ガイドは、アップグレードのお手伝いをするためのものです。アップグレードを実行する前に、必ずお読みいただき、環境が整っていることを確認してください。

解決策

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

バックアップ - 以下の説明で言及されているすべてのコンポーネントが、作業を進める前にバックアップされていることを確認する。
Permissions Algorithm - Portal 6.1 Upgrading Liferay ドキュメントの指示に従って、アップグレードの前に permissions algorithm をアップグレードしてください。
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をデプロイする。
Portal-ext.properties - 古いportal-ext.propertiesの設定を新しいバージョンにコピーします。メジャーアップグレードを行う場合は、 legacy.x.x.propertiesの設定も見直してください。 legacy.x.x.properties 後方互換性のために望ましい設定のみをコピーします。
Supported Upgrade Paths - portal-ext.properties で使用する upgrade.processes については、こちらの Liferay Portal Upgrade Chart を参照してください。
ドキュメントライブラリ / イメージギャラリー - ポータルが同じフックを使用し、ファイルが保存されている古い場所を指していることを確認してください (image.hook.impl, image.hook.file.system.root.dir, dl.hook.impl, dl.hook.file.system.root.dir).
データベース - アプリケーションサーバーは、同じデータソースを指している必要があります。サーバーを再起動すると、Liferayデータベースのスキーマは自動的に更新され、新しいバージョンと同期します。
チェックポイント - ここで停止し、上記のコンポーネントが正常にアップグレードされたことを確認します。 (データベースのアップグレードに成功した場合は、この upgrade.processes= を portal-ext.propertiesから削除してください)
アクティベーション・キー - バージョン6.0EEへのアップグレードには、新しいアクティベーション・キーが必要です。詳しくは、 Liferay Portal Activation Key のリクエストをご参照ください。
Customizations - 最新のリリースされたPlugins SDKをダウンロードし、使用することができます。 Cコード（カスタマイズ、ポートレット、フック、テーマ、レイアウトテンプレートなど）をPlugins SDKの環境にして、コンパイルする。すべてのエラーとAPIの変更が調整された時点で、カスタマイズをデプロイする。 注: 6.0EE +は、古いEXT環境をサポートしていません。

ベストプラクティス

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

ユースケース

5.1.2 CE～6.0 EE SP1
5.1 EE SP5～6.0 SP1
5.2.3 CE～6.0 EE SP1
5.2 EE SP3～6.0 EE SP1
5.2 EE SP4～6.0 EE SP1
5.2 EE SP5～6.0 EE SP1
6.0.5 CEから6.0 EE SP1まで
以前のEEバージョンから6.0 EE SP1まで

5.1.2 CE～6.0 EE SP2

5.1.2のアプリケーションサーバーを停止する。
6.0 EE SP2 portal-ext.propertiesに、5.1.2で使用したデータベースを指すデータベース設定を置き、以下のプロパティを追加します：
permissions.user.check.algorithm=5
#5.1.2で他のパーミッションアルゴリズム(1-4)を使用している場合は、代わりにそちらを使用します。
古いportal-ext.propertiesのその他の設定を配置する（Ex. ドキュメントライブラリの場所）を新しいLiferayのバージョンのportal-ext.propertiesに追加してください。詳しくは、「アップグレード詳細説明書」を参照してください。
アプリケーションサーバーを立ち上げると、アップグレードログが表示されます。
ポータルが起動すると、プロダクトキーが必要であることが通知されます。 5.2とは異なり、ライセンス.xmlファイルを入手し、ホットデプロイフォルダにドロップします。 .xmlファイルをデプロイすると、ポータルページは自動的にライセンス契約ページにリダイレクトされます。

5.1 EE SP5～6.0 EE SP1

5.1.8のアプリケーションサーバーをシャットダウンします。
5.2.8用のportal-ext.propertiesに、5.1.8で使用したデータベースを指すデータベース設定を置き、以下のプロパティを追加します：
```
upgrade.processes=\
com.liferay.portal.upgrade.UpgradeProcess_5_1_8_to_5_2_8
```
古いportal-ext.propertiesのその他の設定を配置する（Ex. ドキュメントライブラリの場所）を新しいLiferayのバージョンのportal-ext.propertiesに追加してください。詳しくは、「アップグレード詳細説明書」を参照してください。
アプリケーションサーバーを起動すると、アップグレードログが表示されます。
5.2.8用アプリケーションサーバーをシャットダウンします。
6.0.11のportal-ext.propertiesに、5.2.8で使用したデータベースを指すデータベース設定を置き、以下のプロパティを追加します：
```
upgrade.processes=\
com.liferay.portal.upgrade.UpgradeProcess_5_2_8_to_6_0_5,\
com.liferay.portal.upgrade.UpgradeProcess_6_0_6,\
com.liferay.portal.upgrade.UpgradeProcess_6_0_11,\
```
permissions.user.check.algorithm=5
#5.2.8で他のパーミッションアルゴリズム（1-4）を使っている場合は、代わりにそれを使ってください。
古いportal-ext.propertiesのその他の設定を配置する（Ex. ドキュメントライブラリの場所）を新しいLiferayのバージョンのportal-ext.propertiesに追加してください。詳しくは、「アップグレード詳細説明書」を参照してください。
6.0.11のアプリケーションサーバーを起動すると、アップグレードログが表示されます。
ポータルが起動すると、プロダクトキーが必要であることが通知されます。 5.2とは異なり、ライセンス.xmlファイルを入手し、ホットデプロイフォルダにドロップします。 .xmlファイルをデプロイすると、ポータルページは自動的にライセンス契約ページにリダイレクトされます。

5.2.3 CE～6.0 EE SP1

5.2.3.のアプリケーションサーバーをシャットダウンします。
/webapps/sevencogs-hook/WEB-INF/classes/portal.propertiesの中のこの行を削除します：
```
upgrade.processes=\
com.liferay.sevencogs.hook.upgrade.UpgradeProcess_1_0_0
```
ポータルに付属するサンプルデータを削除している場合は、この手順をスキップしてください。
5.2.3アプリケーションサーバーを起動します。
5.2.3アプリケーションサーバーをシャットダウンします。
6.0.11のportal-ext.propertiesに、5.2.3で使用したデータベースを指すデータベース設定を置き、以下のプロパティを追加します：
permissions.user.check.algorithm=5
#5.2.3で別のパーミッションアルゴリズム（1〜4）を使っている場合は、代わりにそちらを使ってください。
古いportal-ext.propertiesのその他の設定を配置する（Ex. ドキュメントライブラリの場所）を新しいLiferayのバージョンのportal-ext.propertiesに追加してください。詳しくは、「アップグレード詳細説明書」を参照してください。
アプリケーションサーバーを起動すると、アップグレードログが表示されます。
ポータルサイトが起動すると、プロダクトキーが必要であることが通知されます。 5.2とは異なり、ライセンス.xmlファイルを入手し、ホットデプロイフォルダにドロップします。 .xmlファイルをデプロイすると、ポータルページは自動的にライセンス契約ページにリダイレクトされます。

5.2 SP3～6.0 EE SP1

5.2.7のアプリケーションサーバーをシャットダウンします。

6.0.11のportal-ext.propertiesに、5.2.7で使用したデータベースを指すデータベース設定を置き、以下の行を追加します：

upgrade.processes=\
com.liferay.portal.upgrade.UpgradeProcess_5_2_7_to_6_0_0,\
com.liferay.portal.upgrade.UpgradeProcess_6_0_1,\
com.liferay.portal.upgrade.UpgradeProcess_6_0_2,\
com.liferay.portal.upgrade.UpgradeProcess_6_0_3,\
com.liferay.portal.upgrade.UpgradeProcess_6_0_5,\
com.liferay.portal.upgrade.UpgradeProcess_6_0_6,\
com.liferay.portal.upgrade.UpgradeProcess_6_0_11

permissions.user.check.algorithm=5
#5.2.7で他のパーミッションアルゴリズム（1-4）を使っている場合は、代わりにそれを使ってください。

古いportal-ext.propertiesのその他の設定を配置する（Ex. ドキュメントライブラリの場所）を新しいLiferayのバージョンのportal-ext.propertiesに追加してください。詳しくは、「アップグレード詳細説明書」を参照してください。
6.0.11のアプリケーションサーバーを起動すると、アップグレードログが表示されます。
ポータルが起動すると、プロダクトキーが必要であることが通知されます。 5.2とは異なり、ライセンス.xmlファイルを入手し、ホットデプロイフォルダにドロップします。 .xmlファイルをデプロイすると、ポータルページは自動的にライセンス契約ページにリダイレクトされます。

5.2 SP4～6.0 EE SP1

5.2.8のアプリケーションサーバーをシャットダウンします。
6.0.11のportal-ext.propertiesに、5.2.8で使用したデータベースを指すデータベース設定を置き、以下の行を追加します：
```
upgrade.processes=\
com.liferay.portal.upgrade.UpgradeProcess_5_2_8_to_6_0_5,\
com.liferay.portal.upgrade.UpgradeProcess_6_0_6,\
com.liferay.portal.upgrade.UpgradeProcess_6_0_11
```
permissions.user.check.algorithm=5
#5.2.8で他のパーミッションアルゴリズム（1-4）を使っている場合は、代わりにそれを使ってください。
古いportal-ext.propertiesのその他の設定を配置する（Ex. ドキュメントライブラリの場所）を新しいLiferayのバージョンのportal-ext.propertiesに追加してください。詳しくは、「アップグレード詳細説明書」を参照してください。
6.0.11のアプリケーションサーバーを起動すると、アップグレードログが表示されます。
ポータルが起動すると、プロダクトキーが必要であることが通知されます。 5.2とは異なり、ライセンス.xmlファイルを入手し、ホットデプロイフォルダにドロップします。 .xmlファイルをデプロイすると、ポータルページは自動的にライセンス契約ページにリダイレクトされます。

5.2 SP5～6.0 EE SP1

5.2.9のアプリケーションサーバーをシャットダウンします。
6.0.11のportal-ext.propertiesに、5.2.9で使用したデータベースを指すデータベース設定を置き、以下の行を追加します：
```
upgrade.processes=\
com.liferay.portal.upgrade.UpgradeProcess_5_2_9_to_6_0_11
```
permissions.user.check.algorithm=5
#5.2.9で他のパーミッションアルゴリズム(1-4)を使用している場合は、代わりにそちらを使用します。
古いportal-ext.propertiesのその他の設定を配置する（Ex. ドキュメントライブラリの場所）を新しいLiferayのバージョンのportal-ext.propertiesに追加してください。詳しくは、「アップグレード詳細説明書」を参照してください。
6.0.11のアプリケーションサーバーを起動すると、アップグレードログが表示されます。
ポータルが起動すると、プロダクトキーが必要であることが通知されます。 5.2とは異なり、ライセンス.xmlファイルを入手し、ホットデプロイフォルダにドロップします。 .xmlファイルをデプロイすると、ポータルページは自動的にライセンス契約ページにリダイレクトされます。

6.0.5 CEから6.0 EE SP1まで

古い6.0からアップグレードする場合、6.0.11に移行する前に必ず6.0.5 CEにアップデートしてください。
旧6.0CEのアプリケーションサーバーをシャットダウンします。
6.0.5のportal-ext.propertiesに、旧6.0CEで使用していたデータベースを指すデータベース設定を配置します。
アプリケーションサーバーを起動すると、アップグレードログが表示されます。
6.0.5のアプリケーションサーバーをシャットダウンします。
6.0.11のportal-ext.propertiesに、6.0.5で使用したデータベースを指し示すデータベース設定を配置する。
古いportal-ext.propertiesのその他の設定を配置する（Ex. ドキュメントライブラリの場所）を新しいLiferayのバージョンのportal-ext.propertiesに追加してください。詳しくは、「アップグレード詳細説明書」を参照してください。
ポータルが起動すると、プロダクトキーが必要であることが通知されます。 5.2とは異なり、ライセンス.xmlファイルを入手し、ホットデプロイフォルダにドロップします。 .xmlファイルをデプロイすると、ポータルページは自動的にライセンス契約ページにリダイレクトされます。

旧6.0EEバージョンから6.0EE SP1まで

Liferay 6.0.10をシャットダウンします。
6.0.11用のportal-ext.propertiesに、6.0.10で使用したデータベースを指し示すデータベース設定を配置する。
その他、前回の6.0.10 portal-ext.propertiesの設定を配置します（Ex. 6.0.12版portal-ext.propertiesの「ドキュメントライブラリの場所）」を参照してください。詳しくは、「アップグレード詳細説明書」を参照してください。
6.0.11のアプリケーションサーバーを起動すると、アップグレードログが表示されます。
ポータルサイトの起動時に「このサーバーは登録されていません」と通知されます。 5.2とは異なり、ホットデプロイフォルダにドロップするライセンス.xmlファイルが必要です。 Liferay のデフォルトバンドルでは、このホットデプロイフォルダは $LIFERAY_HOME/deploy に配置されています。 .xmlファイルをデプロイした後、ブラウザをリフレッシュすると、Welcomeページが表示されます。

Liferay Portal 6.0 EE SP1へのアップグレードについて

解決策