現在表示中:

AEM でリポジトリコンテンツをバックアップおよび復元するには、次の 2 つの方法があります。

  • リポジトリの外部バックアップを作成して、安全な場所にそのバックアップを保存することができます。リポジトリが壊れた場合、以前の状態に復元できます。
  • リポジトリコンテンツの内部バージョンを作成できます。内部バージョンはコンテンツと共にリポジトリ内に保存されるので、変更または削除したノードやツリーを迅速に復元できます。

一般

ここで説明する手法は、システムバックアップおよび復元に適用されます。

消失したコンテンツのごく一部のバックアップや復元をおこなう必要がある場合、システムの復元は必ずしも必要ではありません。

  • 別のシステムからパッケージ経由でデータを取得できます。
  • または、バックアップを一時システムに復元し、コンテンツパッケージを作成して、それをシステムのそのコンテンツが消失した場所にデプロイすることができます。

詳しくは、後述のパッケージバックアップを参照してください。

タイミング

バックアップは、データストアのガベージコレクションと同時に実行しないでください。同時に実行すると、この両方のプロセスの結果に悪影響を及ぼす可能性があります。

 

オフラインバックアップ

オフラインバックアップはいつでも実行できます。このバックアップをおこなうには AEM を停止する必要がありますが、オンラインバックアップと比較して、所要時間については非常に効率的です。

ほとんどの場合、ファイルシステムのスナップショットを使用して、その時点でのストレージの読み取り専用コピーを作成することになります。オフラインバックアップを作成するには、次の手順を実行します。

  • アプリケーションを停止します。
  • スナップショットのバックアップを作成します。
  • アプリケーションを起動します。

通常、スナップショットのバックアップは数秒しかかからないので、全体的な停止時間は数分未満になります。

オンラインバックアップ

このバックアップ方式では、AEM など、リポジトリ下にデプロイされているアプリケーションも含めて、リポジトリ全体のバックアップを作成します。バックアップには、コンテンツ、バージョン履歴、設定、ソフトウェア、ホットフィックス、カスタムアプリケーション、ログファイル、検索用インデックスなどが含まれます。クラスター化を使用していて、(物理的に、またはソフトリンクを使用して)crx-quickstart のサブディレクトリが共有フォルダーとして指定されている場合は、共有ディレクトリもバックアップされます。

後でリポジトリ全体(とアプリケーション)を復元できます。

この方法は「ホット」バックアップまたは「オンライン」バックアップとして動作するので、リポジトリ実行中に実行できます。したがって、バックアップ実行中にリポジトリが使用可能です。この方法は、デフォルトの、Tar ストレージベースのリポジトリインスタンスに対応します。

バックアップの作成には次のオプションがあります。

  • AEM の統合バックアップツールを使用して、ディレクトリにバックアップします。
  • ファイルシステムのスナップショットを使用して、ディレクトリにバックアップします。

どちらの場合も、バックアップによってリポジトリのイメージ(スナップショット)が作成されます。その後、システムのバックアップエージェントによって、そのイメージが実際に専用のバックアップシステム(テープドライブ)に送信されます。

注意:

AEM オンラインバックアップ機能をカスタム blobstore 設定がある AEM インスタンスに使用する場合は、データストアのパスを「crx-quickstart」ディレクトリ外に設定し、データストアを別にバックアップすることをお勧めします。

警告:

オンラインバックアップのバックアップ対象はファイルシステムのみです。リポジトリコンテンツやリポジトリファイルをデータベースに保存している場合は、そのデータベースを個別にバックアップする必要があります。AEM を MongoDB で使用している場合、MongoDB のネイティブバックアップツールの使用方法のドキュメントを参照してください。

AEM オンラインバックアップ

リポジトリのオンラインバックアップでは、バックアップファイルを作成、ダウンロードおよび削除できます。これは「ホット」(つまり「オンライン」)バックアップ機能なので、リポジトリが通常どおり読み取り/書き込みモードで使用されているときに実行できます。

警告:

AEM オンラインバックアップを、データストアのガベージコレクションまたはリビジョンクリーンアップと同時に実行しないでください。これらを同時に実行すると、システムのパフォーマンスが低下します。

バックアップの開始時に、「ターゲットパス」か「遅延」(またはその両方)を指定できます。

