AEM 6 でのノードストアとデータストアの設定 configuring-node-stores-and-data-stores-in-aem

はじめに introduction

Adobe Experience Manager(AEM)では、バイナリデータをコンテンツノードとは独立して保存できます。バイナリデータはデータストアに格納され、コンテンツノードはノードストアに格納されます。

データストアとノードストアは、OSGi 設定を使用して設定できます。各 OSGi 設定は、永続的な識別子(PID)を使用して参照されます。

設定手順 configuration-steps

ノードストアおよびデータストアの両方を設定するには、次の手順を実行します。

  1. AEM クイックスタート jar ファイルをインストールディレクトリにコピーします。

  2. インストールディレクトリ内に crx-quickstart/install フォルダーを作成します。

  3. 最初に、ノードストアを設定します。そのためには、使用するノードストアオプションの名前を持つ設定ファイルを crx-quickstart/install ディレクトリに作成します。

    例えば、ドキュメントノードストア(AEM の MongoMK 実装の基盤)では、org.apache.jackrabbit.oak.plugins.document.DocumentNodeStoreService.config ファイルを使用します。

  4. ファイルを編集し、設定オプションを設定します。

  5. 使用するデータストアの PID を持つ設定ファイルを作成します。ファイルを編集し、設定オプションを設定します。

    note note
    NOTE
    設定オプションについては、ノードストアの設定およびデータストアの設定を参照してください。
  6. AEM を起動します。

ノードストア設定 node-store-configurations

CAUTION
新しいバージョンの Oak では、OSGi 設定ファイルの命名スキームと形式が新しく採用されています。新しい命名スキームでは、設定ファイルの名前は .config とし、新しい形式では、値を入力する必要があります。こちらを参照してください。
古いバージョンの Oak からアップグレードする場合は必ず、crx-quickstart/install フォルダーのバックアップを最初に作成してください。アップグレード後、アップグレードしたインストール環境にフォルダーの内容を復元し、設定ファイルの拡張子を .cfg から .config に変更します。
AEM 5.x ​インストールからのアップグレードの準備のためにこの記事を読んでいる場合、まず最初にアップグレードのドキュメントを確認してください。

セグメントノードストア segment-node-store

セグメントノードストアは、AEM6 におけるアドビの TarMK 実装の基盤です。このストアでは、org.apache.jackrabbit.oak.segment.SegmentNodeStoreService という PID を設定に使用します。

CAUTION
セグメントノードストアの PID が、AEM 6 の org.apache.jackrabbit.oak.plugins.segment.SegmentNodeStoreService in previous versions から AEM 6.3 の org.apache.jackrabbit.oak.segment.SegmentNodeStoreService に変更されました。この変更を反映するために必要な設定の調整を行ってください。

以下のオプションを設定できます。

  • repository.home:リポジトリのホームのパスです。リポジトリ関連のデータが格納されます。デフォルトでは、crx-quickstart/segmentstore ディレクトリにセグメントファイルが格納されます。

  • tarmk.size:セグメントの最大サイズ(MB 単位)です。デフォルトの最大サイズは 256 MB です。

  • customBlobStore:カスタムデータストアが使用されることを示すブール値です。AEM 6.3 以降のバージョンのデフォルト値は true です。AEM 6.3 より前のデフォルトは false でした。

以下に、org.apache.jackrabbit.oak.segment.SegmentNodeStoreService.config ファイルのサンプルを示します。

#Path to repo
repository.home="crx-quickstart/repository"

#Max segment size
tarmk.size=I"256"

#Custom data store
customBlobStore=B"true"

ドキュメントノードストア document-node-store

ドキュメントノードストアは、AEM の MongoMK 実装の基盤です。このストアでは、org.apache.jackrabbit.oak.plugins.document.DocumentNodeStoreService* * という PID を使用します。以下の設定オプションを使用できます。

  • mongouri:Mongo データベースに接続するために必要な MongoURI です。デフォルトは mongodb://localhost:27017 です

  • db:Mongo データベースの名前です。デフォルトは Oak です。. However, new AEM 6 installations use **aem-author** デフォルトのデータベース名として使用します。

  • cache:キャッシュサイズ(MB 単位)です。これは DocumentNodeStore で使用される様々なキャッシュに分散されます。デフォルトは 256 です

  • changesSize:Mongo で差分出力のキャッシュに使用される capped コレクションのサイズ(MB 単位)です。デフォルトは 256 です

  • customBlobStore:カスタムデータストアが使用されることを示すブール値です。デフォルトは false です。

