legacy-knowledge-base
公開されました Sep. 10, 2025

Liferay Portal 6.1 EEにアップグレードする。

written-by

Liferay Support

How To articles are not official guidelines or officially supported documentation. They are community-contributed content and may not always reflect the latest updates to Liferay DXP. We welcome your feedback to improve How To articles!

While we make every effort to ensure this Knowledge Base is accurate, it may not always reflect the most recent updates or official guidelines.We appreciate your understanding and encourage you to reach out with any feedback or concerns.

legacy-article

learn-legacy-article-disclaimer-text

Liferay 6.1 EE GA1のリリースで、Liferayは シームレスアップグレード 機能を導入しました。 シームレスアップグレードは、旧バージョンのデータベースに最新バージョンのLiferayを指すだけで、最新バージョンにアップグレードすることができます。 これは、アップグレードを行う際に考慮すべき多くの要素があることを減じるものではありません。 アップグレードする前に、アップグレード可能な環境であることを確認するために、あらゆる予防策を講じてください。

解像度

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

主なアップグレード方法:

  1. テスト環境

    まずは非本番環境でアップグレードのテストを行ってください。

  2. ライセンス認証キー

    バージョン6.0.x以下の場合、バージョン6.1EEへのアップグレードには、新しいキーが必要です。 詳しくは、 Liferay Portal Activation Key のリクエスト をご参照ください。

  3. バックアップ

    以下の説明で言及されているすべてのコンポーネントがバックアップされていることを確認してから作業を進めてください。

  4. パーミッションアルゴリズム

    Portal 6.1 ユーザーガイド の説明に従って、アップグレード前にパーミッションアルゴリズムをアップグレードしてください。

  5. 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をデプロイする。

  6. フィックスパック

    最新リリースされたEE PortalにPatching Toolを使用してすべてのFix Packをインストールし、既知の問題を解消します。

  7. Portal-ext.properties(ポータルエクストプロパティ

    旧版のportal-ext.propertiesの設定を新版にコピーします。 メジャーバージョンアップを行う場合は、legacy.x.x.propertiesの設定も見直してください。 後方互換性のために望ましいlegacy.x.x.propertiesの設定のみをコピーします。

  8. ドキュメントライブラリ / イメージギャラリー

    ポータルが同じフックを使用し、ファイルが保存されている古い場所を指していることを確認してください(image.hook.impl, image.hook.file.system.root.dir, dl.hook.impl, dl.hook.file.system.root.dir).

  9. データベース

    アプリケーションサーバーは、同じデータソースを指しているはずです。 サーバーを再起動すると、Liferayデータベースのスキーマは自動的に更新され、新しいバージョンと同期します。

  10. チェックポイント

    ここで停止し、上記のコンポーネントが正常にアップグレードされたことを確認します。

  11. カスタマイゼーション

    最新版のPlugins SDKをダウンロードし、使用する。 コード(カスタマイズ、ポートレット、フック、テーマ、レイアウトテンプレートなど)をPlugins SDK環境にコピーし、コンパイルします。 すべてのエラーとAPIの変更が調整された時点で、カスタマイズをデプロイする。 (6.0EE+は旧EXT環境には対応していません。 新しいext-pluginへの移行方法については、 拡張環境移行のヒント をご参照ください)

  12. ポータルの動作の変化

    ポータルの大規模なアップグレードには、その使用方法の一部変更が含まれる場合があります。 以下の項目に該当するものがあるかどうか、ご確認ください:

    1. コントロールパネルへのアクセス

      6.1では、コントロールパネルを見るための新しい仕組みが導入されました。 これを実現するのが、新たなパーミッションです。 アップグレードの際に自動的に追加されることはありません。 ユーザーがコントロールパネルにアクセスできるようにする最も簡単な方法は、適切なロール(新しい6.1デプロイメントではUserロールに割り当てられます)にVIEW_CONTROL_PANELパーミッションを追加することです。 コントロールパネルからロールを編集し、Portal > General > Go to Control Panelの権限を選択することで可能です。

ベストプラクティス

  • 現在の環境にすでに明らかな問題がある場合は、アップグレードを試みないようにしてください。 現在の問題は、醜態をさらすと雪だるま式に大きな問題に発展します。 まずすべての問題を解決する。
  • アップグレードに失敗した場合は、同じデータベースでアップグレードを続行しないでください。 アップグレードの問題を解決してから、まだアップグレードを試したことのないデータベースで、新たにアップグレードを試みてください。

ユースケース

  • 5.2 EEと6.1 EEのいずれかのバージョンから6.1 EEへのアップグレード
  • 6.0 EE、6.0 EE SP1、6.0 EE SP2 から 6.1 EE へのアップグレードについて
    • quartz_テーブルにデータがある場合は、Quartz Portletと 指示 を使用して、スケジュールされたジョブをアップグレードバージョンに移行してください。
did-this-article-resolve-your-issue

legacy-knowledge-base