ターゲットパス

バックアップファイルは通常、クイックスタート jar ファイル(.jar)が格納されているフォルダーの親フォルダーに保存されます。例えば、AEM jar ファイルが /InstallationKits/AEM の下にある場合、バックアップは /InstallationKits の下に生成されます。ターゲットとする場所を選んで指定することもできます。

TargetPath がディレクトリの場合、リポジトリのイメージはこのディレクトリに作成されます。同じディレクトリが複数回(または常に)バックアップの保存用に使用される場合は、次のようになります。

  • リポジトリ内で修正されたファイルは、ターゲットパス内でも同様に修正されます。
  • リポジトリ内で削除されたファイルは、ターゲットパス内でも削除されます。
  • リポジトリ内で作成されたファイルは、ターゲットパス内でも作成されます。

注意:

TargetPath が拡張子 .zip のファイル名に設定されている場合、リポジトリは一時ディレクトリにバックアップされ、その後この一時ディレクトリのコンテンツが圧縮されて ZIP ファイルに格納されます。

この方式は次の理由で推奨されません。

  • バックアップ処理中に追加のディスク領域が必要になります(一時ディレクトリと zip ファイル分)。
  • 圧縮処理はリポジトリによっておこなわれるので、パフォーマンスに影響する場合があります。
  • バックアッププロセスの遅延につながります。
  • Java 1.6 までは、4 GB までのサイズの ZIP ファイルしか作成できません。

ZIP をバックアップ形式として作成する必要がある場合は、ディレクトリにバックアップしてから、圧縮プログラムを使用して ZIP ファイルを作成してください。

遅延

リポジトリのパフォーマンスが影響を受けないように、遅延時間をミリ秒単位で指定します。デフォルトでは、リポジトリのバックアップはフルスピードで実行されます。他のタスクの速度を低下させないように、オンラインバックアップの作成速度を下げることができます。

遅延時間を非常に大きく取る場合は、オンラインバックアップに 24 時間以上かけないでください。24 時間を超えた場合はバックアップを破棄してください。バックアップに一部のバイナリしか含まれない可能性があります。
一般的には、1 ミリ秒遅延させると CPU 使用率は 10%になり、10 ミリ秒遅延させると 3%未満になります。遅延時間の合計(秒)は、「リポジトリサイズ(MB) x 遅延(ミリ秒)÷ 2」(zip オプションを使用する場合)、または「リポジトリサイズ(MB) x 遅延(ミリ秒)÷ 4」(ディレクトリにバックアップする場合)という式を使って予測できます。つまり、1 ミリ秒の遅延を指定して 200 MB のリポジトリをディレクトリにバックアップする場合、バックアップ時間は約 50 秒増加します。

注意:

 処理の内部詳細については、AEM オンラインバックアップの仕組みを参照してください。

バックアップを作成するには:

  1. 管理者として AEM にログインします。

  2. ツール/運営/バックアップに移動します。

  3. 作成」をクリックします。バックアップコンソールが開きます。

    chlimage_1
  4. バックアップコンソールで、「ターゲットパス」と「遅延」を指定します。

    chlimage_1

    注意:

    バックアップコンソールは、次のアドレスからもアクセスできます。

        http://<hostname>:<port-number>/libs/granite/backup/content/admin.html

  5. 保存」をクリックします。進行状況バーに、バックアップの進行状況が示されます。

    注意:

    いつでも実行中のバックアップをキャンセルできます。

  6. バックアップが完了すると、バックアップウィンドウに zip ファイルが表示されます。

    chlimage_1

    注意:

    不要になったバックアップファイルは、このコンソールを使用して削除できます。左側のウィンドウでバックアップファイルを選択し、「削除」をクリックします。

    注意:

    ディレクトリにバックアップした場合:バックアッププロセスの完了後、AEM によってターゲットディレクトリに書き込まれることはありません。

AEM オンラインバックアップの自動化

オンラインバックアップは可能な限り、システムの負荷がほとんどない時間帯(早朝など)に実行すべきです。 

バックアップは、wget または curl HTTP クライアントを使用して自動化できます。以下に、curl を使用したバックアップの自動化の例を示します。

デフォルトのターゲットディレクトリへのバックアップ