以下に、org.apache.jackrabbit.oak.plugins.document.DocumentNodeStoreService.config ファイルのサンプルを示します。

#Mongo server details
mongouri="mongodb://localhost:27017"

#Name of Mongo database to use
db="aem-author"

#Store binaries in custom BlobStore
customBlobStore=B"false"

データストア設定 data-store-configurations

多数のバイナリを処理する場合は、最大限のパフォーマンスを確保するために、デフォルトのノードストアではなく外部のデータストアを使用することをお勧めします。

例えば、プロジェクトで多数のメディアアセットが必要な場合は、それらをファイルデータストアまたは S3 データストアに格納すると、MongoDB 内に直接格納するよりも迅速にアセットにアクセスできます。

ファイルデータストアは MongoDB よりも高いパフォーマンスを提供します。また、多数のアセットがある場合は、Mongo のバックアップおよび復元操作も遅くなります。

様々なデータストアおよび設定について詳しくは、次で説明します。

NOTE
カスタムデータストアを有効にするには、それぞれのノードストア設定ファイル(セグメントノードストアまたはドキュメントノードストア)で customBlobStoretrue に設定されていることを確認する必要があります。

ファイルデータストア file-data-store

これは Jackrabbit 2 に含まれる FileDataStore の実装であり、バイナリデータを通常のファイルとしてファイルシステムに格納する手段を提供します。このストアでは、org.apache.jackrabbit.oak.plugins.blob.datastore.FileDataStore という PID を使用します。

以下の設定オプションを使用できます。

  • repository.home:リポジトリのホームのパスです。リポジトリ関連の様々なデータが格納されます。デフォルトでは、crx-quickstart/repository/datastore ディレクトリにバイナリファイルが格納されます。

  • path:ファイルを格納するディレクトリのパスです。このオプションを指定すると、repository.home より優先されます。

  • minRecordLength:データストアに格納するファイルの最小サイズ(バイト単位)です。この値よりも小さいバイナリコンテンツはインライン化されます。

NOTE
NAS を使用して共有ファイルのデータストアを保存する場合は、パフォーマンスの問題を回避するために、必ず高パフォーマンスのデバイスのみを使用してください。

Amazon S3 データストア amazon-s-data-store

Amazon の Simple Storage Service(S3)にデータを格納するように AEM を設定できます。このストアでは、org.apache.jackrabbit.oak.plugins.blob.datastore.S3DataStore.config という PID を設定に使用します。

NOTE
AEM 6.5 では、Amazon S3 でのデータの保存がサポートされますが、他のプラットフォームでのデータ保存までサポートが拡張されるわけではありません。他のプラットフォームでは、Amazon S3 API の独自の実装方法がある可能性があります。

S3 データストア機能を有効にするには、S3 データストアコネクタを含む機能パックをダウンロードしてインストールする必要があります。アドビリポジトリに移動し、1.10.x バージョンの機能パックの中から最新のバージョン(com.adobe.granite.oak.s3connector-1.10.0.zip など)をダウンロードします。さらに、AEM 6.5 リリースノートページに記載されている最新の AEM サービスパックをダウンロードしてインストールする必要もあります。

NOTE
TarMK を選択して AEM を使用する場合、デフォルトでは、FileDataStore にバイナリが格納されます。S3 データストアと共に TarMK を使用するには、次の例のように、crx3tar-nofds 実行モードを使用して AEM を起動する必要があります。
java -jar <aem-jar-file>.jar -r crx3tar-nofds

