インプレースアップグレードの実行

最終更新日: 2023-11-07
  • トピック:
  • Upgrading
    このトピックの詳細を表示
  • 作成対象:
  • Developer
メモ

このページでは、AEM 6.5 のアップグレード手順について説明します。アプリケーションサーバーにデプロイされているインストールがある場合は、 アプリケーションサーバーインストールのアップグレード手順.

アップグレード前の手順

アップグレードを実行する前に、いくつかの手順を完了する必要があります。 詳しくは、 コードのアップグレードとカスタマイズ および アップグレード前のメンテナンスタスク を参照してください。 さらに、お使いのシステムが新しいバージョンのAEMの要件を満たしていることを確認します。 パターン検出を使用して、アップグレードの複雑さを推定する方法を確認します。また、 アップグレードの計画 を参照してください。

移行の前提条件

  • 必要な Java の最小バージョン: 移行ツールは、Java バージョン 7 以降でのみ機能します。 AEM 6.3 以上では、サポートされているバージョンは Oracle の JRE 8 と IBM の JRE 7 および 8 のみです。

  • アップグレードされたインスタンス: バージョンからアップグレードする場合 5.6 より古い​アップグレードに関するドキュメントの 6.0 バージョンに記載されている手順に従って、AEM 6.0 へのインプレースアップグレードを必ず実行してください。

AEM クイックスタート jar ファイルの準備

  1. インスタンスが実行中である場合は停止します。

  2. 新しい AEM jar ファイルをダウンロードし、それを使用して crx-quickstart フォルダーの外部にある古いファイルを置き換えます。

  3. 次のコマンドを実行して新しいクイックスタート jar を解凍します。

    java -Xmx4096m -jar aem-quickstart.jar -unpack
    

コンテンツリポジトリの移行

AEM 6.3 からアップグレードする場合は、この移行は必要ありません。6.3 より前のAdobeでは、AEM 6.3 に存在する Oak Segment Tar の新しいバージョンにリポジトリを移行するために使用できるツールが提供されています。これはクイックスタートパッケージの一部として提供され、TarMK を使用するアップグレードに必須です。 MongoMK を使用している環境のアップグレードには、リポジトリの移行は必要ありません。 新しい Segment Tar 形式の利点について詳しくは、 Oak Segment Tar への移行に関する FAQ.

実際の移行は、標準のAEM quickstart jar ファイルを使用して実行され、新しい -x crx2oak オプション:crx2oak ツールを実行してアップグレードを簡略化し、より堅牢にします。

メモ

CRX2Oak Quickstart 拡張を使用して TarMK リポジトリのコンテンツ移行を実行する場合は、移行コマンドラインに以下を追加することで samplecontent 実行モードを削除できます。

  • --promote-runmode nosamplecontent

実行すべきコマンドを決定するには、次のコマンドを使用します。

java -Xmx4096m -jar aem-quickstart.jar -v -x crx2oak -xargs -- --load-profile <<YOUR_PROFILE>> <<ADDITIONAL_FLAGS>>

<<YOUR_PROFILE>><<ADDITIONAL_FLAGS>> は、次の表にリストされているプロファイルとフラグに置き換えてください。

ソースリポジトリ ターゲットリポジトリ プロファイル 追加のフラグ
crx2 または TarMK FileDataStore TarMK segment-fds 以下の「トラブルシューティング」の節を参照してください。
crx2 MongoMK mongo-from-crx2 -T mongo-uri=mongo://mongo-host:mongo-port -T mongo-db=mongo-database-name
TarMK または crx2 S3DataStore TarMK segment-custom-ds 以下の「トラブルシューティング」の節を参照してください。
データストアなしの TarMK TarMK segment-no-ds
MongoMK MongoMK 移行は不要

この場合:

  • mongo-host は、MongoDB サーバーの IP です(例:127.0.0.1)

  • mongo-port は、MongoDB サーバーのポートです(例:27017)

  • mongo-database-name は、データベースの名前です(例:aem-author)

次のシナリオでは、追加のスイッチが必要となる場合もあります。

  • Java メモリマッピングが正しく処理されない Windows システムでアップグレードを実行する場合は、 --disable-mmap パラメータをコマンドに追加します。