警告:

以下の例では、curl コマンドの様々なパラメーターをお使いのインスタンスに合わせて設定する必要があります。例えば、hostname(localhost)、ポート(4502)、管理者パスワード(xyz)およびファイル名(backup.zip)が該当します。

curl -u admin:admin -X POST http://localhost:4502/system/console/jmx/com.adobe.granite:type=Repository/op/startBackup/java.lang.String?target=backup.zip

バックアップファイル/ディレクトリは、サーバー上で、crx-quickstart フォルダーを含むフォルダーの親フォルダーに作成されます(ブラウザーを使用してバックアップを作成する場合と同様)。例えば、/InstallationKits/crx-quickstart/ ディレクトリに AEM をインストールしている場合、バックアップは /InstallationKits ディレクトリに作成されます。

curl コマンドはすぐに終了するので、このディレクトリを監視して、zip ファイルが作成されているかを必ず確認してください。バックアップの作成中、一時ディレクトリ(ディレクトリ名は、最終の zip ファイルの名前に基づいて付けられる)が出現し、最終的にこのディレクトリが zip で圧縮されます。次に例を示します。

  • 作成される zip ファイルの名前:backup.zip
  • 一時ディレクトリの名前:backup.f4d5.temp

デフォルトのターゲットディレクトリ以外へのバックアップ

通常、バックアップファイルまたはディレクトリは、crx-quickstart フォルダーを含むフォルダーの親フォルダー内に作成されます。

バックアップ(どちらの種類でも)を別の場所に保存する場合は、curl コマンドの target パラメーターに絶対パスを設定できます。

例えば、/Backups/2012 ディレクトリに backupJune.zip を生成するには、次のコマンドを実行します。

curl -u admin:admin -X POST http://localhost:4502/system/console/jmx/com.adobe.granite:type=Repository/op/startBackup/java.lang.String?target=/Backups/2012/backupJune.zip"

警告:

異なるアプリケーションサーバー(JBoss など)を使用している場合、ターゲットディレクトリに書き込みできないという理由でオンラインバックアップが期待どおりに動作しないことがあります。その場合は、サポートまでお問い合わせください。

注意:

バックアップは、AEM に付属する MBean を使用して開始することもできます。

ファイルシステムのスナップショットのバックアップ

ここで説明する手順は、サイズの大きいリポジトリに特に適しています。

注意:

このバックアップ方式を使用する場合は、システムでファイルシステムのスナップショット機能がサポートされる必要があります。例えば、Linux の場合、ファイルシステムを論理ボリュームに配置する必要があります。

  1. AEM がデプロイされているファイルシステムのスナップショットを取得します。

  2. ファイルシステムのスナップショットをマウントします。

  3. バックアップを実行してスナップショットのマウントを解除します。

AEM オンラインバックアップの仕組み

AEM オンラインバックアップは、バックアップ対象のデータと作成されるバックアップファイルの整合性を確保するための一連の内部アクションにより構成されます。以下に、関心のある開発者向けに、これらの内部アクションについて示します。

オンラインバックアップでは次のアルゴリズムを使用します。

  1. zip ファイル作成時の最初の手順は、ターゲットディレクトリを作成または指定することです。
    • zip ファイルにバックアップする場合、一時ディレクトリが作成されます。ディレクトリ名は backup. で始まり、.temp で終わります(例:backup.f4d3.temp)。
    • ディレクトリにバックアップする場合、ターゲットパスに指定された名前が使用されます。既存のディレクトリを使用できますが、それが存在しない場合は新しいディレクトリが作成されます。
      バックアップの開始時に、ターゲットディレクトリ内に backupInProgress.txt という空のファイルが作成されます。このファイルは、バックアップの完了時に削除されます。
  2. すべてのファイルが、ソースディレクトリからターゲットディレクトリ(zip ファイルを作成する場合は一時ディレクトリ)にコピーされます。リポジトリの破損を回避するために、セグメントストアはデータストアより前にコピーされます。バックアップの作成時、インデックスとキャッシュデータは省略されます。結果として、crx-quickstart/repository/cachecrx-quickstart/repository/index からのデータはバックアップに含まれません。このプロセスで進行状況バーのインジケーターは、zip ファイルの作成時は 0~70%、zip ファイルを作成しない場合は 0~100%を示します。
  3. バックアップが既存のディレクトリに作成される場合は、ターゲットディレクトリ内にある「古い」ファイルが削除されます。古いファイルとは、ソースディレクトリ内に存在しないファイルのことです。