ダウンロードが完了したら、次の手順に従って S3 コネクタをインストールして設定できます。

  1. 機能パック zip ファイルの内容を一時フォルダーに解凍します。

  2. 一時フォルダーに移動し、次の場所に移動します。

    code language-xml
    jcr_root/libs/system/install
    

    上述の場所からすべての内容を <aem-install>/crx-quickstart/install. にコピーします。

  3. Tar または MongoDB ストレージと連動するように AEM を設定済みの場合は、続行する前に、既存の設定ファイルを <aem-install>/crx-quickstart/install フォルダーから削除します。削除する必要があるファイルは次のとおりです。

    • For MongoMK: org.apache.jackrabbit.oak.plugins.document.DocumentNodeStoreService.config
    • For TarMK: org.apache.jackrabbit.oak.segment.SegmentNodeStoreService.config
  4. 機能パックを展開した一時的な場所に戻り、次のフォルダーの内容をコピーします。

    • jcr_root/libs/system/config

    コピー先:

    • <aem-install>/crx-quickstart/install

    現在の設定に必要な設定ファイルのみをコピーしてください。専用データストアと共有データストアのどちらの設定の場合も、org.apache.jackrabbit.oak.plugins.blob.datastore.S3DataStore.config ファイルをコピーします。

    note note
    NOTE
    クラスタ設定では、クラスタのすべてのノードで 1 つずつ上記の手順を実行します。また、すべてのノードで同じ S3 設定を使用するようにしてください。
  5. ファイルを編集し、設定に必要な設定オプションを追加します。

  6. AEM を起動します。

1.10.x S3 コネクターの新しいバージョンへのアップグレード upgrading-to-a-new-version-of-the-s-connector

1.10.x S3 コネクターを新しいバージョンにアップグレードする必要がある場合は(1.10.0 から 1.10.4 へのアップグレードなど)、次の手順に従います。

  1. AEM インスタンスを停止します。

  2. AEM インストールフォルダーの <aem-install>/crx-quickstart/install/15 に移動して、その内容のバックアップを作成します。

  3. バックアップ後、古いバージョンの S3 コネクターとその依存関係を削除します。そのためには、<aem-install>/crx-quickstart/install/15 フォルダー内の jar ファイル(以下のファイルなど)をすべて削除します。

    • oak-blob-cloud-1.6.1.jar
    • aws-java-sdk-osgi-1.10.76.jar
    note note
    NOTE
    上記のファイル名は説明の目的でのみ使用されます。
  4. アドビリポジトリから最新バージョンの 1.10.x 機能パックをダウンロードします。

  5. 機能パックの内容を別のフォルダーに展開して、jcr_root/libs/system/install/15 に移動します。

  6. jar ファイルを AEM インストールフォルダーの <aem-install>/crx-quickstart/install/15 にコピーします。

  7. AEM を起動して、コネクタの機能を確認します。

設定ファイルは、以下に説明するオプションと共に使用できます。

S3 Connector 設定ファイルオプション s3-connector-configuration-file-options

NOTE
S3 コネクタは、IAM ユーザー認証と IAM 役割認証の両方をサポートしています。 IAM 役割認証を使用するには、accessKey および secretKey の値を設定ファイルから削除します。 S3 コネクタは、デフォルトで IAM 役割インスタンスに割り当てられます。
キー
説明
デフォルト
必須
accessKey
バケットへのアクセス権を持つ IAM ユーザーのキー ID にアクセスします。
はい、IAM 役割を使用していない場合は有効です。
secretKey
バケットへのアクセス権を持つ IAM ユーザーの秘密アクセスキー。
はい、IAM 役割を使用していない場合は有効です。
cacheSize
ローカルキャッシュのサイズ(バイト単位)です。
64 GB
いいえ。
connectionTimeout
最初に接続を確立したときにタイムアウトするまでに待機する時間(ミリ秒単位)を設定します。
10000
いいえ。
maxCachedBinarySize
サイズがこの値(バイト単位)以下のバイナリは、メモリキャッシュに格納されます。
17408(17 KB)
いいえ。
maxConnections
許可されるオープン HTTP 接続の最大数を設定します。
50
いいえ。
maxErrorRetry
失敗(再試行可能)リクエストの再試行の最大回数を設定します。
3
いいえ。
minRecordLength
データストアに格納するオブジェクトの最小サイズ(バイト単位)です。
16384
いいえ。
path
AEM データストアのローカルパス。
crx-quickstart/repository/datastore
いいえ。
proxyHost
クライアントが接続するオプションのプロキシホストを設定します。
いいえ。
proxyPort
クライアントが接続するオプションのプロキシポートを設定します。
いいえ。
s3Bucket
S3 バケットの名前。
はい
s3EndPoint
S3 REST API エンドポイント。
いいえ。
s3Region
バケットが存在する地域。 詳しくは、このページを参照してください。
AWS インスタンスが実行されている地域。
いいえ。
socketTimeout
確立されたオープン接続を介してデータが転送され、接続がタイムアウトして閉じられるまでの待機時間(ミリ秒単位)を設定します。
50000
いいえ。
stagingPurgeInterval
完了したアップロードをステージングキャッシュからパージする間隔(秒単位)です。
300
いいえ。
stagingRetryInterval
失敗したアップロードを再試行する間隔(秒単位)です。
600
いいえ。
stagingSplitPercentage
非同期アップロードのステージングに使用される cacheSize の割合。
10
いいえ。
uploadThreads
非同期アップロードに使用されるアップロードスレッドの数です。
10
いいえ。
writeThreads
S3 転送マネージャーを介した書き込みに使用される同時スレッドの数。
10
いいえ。

