CRX2Oak 移行ツールの使用

はじめに

CRX2Oak は、異なるリポジトリ間でデータを移行するように設計されたツールです。

Apache Jackrabbit 2 に基づく古い CQ バージョンから Oak にデータを移行するために使用でき、Oak リポジトリ間でのデータのコピーにも使用できます。

最新バージョンの crx2oak は、次の場所で公開されているアドビのリポジトリからダウンロードできます。https://repo1.maven.org/maven2/com/adobe/granite/crx2oak/

移行の使用例

このツールは、次の目的で使用できます。

• 古い CQ 5 バージョンからAEM 6 への移行
• 複数の Oak リポジトリ間でのデータのコピー
• 異なる Oak MicroKernel 実装間でのデータの変換。

外部の BLOB ストア（一般的にデータストアと呼ばれます）を使用したリポジトリの移行に対するサポートは、様々な組み合わせで提供されます。 考えられる移行パスの 1 つは、外部 FileDataStore を使用する CRX2 リポジトリから S3DataStore を使用する Oak リポジトリへの移行です。

下の図に、CRX2Oak がサポートしているすべての移行の組み合わせを示します。

機能

CRX2Oak は、永続化モードの再構成を自動化する事前定義済みの移行プロファイルをユーザーが指定できる方法で、AEMのアップグレード時に呼び出されます。 これはクイックスタートモードと呼ばれます。

さらにカスタマイズが必要な場合に備えて、個別に実行することもできます。 ただし、このモードでは、変更はリポジトリに対してのみおこなわれ、AEMの追加の再設定は手動で実行する必要があります。 これはスタンドアロンモードと呼ばれます。

もう 1 つ注意すべき点は、スタンドアロンモードのデフォルト設定では、ノードストアのみが移行され、新しいリポジトリが古いバイナリストレージを再使用することです。

自動クイックスタートモード

AEM 6.3 以降、CRX2Oak は、すでに使用可能なすべての移行オプションを使用して設定できる、ユーザー定義の移行プロファイルを処理できます。 これにより、高い柔軟性と、スタンドアロンモードでツールを使用している場合は使用できないAEMの設定を自動化する機能の両方が可能になります。

CRX2Oak をクイックスタートモードに切り替えるには、次のオペレーティングシステム環境変数を使用して、AEMインストールディレクトリ内の crx-quickstart フォルダーへのパスを定義する必要があります。

UNIX ベースのシステムおよびmacOSの場合：

export SLING_HOME="/path/to/crx-quickstart"

Windows の場合：

SET "SLING_HOME=/path/to/crx-quickstart"

サポートの再開

移行はいつでも中断でき、後で再開できます。

カスタマイズ可能なアップグレードロジック

CommitHooksを使用して、カスタム Java ロジックも実装できます。カスタム RepositoryInitializer クラスを実装して、カスタム値でリポジトリを初期化できます。

メモリマップ操作のサポート

CRX2Oak は、デフォルトでメモリマッピング操作もサポートします。 メモリマッピングはパフォーマンスを大幅に向上させるので、可能な限り使用する必要があります。

コンテンツの選択的移行

デフォルトでは、このツールは"/"パスの下にあるリポジトリ全体を移行します。しかし、どのコンテンツを移行するかは完全に制御できます。

新しいインスタンスに不要な部分がコンテンツにある場合は、 --exclude-path パラメーターを使用してそのコンテンツを除外し、アップグレード手順を最適化できます。

パスの結合

2 つのリポジトリ間でデータをコピーする必要があり、両方のインスタンス上でコンテンツパスが異なる場合は、--merge-path パラメーターでコンテンツパスを定義できます。定義すると、CRX2Oak は新しいノードのみをコピー先リポジトリにコピーし、古いノードは元の場所に保持します。

バージョンのサポート

デフォルトでは、AEMは、変更された各ノードまたはページのバージョンを作成し、リポジトリに保存します。 その後、バージョンを使用して、ページを以前の状態に復元できます。

ただし、元のページが削除されても、これらのバージョンはパージされません。 長時間使用されているリポジトリを扱う場合は、孤立したバージョンによって生じた多数の冗長なデータを移行で処理しなければならないことがあります。