crx2oak ツールの使用に関する追加の手順については、 CRX2Oak 移行ツール. crx2oak ヘルパー JAR は、必要に応じて手動でアップグレードできます。その場合は、クイックスタートを展開した後に、手動で新しいバージョンに置き換えます。 AEMインストールフォルダー内の場所は次のとおりです。 <aem-install>/crx-quickstart/opt/extensions/crx2oak.jar. 最新バージョンの CRX2Oak 移行ツールは、アドビリポジトリ(https://repo1.maven.org/maven2/com/adobe/granite/crx2oak/)からダウンロードできます。

移行が正常に完了すると、ツールは終了コード 0 で終了します。さらに、AEM インストールディレクトリの crx-quickstart/logs にある upgrade.log ファイルで WARN および ERROR メッセージがないかどうかを確認してください。これらのメッセージは、移行中に発生した致命的ではないエラーを示している場合があります。

crx-quickstart/installフォルダーにある設定ファイルを確認します。移行が必要な場合は、ターゲットリポジトリを反映するように更新されます。

データストアに関する注意:

AEM 6.3 インストールでは新しく FileDataStore がデフォルトになっていますが、外部データストアの使用は必須ではありません。実稼動デプロイメントのベストプラクティスとして、外部データストアを使用することをお勧めしますが、アップグレードの前提条件ではありません。 AEMのアップグレードには既に複雑さが伴うので、Adobeでは、データストアの移行をおこなわずにアップグレードを実行することをお勧めします。 必要に応じて、後でデータストアの移行を個別の作業として実行できます。

移行に関する問題のトラブルシューティング

6.3 からアップグレードする場合は、この節をスキップしてください。提供された crx2oak プロファイルは、ほとんどの顧客のニーズを満たす必要がありますが、追加のパラメーターが必要な場合があります。 移行中にエラーが発生した場合は、環境の中に追加の設定オプションの提供が必要な要素が存在する可能性があります。 その場合は、次のエラーが発生する可能性があります。

外部データストアが指定されていないので、チェックポイントはコピーされません。 これにより、最初の起動時にリポジトリ全体のインデックスが再作成されます。 —skip-checkpoints を使用して強制的に移行します。詳しくは、https://jackrabbit.apache.org/oak/docs/migration.html#Checkpoints_migrationを参照してください。

何らかの理由で、移行プロセスはデータストア内のバイナリにアクセスする必要があり、見つかりません。 データストアの設定を指定するには、次のフラグを <<ADDITIONAL_FLAGS>> 移行コマンドの一部:

S3 データストアの場合:

--src-s3config=/path/to/SharedS3DataStore.config --src-s3datastore=/path/to/datastore

/path/to/SharedS3DataStore.configは、S3 データストア設定ファイルのパスを表します。/path/to/datastoreは、S3 データストアのパスを表します。

ファイルデータストアの場合:

--src-datastore=/path/to/datastore

/path/to/datastoreは、ファイルデータストアのパスを表します。

アップグレードの実行

S3 を使用する場合:

  1. 以前のバージョンの S3 コネクタに関連する、crx-quickstart/install 内の jar を削除します。

  2. https://repo1.maven.org/maven2/com/adobe/granite/com.adobe.granite.oak.s3connector/ から 1.10.x S3 コネクタの最新リリースをダウンロードします。

  3. パッケージを一時フォルダーに抽出し、jcr_root/libs/system/install の内容を crx-quickstart/install フォルダーにコピーします。

適切なアップグレード開始コマンドの確認

アップグレードを実行するには、jar ファイルを使用してAEMを起動し、インスタンスを起動することが重要です。 6.5 へのアップグレードについては、 遅延コンテンツ移行 アップグレードコマンドで選択できます。

重要

oracleJava 11(または通常は 8 より新しいバージョンの Java)を実行している場合は、AEMの起動時に、追加のスイッチをコマンドラインに追加する必要があります。 詳しくは、 Java 11 に関する考慮事項を参照してください。

開始スクリプトからAEMを起動しても、アップグレードは開始されません。 ほとんどのお客様は、起動スクリプトを使用してAEMを起動し、この起動スクリプトをカスタマイズして、メモリ設定やセキュリティ証明書などの環境設定用のスイッチを含めています。 このため、Adobeでは、適切なアップグレードコマンドを判断するために、次の手順に従うことを推奨します。

  1. 実行中の AEM インスタンスで、コマンドラインから次のコマンドを実行します。

    ps -ef | grep java
    
  2. AEM プロセスを探します。次のように表示されます。

    /usr/bin/java -server -Xmx1024m -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar crx-quickstart/app/cq-quickstart-6.5.0-standalone-quickstart.jar start -c crx-quickstart -i launchpad -p 4502 -Dsling.properties=conf/sling.properties
    
  3. 既存の jar のパス(この場合は crx-quickstart/app/aem-quickstart*.jar)を crx-quickstart フォルダーと同じ階層にある新しい jar に置き換えて、コマンドを変更します。例として前述のコマンドを使用すると、コマンドは次のようになります。

    /usr/bin/java -server -Xmx1024m -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar cq-quickstart-6.5.0.jar -c crx-quickstart -p 4502 -Dsling.properties=conf/sling.properties
    

    これにより、適切なメモリ設定、カスタム実行モード、その他の環境パラメーターがすべてアップグレードに適用されます。 アップグレードが完了した後、今後の起動時に開始スクリプトからインスタンスを起動できます。

アップグレードされたコードベースのデプロイ

インプレースアップグレードプロセスが完了したら、更新されたコードベースをデプロイする必要があります。 ターゲットバージョンの AEM で動作するようにコードベースを更新するための手順については、コードおよびカスタマイズのアップグレードのページを参照してください。

アップグレード後のチェックとトラブルシューティングの実行

詳しくは、 アップグレード後のチェックとトラブルシューティング.

このページ