データストアのキャッシュ data-store-caching

NOTE
S3DataStoreCachingFileDataStore および AzureDataStore のデータストア実装では、ローカルファイルシステムのキャッシュがサポートされています。CachingFileDataStore の実装は、データストアがネットワークファイルシステム(NFS)上にある場合に便利です。

古いキャッシュ実装(Oak 1.6 より前)からアップグレードする場合、ローカルファイルシステムのキャッシュディレクトリの構造に違いがあります。古いキャッシュ構造では、ダウンロードされたファイルとアップロードされたファイルの両方がキャッシュパスの直下に配置されていました。新しい構造では、ダウンロードとアップロードが分離され、キャッシュパス配下にある uploaddownload という名前の 2 つのディレクトリに格納されます。アップグレードプロセスはシームレスに行われ、保留中のアップロードがある場合はアップロードがスケジュールされ、キャッシュ内にダウンロード済みファイルがある場合は初期化時にキャッシュに配置されます。

oak-run の「datastorecacheupgrade」コマンドを使用して、キャッシュをオフラインでアップグレードすることもできます。このコマンドの実行方法について詳しくは、oak-run モジュールの README を参照してください。

キャッシュにはサイズ制限があり、cacheSize パラメーターを使用して設定できます。

ダウンロード downloads

データストアからアクセスする前に、要求されたファイル/Blob のレコードがローカルキャッシュでチェックされます。キャッシュにファイルを追加している際に、キャッシュが設定された制限(cacheSize パラメーターを参照)を超えると、領域を再利用できるように、ファイルの一部が消去されます。

非同期アップロード async-upload

キャッシュは、データストアへの非同期アップロードをサポートします。ファイルは(ファイルシステム上の)キャッシュ内でローカルにステージングされ、非同期ジョブがファイルのアップロードを開始します。非同期アップロードの数は、ステージングキャッシュのサイズによって制限されます。ステージングキャッシュのサイズは、stagingSplitPercentage パラメーターを使用して設定します。このパラメーターでは、ステージングキャッシュに使用するキャッシュサイズの割合(%)を定義します。また、ダウンロードに使用可能なキャッシュの割合(%)は、(100 - stagingSplitPercentage)*cacheSize として計算されます。

非同期アップロードはマルチスレッドです。スレッドの数は、uploadThreads パラメーターを使用して設定します。

アップロードが完了すると、ファイルはメインのダウンロードキャッシュに移動されます。ステージングキャッシュのサイズが上限を超えると、前回の非同期アップロードが完了し、ステージングキャッシュで領域が再び使用できるようになるまで、ファイルはデータストアに同期してアップロードされます。アップロードされたファイルは、定期ジョブによってステージング領域から削除されます。定期ジョブの間隔は、stagingPurgeInterval パラメーターで設定します。

(ネットワークの障害などが原因で)失敗したアップロードは再試行キューに配置され、定期的に再試行されます。再試行間隔は、stagingRetryInterval parameter パラメーターを使用して設定します。

Amazon S3 でのバイナリレスレプリケーションの設定 configuring-binaryless-replication-with-amazon-s

