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

メモ

このページでは、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 ファイルの準備

インスタンスが実行中である場合は停止します。
新しい AEM jar ファイルをダウンロードし、それを使用して crx-quickstart フォルダーの外部にある古いファイルを置き換えます。
次のコマンドを実行して新しいクイックスタート 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 を使用している場合、 -XX:MaxPermSize=2048m 直後のパラメータ -Xmx パラメーター。

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 を使用している場合：

以前のバージョンの S3 コネクタに関連する、crx-quickstart/install 内の jar を削除します。
最新リリースの 1.8.x S3 コネクタをからダウンロードします。 https://repo.adobe.com/nexus/content/groups/public/com/adobe/granite/com.adobe.granite.oak.s3connector/
パッケージを一時フォルダーに抽出し、の内容をコピーします。 jcr_root/libs/system/install から crx-quickstart/install フォルダー。

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

アップグレードをおこなうには、jar ファイルを使用して AEM を起動し、インスタンスを実行することが重要です。6.4 にアップグレードする場合は、他のコンテンツ再構築および移行オプション ( 遅延コンテンツ移行アップグレードコマンドで選択できます。

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

実行中の AEM インスタンスで、コマンドラインから次のコマンドを実行します。
```
ps -ef | grep java
```

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

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