ファイルは、4 つのステージでターゲットディレクトリにコピーされます。

  1. コピーの第 1 段階(進行状況インジケーターは zip ファイルの作成時は 0~63%、zip ファイルが作成されない場合は 0~90%)では、リポジトリの通常実行中にすべてのファイルがコピーされます。このプロセスには次の 2 つのフェーズがあります。
    • フェーズ A - データストアを除くすべてのものがコピーされます(遅延付き)。
    • フェーズ B - データストアのみがコピーされます(遅延付き)。
  2. 第 2 コピーステージ(進行状況インジケーターの値は zip ファイルの作成時は 63~65.8%、zip ファイルを作成しない場合は 90~94%)では、第 1 コピーステージの開始以降にソースディレクトリで作成または変更されたファイルのみがコピーされます。リポジトリでのアクティビティに応じて、ファイルがまったくコピーされないことも、(第 1 コピーステージは通常時間がかかるので)多数のファイルがコピーされることもあります。このコピープロセスは第 1 ステージと似ています(遅延付きのフェーズ A とフェーズ B)。
  3. 第 3 コピーステージ(進行状況インジケーターの値は zip ファイルの作成時は 65.8~68.6%、zip ファイルを作成しない場合は 94~98%)では、第 2 コピーステージの開始以降にソースディレクトリで作成または変更されたファイルのみがコピーされます。リポジトリでのアクティビティに応じて、ファイルがまったくコピーされないことも、(第 2 コピーステージは通常高速なので)わずかなファイルがコピーされることもあります。このコピープロセスは第 2 ステージと似ています(遅延なしのフェーズ A とフェーズ B)。
  4. ファイルコピーステージ 1~3 は、リポジトリの実行中すべて同時に実行されます。第 3 コピーステージの開始以降にソースディレクトリで作成または変更されたファイルのみがコピーされます。リポジトリのアクティビティに応じて、コピーするファイルがないことも、(第 2 コピーステージは通常非常に高速なので)ごくわずかなファイルがコピーされることもあります。進行状況インジケーターは、zip ファイルの作成時は 68.6~70%、zip ファイルを作成しない場合は 98~100%を示します。このコピープロセスは第 3 ステージと似ています。
  5. ターゲットに応じて、次の処理が実行されます。
    • zip ファイルが指定されている場合、この時点でこのファイルが一時ディレクトリから作成されます。進行状況インジケーターは 70~100%を示します。その後、一時ディレクトリが削除されます。
    • ターゲットがディレクトリの場合は、バックアップが完了したことを示すために、backupInProgress.txt という空のファイルが削除されます。

バックアップの復元

バックアップは次のように復元できます。

  • ファイルシステムのスナップショットのバックアップを実行した場合は、そのシステムのイメージを復元できます。
  • バックアップを zip ファイルとして作成した場合は、新しいフォルダーにコンテンツを解凍し、その解凍先から AEM を起動します。

パッケージバックアップ

コンテンツをバックアップおよび復元するには、いずれかのパッケージマネージャーを使用できます。コンテンツパッケージ形式を使用してコンテンツのバックアップおよび復元がおこなわれます。パッケージマネージャーでは、パッケージをより柔軟に定義および管理できます。

これらの個別のコンテンツパッケージ形式の機能およびトレードオフについて詳しくは、パッケージの使用方法を参照してください。

バックアップの範囲

パッケージマネージャーまたはコンテンツジッパーを使用してノードをバックアップすると、CRX では次の情報が保存されます。

  • 選択したツリーの下にあるリポジトリコンテンツ。
  • バックアップするコンテンツに使用されているノードタイプの定義
  • バックアップするコンテンツに使用されている名前空間の定義

バックアップの際に、AEM では次の情報が失われます。

  • バージョン履歴

本作品は Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License によってライセンス許可を受けています。  Twitter™ および Facebook の投稿には、Creative Commons の規約内容は適用されません。

法律上の注意   |   プライバシーポリシー