S3 でバイナリレスレプリケーションを設定するには、次の手順が必要です。

  1. オーサーインスタンスおよびパブリッシュインスタンスをインストールし、正しく起動していることを確認します。

  2. https://localhost:4502/etc/replication/agents.author/publish.html ページを開いて、レプリケーションエージェントの設定に移動します。

  3. 設定」セクションの「編集」ボタンを押します。

  4. シリアル化の種類」オプションを「バイナリなし」に変更します。

  5. binaryless= true」パラメーターをトランスポート URI に追加します。変更後、URI は次のようになります。

    https://localhost:4503/bin/receive?sling:authRequestLogin=1&binaryless=true

  6. すべてのオーサーインスタンスおよびパブリッシュインスタンスを再起動して、変更を有効にします。

S3 および MongoDB を使用したクラスターの作成 creating-a-cluster-using-s-and-mongodb

  1. 次のコマンドを使用して、CQ クイックスタートを解凍します。

    java -jar cq-quickstart.jar -unpack

  2. AEM を展開したら、crx-quickstart/install フォルダーをインストールディレクトリ内に作成します。

  3. 次の 2 つのファイルを crx-quickstart フォルダー内に作成します。

    • org.apache.jackrabbit.oak.plugins.document.DocumentNodeStoreServiceconfig

    • org.apache.jackrabbit.oak.plugins.blob.datastore.S3DataStoreconfig

    ファイルを作成した後、必要に応じて設定オプションを追加します。

  4. 前述のように、S3 データストアに必要な 2 つのバンドルをインストールします。

  5. MongoDB がインストールされていること、および mongod のインスタンスが実行されていることを確認します。

  6. 次のコマンドを使用して AEM を起動します。

    java -Xmx1024m -jar cq-quickstart.jar -r crx3,crx3mongo

  7. 2 つ目の AEM インスタンスに対して、手順 1 ~ 4 を繰り返します。

  8. 2 つ目の AEM インスタンスを起動します。

共有データストアの設定 configuring-a-shared-data-store

  1. まず、データストアを共有するために必要な各インスタンスに、次のようなデータストア設定ファイルを作成します。

    • FileDataStore を使用する場合、org.apache.jackrabbit.oak.plugins.blob.datastore.FileDataStore.config という名前のファイルを作成し、<aem-install>/crx-quickstart/install フォルダーに格納します。

    • S3 をデータストアとして使用する場合、前述のように rg.apache.jackrabbit.oak.plugins.blob.datastore.S3DataStore.config という名前のファイルを <aem-install>/crx-quickstart/install フォルダーに作成します。

  2. 各インスタンスのデータストア設定ファイルを変更し、同じデータストアを指すようにします。詳しくは、このページを参照してください。

  3. インスタンスのクローンが既存のサーバーから作成された場合、リポジトリがオフラインになっている間に、最新の oak-run ツールを使用して新しいインスタンスの clusterId を削除する必要があります。実行する必要があるコマンドは次のとおりです。

    code language-xml
    java -jar oak-run.jar resetclusterid < repository path | Mongo URI >
    
    note note
    NOTE
    セグメントノードストアを設定する場合、リポジトリパスを指定する必要があります。デフォルトでは、パスは <aem-install-folder>/crx-quickstart/repository/segmentstore. です。ドキュメントノードストアを設定する場合、Mongo の接続文字列 URI を使用できます。
    note note
    NOTE
    Oak-run ツールは、次の場所からダウンロードできます。
    https://mvnrepository.com/artifact/org.apache.jackrabbit/oak-run/
    AEM のインストールで使用する Oak バージョンに応じて、異なるバージョンのツールを使用する必要があります。ツールを使用する前に、次のバージョン要件リストを確認してください。
    code language-none
    * Oak バージョン **1.2.x** については、Oak-run **1.2.12 以降**​を使用します
    * **上述のものよりも新しい** Oak バージョンについては、AEM インストールの Oak コアと一致するバージョンの oak-run を使用します。
    
  4. 最後に、設定を検証します。検証するには、共有している各リポジトリによってデータストアに追加された一意のファイルを探します。ファイルの形式は repository-[UUID] です。UUID は、個々のリポジトリーの一意の識別子です。

    したがって、適切な設定には、データストアを共有するリポジトリと同じ数の一意のファイルを含める必要があります。

    ファイルの保存方法は、データストアに応じて異なります。

    • FileDataStore の場合、データストアフォルダーのルートパスにファイルが作成されます。
    • S3DataStore の場合、設定済みの S3 バケットの META フォルダーにファイルが作成されます。