このような状況に役立つ機能は、--copy-versions パラメーターを付加することです。このパラメーターを使用すると、リポジトリの移行またはコピー中に、バージョンノードをスキップできます。

--copy-orphaned-versions=true を付加して、孤立したバージョンをコピーするかどうかを選択することもできます。

特定の日付までのバージョンをコピーする場合、どちらのパラメーターも日付形式 YYYY-MM-DD をサポートしています。

オープンソース版

CRX2Oak のオープンソースバージョンは、oak-upgrade の形式で利用できます。 以下を除くすべての機能をサポートします。

• CRX2 サポート
• 移行プロファイルのサポート
• 自動AEM再構成のサポート

詳しくは、 Apache ドキュメント を参照してください。

パラメーター

ノードストアオプション

• --cache：MB 単位でのキャッシュサイズ（デフォルトは 256）

• --mmap：セグメントストア用のメモリマップファイルアクセスを有効化します

• --src-password:：ソース RDB データベースのパスワード

• --src-user:：ソース RDB のユーザー

• --user：ターゲット RDB のユーザー

• --password：ターゲット RDB のパスワード

移行オプション

• --early-shutdown：ノードのコピー後、コミットフックの適用前に、ソース JCR2 リポジトリをシャットダウンします

• --fail-on-error：ソースリポジトリからノードを読み取れない場合、強制的に移行を失敗させます。

• --ldap：LDAP ユーザーを CQ 5.x インスタンスから Oak ベースのインスタンスに移行します。これを機能させるには、Oak 設定の ID プロバイダーを ldap という名前にする必要があります。 詳しくは、 LDAP ドキュメント.

• --ldap-config:：認証に複数の サーバーを使用していた CQ 5.x リポジトリに対しては、このパラメーターと --ldap パラメーターを併用します。このパラメーターを使用して、CQ 5.x の ldap_login.conf または jaas.conf 設定ファイルを指すことができます。形式は、--ldapconfig=path/to/ldap_login.conf です。

バージョンストアオプション

• --copy-orphaned-versions：孤立したバージョンのコピーをスキップします。サポートされているパラメーターは、true、false、yyyy-mm-dd です。デフォルトは true です。

• --copy-versions:：バージョンストレージをコピーします。サポートされているパラメーターは、true、false、yyyy-mm-dd です。デフォルトは true です。

パスオプション

• --include-paths:：コピー時に含めるパスのコンマ区切りのリスト
• --merge-paths：コピー時に結合するパスのコンマ区切りのリスト
• --exclude-paths:：コピー時に除外するパスのコンマ区切りのリスト

コピー元 BLOB ストアオプション

• --src-datastore:：ソース FileDataStore として使用するデータストアディレクトリ

• --src-fileblobstore：ソース FileBlobStore として使用するデータストアディレクトリ

• --src-s3datastore：ソース S3DataStore として使用するデータストアディレクトリ

• --src-s3config：ソース S3DataStore の設定ファイル

コピー先 BlobStore オプション

• --datastore:：ターゲット FileDataStore として使用するデータストアディレクトリ

• --fileblobstore:：ターゲット FileBlobStore として使用するデータストアディレクトリ

• --s3datastore：ターゲット S3DataStore として使用するデータストアディレクトリ

• --s3config：ターゲット S3DataStore の設定ファイル

ヘルプオプション

• -?, -h, --help:：ヘルプ情報を表示します。

デバッグ

また、移行プロセスのデバッグ情報を有効にして、プロセス中に発生する可能性のある問題のトラブルシューティングをおこなうこともできます。 有効にする方法は、ツールを実行するモードによって異なります。

その他の注意点

MongoDB 複製セットに移行する場合は、Mongo データベースへのすべての接続で、WriteConcern パラメーターを 2 に設定します。

次のように、接続文字列の末尾に w=2 パラメーターを付加することによって設定できます。

java -Xmx4092m -jar crx2oak.jar crx-quickstart/repository/ mongodb://localhost:27017/aem-author?replicaset=replica1&w=2

Business.Adobe.com リソース

Content Insights Cms Cloud Asset Collections Responsive Forms Web Content Management Digital Rights Management