Backup Service（バックアップ・サービス）構成オプションのリファレンス

Backup Service（バックアップ・サービス）構成オプションのリファレンスでは、構成ファイルごとに使用できる構成オプションをアルファベット順に示します。構成ファイルとその優先順位に関連する動作の詳細については、「OpsCenterの構成ファイル」を参照してください。

Backup Service（バックアップ・サービス）のOpsCenterデーモン構成オプション

Backup Service（バックアップ・サービス）のクラスター構成オプション

cluster_name.confでは以下のオプションを使用できます。

[agents] backup_staging_dir

このパスは、各ノードでコミット・ログを格納して保持するディレクトリーを指定します。コミット・ログ・アーカイブを有効にする前に、このプロパティを設定する必要があります。

[agents] concurrent_snapshot_list_requests

スナップショット情報の同時取得要求の数。デフォルト値は1です。

[agents] remote_backup_region

リモート・バックアップ/復元のために接続するS3リージョン。デフォルト値はus-west-1です。

[agents] restore_req_update_period

復元中にOpsCenterに進行状況を報告する間隔（秒）。デフォルト値は、クラスターのサイズに基づいて自動的に計算されます。パフォーマンスを最適化するため、クラスターが大きいほど復元の進行状況がUIに送信されるしきい値が大きくなります。復元中に最新情報を取得する間隔を変更するには、このプロパティを構成します。注：数値を小さくすると、復元中にパフォーマンスに影響を及ぼす可能性があります。

[agents] snapshot_wait

「[cassandra] snapshot_threshold」を参照してください。

[backups] failure_threshold

リモート・デスティネーション復元アクションが失敗と見なされるまでにクラスターが応答に失敗できる割合（%）。デフォルト：50。

[backups] restore_init_throttle

OpsCenterが復元プロセスを同時に開始するエージェントの数。デフォルト値は20です。

[backups] restore_sleep

OpsCenterがrestore_init_throttleで設定された復元プロセス開始のバッチ間にスリープする時間。デフォルト値は5秒です。

[cassandra] snapshot_threshold

OpsCenterが要求を受信してすぐにバックアップを実行する状態から、1分単位で切り上げた時刻にsnapshot_waitに設定した時間を加えた時間が経過した後でバックアップを実行するようにスケジュールする状態に切り替わる、クラスター内のノード数の上限。デフォルト値は10です。クラスター内のノード数が10以下の場合、OpsCenterはすべてのノードに、要求を受信したらすぐにスナップショットを作成するように指示します。ノード数が10を超えると、OpsCenterはすべてのノードに、1分単位で切り上げた現在の時刻にsnapshot_wait秒を加えた時刻にスナップショットを作成するように指示します。

Backup Service（バックアップ・サービス）のエージェント構成オプション

address.yamlでは、以下のエージェント構成オプションを使用できます。

backup_staging_dir

バックアップするコミット・ログのステージングに使用するディレクトリー。デフォルトの場所は/var/lib/datastax-agent/commitlogs/です。例：backup_staging_dir: /var/lib/datastax-agent/commitlogs/

destination_pretest_timeout

デスティネーションへの読み取りと書き込みが可能であることを確認するための最大時間（秒）。デフォルト：60。例：destination_pretest_timeout: 60

destinations

デスティネーションの定義のバックアップと復元を行います。各デスティネーションは、キーとしてティネーションIDを持ち、そのタイプのデスティネーションに固有のオプションを持つマップ内のエントリーです。例：destinations: {"4798b1cdb3a145f0b4fa8ef7b3e20309" {:throttle_bytes_per_second "0", :path "s3-bucket", :server_side_encryption "False", :provider "s3", :access_key "key", :access_secret "secret"}}

max_file_transfer_attempts

ファイルのアップロード、またはリモート・デスティネーションの作成の最大試行回数。デフォルト：3。例：max_file_transfer_attempts: 30

remote_backup_region

リモート・バックアップの転送に使用するAWSリージョン。デフォルト：us-west-1。例：remote_backup_region: us-west-1

remote_backup_retries

復元時にファイルのダウンロードが失敗したときの試行回数。デフォルト：3。例：remote_backup_retries: 3

remote_backup_timeout

バックアップをリモート・デスティネーションにプッシュする際に使用する接続のタイムアウト（ミリ秒）。デフォルト：1000。例：remote_backup_timeout: 1000

remote_verify_initial_delay

バックアップ操作時にファイルが正常にアップロードされたかどうかを確認するため待機する初期遅延（ミリ秒）。この構成オプションはremote_verify_maxオプションと併用して、SSTableをクリーンアップする際にバックアップが破損しているのか、または遅れているのかを区別することができます。remote_verify_initial_delayの値は、この値がremote_verify_maxの値を超えるまで、ファイル転送検証が失敗するたびに倍増します。デフォルト：1000（1秒）。例：remote_verify_initial_delay: 1000

remote_verify_max

ファイルのアップロードは完了したが、リモート・デスティネーションから読み取ることができない場合の最大待機時間。この遅延時間を超えると、転送は失敗と見なされます。この構成オプションは、remote_verify_initial_delayオプションと併用して、SSTableをクリーンアップする際にバックアップが破損しているのか、または遅れているのかを区別することができます。デフォルト：30000（30秒）。例：remote_verify_max: 300000

restore_on_transfer_failure

trueに設定すると、リモート・デスティネーションからのファイル転送が失敗しても、復元プロセスは停止されません。以降の復元では、転送に成功したファイルが使用されます。デフォルト：false。例：restore_on_transfer_failure: false

restore_req_update_period

Backup Service（バックアップ・サービス）の復元操作中にopscenterdにステータス更新が送信される間隔（秒）。デフォルト：60。例：restore_req_update_period: 60

sstableloader_max_heap_size

復元操作中にsstableloaderで使用される最大ヒープ・サイズ。DSE 4.8.4以降でのみサポートされています。デフォルト：256M。例：sstableloader_max_heap_size: 256M

tmp_dir

バックアップに使用するBackup Service（バックアップ・サービス）のステージング・ディレクトリーの場所。デフォルトの場所は/var/lib/datastax-agent/tmpです。例：tmp_dir: /var/lib/datastax-agent/tmp/