Azure データストア azure-data-store

AEM は、Microsoft®の Azure ストレージサービスにデータを保存するように設定できます。このストアでは、org.apache.jackrabbit.oak.plugins.blob.datastore.AzureDataStore.config という PID を設定に使用します。

Azure データストア機能を有効にするには、Azure コネクタを含む機能パックをダウンロードしてインストールする必要があります。アドビリポジトリにアクセスし、1.6.x バージョンの機能パックの中から最新バージョン(com.adobe.granite.oak.azureblobconnector-1.6.3.zip など)をダウンロードします。

NOTE
TarMK と AEM を使用する場合、デフォルトでは FileDataStore にバイナリが格納されます。Azure データストアと TarMK を使用する場合、次の例のように、crx3tar-nofds 実行モードを使用して AEM を起動する必要があります。
java -jar <aem-jar-file>.jar -r crx3tar-nofds

ダウンロードが完了したら、次の手順に従って Azure コネクタをインストールして設定できます。

  1. 機能パック zip ファイルの内容を一時フォルダーに解凍します。

  2. 一時フォルダーに移動し、jcr_root/libs/system/install の内容を <aem-install>crx-quickstart/install フォルダーにコピーします。

  3. Tar または MongoDB ストレージと連動するように AEM を設定済みの場合は、続行する前に、既存の設定ファイルを /crx-quickstart/install フォルダーから削除します。削除する必要があるファイルは次のとおりです。

    MongoMK の場合:

    org.apache.jackrabbit.oak.plugins.document.DocumentNodeStoreService.config

    TarMK の場合:

    org.apache.jackrabbit.oak.segment.SegmentNodeStoreService.config

  4. 機能パックを展開した一時的な場所に戻り、jcr_root/libs/system/config の内容を <aem-install>/crx-quickstart/install フォルダーにコピーします。

  5. 設定ファイルを編集し、設定に必要な設定オプションを追加します。

  6. AEM を起動します。

設定ファイルは、次のオプションと共に使用できます。

  • azureSas="":コネクタのバージョン 1.6.3 で、Azure Shared Access Signature(SAS)のサポートが追加されました。SAS とストレージ資格情報の両方が設定ファイルに存在する場合は、SAS が優先されます。 SAS について詳しくは、公式ドキュメントを参照してください。「=」文字は必ず、「=」のようにエスケープしてください。

  • azureBlobEndpoint="":Azure Blob エンドポイントです。例えば、https://<storage-account>.blob.core.windows.net などです。

  • accessKey="":ストレージアカウント名です。Microsoft® Azure の認証資格情報について詳しくは、公式ドキュメントを参照してください。

  • secretKey="":ストレージアクセスキーです。「=」文字は必ず、「=」のようにエスケープしてください。

  • container="":Microsoft® Azure Blob ストレージコンテナ名。コンテナは、一連の Blob をグループ化したものです。詳しくは、公式ドキュメントを参照してください。

  • maxConnections="":1 回の操作における同時リクエスト数。デフォルト値は 1 です。

  • maxErrorRetry="":要求ごとの再試行回数です。デフォルト値は 3 です。

  • socketTimeout="":要求に使用するタイムアウト間隔(ミリ秒単位)です。デフォルト値は 5 分です。

上述の設定に加えて、次の設定も指定できます。

  • path:データストアのパス。 デフォルトは <aem-install>/repository/datastore. です
  • RecordLength:データストアに格納するオブジェクトの最小サイズです。デフォルト値は 16 KB です。
  • maxCachedBinarySize:このサイズ以下のサイズのバイナリは、メモリキャッシュに格納されます。サイズはバイト単位です。デフォルト値は 17408 KB(17 KB)です。
  • cacheSize:キャッシュのサイズです。値はバイト数で指定されます。デフォルト値は 64 GB です。
  • secret:共有データストア設定でバイナリなしのレプリケーションを使用する場合にのみ使用します。
  • stagingSplitPercentage:非同期アップロードのステージングに使用するように設定されたキャッシュサイズの割合(%)です。デフォルト値は 10 です。
  • uploadThreads:非同期アップロードに使用するアップロードスレッドの数です。デフォルト値は 10 です。
  • stagingPurgeInterval:完了したアップロードをステージングキャッシュからパージする間隔(秒単位)です。デフォルト値は 300 秒(5 分)です。
  • stagingRetryInterval:失敗したアップロードの再試行間隔(秒単位)です。デフォルト値は 600 秒(10 分)です。
