付録G Object Storage Daemon (OSD) の設定オプション
デプロイメント時に設定可能な Ceph Object Storage Daemon (OSD) の設定オプションを以下に示します。
これらの設定オプションは、ceph config set osd CONFIGURATION_OPTION VALUE コマンドを使用して設定できます。
- osd_uuid
- 説明
- Ceph OSD の Universally Unique Identifier (UUID)
- 型
- UUID
- デフォルト
- UUID
- 備考
-
osd uuidは単一の Ceph OSD に適用されます。fsidはクラスター全体に適用されます。
- osd_data
- 説明
OSD のデータへのパスCeph のデプロイ時にディレクトリーを作成する必要があります。OSD データ用のドライブをこのマウントポイントにマウントします。
IMPORTANT: Red Hat does not recommend changing the default.
- 型
- String
- デフォルト
-
/var/lib/ceph/osd/$cluster-$id
- osd_max_write_size
- 説明
- 書き込みの最大サイズ (メガバイト)
- 型
- 32 ビット整数
- デフォルト
-
90
- osd_client_message_size_cap
- 説明
- メモリー上で許可される最大のクライアントデータメッセージ
- 型
- 64 ビット整数未署名
- デフォルト
-
500 MB のデフォルト
500*1024L*1024L
- osd_class_dir
- 説明
- RADOS クラスのプラグインのクラスパス
- 型
- String
- デフォルト
-
$libdir/rados-classes
- osd_max_scrubs
- 説明
- Ceph OSD ごとの同時スクラブ操作の最大数
- 型
- 32 ビット整数
- デフォルト
-
1
- osd_scrub_thread_timeout
- 説明
- スクラブスレッドがタイムアウトするまでの最大時間 (秒単位)
- 型
- 32 ビット整数
- デフォルト
-
60
- osd_scrub_finalize_thread_timeout
- 説明
- スクラブ最終スレッドがタイムアウトするまでの最大時間 (秒単位)
- 型
- 32 ビット整数
- デフォルト
-
60*10
- osd_scrub_begin_hour
- 説明
-
これにより、スクラブは 1 日のこの時間以降に制限されます。
osd_scrub_begin_hour = 0およびosd_scrub_end_hour = 0を使用して、1 日中スクラブできるようにします。osd_scrub_end_hourとともに、スクラブが発生する時間枠を定義できます。ただし、配置グループのスクラブ間隔がosd_scrub_max_intervalを超えている限り、時間ウィンドウが許可するかどうかに関係なく、スクラブが実行されます。 - 型
- Integer
- デフォルト
-
0 - 許容範囲
-
[0,23]
- osd_scrub_end_hour
- 説明
-
これにより、スクラブはこれより前の 1 時間に制限されます。
osd_scrub_begin_hour = 0およびosd_scrub_end_hour = 0を使用して、1 日住スクラブできるようにします。osd_scrub_begin_hourとともに、スクラブが発生する時間枠を定義できます。ただし、配置グループのスクラブ間隔がosd_scrub_max_intervalを超えている限り、時間ウィンドウが許可するかどうかに関係なく、スクラブが実行されます。 - 型
- Integer
- デフォルト
-
0 - 許容範囲
-
[0,23]
- osd_scrub_load_threshold
- 説明
-
最大の負荷。(
getloadavg()関数で定義された) システムの負荷がこの数値よりも大きい場合、Ceph はスクラブを実行しません。デフォルトは0.5です。 - 型
- 浮動小数点 (Float)
- デフォルト
-
0.5
- osd_scrub_min_interval
- 説明
- Red Hat Ceph Storage クラスターの負荷が低いときに、Ceph OSD をスクラブする最小の間隔 (秒単位)
- 型
- 浮動小数点 (Float)
- デフォルト
-
1 日 1 回。
60*60*24
- osd_scrub_max_interval
- 説明
- クラスター負荷に関わらず Ceph OSD をスクラビングする最大の間隔 (秒単位)。
- 型
- 浮動小数点 (Float)
- デフォルト
-
1 週間に 1 回。
7*60*60*24
- osd_scrub_interval_randomize_ratio
- 説明
-
比率を取り、
osd scrub min intervalおよびosd scrub max intervalの間隔の間でスケジュールされたスクラブをランダム化します。 - 型
- 浮動小数点 (Float)
- デフォルト
-
0.5。
- mon_warn_not_scrubbed
- 説明
-
スクラブされていない PG について警告する
osd_scrub_intervalからの秒数。 - 型
- Integer
- デフォルト
-
0(警告なし)。
- osd_scrub_chunk_min
- 説明
-
オブジェクトストアは、ハッシュの境界で終わるチャンクに分割されています。チャンキースクラブの場合、Ceph はオブジェクトを 1 チャンクずつスクラブし、そのチャンクへの書き込みをブロックします。
osd scrub chunk min設定は、スクラビングするチャンクの最小数を表します。 - 型
- 32 ビット整数
- デフォルト
-
5
- osd_scrub_chunk_max
- 説明
- スクラブするチャンクの最大数
- 型
- 32 ビット整数
- デフォルト
-
25
- osd_scrub_sleep
- 説明
- ディープスクラブ操作の間のスリープ時間
- 型
- 浮動小数点 (Float)
- デフォルト
-
0(またはオフ)
- osd_scrub_during_recovery
- 説明
- リカバリー時のスクラブを可能にします。
- 型
- ブール (Bool)
- デフォルト
-
false
- osd_scrub_invalid_stats
- 説明
- 無効と判定された統計情報を修正するために、強制的に追加のスクラブを実行します。
- 型
- ブール (Bool)
- デフォルト
-
true
- osd_scrub_priority
- 説明
- クライアント I/O に対するスクラブ操作のキューの優先順位を制御します。
- 型
- 32 ビット符号なし整数
- デフォルト
-
5
- osd_requested_scrub_priority
- 説明
-
ワークキュー上のユーザー要求のスクラブに設定された優先順位。この値が
osd_client_op_priorityより小さい場合、スクラブがクライアント操作をブロックしているときに、この値をosd_client_op_priorityの値まで上げることができます。 - 型
- 32 ビット符号なし整数
- デフォルト
-
120
- osd_scrub_cost
- 説明
- キューのスケジューリングのために、スクラブ操作のコストをメガバイト単位で表したもの。
- 型
- 32 ビット符号なし整数
- デフォルト
-
52428800
- osd_deep_scrub_interval
- 説明
-
すべてのデータを完全に読み込むディープスクラビングのための間隔。
osd scrub load thresholdパラメーターは、この設定には影響を与えません。 - 型
- 浮動小数点 (Float)
- デフォルト
-
1 週間に 1 回。
60*60*24*7
- osd_deep_scrub_stride
- 説明
- デープスクラブを実施する際の読み取りサイズ
- 型
- 32 ビット整数
- デフォルト
-
512 KB。
524288
- mon_warn_not_deep_scrubbed
- 説明
-
スクラビングされていない PG について警告する
osd_deep_scrub_intervalからの秒数。 - 型
- Integer
- デフォルト
-
0(警告なし)。
- osd_deep_scrub_randomize_ratio
- 説明
-
スクラブが無作為にディープスクラビングになる変化 (
osd_deep_scrub_intervalが経過する可能性も) - 型
- 浮動小数点 (Float)
- デフォルト
-
0.15または 15%
- osd_deep_scrub_update_digest_min_age
- 説明
- スクラブがオブジェクト全体のダイジェストを更新するまでに、オブジェクトが何秒経過していなければならないか。
- 型
- Integer
- デフォルト
-
7200(120 時間)。
- osd_deep_scrub_large_omap_object_key_threshold
- 説明
- これより多くの OMAP キーを持つオブジェクトに遭遇した場合の警告。
- 型
- Integer
- デフォルト
-
200000
- osd_deep_scrub_large_omap_object_value_sum_threshold
- 説明
- これより多くの OMAP キーバイトを持つオブジェクトに遭遇した場合に警告が表示されます。
- 型
- Integer
- デフォルト
-
1 G
- osd_delete_sleep
- 説明
- 次の削除トランザクションまでのスリープ時間 (秒)。これにより、配置グループの削除プロセスにスロットリングを適用されます。
- 型
- 浮動小数点 (Float)
- デフォルト
-
0.0
- osd_delete_sleep_hdd
- 説明
- HDD の次の削除トランザクションまでのスリープ時間 (秒)。
- 型
- 浮動小数点 (Float)
- デフォルト
-
5.0
- osd_delete_sleep_ssd
- 説明
- SSD の次の削除トランザクションまでのスリープ時間 (秒)。
- 型
- 浮動小数点 (Float)
- デフォルト
-
1.0
- osd_delete_sleep_hybrid
- 説明
- Ceph OSD データが HDD にあり、OSD ジャーナルまたは WAL と DB が SSD にある場合の、次の削除トランザクションまでのスリープ時間 (秒)。
- 型
- 浮動小数点 (Float)
- デフォルト
-
1.0
- osd_op_num_shards
- 説明
- クライアント操作のためのシャード数
- 型
- 32 ビット整数
- デフォルト
-
0
- osd_op_num_threads_per_shard
- 説明
- クライアント操作のためのシャードあたりのスレッド数
- 型
- 32 ビット整数
- デフォルト
-
0
- osd_op_num_shards_hdd
- 説明
- HDD 操作のためのシャード数
- 型
- 32 ビット整数
- デフォルト
-
5
- osd_op_num_threads_per_shard_hdd
- 説明
- HDD 操作のためのシャードあたりのスレッド数
- 型
- 32 ビット整数
- デフォルト
-
1
- osd_op_num_shards_ssd
- 説明
- SSD 操作のためのシャード数
- 型
- 32 ビット整数
- デフォルト
-
8
- osd_op_num_threads_per_shard_ssd
- 説明
- SSD 操作のためのシャードあたりのスレッド数
- 型
- 32 ビット整数
- デフォルト
-
2
- osd_op_queue
- 説明
- Ceph OSD 内での操作の優先順位付けに使用されるキューのタイプを設定します。OSD デーモンの再起動が必要です。
- 型
- String
- デフォルト
-
wpq - 有効な選択肢
-
wpq、mclock_scheduler、debug_random
重要
mClock OSD スケジューラーは、テクノロジープレビュー機能としてのみご利用いただけます。テクノロジープレビュー機能は、実稼働環境での Red Hat サービスレベルアグリーメント (SLA) ではサポートされておらず、機能的に完全ではない可能性があるため、Red Hat では実稼働環境での使用を推奨していません。テクノロジープレビュー機能は、最新の製品機能をいち早く提供して、開発段階で機能のテストを行いフィードバックを提供していただくことを目的としています。詳細は、Red Hat テクノロジープレビュー機能のサポート範囲 を参照してください。
osd_op_queue_cut_off- 説明
ストリクトキューと通常のキューに送信する操作の優先度を設定します。OSD デーモンの再起動が必要です。
low に設定すると、すべてのレプリケーション以上の操作はストリクトキューに送信され、high に設定するとレプリケーション確認操作以上の操作のみストリクトキューに送信されます。
高く設定した場合、特に
osd_op_queue設定のwpqオプションと組み合わせると、クラスター内の一部の Ceph OSD が非常にビジーな場合に役立ちます。レプリケーショントラフィックの処理で非常にビジーな Ceph OSD は、これらの設定がないと、OSD のプライマリークライアントトラフィックを枯渇させる可能性があります。- 型
- String
- デフォルト
-
高 - 有効な選択肢
-
low、high、debug_random
- osd_client_op_priority
- 説明
-
クライアントの操作に設定されている優先順位。これは、
osd recovery op priorityと相対的になります。 - 型
- 32 ビット整数
- デフォルト
-
63 - 有効な範囲
- 1-63
- osd_recovery_op_priority
- 説明
-
復元の操作に設定されている優先順位。これは、
osd client op priorityと相対的になります。 - 型
- 32 ビット整数
- デフォルト
-
3 - 有効な範囲
- 1-63
- osd_op_thread_timeout
- 説明
- Ceph OSD 操作スレッドのタイムアウト (秒単位)
- 型
- 32 ビット整数
- デフォルト
-
15
- osd_op_complaint_time
- 説明
- 指定された秒数が経過すると、クレームに値する操作になります。
- 型
- 浮動小数点 (Float)
- デフォルト
-
30
- osd_disk_threads
- 説明
- スクラビングやスナップトリミングなど、バックグラウンドでのディスクを多用する OSD 操作に使用されるディスクスレッドの数
- 型
- 32 ビット整数
- デフォルト
-
1
- osd_op_history_size
- 説明
- 追跡する完了した操作の最大数
- 型
- 32 ビット未署名の整数
- デフォルト
-
20
- osd_op_history_duration
- 説明
- 追跡する最も古い完了した操作
- 型
- 32 ビット未署名の整数
- デフォルト
-
600
- osd_op_log_threshold
- 説明
- 一度に表示する操作ログの数
- 型
- 32 ビット整数
- デフォルト
-
5
- osd_op_timeout
- 説明
- 実行中の OSD 操作がタイムアウトするまでの時間 (秒)
- 型
- Integer
- デフォルト
-
0
重要
クライアントが結果に対応できない限り、osd op timeout オプションを設定しないでください。例えば、仮想マシン上で動作するクライアントにこのパラメーターを設定すると、仮想マシンがこのタイムアウトをハードウェアの故障と解釈するため、データの破損につながる可能性があります。
- osd_max_backfills
- 説明
- 1 つの OSD に対して、または 1 つの OSD から許容されるバックフィル操作の最大数
- 型
- 64 ビット未署名の整数
- デフォルト
-
1
- osd_backfill_scan_min
- 説明
- バックフィルスキャン 1 回あたりのオブジェクトの最小数
- 型
- 32 ビット整数
- デフォルト
-
64
- osd_backfill_scan_max
- 説明
- バックフィルスキャン 1 回あたりのオブジェクトの最大数
- 型
- 32 ビット整数
- デフォルト
-
512
- osd_backfill_full_ratio
- 説明
- Ceph OSD のフル比率がこの値以上の場合、バックフィル要求の受け入れを拒否します。
- 型
- 浮動小数点 (Float)
- デフォルト
-
0.85
- osd_backfill_retry_interval
- 説明
- バックフィル要求を再試行するまでの待ち時間 (秒数)
- 型
- Double
- デフォルト
-
30.000000
- osd_map_dedup
- 説明
- OSD マップの重複の削除を有効にします。
- 型
- Boolean
- デフォルト
-
true
- osd_map_cache_size
- 説明
- OSD マップキャッシュのサイズ (メガバイト)
- 型
- 32 ビット整数
- デフォルト
-
50
- osd_map_cache_bl_size
- 説明
- OSD デーモンのメモリー内 OSD マップキャッシュのサイズ
- 型
- 32 ビット整数
- デフォルト
-
50
- osd_map_cache_bl_inc_size
- 説明
- OSD デーモンのメモリー内 OSD マップキャッシュの増分サイズ
- 型
- 32 ビット整数
- デフォルト
-
100
- osd_map_message_max
- 説明
- MOSDMap メッセージごとに許容される最大のマップエントリー数
- 型
- 32 ビット整数
- デフォルト
-
40
- osd_snap_trim_thread_timeout
- 説明
- スナップトリムスレッドがタイムアウトするまでの最大時間 (秒単位)
- 型
- 32 ビット整数
- デフォルト
-
60*60*1
- osd_pg_max_concurrent_snap_trims
- 説明
- PG ごとの並列スナップトリムの最大数。PG ごとに何個のオブジェクトを一度にトリミングするかを制御します。
- 型
- 32 ビット整数
- デフォルト
-
2
- osd_snap_trim_sleep
- 説明
- PG が発行する各トリム操作の間にスリープを挿入します。
- 型
- 32 ビット整数
- デフォルト
-
0
- osd_snap_trim_sleep_hdd
- 説明
- HDD の次のスナップショットトリミングまでのスリープ時間 (秒)。
- 型
- 浮動小数点 (Float)
- デフォルト
-
5.0
- osd_snap_trim_sleep_ssd
- 説明
- NVMe を含む SSD OSD の次のスナップショットトリミング操作までのスリープ時間 (秒単位)。
- 型
- 浮動小数点 (Float)
- デフォルト
-
0.0
- osd_snap_trim_sleep_hybrid
- 説明
- OSD データが HDD 上にあり、OSD ジャーナルまたは WAL および DB が SSD 上にある場合の、次のスナップショットトリミング操作までのスリープ時間 (秒単位)。
- 型
- 浮動小数点 (Float)
- デフォルト
-
2.0
- osd_max_trimming_pgs
- 説明
- トリミング PG の最大数
- 型
- 32 ビット整数
- デフォルト
-
2
- osd_backlog_thread_timeout
- 説明
- バックログスレッドがタイムアウトするまでの最大時間 (秒単位)
- 型
- 32 ビット整数
- デフォルト
-
60*60*1
- osd_default_notify_timeout
- 説明
- OSD デフォルト通知のタイムアウト (単位: 秒)
- 型
- 32 ビット符号なし整数
- デフォルト
-
30
- osd_check_for_log_corruption
- 説明
- ログファイルが破損していないか確認します。計算量が多くなる可能性があります。
- 型
- Boolean
- デフォルト
-
false
- osd_remove_thread_timeout
- 説明
- OSD 削除スレッドがタイムアウトするまでの最大時間 (秒単位)
- 型
- 32 ビット整数
- デフォルト
-
60*60
- osd_command_thread_timeout
- 説明
- コマンドスレッドがタイムアウトするまでの最大時間 (秒単位)
- 型
- 32 ビット整数
- デフォルト
-
10*60
- osd_command_max_records
- 説明
- 失ったオブジェクトを返す際の数を制限します。
- 型
- 32 ビット整数
- デフォルト
-
256
- osd_auto_upgrade_tmap
- 説明
-
古いオブジェクトの
omapにtmapを使用します。 - 型
- Boolean
- デフォルト
-
true
- osd_tmapput_sets_users_tmap
- 説明
-
デバッグにだけ
tmapを使用します。 - 型
- Boolean
- デフォルト
-
false
- osd_preserve_trimmed_log
- 説明
- トリミングされたログファイルは保持されますが、より多くのディスク容量を使用します。
- 型
- Boolean
- デフォルト
-
false
- osd_recovery_delay_start
- 説明
- ピアリングが完了すると、Ceph は指定された秒数だけ遅延してからオブジェクトの回復を開始します。
- 型
- 浮動小数点 (Float)
- デフォルト
-
0
- osd_recovery_max_active
- 説明
- OSD ごとに一度のアクティブな復旧要求の数。リクエストが増えれば復旧も早くなりますが、その分クラスターへの負荷も大きくなります。
- 型
- 32 ビット整数
- デフォルト
-
0
- osd_recovery_max_active_hdd
- 説明
- プライマリーデバイスが HDD の場合に、同時に存在できる Ceph OSD ごとのアクティブリカバリーリクエスト数。
- 型
- Integer
- デフォルト
-
3
- osd_recovery_max_active_ssd
- 説明
- プライマリーデバイスが OSD の場合に、同時に存在できる Ceph OSD ごとのアクティブリカバリーリクエスト数。
- 型
- Integer
- デフォルト
-
10
- osd_recovery_sleep
- 説明
- 次のリカバリーまたはバックフィル操作までのスリープ時間 (秒)。この値を大きくすると、リカバリー操作が遅くなりますが、クライアント操作への影響は少なくなります。
- 型
- 浮動小数点 (Float)
- デフォルト
-
0.0
- osd_recovery_sleep_hdd
- 説明
- HDD の次のリカバリーまたはバックフィル操作までのスリープ時間 (秒)。
- 型
- 浮動小数点 (Float)
- デフォルト
-
0.1
- osd_recovery_sleep_ssd
- 説明
- SSD の次のリカバリーまたはバックフィル操作までのスリープ時間 (秒)。
- 型
- 浮動小数点 (Float)
- デフォルト
-
0.0
- osd_recovery_sleep_hybrid
- 説明
- Ceph OSD データが HDD にあり、OSD ジャーナルまたは WAL と DB が SSD にある場合の、次のリカバリーまたはバックフィル操作までのスリープ時間 (秒)。
- 型
- 浮動小数点 (Float)
- デフォルト
-
0.025
- osd_recovery_max_chunk
- 説明
- 復元したデータチャンクをプッシュする際の最大サイズ
- 型
- 64 ビット整数未署名
- デフォルト
-
8388608
- osd_recovery_threads
- 説明
- データを復元するためのスレッド数
- 型
- 32 ビット整数
- デフォルト
-
1
- osd_recovery_thread_timeout
- 説明
- 復元スレッドがタイムアウトするまでの最大時間 (秒単位)
- 型
- 32 ビット整数
- デフォルト
-
30
- osd_recover_clone_overlap
- 説明
-
復元時のクローンのオーバーラップを保持します。常に
trueに設定する必要があります。 - 型
- Boolean
- デフォルト
-
true
- rados_osd_op_timeout
- 説明
- RADOS 操作からのエラーを返す前に、RADOS が OSD からの応答を待つ時間 (秒数)。値が 0 の場合は制限がないことを意味します。
- 型
- Double
- デフォルト
- 0
