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

メモ

このページでは、AEM 6.4 のアップグレード手順の概要を説明します。インストールがアプリケーションサーバーにデプロイされている場合は、アプリケーションサーバーのインストール環境のアップグレード手順を参照してください。

アップグレード前の手順

アップグレードを実行する前に、いくつかの手順を完了しておく必要があります。詳しくは、コードのアップグレードとカスタマイズおよびアップグレード前のメンテナンスタスクを参照してください。また、システムが新しいバージョンの 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 以前のバージョンでは、リポジトリを 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パラメータを追加してください。

  • Java 7を使用している場合は、-Xmxパラメーターの直後に-XX:MaxPermSize=2048mパラメーターを追加します。

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

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

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

メモ

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

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

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

Checkpoints won't be copied, because no external datastore has been specified.This will result in the full repository reindexing on the first start.Use --skip-checkpoints to force the migration or see https://jackrabbit.apache.org/oak/docs/migration.html#Checkpoints_migration for more info.

何らかの理由で、移行プロセスがデータストア内のバイナリにアクセスする必要がありますが、データストアを見つけることができません。データストア設定を指定するには、マイグレーションコマンドの<<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://repo.adobe.com/nexus/content/groups/public/com/adobe/granite/com.adobe.granite.oak.s3connector/から1.8.x S3コネクタの最新リリースをダウンロードしてください。

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

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

アップグレードをおこなうには、jar ファイルを使用して AEM を起動し、インスタンスを実行することが重要です。6.4にアップグレードする場合は、Lazy Content Migrationの、アップグレードコマンドで選択できるその他のコンテンツの再構築と移行のオプションも参照してください。

起動スクリプトから AEM を起動した場合、アップグレードは開始されません。ほとんどの顧客は、起動スクリプトを使用して AEM を起動します。また、メモリ設定、セキュリティ証明書など、環境設定に関するスイッチを追加するように起動スクリプトをカスタマイズしています。そのため、次の手順に従って、適切なアップグレードコマンドを確認することをお勧めします。

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

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

    /usr/bin/java -server -Xmx1024m -XX:MaxPermSize=256M -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar crx-quickstart/app/cq-quickstart-6.2.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 -XX:MaxPermSize=256M -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar cq-quickstart-6.4.0.jar -c crx-quickstart -p 4502 -Dsling.properties=conf/sling.properties
    

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

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

インプレースアップグレードプロセスが完了したら、更新したコードベースをデプロイする必要があります。AEMのターゲット版で動作するようにコードベースを更新する手順は、アップグレードコードとカスタマイズのページにあります。

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

アップグレード後のチェックおよびトラブルシューティングを参照してください。

このページ

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now