NOTE
すべての設定を引用符で囲む必要があります。例:
accessKey="ASDASDERFAERAER"
secretKey="28932hfjlkwdo8fufsdfas\=\="

データストアのガベージコレクション data-store-garbage-collection

データストアのガベージコレクションプロセスは、データストア内の未使用のファイルを削除するために使用します。このプロセスによって、貴重なディスク領域が解放されます。

データストアのガベージコレクションを実行する手順は次のとおりです。

  1. JMX コンソール(https://<serveraddress:port>/system/console/jmx)に移動します。

  2. RepositoryManagement を検索します。 Repository Manager MBean を見つけたら、それをクリックして使用可能なオプションを表示します。

  3. ページの最後までスクロールし、startDataStoreGC(boolean markOnly) ​リンクをクリックします。

  4. 次に示すダイアログで markOnly パラメーターに false と入力して、「Invoke」をクリックします。

    chlimage_1-9

    note note
    NOTE
    markOnly パラメーターは、ガベージコレクションのスイープフェーズを実行するかどうかを示します。

共有データストア用データストアガベージコレクション data-store-garbage-collection-for-a-shared-data-store

NOTE
クラスター化または共有データストアでガベージコレクションを実行する際に、(Mongo または Segment Tar を使用して)設定すると、特定の Blob ID を削除できないことに関する警告がログに表示される場合があります。以前のガベージコレクションで削除された Blob ID が、その ID 削除の情報を持たない他のクラスターまたは共有ノードによって誤って再度参照されることがあります。その結果、前回の実行時に既に削除された ID を、ガベージコレクションで再度削除しようとするので、警告がログに記録されます。この動作は、パフォーマンスや機能に影響しません。
NOTE
共有データストアの設定を使用している場合、データストアのガベージコレクションが無効になった状態で、Lucene Binary クリーンアップタスクを実行すると、使用するディスク領域が突然増加することがあります。次の手順を実行して、すべてのオーサーインスタンスおよびパブリッシュインスタンスで BlobTracker を無効にすることを検討してください。
  1. AEM インスタンスを停止します。
  2. crx-quickstart/install/org.apache.jackrabbit.oak.segment.SegmentNodeStoreService.config ファイルで blobTrackSnapshotIntervalInSecs=L"0" パラメーターを追加します。このパラメーターを使用するには、Oak 1.12.0、1.10.2 以降のバージョンが必要です。
  3. AEM インスタンスを再起動します。

新しいバージョンの AEM では、複数のリポジトリによって共有されるデータストアでもガベージコレクションを実行できます。共有データストアでデータストアガベージコレクションを実行できるようにするには、次の手順に従います。

  1. データストアのガベージコレクション用に設定されたメンテナンスタスクが、データストアを共有するすべてのリポジトリインスタンスで無効になっていることを確認します。

  2. データストアを共有する​ すべての ​リポジトリーインスタンスについて、バイナリガベージコレクションで指示されたステップを実行します。ただし、呼び出しボタンをクリックする前に必ず markOnly パラメーターに対して true を入力してください。

    chlimage_1-10

  3. 前述の手順がすべてのインスタンスで完了したら、いずれかの ​インスタンスからデータストアガベージコレクションを再び実行します。

    1. JMX コンソールに移動し、「Repository Manager Mbean」を選択します。
    2. startDataStoreGC(boolean markOnly) リンクをクリックします。
    3. 次のダイアログで、markOnly パラメーターに再度 false を入力してください。

    以前に使用したマークフェーズで見つかったすべてのファイルを照合して、未使用の残りのファイルがデータストアから削除されます。

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2