Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

ファイルシステムガイド

Red Hat Ceph Storage 7

Ceph ファイルシステムの設定とマウント

Red Hat Ceph Storage Documentation Team

概要

このガイドでは、Ceph Metadata Server (MDS) の設定方法と、Ceph File System (CephFS) の作成、マウント、作業方法について説明します。
Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。まずは、マスター (master)、スレーブ (slave)、ブラックリスト (blacklist)、ホワイトリスト (whitelist) の 4 つの用語の置き換えから始めます。この取り組みは膨大な作業を要するため、用語の置き換えは、今後の複数のリリースにわたって段階的に実施されます。詳細は、Red Hat CTO である Chris Wright のメッセージ をご覧ください。

第1章 Ceph ファイルシステムの紹介
リンクのコピー

ストレージ管理者として、Ceph File System (CephFS) 環境を管理するための機能、システムコンポーネント、および制限事項について理解することができます。

1.1. Ceph File System の機能と強化点
リンクのコピー

Ceph File System (CephFS) は、Ceph の RADOS (Reliable Autonomic Distributed Object Storage) と呼ばれる分散オブジェクトストアの上に構築された POSIX 規格と互換性のあるファイルシステムです。CephFS は、Red Hat Ceph Storage クラスターへのファイルアクセスを提供し、可能な限り POSIX セマンティクスを使用します。たとえば、NFS のような他の多くの一般的なネットワークファイルシステムとは対照的に、CephFS はクライアント間で強力なキャッシュコヒーレンシーを維持します。目標は、ファイルシステムを使用するプロセスが、異なるホストに存在するときも、同じホストにいるときも、同じように動作することです。ただし、CephFS は厳密な POSIX セマンティクスから乖離している場合もあります。

Ceph File System には、以下のような機能や強化があります。

スケーラビリティー
Ceph File System は、メタデータサーバーの水平方向のスケーリングと、個々の OSD ノードでのクライアントの直接の読み書きにより、高いスケーラビリティーを実現しています。
共有ファイルシステム
Ceph File System は共有ファイルシステムなので、複数のクライアントが同じファイルシステム上で同時に作業することができます。
複数のファイルシステム
1 つのストレージクラスターで複数のファイルシステムをアクティブにできます。各 CephFS には、独自のプールのセットと、独自のメタデータサーバー (MDS) ランクのセットがあります。複数のファイルシステムをデプロイメントする場合は、MDS デーモンの数を増やす必要があります。これにより、メタデータのスループットを向上させることができますが、同時に運用コストも増加します。また、特定のファイルシステムへのクライアントのアクセスを制限することもできます。
高可用性
Ceph File System には、Ceph Metadata Server (MDS) のクラスターが用意されています。1 つはアクティブで、他はスタンバイモードです。アクティブなデータシートが不意に終了した場合、スタンバイデータシートの 1 つがアクティブになります。その結果、サーバーが故障してもクライアントのマウントは継続して動作します。この動作により、Ceph File System は可用性が高くなります。さらに、複数のアクティブなメタデータサーバーを設定することも可能です。
設定可能なファイルおよびディレクトリーレイアウト
Ceph File System では、ファイルやディレクトリーのレイアウトを設定して、複数のプール、プールの名前空間、オブジェクト間のファイルストライピングモードを使用することができます。
POSIX アクセスコントロールリスト (ACL)
Ceph File System は POSIX Access Control Lists (ACL) をサポートしています。ACL は、カーネルバージョン kernel-3.10.0-327.18.2.el7 以降のカーネルクライアントとしてマウントされた Ceph File Systems でデフォルトで有効になります。FUSE クライアントとしてマウントされた Ceph File Systems で ACL を使用するには、ACL を有効にする必要があります。
クライアントクオータ
Ceph File System は、システム内のあらゆるディレクトリーにクォータを設定することをサポートしています。クオータは、ディレクトリー階層のそのポイントの下に保存されているバイト数やファイル数を制限することができます。CephFS クライアントクオータはデフォルトで有効です。
重要

CephFS EC プールはアーカイブのみを目的としています。

関連情報

1.2. Ceph File System のコンポーネント
リンクのコピー

Ceph File System には 2 つの主要コンポーネントがあります。

Clients
CephFS クライアントは、FUSE クライアントの ceph-fuse やカーネルクライアントの kcephfs など、CephFS を使用するアプリケーションの代わりに I/O 操作を行います。CephFS クライアントは、アクティブな Metadata Server にメタデータの要求を送信します。その代わり、CephFS クライアントはファイルのメタデータ認識し、メタデータとファイルデータの両方を安全にキャッシュすることができます。
メタデータサーバー (MDS)

MDS では以下のことを行います。

  • CephFS クライアントにメタデータを提供します。
  • Ceph File System に保存されているファイルに関連するメタデータを管理します。
  • 共有されている Red Hat Ceph Storage クラスターへのアクセスを調整します。
  • ホットなメタデータをキャッシュして、バッキングメタデータプールストアへのリクエストを減らします。
  • CephFS クライアントのキャッシュを管理して、キャッシュコヒーレンスを維持します。
  • アクティブなデータシート間でホットメタデータを複製します。
  • メタデータミューテーションをコンパクトジャーナルにまとめて、バックメタデータプールに定期的にフラッシュします。
  • CephFS では、少なくとも 1 つの Metadata Server デーモン (ceph-mds) の実行が必要です。

下図は、Ceph File System のコンポーネント層を示しています。

157 Ceph File System 1021 2
View larger image
157 Ceph File System 1021 2

一番下の層は、基礎となるコアストレージクラスターコンポーネントを表しています。

  • Ceph OSD (ceph-osd) Ceph File System のデータとメタデータが格納されています。
  • Ceph File System のメタデータを管理する Ceph Metadata Servers (ceph-mds)。
  • クラスターマップのマスターコピーを管理する Ceph Monitors (ceph-mon)。

Ceph Storage プロトコル層は、コアストレージクラスターと対話するための Ceph ネイティブ librados ライブラリーを表します。

CephFS ライブラリー層には、librados の上で動作し、Ceph File System を表す CephFS libcephfs ライブラリーが含まれます。

一番上の層は、Ceph File Systems にアクセスできる 2 種類の Ceph クライアントを表しています。

下の図は、Ceph File System のコンポーネントがどのように相互に作用するかを詳しく示しています。

157 Ceph File System 1021 1
View larger image
157 Ceph File System 1021 1

関連情報

1.3. Ceph File System と SELinux
リンクのコピー

Red Hat Enterprise Linux 8.3 および Red Hat Ceph Storage 4.2 より、Ceph File Systems (CephFS) 環境での Security-Enhanced Linux (SELinux) の使用をサポートしています。CephFS では、任意の SELinux ファイルタイプを設定できるようになったほか、個々のファイルに特定の SELinux タイプを割り当てることもできます。このサポートは、Ceph File System Metadata Server (MDS)、CephFS File System in User Space (FUSE) クライアント、および CephFS カーネルクライアントに適用されます。

関連情報

1.4. Ceph File System の制限と POSIX 規格
リンクのコピー

Ceph File System は、以下の点で厳密な POSIX セマンティクスから乖離しています。

  • クライアントがファイルの書き込みに失敗した場合、書き込み操作は必ずしも Atomic ではありません。例えば、O_SYNC フラグで開かれた 8MB のバッファーを持つファイルに対して、クライアントが write() システムコールを呼び出したところ、予期せぬ終了で、書き込み操作が部分的にしかできなくなってしまうことがあります。ローカルファイルシステムを含め、ほとんどのファイルシステムがこのような動作をします。
  • 書き込み操作が同時に行われる状況では、オブジェクトの境界を超えた書き込み操作は必ずしも Atomic ではありません。例えば、ライター A が "aa|aa"、ライター B が "bb|bb" を同時に書いた場合、"|" はオブジェクトの境界であり、本来の"aa|aa" や "bb|bb" ではなく、"aa|bb" が書かれてしまいます。
  • POSIX には telldir() や seekdir() というシステムコールがあり、カレントディレクトリーのオフセットを取得して、そこまでシークすることができます。CephFS はいつでもディレクトリーを断片化できるため、ディレクトリーの安定した整数オフセットを返すことは困難です。そのため、0 以外のオフセットで seekdir() システムコールを呼び出しても、動作する場合がありますが、動作を保証するものではありません。seekdir() をオフセット 0 で呼び出すと必ず動作します。これは、rewinddir() システムコールと同等のものです。
  • スパースファイルは、stat() システムコールの st_blocks フィールドに正しく伝わりませんでした。st_blocks フィールドには、ファイルサイズをブロックサイズで割った商が常に入力されているため、CephFS では、割り当てられたり書き込まれたりしたファイルの一部を明示的に追跡しません。この動作により、du などのユーティリティーが使用スペースを過大評価してしまいます。
  • mmap() システムコールでファイルを複数のホストのメモリーにマッピングした場合、書き込み操作が他のホストのキャッシュに一貫して伝わらない。つまり、あるページがホスト A でキャッシュされ、ホスト B で更新された場合、ホスト A のページはコヒーレントに無効にはなりません。
  • CephFS クライアントには、スナップショットへのアクセス、作成、削除、名前の変更に使用される隠れた .snap ディレクトリーがあります。このディレクトリーは readdir() システムコールから除外されていますが、同名のファイルやディレクトリーを作成しようとしたプロセスはエラーを返します。この隠しディレクトリーの名前は、マウント時に -o snapdirname=.<new_name> オプションを使用するか、client_snapdir 設定オプションを使用して変更できます。

関連情報

第2章 Ceph File System Metadata Server
リンクのコピー

ストレージ管理者として、Ceph File System (CephFS) Metadata Server (MDS) のさまざまな状態について学ぶとともに、CephFS MDS ランキングの仕組み、MDS スタンバイデーモンの設定、キャッシュサイズの制限についても学ぶことができます。これらの概念を知ることで、ストレージ環境に合わせて MDS デーモンを設定することができます。

前提条件

  • 実行中、および正常な Red Hat Ceph Storage クラスター
  • Ceph Metadata Server デーモン (ceph-mds) のインストール。MDS デーモンの設定の詳細は、Red Hat Ceph Storage File System ガイド の Ceph Orchestrator を使用した MDS サービスの管理 セクションを参照してください。

2.1. Metadata Server デーモンの状態
リンクのコピー

Metadata Server (MDS) のデーモンは、2 つの状態で動作します。

  • Active: Ceph File System に保存されているファイルとディレクトリーのメタデータを管理します。
  • Standby — バックアップとして機能し、アクティブな MDS デーモンが反応しなくなったときにアクティブになります。

デフォルトでは、Ceph File System はアクティブな MDS デーモンを 1 つだけ使用します。ただし、多くのクライアントがあるシステムでは複数のアクティブな MDS デーモンを使用する利点があります。

ファイルシステムでは、複数のアクティブな MDS デーモンを使用するように設定することで、大規模なワークロードに対してメタデータのパフォーマンスを拡張することができます。メタデータの負荷パターンが変化したときに、アクティブな MDS デーモンがメタデータのワークロードを動的に分担します。なお、複数のアクティブな MDS デーモンを持つシステムでは、高可用性を維持するためにスタンバイ MDS デーモンが必要となります。

Active MDS デーモンが停止したときの動作について

アクティブな MDS が応答しなくなると、Ceph Monitor デーモンは mds_beacon_grace オプションで指定された値に等しい秒数だけ待機します。指定した時間が経過してもアクティブな MDS が応答しない場合、Ceph Monitor は MDS デーモンを laggy としてマークします。設定に応じて、いずれかのスタンバイデーモンがアクティブになります。

注記

mds_beacon_grace の値を変更するには、Ceph の設定ファイルにこのオプションを追加して、新しい値を指定します。

2.2. メタデータサーバーのランク
リンクのコピー

各 Ceph File System (CephFS) には、ランクの数があり、デフォルトでは 1 つで、ゼロから始まります。

ランクは、メタデータのワークロードを複数の Metadata Server (MDS) デーモン間で共有する方法を定義します。ランク数は、一度にアクティブにすることができる MDS デーモンの最大数です。各 MDS デーモンは、そのランクに割り当てられた CephFS メタデータのサブセットを処理します。

各 MDS デーモンは、最初はランクなしで起動します。Ceph Monitor は、デーモンにランクを割り当てます。MDS デーモンは一度に 1 つのランクしか保持できません。デーモンがランクを失うのは、停止したときだけです。

max_mds の設定は、作成されるランクの数を制御します。

CephFS の実際のランク数は、新しいランクを受け入れるための予備のデーモンが利用できる場合にのみ増加します。

ランクステート

ランクには、以下の状態があります。

  • Up: MDS デーモンに割り当てられたランクです。
  • Failed: どの MDS デーモンにも関連付けられていないランクです。
  • Damaged: メタデータが破損していたり、欠落していたりと、ダメージを受けているランクです。オペレーターが問題を解決して、破損したランクに ceph mds repaired コマンドを使用するまで、破損したランクはどの MDS デーモンにも割り当てられません。

2.3. メタデータサーバーのキャッシュサイズ制限
リンクのコピー

Ceph File System (CephFS) の Metadata Server (MDS) キャッシュのサイズを以下の方法で制限できます。

  • メモリーの制限: mds_cache_memory_limit オプションを使用します。Red Hat では、mds_cache_memory_limit に 8 GB ~ 64 GB の値を推奨しています。より多くのキャッシュを設定すると、復元で問題が発生する可能性があります。この制限は、MDS の望ましい最大メモリー使用量の約 66% です。

    注記

    mds_cache_memory_limit のデフォルト値は 4 GB です。デフォルト値は推奨範囲外であるため、Red Hat では前述の範囲内に値を設定することを推奨します。

    重要

    Red Hat は inode 数制限の代わりにメモリー制限を使用することを推奨します。

  • Inode 数: mds_cache_size オプションを使用します。デフォルトでは、inode 数による MDS キャッシュの制限は無効になっています。

また、MDS の操作に mds_cache_reservation オプションを使用することで、キャッシュの予約を指定することができます。キャッシュ予約は、メモリーまたは inode の上限に対する割合で制限され、デフォルトでは 5 % に設定されています。このパラメーターの目的は、データシートが新しいメタデータの操作に使用するために、キャッシュのメモリーを余分に確保することです。その結果、データシートは一般的にメモリー制限値以下で動作することになります。これは、データシートは、未使用のメタデータをキャッシュに落とすために、クライアントから古い状態を呼び出すためです。

mds_cache_reservation オプションは、MDS ノードがキャッシュが大きすぎることを示すヘルスアラートを Ceph Monitors に送信する場合を除き、すべての状況で mds_health_cache_threshold オプションを置き換えます。デフォルトでは、mds_health_cache_threshold は最大キャッシュサイズの 150% です。

キャッシュの制限はハードな制限ではないことに注意してください。CephFS クライアントや MDS のバグ、または誤動作するアプリケーションが原因で、MDS のキャッシュサイズが超過する可能性があります。mds_health_cache_threshold オプションは、ストレージクラスターの健全性に関する警告メッセージを設定し、データシートがキャッシュを縮小できない原因をオペレーターが調査できるようにします。

関連情報

2.4. ファイルシステムアフィニティー
リンクのコピー

Ceph File System (CephFS) が特定の Ceph Metadata Server (MDS) を別の Ceph MDS よりも優先するように設定できます。例えば、新しくて高速なハードウェアで動作している MDS を、古くて低速なハードウェアで動作しているスタンバイ MDS よりも優先的に使用したいとします。mds_join_fs オプションを設定することで、この優先順位を指定することができ、このファイルシステムのアフィニティーが実行されます。Ceph Monitor は、mds_join_fs が失敗したランクのファイルシステム名と同じである MDS スタンバイデーモンを優先します。standby-replay デーモンを選択してから、別のスタンバイデーモンを選択します。mds_join_fs オプションを指定したスタンバイデーモンが存在しない場合、Ceph Monitors は、最後の手段として、通常のスタンバイを交換用に選択するか、その他の利用可能なスタンバイを選択します。Ceph Monitor は、Ceph ファイルシステムを定期的に検査して、親和性の低い Ceph MDS の代わりに親和性の高いスタンバイが利用できるかどうかを確認します。

2.5. Ceph Orchestrator を使用した MDS サービスの管理
リンクのコピー

ストレージ管理者は、バックエンドにて Cephadm と Ceph Orchestrator を使用して MDS サービスをデプロイできます。デフォルトでは、Ceph File System (CephFS) はアクティブな MDS デーモンを 1 つだけ使用します。ただし、多くのクライアントがあるシステムでは複数のアクティブな MDS デーモンを使用する利点があります。

このセクションでは、以下の管理タスクを説明します。

前提条件

  • 稼働中の Red Hat Ceph Storage クラスターがある。
  • すべてのノードへの root レベルのアクセス。
  • ホストがクラスターに追加されている。
  • すべてのマネージャー、モニター、および OSD デーモンがデプロイされます。

2.5.1. コマンドラインインターフェイスを使用した MDS サービスのデプロイ
リンクのコピー

Ceph Orchestrator を使用すると、コマンドラインインターフェイスで placement 仕様を使用して、Metadata Server (MDS) サービスをデプロイできます。Ceph ファイルシステム (CephFS) には、1 つ以上の MDS が必要です。

注記

最低でも、Ceph ファイルシステム (CephFS) データ用のプール 1 つと CephFS メタデータ用のプール 1 つの 2 つのプールがあるようにしてください。

前提条件

  • 稼働中の Red Hat Ceph Storage クラスターがある。
  • ホストがクラスターに追加されている。
  • すべてのマネージャー、モニター、および OSD デーモンがデプロイされます。

手順

  1. Cephadm シェルにログインします。

    例

    [root@host01 ~]# cephadm shell
    Copy to Clipboard Toggle word wrap

  2. 配置仕様を使用して MDS デーモンをデプロイする方法は 2 つあります。

方法 1

  • ceph fs volume を使用して MDS デーモンを作成します。これにより、CephFS に関連付けられた CephFS ボリュームとプールが作成され、ホストで MDS サービスも開始されます。

    構文

    ceph fs volume create FILESYSTEM_NAME --placement="NUMBER_OF_DAEMONS HOST_NAME_1 HOST_NAME_2 HOST_NAME_3"
    Copy to Clipboard Toggle word wrap

    注記

    デフォルトでは、このコマンドに対してレプリケートされたプールが作成されます。

    例

    [ceph: root@host01 /]# ceph fs volume create test --placement="2 host01 host02"
    Copy to Clipboard Toggle word wrap

方法 2

  • プール、CephFS を作成してから、配置仕様を使用して MDS サービスをデプロイします。

    1. CephFS のプールを作成します。

      構文

      ceph osd pool create DATA_POOL [PG_NUM]
ceph osd pool create METADATA_POOL [PG_NUM]
      Copy to Clipboard Toggle word wrap

      例

      [ceph: root@host01 /]# ceph osd pool create cephfs_data 64
[ceph: root@host01 /]# ceph osd pool create cephfs_metadata 64
      Copy to Clipboard Toggle word wrap

      通常、メタデータプールは、データプールよりもオブジェクトがはるかに少ないため、控えめな数の配置グループ (PG) で開始できます。必要に応じて PG の数を増やすことができます。プールサイズの範囲は 64 PG ~ 512 PG です。データプールのサイズは、ファイルシステム内で予想されるファイルの数とサイズに比例します。

      重要

      メタデータプールでは、以下を使用することを検討してください。

      • このプールへのデータ損失によりファイルシステム全体にアクセスできなくなる可能性があるため、レプリケーションレベルが高くなります。
      • Solid-State Drive (SSD) ディスクなどのレイテンシーが低くなるストレージ。これは、クライアントで観察されるファイルシステム操作のレイテンシーに直接影響するためです。

    2. データプールおよびメタデータプールのファイルシステムを作成します。

      構文

      ceph fs new FILESYSTEM_NAME METADATA_POOL DATA_POOL
      Copy to Clipboard Toggle word wrap

      例

      [ceph: root@host01 /]# ceph fs new test cephfs_metadata cephfs_data
      Copy to Clipboard Toggle word wrap

    3. ceph orch apply コマンドを使用して MDS サービスをデプロイします。

      構文

      ceph orch apply mds FILESYSTEM_NAME --placement="NUMBER_OF_DAEMONS HOST_NAME_1 HOST_NAME_2 HOST_NAME_3"
      Copy to Clipboard Toggle word wrap

      例

      [ceph: root@host01 /]# ceph orch apply mds test --placement="2 host01 host02"
      Copy to Clipboard Toggle word wrap

検証

  • サービスをリスト表示します。

    例

    [ceph: root@host01 /]# ceph orch ls
    Copy to Clipboard Toggle word wrap

  • CephFS のステータスを確認します。

    例

    [ceph: root@host01 /]# ceph fs ls
[ceph: root@host01 /]# ceph fs status
    Copy to Clipboard Toggle word wrap

  • ホスト、デーモン、およびプロセスをリスト表示します。

    構文

    ceph orch ps --daemon_type=DAEMON_NAME
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph orch ps --daemon_type=mds
    Copy to Clipboard Toggle word wrap

2.5.2. サービス仕様を使用した MDS サービスのデプロイ
リンクのコピー

Ceph Orchestrator を使用すると、サービス仕様を使用して MDS サービスをデプロイできます。

注記

少なくとも 2 つのプールがあることを確認してください。1 つは Ceph ファイルシステム (CephFS) データ用で、もう 1 つは CephFS メタデータ用です。

前提条件

  • 稼働中の Red Hat Ceph Storage クラスターがある。
  • ホストがクラスターに追加されている。
  • すべてのマネージャー、モニター、および OSD デーモンがデプロイされます。

手順

  1. mds.yaml ファイルを作成します。

    例

    [root@host01 ~]# touch mds.yaml
    Copy to Clipboard Toggle word wrap

  2. mds.yaml ファイルを編集し、以下の詳細を含めます。

    構文

    service_type: mds
service_id: FILESYSTEM_NAME
placement:
  hosts:
  - HOST_NAME_1
  - HOST_NAME_2
  - HOST_NAME_3
    Copy to Clipboard Toggle word wrap

    例

    service_type: mds
service_id: fs_name
placement:
  hosts:
  - host01
  - host02
    Copy to Clipboard Toggle word wrap

  3. YAML ファイルをコンテナー内のディレクトリーにマウントします。

    例

    [root@host01 ~]# cephadm shell --mount mds.yaml:/var/lib/ceph/mds/mds.yaml
    Copy to Clipboard Toggle word wrap

  4. そのディレクトリーに移動します。

    例

    [ceph: root@host01 /]# cd /var/lib/ceph/mds/
    Copy to Clipboard Toggle word wrap

  5. Cephadm シェルにログインします。

    例

    [root@host01 ~]# cephadm shell
    Copy to Clipboard Toggle word wrap

  6. 以下のディレクトリーに移動します。

    例

    [ceph: root@host01 /]# cd /var/lib/ceph/mds/
    Copy to Clipboard Toggle word wrap

  7. サービス仕様を使用して MDS サービスをデプロイします。

    構文

    ceph orch apply -i FILE_NAME.yaml
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 mds]# ceph orch apply -i mds.yaml
    Copy to Clipboard Toggle word wrap

  8. MDS サービスがデプロイされ、機能したら、CephFS を作成します。

    構文

    ceph fs new CEPHFS_NAME METADATA_POOL DATA_POOL
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph fs new test metadata_pool data_pool
    Copy to Clipboard Toggle word wrap

検証

  • サービスをリスト表示します。

    例

    [ceph: root@host01 /]# ceph orch ls
    Copy to Clipboard Toggle word wrap

  • ホスト、デーモン、およびプロセスをリスト表示します。

    構文

    ceph orch ps --daemon_type=DAEMON_NAME
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph orch ps --daemon_type=mds
    Copy to Clipboard Toggle word wrap

2.5.3. Ceph Orchestrator を使用した MDS サービスの削除
リンクのコピー

ceph orch rm コマンドを使用してサービスを削除できます。または、ファイルシステムおよび関連するプールを削除できます。

前提条件

  • 稼働中の Red Hat Ceph Storage クラスターがある。
  • すべてのノードへの root レベルのアクセス。
  • ホストがクラスターに追加されている。
  • ホストにデプロイされた MDS デーモン 1 つ以上。

手順

  • MDS デーモンをクラスターから削除する方法は 2 つあります。

方法 1

  • CephFS ボリューム、関連するプール、およびサービスを削除します。

    1. Cephadm シェルにログインします。

      例

      [root@host01 ~]# cephadm shell
      Copy to Clipboard Toggle word wrap

    2. 設定パラメーター mon_allow_pool_delete を true に設定します。

      例

      [ceph: root@host01 /]# ceph config set mon mon_allow_pool_delete true
      Copy to Clipboard Toggle word wrap

    3. ファイルシステムを削除します。

      構文

      ceph fs volume rm FILESYSTEM_NAME --yes-i-really-mean-it
      Copy to Clipboard Toggle word wrap

      例

      [ceph: root@host01 /]# ceph fs volume rm cephfs-new --yes-i-really-mean-it
      Copy to Clipboard Toggle word wrap

      このコマンドは、ファイルシステム、そのデータ、メタデータプールを削除します。また、有効な ceph-mgr Orchestrator モジュールを使用して MDS を削除しようとします。

方法 2

  • ceph orch rm コマンドを使用して、クラスター全体から MDS サービスを削除します。

    1. サービスをリスト表示します。

      例

      [ceph: root@host01 /]# ceph orch ls
      Copy to Clipboard Toggle word wrap

    2. サービスの削除

      構文

      ceph orch rm SERVICE_NAME
      Copy to Clipboard Toggle word wrap

      例

      [ceph: root@host01 /]# ceph orch rm mds.test
      Copy to Clipboard Toggle word wrap

検証

  • ホスト、デーモン、およびプロセスをリスト表示します。

    構文

    ceph orch ps
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph orch ps
    Copy to Clipboard Toggle word wrap

2.6. ファイルシステムのアフィニティーを設定する
リンクのコピー

特定の Ceph Metadata Server (MDS) に対する Ceph File System (CephFS) のアフィニティーを設定します。

前提条件

  • 正常で稼働している Ceph File System。
  • Ceph Monitor ノードへの root レベルのアクセス。

手順

  1. Ceph File System の現在の状態を確認します。

    例

    [root@mon ~]# ceph fs dump
dumped fsmap epoch 399
...
Filesystem 'cephfs01' (27)
...
e399
max_mds 1
in      0
up      {0=20384}
failed
damaged
stopped
...
[mds.a{0:20384} state up:active seq 239 addr [v2:127.0.0.1:6854/966242805,v1:127.0.0.1:6855/966242805]]

Standby daemons:

[mds.b{-1:10420} state up:standby seq 2 addr [v2:127.0.0.1:6856/2745199145,v1:127.0.0.1:6857/2745199145]]
    Copy to Clipboard Toggle word wrap

  2. ファイルシステムのアフィニティーを設定します。

    構文

    ceph config set STANDBY_DAEMON mds_join_fs FILE_SYSTEM_NAME
    Copy to Clipboard Toggle word wrap

    例

    [root@mon ~]# ceph config set mds.b mds_join_fs cephfs01
    Copy to Clipboard Toggle word wrap

    Ceph MDS のフェイルオーバーイベントが発生すると、ファイルシステムはアフィニティーが設定されているスタンバイデーモンを優先します。

    例

    [root@mon ~]# ceph fs dump
dumped fsmap epoch 405
e405
...
Filesystem 'cephfs01' (27)
...
max_mds 1
in      0
up      {0=10420}
failed
damaged
stopped
...
[mds.b{0:10420} state up:active seq 274 join_fscid=27 addr [v2:127.0.0.1:6856/2745199145,v1:127.0.0.1:6857/2745199145]]
    1 
    

Standby daemons:

[mds.a{-1:10720} state up:standby seq 2 addr [v2:127.0.0.1:6854/1340357658,v1:127.0.0.1:6855/1340357658]]
    Copy to Clipboard Toggle word wrap

    1
    mds.b デーモンのファイルシステムダンプの出力に join_fscid=27 が含まれるようになりました。
    重要

    ファイルシステムがデグレードまたはアンダーサイズの状態である場合、ファイルシステムのアフィニティーを実施するためのフェイルオーバーは発生しません。

2.7. 複数のアクティブな Metadata Server デーモンの設定
リンクのコピー

複数のアクティブなメタデータサーバー (MDS) デーモンを設定し、大規模システムのメタデータのパフォーマンスを拡張します。

重要

スタンバイ状態の MDS デーモンをすべてアクティブ状態に変換しないでください。Ceph File System (CephFS) は、高可用性を維持するために、少なくとも 1 つのスタンバイ MDS デーモンを必要とします。

前提条件

  • MDS ノードでの Ceph 管理機能。
  • Ceph Monitor ノードへの root レベルのアクセス。

手順

  1. max_mds パラメーターには、アクティブな MDS デーモンの数を設定してください。

    構文

    ceph fs set NAME max_mds NUMBER
    Copy to Clipboard Toggle word wrap

    例

    [root@mon ~]# ceph fs set cephfs max_mds 2
    Copy to Clipboard Toggle word wrap

    この例では、cephfs という CephFS でアクティブな MDS デーモンの数を 2 つに増やしています。

    注記

    Ceph は、新しいランクを取るために予備の MDS デーモンが利用できる場合にのみ、CephFS の実際のランク数を増やします。

  2. アクティブな MDS デーモンの数を確認します。

    構文

    ceph fs status NAME
    Copy to Clipboard Toggle word wrap

    例

    [root@mon ~]# ceph fs status cephfs
cephfs - 0 clients
======
+------+--------+-------+---------------+-------+-------+--------+--------+
| RANK | STATE  |  MDS  |    ACTIVITY   |  DNS  |  INOS |  DIRS  |  CAPS  |
+------+--------+-------+---------------+-------+-------+--------+--------+
|  0   | active | node1 | Reqs:    0 /s |   10  |   12  |   12   |   0    |
|  1   | active | node2 | Reqs:    0 /s |   10  |   12  |   12   |   0    |
+------+--------+-------+---------------+-------+-------+--------+--------+
+-----------------+----------+-------+-------+
|       POOL      |   TYPE   |  USED | AVAIL |
+-----------------+----------+-------+-------+
| cephfs_metadata | metadata | 4638  | 26.7G |
|   cephfs_data   |   data   |    0  | 26.7G |
+-----------------+----------+-------+-------+

+-------------+
| STANDBY MDS |
+-------------+
|    node3    |
+-------------+
    Copy to Clipboard Toggle word wrap

関連情報

2.8. スタンバイデーモンの数の設定
リンクのコピー

各 Ceph File System (CephFS) では、健全であると判断するために必要なスタンバイデーモンの数を指定できます。この数には、ランク不具合を待っている standby-replay デーモンも含まれます。

前提条件

  • Ceph Monitor ノードへの root レベルのアクセス。

手順

  • 特定の CephFS のスタンバイデーモンの予想数を設定します。

    構文

    ceph fs set FS_NAME standby_count_wanted NUMBER
    Copy to Clipboard Toggle word wrap

    注記

    NUMBER を 0 にすると、デーモンのヘルスチェックが無効になります。

    例

    [root@mon ~]# ceph fs set cephfs standby_count_wanted 2
    Copy to Clipboard Toggle word wrap

    この例では、予想されるスタンバイデーモンの数を 2 に設定しています。

2.9. standby-replay 用 Metadata Server の設定
リンクのコピー

各 Ceph File System (CephFS) を設定して、standby-replay の Metadata Server (MDS) デーモンを追加します。これにより、アクティブな MDS が利用できなくなった場合のフェイルオーバー時間を短縮することができます。

この特定の standby-replay デーモンは、アクティブなデータシートのメタデータジャーナルに従います。standby-replay デーモンは、同一ランクのアクティブなデータシートでのみ使用され、他のランクでは使用できません。

重要

standby-replay を使用する場合は、すべてのアクティブなデータシートに standby-replay デーモンが必要です。

前提条件

  • Ceph Monitor ノードへの root レベルのアクセス。

手順

  • 特定の CephFS の standby-replay を設定します。

    構文

    ceph fs set FS_NAME allow_standby_replay 1
    Copy to Clipboard Toggle word wrap

    例

    [root@mon ~]# ceph fs set cephfs allow_standby_replay 1
    Copy to Clipboard Toggle word wrap

    この例では、ブール値が 1 であるため、standby-replay デーモンをアクティブな Ceph MDS デーモンに割り当てることができます。

2.10. エフェメラルピニングポリシー
リンクのコピー

エフェメラルピンは、サブツリーの静的なパーティションであり、拡張属性を使用したポリシーで設定できます。ポリシーでは、ディレクトリーにエフェメラルピンを自動的に設定することができます。ディレクトリーにエフェメラルピンを設定すると、そのピンは自動的に特定のランクに割り当てられ、すべての Ceph MDS ランクに均一に分散されるようになります。どのランクが割り当てられるかは、一貫したハッシュとディレクトリーの inode 番号によって決定されます。エフェメラルピンは、ディレクトリーの inode がファイルシステムのキャッシュから削除されても持続しません。Ceph Metadata Server (MDS) をフェイルオーバーする際には、エフェメラルピンがジャーナルに記録されるため、Ceph MDS スタンバイサーバーがこの情報を失うことはありません。エフェメラルピンを使用する際のポリシーは 2 種類あります。

注記

attr パッケージと jq パッケージのインストールは、エフェメラルピニングポリシーの前提条件です。

Distributed (分散)
このポリシーでは、ディレクトリーの直接の子のすべてが、一時的にピン留めされなければならないことを強制します。たとえば、分散ポリシーを使用して、ユーザーのホームディレクトリーを Ceph File System クラスター全体に広げることができます。ceph.dir.pin.distributed 拡張属性を設定して、このポリシーを有効にします。

構文

setfattr -n ceph.dir.pin.distributed -v 1 DIRECTORY_PATH
Copy to Clipboard Toggle word wrap

例

[root@host01 mount]# setfattr -n ceph.dir.pin.distributed -v 1 dir1/
Copy to Clipboard Toggle word wrap

ランダム
このポリシーでは、子孫のサブディレクトリーが一時的にピン留めされる可能性があります。エフェメラルピン留めが可能なディレクトリーの割合をカスタマイズできます。ceph.dir.pin.random を設定し、パーセンテージを設定することで、このポリシーを有効にします。Red Hat では、このパーセンテージを 1% (0.01) より小さい値に設定することを推奨します。サブツリーのパーティションの数が多すぎると、パフォーマンスが低下します。mds_export_ephemeral_random_max Ceph MDS 設定オプションを設定することで、最大の割合を設定できます。パラメーター mds_export_ephemeral_distributed および mds_export_ephemeral_random はすでに有効になっています。

構文

setfattr -n ceph.dir.pin.random -v PERCENTAGE_IN_DECIMAL DIRECTORY_PATH
Copy to Clipboard Toggle word wrap

例

[root@host01 mount]# setfattr -n ceph.dir.pin.random -v  0.01 dir1/
Copy to Clipboard Toggle word wrap

ピニングを有効にした後、次のいずれかのコマンドを実行して 確認 できます。

構文

getfattr -n ceph.dir.pin.random DIRECTORY_PATH
getfattr -n ceph.dir.pin.distributed DIRECTORY_PATH
Copy to Clipboard Toggle word wrap

例

[root@host01 mount]# getfattr -n ceph.dir.pin.distributed dir1/
# file: dir1/
ceph.dir.pin.distributed="1"

[root@host01 mount]# getfattr -n ceph.dir.pin.random dir1/
# file: dir1/
ceph.dir.pin.random="0.01"
Copy to Clipboard Toggle word wrap

例

[ceph: root@host01 /]# ceph tell mds.a get subtrees | jq '.[] | [.dir.path, .auth_first, .export_pin]'
Copy to Clipboard Toggle word wrap

ディレクトリーが固定されている場合、export_pin の値は、ランク 0 に固定されている場合は 0、ランク 1 に固定されている場合は 1、などとなります。ディレクトリーが固定されていない場合、値は -1 です。

パーティション設定ポリシーを 削除 するには、拡張属性を削除するか、値を 0 に設定します。

構文

 setfattr -n ceph.dir.pin.distributed -v 0 DIRECTORY_PATH
Copy to Clipboard Toggle word wrap

例

[root@host01 mount]# setfattr -n ceph.dir.pin.distributed -v 0 dir1/
Copy to Clipboard Toggle word wrap

次のコマンドのいずれかを実行して 確認 できます。構文 

getfattr -n ceph.dir.pin.distributed DIRECTORY_PATH
Copy to Clipboard Toggle word wrap

例

[root@host01 mount]# getfattr -n ceph.dir.pin.distributed dir1/
Copy to Clipboard Toggle word wrap

エクスポートピンの場合は、拡張属性を削除するか、拡張属性を -1 に設定します。

構文

setfattr -n ceph.dir.pin -v -1 DIRECTORY_PATH
Copy to Clipboard Toggle word wrap

例

[root@host01 mount]# setfattr -n ceph.dir.pin -v -1 dir1/
Copy to Clipboard Toggle word wrap

2.11. ディレクトリーツリーを特定のランクに手動で固定する
リンクのコピー

メタデータを特定の Ceph Metadata Server (MDS) ランクに明示的にマッピングすることで、ダイナミックバランサーをオーバーライドしたい場合もあります。これを手動で行うことで、アプリケーションの負荷を均等に分散したり、ユーザーのメタデータ要求が Ceph File System クラスターに与える影響を抑えることができます。ディレクトリーを手動で固定することは、ceph.dir.pin 拡張属性を設定することで、エクスポートピンとも呼ばれます。

ディレクトリーのエクスポートピンは、最も近い親ディレクトリーから継承されますが、そのディレクトリーにエクスポートピンを設定することで、上書きすることができます。例えば、あるディレクトリーにエクスポートピンを設定すると、そのディレクトリーのすべてのサブディレクトリーに影響します。 

[root@client ~]# mkdir -p a/b
1 

[root@client ~]# setfattr -n ceph.dir.pin -v 1 a/
2 

[root@client ~]# setfattr -n ceph.dir.pin -v 0 a/b
3
Copy to Clipboard Toggle word wrap
1
ディレクトリー a/ と a/b はどちらも輸出用のピンセットがない状態でスタートします。
2
ディレクトリー a/ および a/b は、ランク 1 に固定されるようになりました。
3
ディレクトリー a/b は、ランク 0 およびディレクトリー a/ にピニングされ、そのサブディレクトリーの残りの部分は、引き続きランク 1 に固定されています。

前提条件

  • 稼働中の Red Hat Ceph Storage クラスターがある。
  • 実行中の Ceph File System
  • CephFS クライアントへのルートレベルのアクセス。
  • attr パッケージのインストール。

手順

  • ディレクトリーにエクスポートピンを設定します。

    構文

    setfattr -n ceph.dir.pin -v RANK PATH_TO_DIRECTORY
    Copy to Clipboard Toggle word wrap

    例

    [root@client ~]# setfattr -n ceph.dir.pin -v 2 cephfs/home
    Copy to Clipboard Toggle word wrap

2.12. アクティブな Metadata Server デーモンの数を減らす方法
リンクのコピー

アクティブな Ceph File System (CephFS) メタデータサーバー (MDS) デーモンの数を減らす方法。

前提条件

  • 削除するランクは最初にアクティブにする必要があります。つまり、max_mds パラメーターで指定された MDS デーモンの数と同じである必要があります。
  • Ceph Monitor ノードへの root レベルのアクセス。

手順

  1. max_mds パラメーターで指定された MDS デーモンの数を設定します。

    構文

    ceph fs status NAME
    Copy to Clipboard Toggle word wrap

    例

    [root@mon ~]# ceph fs status cephfs
cephfs - 0 clients

+------+--------+-------+---------------+-------+-------+--------+--------+
| RANK | STATE  |  MDS  |    ACTIVITY   |  DNS  |  INOS |  DIRS  |  CAPS  |
+------+--------+-------+---------------+-------+-------+--------+--------+
|  0   | active | node1 | Reqs:    0 /s |   10  |   12  |   12   |   0    |
|  1   | active | node2 | Reqs:    0 /s |   10  |   12  |   12   |   0    |
+------+--------+-------+---------------+-------+-------+--------+--------+
+-----------------+----------+-------+-------+
|       POOL      |   TYPE   |  USED | AVAIL |
+-----------------+----------+-------+-------+
| cephfs_metadata | metadata | 4638  | 26.7G |
|   cephfs_data   |   data   |    0  | 26.7G |
+-----------------+----------+-------+-------+

+-------------+
| Standby MDS |
+-------------+
|    node3    |
+-------------+
    Copy to Clipboard Toggle word wrap

  2. 管理機能を持つノードで、max_mds パラメーターを必要なアクティブな MDS デーモンの数に変更します。

    構文

    ceph fs set NAME max_mds NUMBER
    Copy to Clipboard Toggle word wrap

    例

    [root@mon ~]# ceph fs set cephfs max_mds 1
    Copy to Clipboard Toggle word wrap

  3. Ceph File System のステータスを監視して、ストレージクラスターが新しい max_mds 値を安定させるのを待機します。

  4. アクティブな MDS デーモンの数を確認します。

    構文

    ceph fs status NAME
    Copy to Clipboard Toggle word wrap

    例

    [root@mon ~]# ceph fs status cephfs
cephfs - 0 clients

+------+--------+-------+---------------+-------+-------+--------+--------+
| RANK | STATE  |  MDS  |    ACTIVITY   |  DNS  |  INOS |  DIRS  |  CAPS  |
+------+--------+-------+---------------+-------+-------+--------+--------+
|  0   | active | node1 | Reqs:    0 /s |   10  |   12  |   12   |   0    |
+------+--------+-------+---------------+-------+-------+--------|--------+
+-----------------+----------+-------+-------+
|       POOl      |   TYPE   |  USED | AVAIL |
+-----------------+----------+-------+-------+
| cephfs_metadata | metadata | 4638  | 26.7G |
|   cephfs_data   |   data   |    0  | 26.7G |
+-----------------+----------+-------+-------+

+-------------+
| Standby MDS |
+-------------+
|    node3    |
|    node2    |
+-------------+
    Copy to Clipboard Toggle word wrap

関連情報

2.13. Ceph メタデータサーバークライアントのメトリクスを表示する
リンクのコピー

コマンドラインインターフェイスを使用して、Ceph メタデータサーバー (MDS) のメトリクスを表示できます。CephFS は、Perf Counters を使用してメトリクスを追跡します。counter dump コマンドを使用してメトリクスを表示できます。

前提条件

  • 実行中の IBM Storage Ceph クラスター。

手順

  1. mds サービスの名前を取得します。

    構文

    [ceph: root@mds-host01 /]# ceph orch ps | grep mds
    Copy to Clipboard Toggle word wrap

  2. クライアントメトリクスごとの MDS を確認します。

    構文

    [ceph: root@mds-host01 /]# ceph tell MDS_SERVICE_NAME counter dump
    Copy to Clipboard Toggle word wrap

    例

    [root@ceph2-hk-n-0mfqao-node1-installer ~]# ceph tell mds.cephfs.ceph2-hk-n-0mfqao-node4.isztbk counter dump

[
  {
    "key": "mds_client_metrics",
    "value": [
      {
        "labels": {
          "fs_name": "cephfs",
          "id": "24379"
        },
        "counters": {
          "num_clients": 4
        }
      }
    ]
  },
  {
    "key": "mds_client_metrics-cephfs",
    "value": [
      {
        "labels": {
          "client": "client.24413",
          "rank": "0"
        },
        "counters": {
          "cap_hits": 56,
          "cap_miss": 9,
          "avg_read_latency": 0E-9,
          "avg_write_latency": 0E-9,
          "avg_metadata_latency": 0E-9,
          "dentry_lease_hits": 2,
          "dentry_lease_miss": 12,
          "opened_files": 0,
          "opened_inodes": 9,
          "pinned_icaps": 4,
          "total_inodes": 9,
          "total_read_ops": 0,
          "total_read_size": 0,
          "total_write_ops": 0,
          "total_write_size": 0
        }
      },
      {
        "labels": {
          "client": "client.24502",
          "rank": "0"
        },
        "counters": {
          "cap_hits": 921403,
          "cap_miss": 102382,
          "avg_read_latency": 0E-9,
          "avg_write_latency": 0E-9,
          "avg_metadata_latency": 0E-9,
          "dentry_lease_hits": 17117,
          "dentry_lease_miss": 204710,
          "opened_files": 0,
          "opened_inodes": 9,
          "pinned_icaps": 7,
          "total_inodes": 9,
          "total_read_ops": 0,
          "total_read_size": 0,
          "total_write_ops": 1,
          "total_write_size": 132
        }
      },
      {
        "labels": {
          "client": "client.24508",
          "rank": "0"
        },
        "counters": {
          "cap_hits": 928694,
          "cap_miss": 103183,
          "avg_read_latency": 0E-9,
          "avg_write_latency": 0E-9,
          "avg_metadata_latency": 0E-9,
          "dentry_lease_hits": 17217,
          "dentry_lease_miss": 206348,
          "opened_files": 0,
          "opened_inodes": 9,
          "pinned_icaps": 7,
          "total_inodes": 9,
          "total_read_ops": 0,
          "total_read_size": 0,
          "total_write_ops": 1,
          "total_write_size": 132
        }
      },
      {
        "labels": {
          "client": "client.24520",
          "rank": "0"
        },
        "counters": {
          "cap_hits": 56,
          "cap_miss": 9,
          "avg_read_latency": 0E-9,
          "avg_write_latency": 0E-9,
          "avg_metadata_latency": 0E-9,
          "dentry_lease_hits": 2,
          "dentry_lease_miss": 12,
          "opened_files": 0,
          "opened_inodes": 9,
          "pinned_icaps": 4,
          "total_inodes": 9,
          "total_read_ops": 0,
          "total_read_size": 0,
          "total_write_ops": 0,
          "total_write_size": 0
        }
      }
    ]
  }
]
    Copy to Clipboard Toggle word wrap

クライアントメトリクスの説明

CephFS はクライアントメトリクスを、クライアントのパフォーマンスを監視するために使用できるラベル付きパフォーマンスカウンターとしてエクスポートします。CephFS は以下のクライアントメトリクスをエクスポートします。

Expand
名前タイプ説明

cap_hits

ゲージ

キャップ総数に対するファイル機能ヒットの割合。

cap_miss

ゲージ

キャップ総数に対するファイル機能ミスの割合。

avg_read_latency

ゲージ

読み取りレイテンシーの平均値。

avg_write_latency

ゲージ

書き込みレイテンシーの平均値。

avg_metadata_latency

ゲージ

メタデータレイテンシーの平均値。

dentry_lease_hits

ゲージ

dentry リース要求総数に対する配布された dentry リースヒットの割合。

dentry_lease_miss

ゲージ

dentry リース要求総数に対する配布された dentry リースミスの割合。

opened_files

ゲージ

開かれたファイルの数。

opened_inodes

ゲージ

開かれた inode の数。

pinned_icaps

ゲージ

固定された Inode キャップの数。

total_inodes

ゲージ

ノードの総数。

total_read_ops

ゲージ

すべてのプロセスで生成された読み取り操作の総数。

total_read_size

ゲージ

すべてのプロセスで生成された入出力操作で読み取られたバイト数。

total_write_ops

ゲージ

すべてのプロセスで生成された書き込み操作の総数。

total_write_size

ゲージ

すべてのプロセスで生成された入出力操作で書き込まれたバイト数。

第3章 Ceph File System のデプロイメント
リンクのコピー

ストレージ管理者は、ストレージ環境に Ceph File Systems (CephFS) をデプロイでき、ストレージのニーズを満たすためにクライアントがそれらの Ceph File System をマウントすることができます。

基本的に、デプロイメントワークフローは以下の 3 つのステップになります。

  1. Ceph Monitor ノードで Ceph File Systems を作成します。
  2. 適切な機能を持つ Ceph クライアントユーザーを作成し、Ceph File System がマウントされるノードでクライアントキーを利用できるようにします。
  3. カーネルクライアントまたは File System in User Space (FUSE) クライアントで使用して、専用のノードに CephFS をマウントします。

前提条件

  • 実行中、および正常な Red Hat Ceph Storage クラスター
  • Ceph Metadata Server デーモン (ceph-mds) のインストールおよび設定

3.1. レイアウト、クォータ、スナップショット、およびネットワークの制限
リンクのコピー

これらのユーザー機能は、必要な要件に基づいて Ceph File System (CephFS) へのアクセスを制限するのに役立ちます。

重要

rw を除くすべてのユーザーケイパビリティーフラグは、アルファベット順に指定する必要があります。

レイアウトとクォータ

レイアウトまたはクォータを使用する場合には、rw 機能に加えて、クライアントが p フラグが必要になります。p フラグを設定すると、特殊拡張属性 (ceph. 接頭辞が付いた属性) で設定されるすべての属性を制限します。また、これによりレイアウトを持つ openc 操作など、これらのフィールドを設定する他の方法が制限されます。

例

client.0
    key: AQAz7EVWygILFRAAdIcuJ10opU/JKyfFmxhuaw==
    caps: [mds] allow rwp
    caps: [mon] allow r
    caps: [osd] allow rw tag cephfs data=cephfs_a

client.1
    key: AQAz7EVWygILFRAAdIcuJ11opU/JKyfFmxhuaw==
    caps: [mds] allow rw
    caps: [mon] allow r
    caps: [osd] allow rw tag cephfs data=cephfs_a
Copy to Clipboard Toggle word wrap

この例では、client.0 はファイルシステムの cephfs_a のレイアウトとクォータを修正できますが、client.1 はできません。

スナップショット

スナップショットの作成または削除時に、クライアントは rw 機能に加えて s フラグが必要になります。機能文字列に p フラグも含まれる場合は、s フラグがこれの後に表示される必要があります。

例

client.0
    key: AQAz7EVWygILFRAAdIcuJ10opU/JKyfFmxhuaw==
    caps: [mds] allow rw, allow rws path=/temp
    caps: [mon] allow r
    caps: [osd] allow rw tag cephfs data=cephfs_a
Copy to Clipboard Toggle word wrap

この例では、client.0 はファイルシステムの cephfs_a の temp ディレクトリーでスナップショットを作成または削除することができます。

ネットワーク

特定のネットワークから接続するクライアントを制限します。

例

client.0
  key: AQAz7EVWygILFRAAdIcuJ10opU/JKyfFmxhuaw==
  caps: [mds] allow r network 10.0.0.0/8, allow rw path=/bar network 10.0.0.0/8
  caps: [mon] allow r network 10.0.0.0/8
  caps: [osd] allow rw tag cephfs data=cephfs_a network 10.0.0.0/8
Copy to Clipboard Toggle word wrap

オプションのネットワークおよび接頭辞長は CIDR 表記です (例: 10.3.0.0/16)。

関連情報

  • Ceph ユーザー機能の設定に関する詳細は、Red Hat Ceph Storage File System ガイド の Ceph File System のクライアント セクションを参照してください。

3.2. Ceph ファイルシステムの作成
リンクのコピー

Ceph Monitor ノードで複数の Ceph File Systems (CephFS) を作成することができます。

前提条件

  • 実行中、および正常な Red Hat Ceph Storage クラスター
  • Ceph Metadata Server デーモン (ceph-mds) のインストールおよび設定
  • Ceph Monitor ノードへの root レベルのアクセス。
  • Ceph クライアントノードへのルートレベルのアクセスがある。

手順

  1. Ceph Storage クラスターを使用するようにクライアントノードを設定します。

    1. Red Hat Ceph Storage Tools リポジトリーを有効にします。

      Red Hat Enterprise Linux 8

      [root@client01 ~]# subscription-manager repos --enable=rhceph-6-tools-for-rhel-8-x86_64-rpms
      Copy to Clipboard Toggle word wrap

      Red Hat Enterprise Linux 9

      [root@client01 ~]# subscription-manager repos --enable=rhceph-6-tools-for-rhel-9-x86_64-rpms
      Copy to Clipboard Toggle word wrap

    2. ceph-fuse パッケージをインストールします。 

      [root@client ~]# dnf install ceph-fuse
      Copy to Clipboard Toggle word wrap

    3. Ceph クライアントキーリングを Ceph Monitor ノードからクライアントノードにコピーします。

      構文

      scp root@MONITOR_NODE_NAME:/etc/ceph/KEYRING_FILE /etc/ceph/
      Copy to Clipboard Toggle word wrap

      MONITOR_NODE_NAME は、Ceph Monitor ホスト名または IP アドレスに置き換えます。

      例

      [root@client ~]# scp root@192.168.0.1:/etc/ceph/ceph.client.1.keyring /etc/ceph/
      Copy to Clipboard Toggle word wrap

    4. Ceph 設定ファイルを Monitor ノードからクライアントノードにコピーします。

      構文

      scp root@MONITOR_NODE_NAME:/etc/ceph/ceph.conf /etc/ceph/ceph.conf
      Copy to Clipboard Toggle word wrap

      MONITOR_NODE_NAME は、Ceph Monitor ホスト名または IP アドレスに置き換えます。

      例

      [root@client ~]# scp root@192.168.0.1:/etc/ceph/ceph.conf /etc/ceph/ceph.conf
      Copy to Clipboard Toggle word wrap

    5. 設定ファイルに適切なパーミッションを設定します。 

      [root@client ~]# chmod 644 /etc/ceph/ceph.conf
      Copy to Clipboard Toggle word wrap

  2. Ceph ファイルシステムを作成します。

    構文

    ceph fs volume create FILE_SYSTEM_NAME
    Copy to Clipboard Toggle word wrap

    例

    [root@mon ~]# ceph fs volume create cephfs01
    Copy to Clipboard Toggle word wrap

    この手順を繰り返して、追加のファイルシステムを作成します。

    注記

    このコマンドを実行すると、Ceph は新しいプールを自動的に作成し、新しいファイルシステムをサポートする新たな Ceph Metadata Server (MDS) デーモンをデプロイします。また、これにより MDS アフィニティーを適宜設定します。

  3. Ceph クライアントから新しい Ceph File System へのアクセスを確認します。

    1. Ceph クライアントが新しいファイルシステムへのアクセスを承認します。

      構文

      ceph fs authorize FILE_SYSTEM_NAME CLIENT_NAME DIRECTORY PERMISSIONS
      Copy to Clipboard Toggle word wrap

      例

      [root@mon ~]# ceph fs authorize cephfs01 client.1 / rw
[client.1]
    key = BQAmthpf81M+JhAAiHDYQkMiCq3x+J0n9e8REK==

[root@mon ~]# ceph auth get client.1
exported keyring for client.1
[client.1]
    key = BQAmthpf81M+JhAAiHDYQkMiCq3x+J0n9e8REK==
    caps mds = "allow rw fsname=cephfs01"
    caps mon = "allow r fsname=cephfs01"
    caps osd = "allow rw tag cephfs data=cephfs01"
      Copy to Clipboard Toggle word wrap

      注記

      必要に応じて、root_squash オプションを指定することで安全対策を追加できます。これにより、uid=0 または gid=0 のクライアントが書き込み操作を行うのを許可することで、誤って削除のシナリオは阻止されますが、読み取り操作は引き続き許可されます。

      例

      [root@mon ~]# ceph fs authorize cephfs01 client.1 / rw root_squash /volumes rw
[client.1]
    key = BQAmthpf81M+JhAAiHDYQkMiCq3x+J0n9e8REK==

[root@mon ~]# ceph auth get client.1
[client.1]
    key = BQAmthpf81M+JhAAiHDYQkMiCq3x+J0n9e8REK==
    caps mds = "allow rw fsname=cephfs01 root_squash, allow rw fsname=cephfs01 path=/volumes"
    caps mon = "allow r fsname=cephfs01"
    caps osd = "allow rw tag cephfs data=cephfs01"
      Copy to Clipboard Toggle word wrap

      この例では、/volumes ディレクトリーツリー内ではファイルシステム cephfs01 に対して root_squash が有効になります。

      重要

      Ceph クライアントは、それが承認されている CephFS のみを認識することができます。

    2. Ceph ユーザーのキーリングを Ceph クライアントノードにコピーします。

      構文

      ceph auth get CLIENT_NAME > OUTPUT_FILE_NAME
scp OUTPUT_FILE_NAME TARGET_NODE_NAME:/etc/ceph
      Copy to Clipboard Toggle word wrap

      例

      [root@mon ~]# ceph auth get client.1 > ceph.client.1.keyring
exported keyring for client.1
[root@mon ~]# scp ceph.client.1.keyring client:/etc/ceph
root@client's password:
ceph.client.1.keyring                     100%  178   333.0KB/s   00:00
      Copy to Clipboard Toggle word wrap

    3. Ceph クライアントノードで、新しいディレクトリーを作成します。

      構文

      mkdir PATH_TO_NEW_DIRECTORY_NAME
      Copy to Clipboard Toggle word wrap

      例

      [root@client ~]# mkdir /mnt/mycephfs
      Copy to Clipboard Toggle word wrap

    4. Ceph クライアントノードで、新しい Ceph File System をマウントします。

      構文

      ceph-fuse PATH_TO_NEW_DIRECTORY_NAME -n CEPH_USER_NAME --client-fs=_FILE_SYSTEM_NAME
      Copy to Clipboard Toggle word wrap

      例

      [root@client ~]# ceph-fuse /mnt/mycephfs/ -n client.1 --client-fs=cephfs01
ceph-fuse[555001]: starting ceph client
2022-05-09T07:33:27.158+0000 7f11feb81200 -1 init, newargv = 0x55fc4269d5d0 newargc=15
ceph-fuse[555001]: starting fuse
      Copy to Clipboard Toggle word wrap

    5. Ceph クライアントノードで、新しいマウントポイントのディレクトリーコンテンツをリスト表示するか、新しいマウントポイントにファイルを作成します。

3.3. Ceph ファイルシステムへのイレイジャーコーディングされたプールの追加
リンクのコピー

デフォルトでは、Ceph はデータプールにレプリケートされたプールを使用します。必要に応じて、Ceph File System に新たなイレイジャーコーディングデータプールを追加することもできます。イレイジャーコーディングプールが対応する Ceph File Systems (CephFS) は、複製されたプールでサポートされる Ceph File Systems と比較して、全体的なストレージの使用量を使用します。イレイジャーコーディングされたプールは、全体的なストレージを使用しますが、レプリケートされたプールよりも多くのメモリーおよびプロセッサーリソースを使用します。

重要

CephFS EC プールはアーカイブのみを目的としています。

重要

実稼働環境では、CephFS にデフォルトのレプリケートデータプールを使用することを推奨します。CephFS で inode を作成すると、デフォルトのデータプールに少なくとも 1 つのオブジェクトが作成されます。デフォルトのデータにレプリケートされたプールを使用すると、小規模なオブジェクト書き込みパフォーマンスを向上し、バックトレースを更新する読み取りパフォーマンスが向上します。

前提条件

  • 稼働中の Red Hat Ceph Storage クラスターがある。
  • 既存の Ceph File System。
  • BlueStore OSD を使用するプール。
  • Ceph Monitor ノードへの root レベルのアクセス。
  • attr パッケージのインストール。

手順

  1. CephFS 用のイレイジャーコーディングデータプールを作成します。

    構文

    ceph osd pool create DATA_POOL_NAME erasure
    Copy to Clipboard Toggle word wrap

    例

    [root@mon ~]# ceph osd pool create cephfs-data-ec01 erasure
pool 'cephfs-data-ec01' created
    Copy to Clipboard Toggle word wrap

  2. プールが追加されたことを確認します。

    例

    [root@mon ~]# ceph osd lspools
    Copy to Clipboard Toggle word wrap

  3. 消去コード化されたプールでのオーバーライトを有効にします。

    構文

    ceph osd pool set DATA_POOL_NAME allow_ec_overwrites true
    Copy to Clipboard Toggle word wrap

    例

    [root@mon ~]# ceph osd pool set cephfs-data-ec01 allow_ec_overwrites true
set pool 15 allow_ec_overwrites to true
    Copy to Clipboard Toggle word wrap

  4. Ceph File System のステータスを確認します。

    構文

    ceph fs status FILE_SYSTEM_NAME
    Copy to Clipboard Toggle word wrap

    例

    [root@mon ~]# ceph fs status cephfs-ec
cephfs-ec - 14 clients
=========
RANK  STATE              MDS                ACTIVITY     DNS    INOS   DIRS   CAPS
 0    active  cephfs-ec.example.ooymyq  Reqs:    0 /s  8231   8233    891    921
       POOL           TYPE     USED  AVAIL
cephfs-metadata-ec  metadata   787M  8274G
  cephfs-data-ec      data    2360G  12.1T

       STANDBY MDS
cephfs-ec.example.irsrql
cephfs-ec.example.cauuaj
    Copy to Clipboard Toggle word wrap

  5. 既存の CephFS にイレイジャーコーディングのデータプールを追加します。

    構文

    ceph fs add_data_pool FILE_SYSTEM_NAME DATA_POOL_NAME
    Copy to Clipboard Toggle word wrap

    例

    [root@mon ~]# ceph fs add_data_pool cephfs-ec cephfs-data-ec01
    Copy to Clipboard Toggle word wrap

    この例では、新しいデータプール cephfs-data-ec01 を、既存のイレイジャーコーディングのファイルシステム cephfs-ec に追加します。

  6. イレイジャーコーディングされたプールが Ceph File System に追加されていることを確認します。

    構文

    ceph fs status FILE_SYSTEM_NAME
    Copy to Clipboard Toggle word wrap

    例

    [root@mon ~]# ceph fs status cephfs-ec
cephfs-ec - 14 clients
=========
RANK  STATE              MDS                ACTIVITY     DNS    INOS   DIRS   CAPS
 0    active  cephfs-ec.example.ooymyq  Reqs:    0 /s  8231   8233    891    921
       POOL           TYPE     USED  AVAIL
cephfs-metadata-ec  metadata   787M  8274G
  cephfs-data-ec      data    2360G  12.1T
 cephfs-data-ec01     data       0   12.1T

       STANDBY MDS
cephfs-ec.example.irsrql
cephfs-ec.example.cauuaj
    Copy to Clipboard Toggle word wrap

  7. 新しいディレクトリーにファイルレイアウトを設定します。

    構文

    mkdir PATH_TO_DIRECTORY
setfattr -n ceph.dir.layout.pool -v DATA_POOL_NAME PATH_TO_DIRECTORY
    Copy to Clipboard Toggle word wrap

    例

    [root@mon ~]# mkdir /mnt/cephfs/newdir
[root@mon ~]# setfattr -n ceph.dir.layout.pool -v cephfs-data-ec01 /mnt/cephfs/newdir
    Copy to Clipboard Toggle word wrap

    この例では、/mnt/cephfs/newdir ディレクトリーで作成されるすべての新しいファイルは、ディレクトリーレイアウトを継承して、新たに追加したレイジャーコーディングプールにデータを配置します。

関連情報

3.4. Ceph ファイルシステム用のクライアントユーザーの作成
リンクのコピー

Red Hat Ceph Storage は認証に cephx を使用します。これはデフォルトで有効になります。Ceph File System で cephx を使用するには、Ceph Monitor ノードで正しい承認機能を持つユーザーを作成し、そのキーを Ceph File System がマウントされるノードで利用できるようにします。

前提条件

  • 稼働中の Red Hat Ceph Storage クラスターがある。
  • Ceph Metadata Server デーモン (ceph-mds) のインストールおよび設定
  • Ceph Monitor ノードへの root レベルのアクセス。
  • Ceph クライアントノードへのルートレベルのアクセスがある。

手順

  1. モニターノードの Cephadm シェルにログインします。

    例

    [root@host01 ~]# cephadm shell
    Copy to Clipboard Toggle word wrap

  2. Ceph Monitor ノードで、クライアントユーザーを作成します。

    構文

    ceph fs authorize FILE_SYSTEM_NAME client.CLIENT_NAME /DIRECTORY CAPABILITY [/DIRECTORY CAPABILITY] PERMISSIONS ...
    Copy to Clipboard Toggle word wrap

    • クライアントを、ファイルシステム cephfs_a の temp ディレクトリーでのみ書き込みするよう制限するには、以下を実行します。

      例

      [ceph: root@host01 /]# ceph fs authorize cephfs_a client.1 / r /temp rw

client.1
  key = AQBSdFhcGZFUDRAAcKhG9Cl2HPiDMMRv4DC43A==
      Copy to Clipboard Toggle word wrap

    • クライアントを temp ディレクトリーに完全に制限するには、root (/) ディレクトリーを削除します。

      例

      [ceph: root@host01 /]# ceph fs authorize cephfs_a client.1 /temp rw
      Copy to Clipboard Toggle word wrap

    注記

    ファイルシステム名、all またはアスタリスク (*) をファイルシステム名として指定することにより、すべてのファイルシステムへのアクセスが付与されます。通常、シェルから保護するには、アスタリスクを引用符で囲む必要があります。

  3. 作成したキーを確認します。

    構文

    ceph auth get client.ID
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph auth get client.1

client.1
  key = AQBSdFhcGZFUDRAAcKhG9Cl2HPiDMMRv4DC43A==
  caps mds = "allow r, allow rw path=/temp"
  caps mon = "allow r"
  caps osd = "allow rw tag cephfs data=cephfs_a"
    Copy to Clipboard Toggle word wrap

  4. キーリングをクライアントにコピーします。

    1. Ceph Monitor ノードで、キーリングをファイルにエクスポートします。

      構文

      ceph auth get client.ID -o ceph.client.ID.keyring
      Copy to Clipboard Toggle word wrap

      例

      [ceph: root@host01 /]# ceph auth get client.1 -o ceph.client.1.keyring
exported keyring for client.1
      Copy to Clipboard Toggle word wrap

    2. Ceph Monitor ノードからクライアントノードの /etc/ceph/ ディレクトリーに、クライアントキーリングをコピーします。

      構文

      scp /ceph.client.ID.keyring root@CLIENT_NODE_NAME:/etc/ceph/ceph.client.ID.keyring
      Copy to Clipboard Toggle word wrap

      CLIENT_NODE_NAME を Ceph クライアントのノード名または IP に置き換えます。

      例

      [ceph: root@host01 /]# scp /ceph.client.1.keyring root@client01:/etc/ceph/ceph.client.1.keyring
      Copy to Clipboard Toggle word wrap

  5. クライアントノードから、キーリングファイルに適切なパーミッションを設定します。

    構文

    chmod 644 ceph.client.ID.keyring
    Copy to Clipboard Toggle word wrap

    例

    [root@client01 ~]# chmod 644 /etc/ceph/ceph.client.1.keyring
    Copy to Clipboard Toggle word wrap

関連情報

  • 詳細は、Red Hat Ceph Storage 管理ガイド の Ceph ユーザー管理 の章を参照してください。

3.5. Ceph File System のカーネルクライアントとしてのマウント
リンクのコピー

Ceph File System (CephFS) は、システムの起動時に手動で、または自動でカーネルクライアントとしてマウントできます。

重要

Red Hat Enterprise Linux の他に、他の Linux ディストリビューションで実行しているクライアントは許可されますが、サポートされていません。これらのクライアントの使用時に、CephFS Metadata Server またはその他のストレージクラスターで問題が見つかる場合、Red Hat はそれらに対応します。原因がクライアント側にある場合は、Linux ディストリビューションのカーネルベンダーがこの問題に対応する必要があります。

前提条件

  • Linux ベースのクライアントノードへのルートレベルのアクセス。
  • Ceph Monitor ノードへの root レベルのアクセス。
  • 既存の Ceph File System。

手順

  1. Ceph Storage クラスターを使用するようにクライアントノードを設定します。

    1. Red Hat Ceph Storage 7 Tools リポジトリーを有効にします。

      Red Hat Enterprise Linux 9

      [root@client01 ~]# subscription-manager repos --enable=rhceph-6-tools-for-rhel-9-x86_64-rpms
      Copy to Clipboard Toggle word wrap

    2. ceph-common パッケージをインストールします。 

      [root@client01 ~]# dnf install ceph-common
      Copy to Clipboard Toggle word wrap

    3. モニターノードの Cephadm シェルにログインします。

      例

      [root@host01 ~]# cephadm shell
      Copy to Clipboard Toggle word wrap

    4. Ceph クライアントキーリングを Ceph Monitor ノードからクライアントノードにコピーします。

      構文

      scp /ceph.client.ID.keyring root@CLIENT_NODE_NAME:/etc/ceph/ceph.client.ID.keyring
      Copy to Clipboard Toggle word wrap

      CLIENT_NODE_NAME を Ceph クライアントのホスト名または IP アドレスに置き換えます。

      例

      [ceph: root@host01 /]# scp /ceph.client.1.keyring root@client01:/etc/ceph/ceph.client.1.keyring
      Copy to Clipboard Toggle word wrap

    5. Ceph 設定ファイルを Monitor ノードからクライアントノードにコピーします。

      構文

      scp /etc/ceph/ceph.conf root@CLIENT_NODE_NAME:/etc/ceph/ceph.conf
      Copy to Clipboard Toggle word wrap

      CLIENT_NODE_NAME を Ceph クライアントのホスト名または IP アドレスに置き換えます。

      例

      [ceph: root@host01 /]# scp /etc/ceph/ceph.conf root@client01:/etc/ceph/ceph.conf
      Copy to Clipboard Toggle word wrap

    6. クライアントノードから、設定ファイルに適切なパーミッションを設定します。 

      [root@client01 ~]# chmod 644 /etc/ceph/ceph.conf
      Copy to Clipboard Toggle word wrap
    7. automatically または manually のいずれかを選択します。

Manually Mounting

  1. クライアントノードにマウントディレクトリーを作成します。

    構文

    mkdir -p MOUNT_POINT
    Copy to Clipboard Toggle word wrap

    例

    [root@client01 ~]# mkdir -p /mnt/cephfs
    Copy to Clipboard Toggle word wrap

  2. Ceph ファイルシステムをマウントします。複数の Ceph Monitor アドレスを指定するには、mount コマンドでコンマで区切って、マウントポイントを指定し、クライアント名を設定します。

    注記

    Red Hat Ceph Storage 4.1 の時点で、mount.ceph はキーリングファイルを直接読み取りできます。そのため、シークレットファイルは不要になりました。name=CLIENT_ID でクライアント ID を指定すると、mount.ceph は適切なキーリングファイルを検索します。

    構文

    mount -t ceph MONITOR-1_NAME:6789,MONITOR-2_NAME:6789,MONITOR-3_NAME:6789:/ MOUNT_POINT -o name=CLIENT_ID,fs=FILE_SYSTEM_NAME
    Copy to Clipboard Toggle word wrap

    例

    [root@client01 ~]# mount -t ceph mon1:6789,mon2:6789,mon3:6789:/ /mnt/cephfs -o name=1,fs=cephfs01
    Copy to Clipboard Toggle word wrap

    注記

    1 つのホスト名が複数の IP アドレスに解決するように DNS サーバーを設定できます。次に、コンマ区切りリストを指定する代わりに、mount コマンドでその 1 つのホスト名を使用できます。

    注記

    また、Monitor ホスト名は :/ に置き換えられ、mount.ceph は Ceph 設定ファイルを読み取り、どのモニターに接続するかを判断することもできます。

    注記

    nowsync オプションを設定して、Red Hat Ceph Storage クラスターでファイルの作成と削除を非同期的に実行できます。これにより、整合性に影響を与えずにこれらのシステムコールのラウンドトリップレイテンシーを回避することで、一部のワークロードのパフォーマンスが改善されます。nowsync オプションには、Red Hat Enterprise Linux 9.0 以降を搭載したカーネルクライアントが必要です。

    例

    [root@client01 ~]# mount -t ceph mon1:6789,mon2:6789,mon3:6789:/ /mnt/cephfs -o nowsync,name=1,fs=cephfs01
    Copy to Clipboard Toggle word wrap

  3. ファイルシステムが正常にマウントされていることを確認します。

    構文

    stat -f MOUNT_POINT
    Copy to Clipboard Toggle word wrap

    例

    [root@client01 ~]# stat -f /mnt/cephfs
    Copy to Clipboard Toggle word wrap

自動マウント

  1. クライアントホストで、Ceph ファイルシステムをマウントする新しいディレクトリーを作成します。

    構文

    mkdir -p MOUNT_POINT
    Copy to Clipboard Toggle word wrap

    例

    [root@client01 ~]# mkdir -p /mnt/cephfs
    Copy to Clipboard Toggle word wrap

  2. 以下のように /etc/fstab ファイルを編集します。

    構文

    #DEVICE                                              PATH                      TYPE               OPTIONS
MON_0_HOST:PORT,            MOUNT_POINT          ceph         name=CLIENT_ID,
MON_1_HOST:PORT,                                                         ceph.client_mountpoint=/VOL/SUB_VOL_GROUP/SUB_VOL/UID_SUB_VOL,                                                       fs=FILE_SYSTEM_NAME,
MON_2_HOST:PORT:/q[_VOL_]/SUB_VOL/UID_SUB_VOL,            [ADDITIONAL_OPTIONS]
    Copy to Clipboard Toggle word wrap

    最初の列 は、Ceph Monitor ホスト名とポート番号を設定します。

    2 列目 は、マウントポイントを設定します。

    3 列目 は、ファイルシステムのタイプ (ここでは CephFS 用 ceph) を設定します。

    4 番目のコラム は、name および secretfile オプションを使用してユーザー名やシークレットファイルなどのさまざまなオプションを設定します。ceph.client_mountpoint オプションを使用して、特定のボリューム、サブボリューム、およびサブボリュームを設定できます。

    ネットワークサブシステムの開始後にファイルシステムがマウントされ、ハングやネットワークの問題を回避するために、_netdev オプションを設定します。アクセス時間情報が必要ない場合は、noatime オプションを設定するとパフォーマンスが向上します。

    5 番目のコラムと 6 番目のコラム をゼロに設定します。

    例

    #DEVICE         PATH                   TYPE    OPTIONS         DUMP  FSCK
mon1:6789,      /mnt/cephfs            ceph    name=1,            0     0
mon2:6789,                                     ceph.client_mountpoint=/my_vol/my_sub_vol_group/my_sub_vol/0,
mon3:6789:/                                    fs=cephfs01,
                                               _netdev,noatime
    Copy to Clipboard Toggle word wrap

    Ceph File System は、次回のシステム起動時にマウントされます。

    注記

    Red Hat Ceph Storage 4.1 の時点で、mount.ceph はキーリングファイルを直接読み取りできます。そのため、シークレットファイルは不要になりました。name=CLIENT_ID でクライアント ID を指定すると、mount.ceph は適切なキーリングファイルを検索します。

    注記

    また、Monitor ホスト名は :/ に置き換えられ、mount.ceph は Ceph 設定ファイルを読み取り、どのモニターに接続するかを判断することもできます。

関連情報

  • mount(8) man ページを参照してください。
  • Ceph ユーザーの作成の詳細は、Red Hat Ceph Storage 管理ガイド の Ceph ユーザー管理 の章を参照してください。
  • 詳細は、Red Hat Ceph Storage File System ガイド の Ceph File Systems の作成 セクションを参照してください。

3.6. Ceph File System の FUSE クライアントとしてのマウント
リンクのコピー

Ceph File System (CephFS) は、システムの起動時に手動で、または自動で File System in User Space (FUSE) クライアントとしてマウントできます。

前提条件

  • Linux ベースのクライアントノードへのルートレベルのアクセス。
  • Ceph Monitor ノードへの root レベルのアクセス。
  • 既存の Ceph File System。

手順

  1. Ceph Storage クラスターを使用するようにクライアントノードを設定します。

    1. Red Hat Ceph Storage 7 Tools リポジトリーを有効にします。

      Red Hat Enterprise Linux 8

      [root@client01 ~]# subscription-manager repos --enable=6-tools-for-rhel-8-x86_64-rpms
      Copy to Clipboard Toggle word wrap

      Red Hat Enterprise Linux 9

      [root@client01 ~]# subscription-manager repos --enable=6-tools-for-rhel-9-x86_64-rpms
      Copy to Clipboard Toggle word wrap

    2. ceph-fuse パッケージをインストールします。 

      [root@client01 ~]# dnf install ceph-fuse
      Copy to Clipboard Toggle word wrap

    3. モニターノードの Cephadm シェルにログインします。

      例

      [root@host01 ~]# cephadm shell
      Copy to Clipboard Toggle word wrap

    4. Ceph クライアントキーリングを Ceph Monitor ノードからクライアントノードにコピーします。

      構文

      scp /ceph.client.ID.keyring root@CLIENT_NODE_NAME:/etc/ceph/ceph.client.ID.keyring
      Copy to Clipboard Toggle word wrap

      CLIENT_NODE_NAME を Ceph クライアントのホスト名または IP アドレスに置き換えます。

      例

      [ceph: root@host01 /]# scp /ceph.client.1.keyring root@client01:/etc/ceph/ceph.client.1.keyring
      Copy to Clipboard Toggle word wrap

    5. Ceph 設定ファイルを Monitor ノードからクライアントノードにコピーします。

      構文

      scp /etc/ceph/ceph.conf root@CLIENT_NODE_NAME:/etc/ceph/ceph.conf
      Copy to Clipboard Toggle word wrap

      CLIENT_NODE_NAME を Ceph クライアントのホスト名または IP アドレスに置き換えます。

      例

      [ceph: root@host01 /]# scp /etc/ceph/ceph.conf root@client01:/etc/ceph/ceph.conf
      Copy to Clipboard Toggle word wrap

    6. クライアントノードから、設定ファイルに適切なパーミッションを設定します。 

      [root@client01 ~]# chmod 644 /etc/ceph/ceph.conf
      Copy to Clipboard Toggle word wrap
    7. automatically または manually のいずれかを選択します。

Manually Mounting

  1. クライアントノードで、マウントポイントのディレクトリーを作成します。

    構文

    mkdir PATH_TO_MOUNT_POINT
    Copy to Clipboard Toggle word wrap

    例

    [root@client01 ~]# mkdir /mnt/mycephfs
    Copy to Clipboard Toggle word wrap

    注記

    MDS 機能で path オプションを使用した場合、マウントポイントは path で指定されたもの内になければなりません。

  2. ceph-fuse ユーティリティーを使用して Ceph ファイルシステムをマウントします。

    構文

    ceph-fuse -n client.CLIENT_ID --client_fs FILE_SYSTEM_NAME MOUNT_POINT
    Copy to Clipboard Toggle word wrap

    例

    [root@client01 ~]# ceph-fuse -n client.1 --client_fs cephfs01 /mnt/mycephfs
    Copy to Clipboard Toggle word wrap

    注記

    /etc/ceph/ceph.client.CLIENT_ID.keyring であるユーザーキーリングのデフォルト名と場所を使用しない場合は --keyring オプションを使用してユーザーキーリングへのパスを指定します。以下に例を示します。

    例

    [root@client01 ~]# ceph-fuse -n client.1 --keyring=/etc/ceph/client.1.keyring /mnt/mycephfs
    Copy to Clipboard Toggle word wrap

    注記

    -r オプションを使用して、そのパスを root として処理するように指示します。

    構文

    ceph-fuse -n client.CLIENT_ID MOUNT_POINT -r PATH
    Copy to Clipboard Toggle word wrap

    例

    [root@client01 ~]# ceph-fuse -n client.1 /mnt/cephfs -r /home/cephfs
    Copy to Clipboard Toggle word wrap

    注記

    エビクトされた Ceph クライアントを自動的に再接続する場合は --client_reconnect_stale=true オプションを追加します。

    例

    [root@client01 ~]# ceph-fuse -n client.1 /mnt/cephfs --client_reconnect_stale=true
    Copy to Clipboard Toggle word wrap

  3. ファイルシステムが正常にマウントされていることを確認します。

    構文

    stat -f MOUNT_POINT
    Copy to Clipboard Toggle word wrap

    例

    [root@client01 ~]# stat -f /mnt/cephfs
    Copy to Clipboard Toggle word wrap

自動マウント

  1. クライアントノードで、マウントポイントのディレクトリーを作成します。

    構文

    mkdir PATH_TO_MOUNT_POINT
    Copy to Clipboard Toggle word wrap

    例

    [root@client01 ~]# mkdir /mnt/mycephfs
    Copy to Clipboard Toggle word wrap

    注記

    MDS 機能で path オプションを使用した場合、マウントポイントは path で指定されたもの内になければなりません。

  2. 以下のように /etc/fstab ファイルを編集します。

    構文

    #DEVICE                 PATH           TYPE          OPTIONS                  DUMP  FSCK
HOST_NAME:PORT,     MOUNT_POINT fuse.ceph     ceph.id=CLIENT_ID,        0     0
HOST_NAME:PORT,                                  ceph.client_mountpoint=/VOL/SUB_VOL_GROUP/SUB_VOL/UID_SUB_VOL,
HOST_NAME:PORT:/                                 ceph.client_fs=FILE_SYSTEM_NAME,ceph.name=USERNAME,ceph.keyring=/etc/ceph/KEYRING_FILE,
                                                     [ADDITIONAL_OPTIONS]
    Copy to Clipboard Toggle word wrap

    最初の列 は、Ceph Monitor ホスト名とポート番号を設定します。

    2 列目 は、マウントポイントを設定します。

    3 列目 は、ファイルシステムのタイプ (ここでは CephFS 用 fuse.ceph) を設定します。

    4 列目 は、ceph.name および ceph.keyring オプションを使用して、ユーザー名やキーリングなどのさまざまなオプションを設定します。ceph.client_mountpoint オプションを使用して、特定のボリューム、サブボリューム、およびサブボリュームを設定できます。アクセスする Ceph File System を指定するには、ceph.client_fs オプションを使用します。ネットワークサブシステムの開始後にファイルシステムがマウントされ、ハングやネットワークの問題を回避するために、_netdev オプションを設定します。アクセス時間情報が必要ない場合は、noatime オプションを設定するとパフォーマンスが向上します。エビクションの後に自動的に再接続する必要がある場合は、client_reconnect_stale=true オプションを設定します。

    5 番目のコラムと 6 番目のコラム をゼロに設定します。

    例

    #DEVICE         PATH              TYPE         OPTIONS         DUMP  FSCK
mon1:6789,      /mnt/mycephfs       fuse.ceph    ceph.id=1,         0     0
mon2:6789,                                     ceph.client_mountpoint=/my_vol/my_sub_vol_group/my_sub_vol/0,
mon3:6789:/                                    ceph.client_fs=cephfs01,ceph.name=client.1,ceph.keyring=/etc/ceph/client1.keyring,
                                               _netdev,defaults
    Copy to Clipboard Toggle word wrap

    Ceph File System は、次回のシステム起動時にマウントされます。

ストレージ管理者は、Red Hat の Ceph Container Storage Interface (CSI) を使用して Ceph File System (CephFS) エクスポートを管理できます。また、OpenStack のファイルシステムサービス (Manila) などの他のサービスは、一般的なコマンドラインインターフェイスを使用して対話できます。Ceph Manager デーモンの volumes モジュール (ceph-mgr) は、Ceph File Systems (CephFS) をエクスポートする機能を実装します。

Ceph Manager ボリュームモジュールは、以下のファイルシステムのエクスポートの抽象化を実装します。

  • CephFS ボリューム
  • CephFS サブボリュームグループ
  • CephFS サブボリューム

4.1. Ceph File System ボリューム
リンクのコピー

ストレージ管理者は、Ceph File System (CephFS) ボリュームの作成、リスト表示、および削除を行うことができます。CephFS ボリュームは、Ceph File Systems の抽象化です。

このセクションでは、以下を行う方法を説明します。

4.1.1. Ceph ファイルシステムボリュームの作成
リンクのコピー

Ceph Orchestrator は、Ceph File System (CephFS) の Metadata Server (MDS) を作成する Ceph Manager のモジュールです。このセクションでは、CephFS ボリュームを作成する方法を説明します。

注記

これにより、データおよびメタデータプールと共に Ceph File System が作成されます。

前提条件

  • Ceph File System がデプロイされている稼働中の Red Hat Ceph Storage クラスター。
  • Ceph Monitor での少なくとも読み取りアクセス。
  • Ceph Manager ノードの読み取りおよび書き込み機能。

手順

  • モニターノードに CephFS ボリュームを作成します。

    構文

    ceph fs volume create VOLUME_NAME
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph fs volume create cephfs
    Copy to Clipboard Toggle word wrap

4.1.2. Ceph ファイルシステムボリュームの一覧表示
リンクのコピー

このセクションでは、Ceph File System (CephFS) ボリュームをリスト表示する手順について説明します。

前提条件

  • Ceph File System がデプロイされている稼働中の Red Hat Ceph Storage クラスター。
  • Ceph Monitor での少なくとも読み取りアクセス。
  • Ceph Manager ノードの読み取りおよび書き込み機能。
  • CephFS ボリューム。

手順

  • CephFS ボリュームをリスト表示します。

    例

    [ceph: root@host01 /]# ceph fs volume ls
    Copy to Clipboard Toggle word wrap

4.1.3. Ceph ファイルシステムボリュームに関する情報の表示
リンクのコピー

CephFS ボリュームのデータおよびメタデータプールの属性、保留中のサブボリュームの削除数など、Ceph ファイルシステム (CephFS) ボリュームに関する基本的な詳細を一覧表示できます。

前提条件

  • Ceph File System がデプロイされている稼働中の Red Hat Ceph Storage クラスター。
  • Ceph Monitor での少なくとも読み取りアクセス。
  • Ceph Manager ノードの読み取りおよび書き込み機能。
  • CephFS ボリュームが作成されている。

手順

  • CephFS ボリュームに関する情報を表示します。

    構文

    ceph fs volume info VOLUME_NAME
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph fs volume info cephfs
{
    "mon_addrs": [
        "192.168.1.7:40977",
    ],
    "pending_subvolume_deletions": 0,
    "pools": {
        "data": [
            {
                "avail": 106288709632,
                "name": "cephfs.cephfs.data",
                "used": 4096
            }
        ],
        "metadata": [
            {
                "avail": 106288709632,
                "name": "cephfs.cephfs.meta",
                "used": 155648
            }
        ]
    },
    "used_size": 0
}
    Copy to Clipboard Toggle word wrap

ceph fs volume info コマンドの出力には以下が含まれます。

  • mon_addrs: モニターアドレスの一覧。
  • pending_subvolume_deletions: 削除保留中のサブボリュームの数。

  • pools: データおよびメタデータプールの属性。

    • avail: 利用可能な空き容量 (バイト単位)。
    • name: プールの名前。
    • used: 消費されたストレージの量 (バイト単位)。
  • used_size: CephFS ボリュームの現在の使用サイズ (バイト単位)。

4.1.4. Ceph ファイルシステムボリュームの削除
リンクのコピー

Ceph Orchestrator は、Ceph File System (CephFS) の Metadata Server (MDS) を削除する Ceph Manager のモジュールです。このセクションでは、Ceph File System (CephFS) ボリュームを削除する方法を説明します。

前提条件

  • Ceph File System がデプロイされている稼働中の Red Hat Ceph Storage クラスター。
  • Ceph Monitor での少なくとも読み取りアクセス。
  • Ceph Manager ノードの読み取りおよび書き込み機能。
  • CephFS ボリューム。

手順

  1. mon_allow_pool_delete オプションが true に設定されていない場合は、CephFS ボリュームを削除する前に true に設定します。

    例

    [ceph: root@host01 /]# ceph config set mon mon_allow_pool_delete true
    Copy to Clipboard Toggle word wrap

  2. CephFS ボリュームを削除します。

    構文

    ceph fs volume rm VOLUME_NAME [--yes-i-really-mean-it]
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph fs volume rm cephfs --yes-i-really-mean-it
    Copy to Clipboard Toggle word wrap

4.2. Ceph File System サブボリュームグループ
リンクのコピー

ストレージ管理者は、Ceph File System (CephFS) サブボリュームグループの作成、リスト表示、取得、および削除できます。CephFS サブボリュームグループは、サブボリュームのセット全体で、ファイルレイアウトなどのポリシーに影響を与えるディレクトリーレベルで抽象化されます。

Red Hat Ceph Storage 5.0 以降では、サブボリュームグループスナップショット機能はサポートされません。これらのサブボリュームグループの既存のスナップショットのみをリスト表示および削除できます。

このセクションでは、以下を行う方法を説明します。

4.2.1. ファイルシステムのサブボリュームグループの作成
リンクのコピー

このセクションでは、Ceph File System (CephFS) サブボリュームグループを作成する方法を説明します。

注記

subvolume グループを作成する場合は、そのデータプールのレイアウト (uid、gid、および file モード) を 8 進数で指定できます。デフォルトでは、サブボリュームグループは、親ディレクトリーの 8 進数ファイルモード '755'、uid '0'、gid '0'、およびデータプールレイアウトで作成されます。

注記

サブボリュームグループの作成中にクォータを設定するには、ファイルシステムサブボリュームグループでのクォータの設定と管理 を参照してください。

前提条件

  • Ceph File System がデプロイされている稼働中の Red Hat Ceph Storage クラスター。
  • Ceph Monitor での少なくとも読み取りアクセス。
  • Ceph Manager ノードの読み取りおよび書き込み機能。

手順

  • CephFS サブボリュームグループを作成します。

    構文

    ceph fs subvolumegroup create VOLUME_NAME GROUP_NAME [--pool_layout DATA_POOL_NAME --uid UID --gid GID --mode OCTAL_MODE]
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph fs subvolumegroup create cephfs subgroup0
    Copy to Clipboard Toggle word wrap

    subvolume グループがすでに存在している場合でも、コマンドは成功します。

4.2.2. ファイルシステムサブボリュームグループのクォータの設定と管理
リンクのコピー

このセクションでは、Ceph ファイルシステム (CephFS) サブボリュームグループでクォータを設定および管理する方法について説明します。

前提条件

  • Ceph File System がデプロイされている稼働中の Red Hat Ceph Storage クラスター。
  • Ceph Monitor での少なくとも読み取りアクセス。
  • Ceph Manager ノードの読み取りおよび書き込み機能。

手順

  1. サイズをバイト単位で指定して、サブボリュームグループの作成中にクォータを設定します。

    構文

    ceph fs subvolumegroup create VOLUME_NAME GROUP_NAME [--size SIZE_IN_BYTES] [--pool_layout DATA_POOL_NAME] [--uid UID] [--gid GID] [--mode OCTAL_MODE]
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph fs subvolumegroup create cephfs subvolgroup_2 10737418240
    Copy to Clipboard Toggle word wrap

  2. サブボリュームグループのサイズを変更します。

    構文

    ceph fs subvolumegroup resize VOLUME_NAME GROUP_NAME new_size [--no_shrink]
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph fs subvolumegroup resize cephfs subvolgroup_2 20737418240
[
    {
        "bytes_used": 10768679044
    },
    {
        "bytes_quota": 20737418240
    },
    {
        "bytes_pcent": "51.93"
    }
]
    Copy to Clipboard Toggle word wrap

  3. サブボリュームグループのメタデータを取得します。

    構文

    ceph fs subvolumegroup info VOLUME_NAME GROUP_NAME
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph fs subvolumegroup info cephfs subvolgroup_2
{
    "atime": "2022-10-05 18:00:39",
    "bytes_pcent": "51.85",
    "bytes_quota": 20768679043,
    "bytes_used": 10768679044,
    "created_at": "2022-10-05 18:00:39",
    "ctime": "2022-10-05 18:21:26",
    "data_pool": "cephfs.cephfs.data",
    "gid": 0,
    "mode": 16877,
    "mon_addrs": [
        "60.221.178.236:1221",
        "205.64.75.112:1221",
        "20.209.241.242:1221"
    ],
    "mtime": "2022-10-05 18:01:25",
    "uid": 0
}
    Copy to Clipboard Toggle word wrap

4.2.3. ファイルシステムのサブボリュームグループのリスト表示
リンクのコピー

このセクションでは、Ceph File System (CephFS) サブボリュームグループをリスト表示する手順について説明します。

前提条件

  • Ceph File System がデプロイされている稼働中の Red Hat Ceph Storage クラスター。
  • Ceph Monitor での少なくとも読み取りアクセス。
  • Ceph Manager ノードの読み取りおよび書き込み機能。
  • CephFS サブボリュームグループ

手順

  • CephFS サブボリュームグループをリスト表示します。

    構文

    ceph fs subvolumegroup ls VOLUME_NAME
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph fs subvolumegroup ls cephfs
    Copy to Clipboard Toggle word wrap

4.2.4. ファイルシステムのサブボリュームグループの絶対パスを取得中
リンクのコピー

このセクションでは、Ceph File System (CephFS) サブボリュームの絶対パスを取得する方法を説明します。

前提条件

  • Ceph File System がデプロイされている稼働中の Red Hat Ceph Storage クラスター。
  • Ceph Monitor での少なくとも読み取りアクセス。
  • Ceph Manager ノードの読み取りおよび書き込み機能。
  • CephFS サブボリュームグループ

手順

  • CephFS サブボリュームの絶対パスを取得します。

    構文

    ceph fs subvolumegroup getpath VOLUME_NAME GROUP_NAME
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph fs subvolumegroup getpath cephfs subgroup0
    Copy to Clipboard Toggle word wrap

4.2.5. ファイルシステムのサブボリュームグループのスナップショットのリスト表示
リンクのコピー

このセクションでは、Ceph File System (CephFS) サブボリュームグループのスナップショットをリスト表示する手順について説明します。

前提条件

  • Ceph File System がデプロイされている稼働中の Red Hat Ceph Storage クラスター。
  • Ceph Monitor での少なくとも読み取りアクセス。
  • Ceph Manager ノードの読み取りおよび書き込み機能。
  • CephFS サブボリュームグループ
  • サブボリュームグループのスナップショット。

手順

  • CephFS サブボリュームグループのスナップショットをリスト表示します。

    構文

    ceph fs subvolumegroup snapshot ls VOLUME_NAME GROUP_NAME
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph fs subvolumegroup snapshot ls cephfs subgroup0
    Copy to Clipboard Toggle word wrap

4.2.6. ファイルシステムのサブボリュームグループのスナップショットの削除
リンクのコピー

このセクションでは、Ceph File System (CephFS) サブボリュームグループのスナップショットを削除する手順について説明します。

注記

--force フラグを使用すると、コマンドを正常に実行でき、スナップショットが存在しない場合には失敗します。

前提条件

  • Ceph File System がデプロイされている稼働中の Red Hat Ceph Storage クラスター。
  • Ceph Monitor での少なくとも読み取りアクセス。
  • Ceph Manager ノードの読み取りおよび書き込み機能。
  • Ceph File System ボリューム。
  • サブボリュームグループのスナップショット。

手順

  • CephFS サブボリュームグループのスナップショットを削除します。

    構文

    ceph fs subvolumegroup snapshot rm VOLUME_NAME GROUP_NAME SNAP_NAME [--force]
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph fs subvolumegroup snapshot rm cephfs subgroup0 snap0 --force
    Copy to Clipboard Toggle word wrap

4.2.7. ファイルシステムのサブボリュームグループの削除
リンクのコピー

このセクションでは、Ceph File System (CephFS) サブボリュームグループを削除する方法を説明します。

注記

サブボリュームグループが空であるか、存在しないと、そのグループの削除に失敗します。--force フラグは、存在しないサブボリュームグループの削除を許可します。

前提条件

  • Ceph File System がデプロイされている稼働中の Red Hat Ceph Storage クラスター。
  • Ceph Monitor での少なくとも読み取りアクセス。
  • Ceph Manager ノードの読み取りおよび書き込み機能。
  • CephFS サブボリュームグループ

手順

  • CephFS サブボリュームグループを削除します。

    構文

    ceph fs subvolumegroup rm VOLUME_NAME GROUP_NAME [--force]
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph fs subvolumegroup rm cephfs subgroup0 --force
    Copy to Clipboard Toggle word wrap

4.3. Ceph File System サブボリューム
リンクのコピー

ストレージ管理者は、Ceph File System (CephFS) サブボリュームの作成、リスト表示、取得、メタデータの取得、削除が可能です。また、これらのサブボリュームのスナップショットの作成、リスト表示、および削除も可能です。CephFS サブボリュームは、独立した Ceph File Systems ディレクトリーツリーの抽象化です。

このセクションでは、以下を行う方法を説明します。

4.3.1. ファイルシステムのサブボリュームの作成
リンクのコピー

このセクションでは、Ceph File System (CephFS) サブボリュームを作成する方法を説明します。

注記

サブボリュームを作成する場合、そのサブボリュームグループ、データプールレイアウト、uid、gid、ファイルモード (8 進数)、およびサイズ (バイト単位) を指定できます。サブボリュームは、--namespace-isolated オプションを指定することで、別の RADOS namespace に作成できます。デフォルトでは、サブボリュームはデフォルトの subvolume グループ内に作成され、サブボリュームグループの 8 進数ファイルモード '755'、サブボリュームグループの gid、親ディレクトリーのデータプールレイアウトとサイズ制限がありません。

前提条件

  • Ceph File System がデプロイされている稼働中の Red Hat Ceph Storage クラスター。
  • Ceph Monitor での少なくとも読み取りアクセス。
  • Ceph Manager ノードの読み取りおよび書き込み機能。

手順

  • CephFS サブボリュームを作成します。

    構文

    ceph fs subvolume create VOLUME_NAME SUBVOLUME_NAME [--size SIZE_IN_BYTES --group_name SUBVOLUME_GROUP_NAME --pool_layout DATA_POOL_NAME --uid _UID --gid GID --mode OCTAL_MODE] [--namespace-isolated]
    Copy to Clipboard Toggle word wrap

    例

    [root@mon ~]# ceph fs subvolume create cephfs sub0 --group_name subgroup0 --namespace-isolated
    Copy to Clipboard Toggle word wrap

    subvolume がすでに存在している場合でも、コマンドは成功します。

4.3.2. ファイルシステムのサブボリュームのリスト表示
リンクのコピー

このセクションでは、Ceph File System (CephFS) サブボリュームをリスト表示する手順について説明します。

前提条件

  • Ceph File System がデプロイされている稼働中の Red Hat Ceph Storage クラスター。
  • Ceph Monitor での少なくとも読み取りアクセス。
  • Ceph Manager ノードの読み取りおよび書き込み機能。
  • CephFS サブボリューム。

手順

  • CephFS サブボリュームをリスト表示します。

    構文

    ceph fs subvolume ls VOLUME_NAME [--group_name SUBVOLUME_GROUP_NAME]
    Copy to Clipboard Toggle word wrap

    例

    [root@mon ~]# ceph fs subvolume ls cephfs --group_name subgroup0
    Copy to Clipboard Toggle word wrap

4.3.3. ファイルシステムのサブボリュームのサイズ変更
リンクのコピー

このセクションでは、Ceph File System (CephFS) サブボリュームのサイズを変更する方法を説明します。

注記

ceph fs subvolume resize コマンドは、new_size で指定されたサイズでサブボリュームのクォータのサイズを変更します。--no_shrink フラグは、サブボリュームが現在使用されているサブボリュームのサイズを下回って縮小するのを防ぎます。サブボリュームは、f または infinite を new_size として渡すと、無限にリサイズできます。

前提条件

  • Ceph File System がデプロイされている稼働中の Red Hat Ceph Storage クラスター。
  • Ceph Monitor での少なくとも読み取りアクセス。
  • Ceph Manager ノードの読み取りおよび書き込み機能。
  • CephFS サブボリューム。

手順

  • CephFS サブボリュームのサイズを変更します。

    構文

    ceph fs subvolume resize VOLUME_NAME SUBVOLUME_NAME NEW_SIZE [--group_name SUBVOLUME_GROUP_NAME] [--no_shrink]
    Copy to Clipboard Toggle word wrap

    例

    [root@mon ~]# ceph fs subvolume resize cephfs sub0 1024000000 --group_name subgroup0 --no_shrink
    Copy to Clipboard Toggle word wrap

4.3.4. ファイルシステムのサブボリュームの絶対パスを取得中
リンクのコピー

このセクションでは、Ceph File System (CephFS) サブボリュームの絶対パスを取得する方法を説明します。

前提条件

  • Ceph File System がデプロイされている稼働中の Red Hat Ceph Storage クラスター。
  • Ceph Monitor での少なくとも読み取りアクセス。
  • Ceph Manager ノードの読み取りおよび書き込み機能。
  • CephFS サブボリューム。

手順

  • CephFS サブボリュームの絶対パスを取得します。

    構文

    ceph fs subvolume getpath VOLUME_NAME SUBVOLUME_NAME [--group_name _SUBVOLUME_GROUP_NAME]
    Copy to Clipboard Toggle word wrap

    例

    [root@mon ~]# ceph fs subvolume getpath cephfs sub0 --group_name subgroup0
    Copy to Clipboard Toggle word wrap

4.3.5. ファイルシステムのサブボリュームのメタデータの取得
リンクのコピー

このセクションでは、Ceph File System (CephFS) サブボリュームのメタデータを取得する方法について説明します。

前提条件

  • Ceph File System がデプロイされている稼働中の Red Hat Ceph Storage クラスター。
  • Ceph Monitor での少なくとも読み取りアクセス。
  • Ceph Manager ノードの読み取りおよび書き込み機能。
  • CephFS サブボリューム。

手順

  • CephFS サブボリュームのメタデータを取得します。

    構文

    ceph fs subvolume info VOLUME_NAME SUBVOLUME_NAME [--group_name SUBVOLUME_GROUP_NAME]
    Copy to Clipboard Toggle word wrap

    例

    [root@mon ~]# ceph fs subvolume info cephfs sub0 --group_name subgroup0
    Copy to Clipboard Toggle word wrap

    出力例

    # ceph fs subvolume info cephfs sub0
{
    "atime": "2023-07-14 08:52:46",
    "bytes_pcent": "0.00",
    "bytes_quota": 1024000000,
    "bytes_used": 0,
    "created_at": "2023-07-14 08:52:46",
    "ctime": "2023-07-14 08:53:54",
    "data_pool": "cephfs.cephfs.data",
    "features": [
        "snapshot-clone",
        "snapshot-autoprotect",
        "snapshot-retention"
    ],
    "flavor": "2",
    "gid": 0,
    "mode": 16877,
    "mon_addrs": [
        "10.0.208.172:6789",
        "10.0.211.197:6789",
        "10.0.209.212:6789"
    ],
    "mtime": "2023-07-14 08:52:46",
    "path": "/volumes/_nogroup/sub0/834c5cbc-f5db-4481-80a3-aca92ff0e7f3",
    "pool_namespace": "",
    "state": "complete",
    "type": "subvolume",
    "uid": 0
}
    Copy to Clipboard Toggle word wrap

出力形式は JSON で、以下のフィールドが含まれます。

  • atime: "YYYY-MM-DD HH:MM:SS" 形式のサブボリュームパスのアクセス時間。
  • bytes_pcent: クォータが設定されている場合に使用するクォータ。それ以外の場合は "undefined" を表示します。
  • bytes_quota: クォータが設定されている場合のクォータサイズ (バイト単位)。それ以外の場合は "infinite" を表示します。
  • bytes_used: サブボリュームの現在の使用サイズ (バイト単位)。
  • created_at: サブボリュームを作成する時間 ("YYYY-MM-DD HH:MM:SS" 形式)。
  • ctime: サブボリュームの時間を "YYYY-MM-DD HH:MM:SS" 形式で変更します。
  • data_pool: サブボリュームが属するデータプール。
  • features: snapshot-clone"、"snapshot-autoprotect"、"snapshot-retention" などのサブボリュームでサポートされる機能。
  • flavor: サブボリュームのバージョン。バージョン 1 の場合は 1、バージョン 2 の場合は 2 です。
  • gid: サブボリュームパスのグループ ID。
  • モード: サブボリュームパスのモード。
  • mon_addrs: モニターアドレスのリスト。
  • mtime: サブボリュームパスの変更時間 ("YYYY-MM-DD HH:MM:SS" 形式)。
  • path: サブボリュームの絶対パス。
  • pool_namespace: サブボリュームの RADOS 名前空間。
  • state: サブボリュームの現在の状態 (例: "complete" または "snapshot-retained"d)
  • type: クローンかサブボリュームかを示すサブボリュームタイプ。
  • uid : サブボリュームパスのユーザー ID。

4.3.6. ファイルシステムのサブボリュームのスナップショットの作成
リンクのコピー

このセクションでは、Ceph File System (CephFS) サブボリュームのスナップショットを作成する方法を説明します。

前提条件

  • Ceph File System がデプロイされている稼働中の Red Hat Ceph Storage クラスター。
  • Ceph Monitor での少なくとも読み取りアクセス。
  • Ceph Manager ノードの読み取りおよび書き込み機能。
  • CephFS サブボリューム。
  • クライアントの読み取り (r) および書き込み (w) 機能のほかに、クライアントはファイルシステム内のディレクトリーパスに s フラグも必要になります。

手順

  1. s フラグがディレクトリーに設定されていることを確認します。

    構文

    ceph auth get CLIENT_NAME
    Copy to Clipboard Toggle word wrap

    例

    [root@mon ~]# ceph auth get client.0
[client.0]
    key = AQAz7EVWygILFRAAdIcuJ12opU/JKyfFmxhuaw==
    caps mds = "allow rw, allow rws path=/bar"
    1 
    
    caps mon = "allow r"
    caps osd = "allow rw tag cephfs data=cephfs_a"
    2
    Copy to Clipboard Toggle word wrap

    1 2
    この例では、client.0 はファイルシステムの cephfs_a の bar ディレクトリーにスナップショットを作成または削除することができます。

  2. Ceph File System サブボリュームのスナップショットを作成します。

    構文

    ceph fs subvolume snapshot create VOLUME_NAME SUBVOLUME_NAME SNAP_NAME [--group_name GROUP_NAME]
    Copy to Clipboard Toggle word wrap

    例

    [root@mon ~]# ceph fs subvolume snapshot create cephfs sub0 snap0 --group_name subgroup0
    Copy to Clipboard Toggle word wrap

4.3.7. スナップショットからのサブボリュームのクローン作成
リンクのコピー

サブボリュームスナップショットのクローン作成により、サブボリュームを作成できます。これは、スナップショットからサブボリュームにデータをコピーする非同期操作です。

注記

非常に大規模なデータセットの場合、クローン作成は非効率的です。

前提条件

  • Ceph File System がデプロイされている稼働中の Red Hat Ceph Storage クラスター。
  • Ceph Monitor での少なくとも読み取りアクセス。
  • Ceph Manager ノードの読み取りおよび書き込み機能。

  • スナップショットの作成や書き込み機能の削除に加えて、クライアントはファイルシステム内のディレクトリーパスに s フラグが必要です。

    構文

    CLIENT_NAME
    key = AQAz7EVWygILFRAAdIcuJ12opU/JKyfFmxhuaw==
    caps mds = allow rw, allow rws path=DIRECTORY_PATH
    caps mon = allow r
    caps osd = allow rw tag cephfs data=DIRECTORY_NAME
    Copy to Clipboard Toggle word wrap

    以下の例では、client.0 はファイルシステム cephfs_a の bar ディレクトリーにスナップショットを作成または削除することができます。

    例

    [client.0]
    key = AQAz7EVWygILFRAAdIcuJ12opU/JKyfFmxhuaw==
    caps mds = "allow rw, allow rws path=/bar"
    caps mon = "allow r"
    caps osd = "allow rw tag cephfs data=cephfs_a"
    Copy to Clipboard Toggle word wrap

手順

  1. Ceph File System (CephFS) ボリュームを作成します。

    構文

    ceph fs volume create VOLUME_NAME
    Copy to Clipboard Toggle word wrap

    例

    [root@mon ~]# ceph fs volume create cephfs
    Copy to Clipboard Toggle word wrap

    これにより、CephFS ファイルシステム、そのデータおよびメタデータプールが作成されます。

  2. サブボリュームグループを作成します。デフォルトでは、サブボリュームグループは、モード '755' および、親ディレクトリーのデータプールレイアウトで作成されます。

    構文

    ceph fs subvolumegroup create VOLUME_NAME GROUP_NAME [--pool_layout DATA_POOL_NAME --uid UID --gid GID --mode OCTAL_MODE]
    Copy to Clipboard Toggle word wrap

    例

    [root@mon ~]# ceph fs subvolumegroup create cephfs subgroup0
    Copy to Clipboard Toggle word wrap

  3. サブボリュームを作成します。デフォルトでは、サブボリュームはデフォルトの subvolume グループ内に作成され、サブボリュームグループの 8 進数ファイルモード '755'、サブボリュームグループの gid、親ディレクトリーのデータプールレイアウトとサイズ制限がありません。

    構文

    ceph fs subvolume create VOLUME_NAME SUBVOLUME_NAME [--size SIZE_IN_BYTES --group_name SUBVOLUME_GROUP_NAME --pool_layout DATA_POOL_NAME --uid _UID --gid GID --mode OCTAL_MODE]
    Copy to Clipboard Toggle word wrap

    例

    [root@mon ~]# ceph fs subvolume create cephfs sub0 --group_name subgroup0
    Copy to Clipboard Toggle word wrap

  4. サブボリュームのスナップショットを作成します。

    構文

    ceph fs subvolume snapshot create VOLUME_NAME _SUBVOLUME_NAME SNAP_NAME [--group_name SUBVOLUME_GROUP_NAME]
    Copy to Clipboard Toggle word wrap

    例

    [root@mon ~]# ceph fs subvolume snapshot create cephfs sub0 snap0  --group_name subgroup0
    Copy to Clipboard Toggle word wrap

  5. クローン操作を開始します。

    注記

    デフォルトでは、クローン作成されたサブボリュームがデフォルトのグループに作成されます。

    1. ソースサブボリュームとターゲットのクローンがデフォルトのグループにある場合は、以下のコマンドを実行します。

      構文

      ceph fs subvolume snapshot clone VOLUME_NAME SUBVOLUME_NAME SNAP_NAME TARGET_CLONE_NAME
      Copy to Clipboard Toggle word wrap

      例

      [root@mon ~]# ceph fs subvolume snapshot clone cephfs sub0 snap0 clone0
      Copy to Clipboard Toggle word wrap

    2. ソースサブボリュームがデフォルト以外のグループにある場合は、以下のコマンドでソース subvolume グループを指定します。

      構文

      ceph fs subvolume snapshot clone VOLUME_NAME SUBVOLUME_NAME SNAP_NAME TARGET_CLONE_NAME --group_name SUBVOLUME_GROUP_NAME
      Copy to Clipboard Toggle word wrap

      例

      [root@mon ~]# ceph fs subvolume snapshot clone cephfs sub0 snap0 clone0 --group_name subgroup0
      Copy to Clipboard Toggle word wrap

    3. ターゲットのクローンがデフォルト以外のグループにある場合は、以下のコマンドでターゲットグループを指定します。

      構文

      ceph fs subvolume snapshot clone VOLUME_NAME SUBVOLUME_NAME SNAP_NAME TARGET_CLONE_NAME --target_group_name SUBVOLUME_GROUP_NAME
      Copy to Clipboard Toggle word wrap

      例

      [root@mon ~]# ceph fs subvolume snapshot clone cephfs sub0 snap0 clone0 --target_group_name subgroup1
      Copy to Clipboard Toggle word wrap

  6. clone 操作のステータスを確認します。

    構文

    ceph fs clone status VOLUME_NAME CLONE_NAME [--group_name TARGET_GROUP_NAME]
    Copy to Clipboard Toggle word wrap

    例

    [root@mon ~]# ceph fs clone status cephfs clone0 --group_name subgroup1

{
  "status": {
    "state": "complete"
  }
}
    Copy to Clipboard Toggle word wrap

関連情報

4.3.8. ファイルシステムのサブボリュームのスナップショットのリスト表示
リンクのコピー

このセクションでは、Ceph File システム (CephFS) サブボリュームのスナップショットをリスト表示する手順について説明します。

前提条件

  • Ceph File System がデプロイされている稼働中の Red Hat Ceph Storage クラスター。
  • Ceph Monitor での少なくとも読み取りアクセス。
  • Ceph Manager ノードの読み取りおよび書き込み機能。
  • CephFS サブボリューム。
  • サブボリュームのスナップショット。

手順

  • CephFS サブボリュームのスナップショットをリスト表示します。

    構文

    ceph fs subvolume snapshot ls VOLUME_NAME SUBVOLUME_NAME [--group_name SUBVOLUME_GROUP_NAME]
    Copy to Clipboard Toggle word wrap

    例

    [root@mon ~]# ceph fs subvolume snapshot ls cephfs sub0 --group_name subgroup0
    Copy to Clipboard Toggle word wrap

4.3.9. ファイルシステムサブボリュームのスナップショットのメタデータの取得。
リンクのコピー

このセクションでは、Ceph File System (CephFS) サブボリュームのスナップショットのメタデータを取得する手順について説明します。

前提条件

  • CephFS がデプロイされている稼働中の Red Hat Ceph Storage クラスター。
  • Ceph Monitor での少なくとも読み取りアクセス。
  • Ceph Manager ノードの読み取りおよび書き込み機能。
  • CephFS サブボリューム。
  • サブボリュームのスナップショット。

手順

  1. CephFS サブボリュームのスナップショットのメタデータを取得します。

    構文

    ceph fs subvolume snapshot info VOLUME_NAME SUBVOLUME_NAME SNAP_NAME [--group_name SUBVOLUME_GROUP_NAME]
    Copy to Clipboard Toggle word wrap

    例

    [root@mon ~]# ceph fs subvolume snapshot info cephfs sub0 snap0 --group_name subgroup0
    Copy to Clipboard Toggle word wrap

    出力例

    {
    "created_at": "2022-05-09 06:18:47.330682",
    "data_pool": "cephfs_data",
    "has_pending_clones": "no",
    "size": 0
}
    Copy to Clipboard Toggle word wrap

出力形式は JSON で、以下のフィールドが含まれます。

  • created_at: スナップショットの作成時間 ("YYYY-MM-DD HH:MM:SS:ffffff" 形式)。
  • data_pool: スナップショットが属するデータプール。
  • has_pending_clones: スナップショットの選択が進行中の場合は "yes" そうでなければ "no"。
  • サイズ: スナップショットサイズ (バイト単位)。

4.3.10. ファイルシステムのサブボリュームの削除
リンクのコピー

このセクションでは、Ceph File System (CephFS) サブボリュームを削除する方法を説明します。

注記

ceph fs subvolume rm コマンドは、2 つのステップでサブボリュームとその内容を削除します。まず、サブボリュームをゴミ箱フォルダーに移動し、そのコンテンツを非同期的にパージします。

サブボリュームは、--retain-snapshots オプションを使用してサブボリュームの既存のスナップショットを保持できます。スナップショットが保持されると、そのサブボリュームは、保持済みスナップショットが関係するすべての操作に対して空であると見なされます。保持されるスナップショットは、サブボリュームを再作成するクローンソースとして使用するか、新しいサブボリュームにクローンを作成します。

前提条件

  • Ceph File System がデプロイされている稼働中の Red Hat Ceph Storage クラスター。
  • Ceph Monitor での少なくとも読み取りアクセス。
  • Ceph Manager ノードの読み取りおよび書き込み機能。
  • CephFS サブボリューム。

手順

  1. CephFS サブボリュームを削除します。

    構文

    ceph fs subvolume rm VOLUME_NAME SUBVOLUME_NAME [--group_name SUBVOLUME_GROUP_NAME] [--force] [--retain-snapshots]
    Copy to Clipboard Toggle word wrap

    例

    [root@mon ~]# ceph fs subvolume rm cephfs sub0 --group_name subgroup0 --retain-snapshots
    Copy to Clipboard Toggle word wrap

  2. 保持されるスナップショットからサブボリュームを再作成するには、以下を実行します。

    構文

    ceph fs subvolume snapshot clone VOLUME_NAME DELETED_SUBVOLUME RETAINED_SNAPSHOT NEW_SUBVOLUME --group_name SUBVOLUME_GROUP_NAME --target_group_name SUBVOLUME_TARGET_GROUP_NAME
    Copy to Clipboard Toggle word wrap

    • NEW_SUBVOLUMEは、以前に削除された同じサブボリュームにするか、新しいサブボリュームにクローンを作成します。

    例

    [root@mon ~]# ceph fs subvolume snapshot clone cephfs sub0 snap0 sub1 --group_name subgroup0 --target_group_name subgroup0
    Copy to Clipboard Toggle word wrap

4.3.11. ファイルシステムのサブボリュームのスナップショットの削除
リンクのコピー

このセクションでは、Ceph File System (CephFS) サブボリュームグループのスナップショットを削除する手順について説明します。

注記

--force フラグを使用すると、コマンドを正常に実行でき、スナップショットが存在しない場合には失敗します。

前提条件

  • Ceph File System がデプロイされている稼働中の Red Hat Ceph Storage クラスター。
  • Ceph Monitor での少なくとも読み取りアクセス。
  • Ceph Manager ノードの読み取りおよび書き込み機能。
  • Ceph File System ボリューム。
  • サブボリュームグループのスナップショット。

手順

  • CephFS サブボリュームのスナップショットを削除します。

    構文

    ceph fs subvolume snapshot rm VOLUME_NAME SUBVOLUME_NAME SNAP_NAME [--group_name GROUP_NAME --force]
    Copy to Clipboard Toggle word wrap

    例

    [root@mon ~]# ceph fs subvolume snapshot rm cephfs sub0 snap0 --group_name subgroup0 --force
    Copy to Clipboard Toggle word wrap

4.4. Ceph File System サブボリュームのメタデータ情報
リンクのコピー

ストレージ管理者は、Ceph File System (CephFS) サブボリュームのメタデータ情報を設定、取得、一覧表示、および削除できます。

カスタムメタデータは、ユーザーがメタデータをサブボリュームに保存するためのものです。ユーザーは xattr と同様のキーと値のペアを Ceph ファイルシステムに保存できます。

このセクションでは、以下を行う方法を説明します。

4.4.1. ファイルシステムサブボリュームでのカスタムメタデータの設定
リンクのコピー

ファイルシステムサブボリュームにカスタムメタデータをキーと値のペアとして設定できます。

注記

key_name がすでに存在する場合、古い値は新しい値に置き換えられます。

注記

KEY_NAME と VALUE は、python の string.printable で指定されている ASCII 文字の文字列である必要があります。KEY_NAME は大文字と小文字が区別されず、常に小文字で保存されます。

重要

サブボリュームのカスタムメタデータは、サブボリュームのスナップショット作成時に保持されないため、サブボリュームスナップショットのクローン作成時にも保持されません。

前提条件

  • 稼働中の Red Hat Ceph Storage クラスターがある。
  • Ceph ファイルシステム (CephFS)、CephFS ボリューム、サブボリュームグループ、およびサブボリュームが作成されました。

手順

  1. CephFS サブボリュームにメタデータを設定します。

    構文

    ceph fs subvolume metadata set VOLUME_NAME SUBVOLUME_NAME KEY_NAME VALUE [--group_name SUBVOLUME_GROUP_NAME]
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph fs subvolume metadata set cephfs sub0 test_meta cluster --group_name subgroup0
    Copy to Clipboard Toggle word wrap

  2. オプション: KEY_NAME にスペースを含むカスタムメタデータを設定します。

    例

    [ceph: root@host01 /]# ceph fs subvolume metadata set cephfs sub0 "test meta" cluster --group_name subgroup0
    Copy to Clipboard Toggle word wrap

    これにより、KEY_NAME を持つ別のメタデータが VALUE cluster の test meta として作成されます。

  3. オプション: 同じメタデータに別の値を設定することもできます。

    例

    [ceph: root@host01 /]# ceph fs subvolume metadata set cephfs sub0 "test_meta" cluster2 --group_name subgroup0
    Copy to Clipboard Toggle word wrap

4.4.2. ファイルシステムサブボリュームでのカスタムメタデータの取得
リンクのコピー

ボリューム内、およびオプションで特定のサブボリュームグループ内の Ceph ファイルシステム (CephFS) のカスタムメタデータ (キーと値のペア) を取得できます。

前提条件

  • 稼働中の Red Hat Ceph Storage クラスターがある。
  • CephFS ボリューム、サブボリュームグループ、およびサブボリュームが作成されました。
  • CephFS サブボリュームで作成されたカスタムメタデータ。

手順

  • CephFS サブボリュームのメタデータを取得します。

    構文

    ceph fs subvolume metadata get VOLUME_NAME SUBVOLUME_NAME KEY_NAME [--group_name SUBVOLUME_GROUP_NAME]
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph fs subvolume metadata get cephfs sub0 test_meta --group_name subgroup0

cluster
    Copy to Clipboard Toggle word wrap

4.4.3. ファイルシステムサブボリュームでのカスタムメタデータの一覧表示
リンクのコピー

ボリューム内の Ceph ファイルシステム (CephFS) のキーに関連付けられたカスタムメタデータを一覧表示し、オプションで特定のサブボリュームグループ内に一覧表示することもできます。

前提条件

  • 稼働中の Red Hat Ceph Storage クラスターがある。
  • CephFS ボリューム、サブボリュームグループ、およびサブボリュームが作成されました。
  • CephFS サブボリュームで作成されたカスタムメタデータ。

手順

  • CephFS サブボリュームのメタデータを一覧表示します。

    構文

    ceph fs subvolume metadata ls VOLUME_NAME SUBVOLUME_NAME [--group_name SUBVOLUME_GROUP_NAME]
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph fs subvolume metadata ls cephfs sub0
{
    "test_meta": "cluster"
}
    Copy to Clipboard Toggle word wrap

4.4.4. ファイルシステムサブボリュームからのカスタムメタデータの削除
リンクのコピー

ボリューム内、およびオプションで特定のサブボリュームグループ内の Ceph ファイルシステム (CephFS) のカスタムメタデータ (キーと値のペア) を削除できます。

前提条件

  • 稼働中の Red Hat Ceph Storage クラスターがある。
  • CephFS ボリューム、サブボリュームグループ、およびサブボリュームが作成されました。
  • CephFS サブボリュームで作成されたカスタムメタデータ。

手順

  1. CephFS サブボリュームのカスタムメタデータを削除します。

    構文

    ceph fs subvolume metadata rm VOLUME_NAME SUBVOLUME_NAME KEY_NAME [--group_name SUBVOLUME_GROUP_NAME]
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph fs subvolume metadata rm cephfs sub0 test_meta --group_name subgroup0
    Copy to Clipboard Toggle word wrap

  2. メタデータを一覧表示します。

    例

    [ceph: root@host01 /]# ceph fs subvolume metadata ls cephfs sub0

{}
    Copy to Clipboard Toggle word wrap

第5章 Ceph File System 管理
リンクのコピー

ストレージ管理者は、以下のような共通の Ceph File System (CephFS) の管理タスクを実行することができます。

前提条件

  • 実行中、および正常な Red Hat Ceph Storage クラスター
  • Ceph Metadata Server デーモン (ceph-mds) のインストールおよび設定
  • Ceph ファイルシステムを作成してマウントします。

5.1. cephfs-top ユーティリティーの使用
リンクのコピー

Ceph File System (CephFS) は、リアルタイムに Ceph File Systems でメトリックを表示する top のようなユーティリティーを提供します。cephfs-top ユーティリティーは、Ceph Manager の stats モジュールを使用してクライアントパフォーマンスメトリックを取得して表示する curses ベースの Python スクリプトです。

現在、cephfs-top ユーティリティーは約 10,000 のクライアントをサポートしています。

注記

現在、Red Hat Enterprise Linux 9.2 カーネルで、パフォーマンス統計がすべて利用できるわけではありません。cephfs-top は Red Hat Enterprise Linux 9 以降でサポートされており、Red Hat Enterprise Linux の標準ターミナルの 1 つを使用します。

重要

cephfs-top ユーティリティーと互換性のある Python の最小バージョンは 3.6.0 です。

前提条件

  • 正常かつ稼働中の Red Hat Ceph Storage クラスター
  • Ceph File System のデプロイメント
  • Ceph クライアントノードへのルートレベルのアクセスがある。
  • cephfs-top パッケージのインストール

手順

  1. Red Hat Ceph Storage 7 ツールリポジトリーがまだ有効になっていない場合は、有効にします。

    Red Hat Enterprise Linux 9

    [root@client ~]# subscription-manager repos --enable=rhceph-7-tools-for-rhel-9-x86_64-rpms
    Copy to Clipboard Toggle word wrap

  2. cephfs-top パッケージをインストールします。

    例

    [root@client ~]# dnf install cephfs-top
    Copy to Clipboard Toggle word wrap

  3. Ceph Manager stats プラグインを有効にします。

    例

    [root@client ~]# ceph mgr module enable stats
    Copy to Clipboard Toggle word wrap

  4. Ceph ユーザー client.fstop を作成します。

    例

    [root@client ~]# ceph auth get-or-create client.fstop mon 'allow r' mds 'allow r' osd 'allow r' mgr 'allow r' > /etc/ceph/ceph.client.fstop.keyring
    Copy to Clipboard Toggle word wrap

    注記

    必要に応じて、--id 引数を使用して、client.fstop 以外の別の Ceph ユーザーを指定します。

  5. cephfs-top ユーティリティーを起動します。

    例

    [root@client ~]# cephfs-top
cephfs-top - Wed Nov 30 15:26:05 2022

All Filesystem Info
Total Client(s): 4 - 3 FUSE, 1 kclient, 0 libcephfs
COMMANDS: m - select a filesystem | s - sort menu | l - limit number of clients | r - reset to default | q - quit

  client_id mount_root chit(%) dlease(%) ofiles oicaps oinodes rtio(MB) raio(MB) rsp(MB/s) wtio(MB) waio(MB) wsp(MB/s) rlatavg(ms) rlatsd(ms) wlatavg(ms) wlatsd(ms) mlatavg(ms) mlatsd(ms) mount_point@host/addr

Filesystem: cephfs1 - 2 client(s)


  4500     /          100.0   100.0	     0	    751    0       0.0	    0.0	     0.0	   578.13   0.03     0.0       N/A         N/A        N/A         N/A       N/A        N/A       N/A@example/192.168.1.4
  4501     /          100.0   0.0      0	    1    0       0.0	    0.0	     0.0	   0.0   0.0     0.0       0.0         0.0        0.0         0.0        0.41        0.0       /mnt/cephfs2@example/192.168.1.4

Filesystem: cephfs2 - 2 client(s)


  4512     /          100.0   0.0	     0	    1      0       0.0	    0.0	     0.0	   0.0      0.0      0.0       0.0         0.0        0.0         0.0        0.4        0.0        /mnt/cephfs3@example/192.168.1.4
  4518     /          100.0   0.0	     0	    1      0       0.0	    0.0	     0.0	   0.0      0.0      0.0       0.0         0.0        0.0         0.0        0.52        0.0        /mnt/cephfs4@example/192.168.1.4
    Copy to Clipboard Toggle word wrap

5.1.1. cephfs-top ユーティリティーの対話型コマンド
リンクのコピー

特定のファイルシステムを選択し、cephfs-top ユーティリティーの対話型コマンドを使用して、そのファイルシステムに関連するメトリックを表示します。

m
説明
ファイルシステムの選択: 選択するファイルシステムのメニューを表示します。
q
説明
終了: すべてのファイルシステム情報が表示されたホーム画面にいる場合は、ユーティリティーを終了します。ホーム画面にいない場合は、ホーム画面にリダイレクトされます。
s
説明
ソートフィールドの選択: ソートフィールドを指定します。‘cap_hit’ がデフォルトです。
l
説明
クライアントの制限: 表示するクライアント数の制限を設定します。
r
説明
リセット: ソートフィールドと制限値をデフォルトにリセットします。

メトリクス表示は、矢印キー、PgUp/PgDn、Home/End、およびマウスを使用してスクロールできます。

ファイルシステム選択メニューの開始と終了の例

[root@client ~]# m

                       Filesystems
Press "q" to go back to home (all filesystem info) screen



                        cephfs01
                        cephfs02
[root@client ~]# q

cephfs-top - Thu Oct 20 07:29:35 2022
Total Client(s): 3 - 2 FUSE, 1 kclient, 0 libcephfs
Copy to Clipboard Toggle word wrap

5.1.2. cephfs-top ユーティリティーのオプション
リンクのコピー

cephfs-top ユーティリティーコマンドをさまざまなオプションとともに使用できます。

例

[root@client ~]# cephfs-top --selftest
selftest ok
Copy to Clipboard Toggle word wrap

--cluster NAME_OF_THE_CLUSTER
説明
このオプションを使用すると、デフォルト以外のクラスター名に接続できます。デフォルト名は ceph です。
--id user
説明
これは、Ceph クラスターに接続するクライアントであり、デフォルトでは fstop です。
--selftest
説明
このオプションを使用すると、セルフテストを実行できます。このモードは、stats モジュールの健全性チェックを実行します。
--conffile PATH_TO_THE_CONFIGURATION_FILE
説明
このオプションを使用すると、Ceph クラスター設定ファイルへのパスを指定できます。
-d/--delay INTERVAL_IN_SECONDS
説明

cephfs-top ユーティリティーは、デフォルトで統計を毎秒更新します。このオプションを使用すると、更新間隔を変更できます。

注記

間隔は 1 秒以上にする必要があります。小数秒は尊重されます。

--dump
説明
このオプションを使用すると、curses 表示を作成せずにメトリクスを標準出力にダンプできます。
--dumpfs FILE_SYSTEM_NAME
説明
このオプションを使用すると、curses 表示を作成せずに、指定されたファイルシステムのメトリクスを標準出力にダンプできます。

5.2. MDS Autoscaler モジュールの使用
リンクのコピー

MDS Autoscaler モジュールは、Ceph File System (CephFS) を監視し、十分な MDS デーモンが利用可能であることを確認します。MDS サービスの Orchestrator バックエンドの配置仕様を調整することで機能します。

モジュールは、以下のファイルシステム設定をモニタリングして、配置数の調整を通知します。

  • max_mds ファイルシステムの設定
  • standby_count_wanted ファイルシステムの設定

Ceph monitor デーモンは、これらの設定に応じて MDS をプロモートまたは停止します。mds_autoscaler は、オーケストレーターによって起動する MDS の数を調整します。

前提条件

  • 正常かつ稼働中の Red Hat Ceph Storage クラスター
  • Ceph File System のデプロイメント
  • Ceph Monitor ノードへの root レベルのアクセス。

手順

  • MDS Autoscaler モジュールを有効にします。

    例

    [ceph: root@host01 /]# ceph mgr module enable mds_autoscaler
    Copy to Clipboard Toggle word wrap

5.3. カーネルクライアントとしてマウントされた Ceph File Systems のアンマウント
リンクのコピー

カーネルクライアントとしてマウントされている Ceph File System をアンマウントする方法。

前提条件

  • マウントを実行するノードへの Root レベルのアクセス。

手順

  • カーネルクライアントとしてマウントされている Ceph File System をアンマウントするには、以下を実行します。

    構文

    umount MOUNT_POINT
    Copy to Clipboard Toggle word wrap

    例

    [root@client ~]# umount /mnt/cephfs
    Copy to Clipboard Toggle word wrap

関連情報

  • umount(8) man ページ

5.4. FUSE クライアントとしてマウントされている Ceph File Systems のアンマウント
リンクのコピー

File System in User Space (FUSE) クライアントとしてマウントされている Ceph File System のアンマウント。

前提条件

  • FUSE クライアントノードへのルートレベルのアクセス。

手順

  • FUSE にマウントされた Ceph File System をアンマウントするには、以下を実行します。

    構文

    fusermount -u MOUNT_POINT
    Copy to Clipboard Toggle word wrap

    例

    [root@client ~]# fusermount -u /mnt/cephfs
    Copy to Clipboard Toggle word wrap

関連情報

  • ceph-fuse(8) man ページ

5.5. ディレクトリーツリーから Metadata Server デーモンのランクへのマッピング
リンクのコピー

ディレクトリーとそのサブディレクトリーを特定のアクティブな Metadata Server (MDS) ランクにマッピングするには、そのメタデータがランクを保持する MDS デーモンによってのみ管理されるようにします。このアプローチにより、アプリケーションの負荷や、ユーザーのメタデータ要求の影響をストレージクラスター全体に均等に分散させることができます。

重要

内部バランサーは、すでにアプリケーションの負荷を動的に分散します。そのため、特定の慎重に選択したアプリケーションに対して、ディレクトリーツリーのみをマップします。

さらに、ディレクトリーがランクにマップされると、バランサーはこれを分割できません。そのため、マップされたディレクトリー内の多数の操作を行うと、ランクおよびそれを管理する MDS デーモンをオーバーロードできます。

前提条件

  • 少なくとも 2 つのアクティブな MDS デーモン。
  • CephFS クライアントノードへのユーザーアクセス
  • マウントされた Ceph File System を含む CephFS クライアントノードに attr パッケージがインストールされていることを確認します。

手順

  1. Ceph ユーザーのケイパビリティーに p フラグを追加します。

    構文

    ceph fs authorize FILE_SYSTEM_NAME client.CLIENT_NAME /DIRECTORY CAPABILITY [/DIRECTORY CAPABILITY] ...
    Copy to Clipboard Toggle word wrap

    例

    [user@client ~]$ ceph fs authorize cephfs_a client.1 /temp rwp

client.1
  key: AQBSdFhcGZFUDRAAcKhG9Cl2HPiDMMRv4DC43A==
  caps: [mds] allow r, allow rwp path=/temp
  caps: [mon] allow r
  caps: [osd] allow rw tag cephfs data=cephfs_a
    Copy to Clipboard Toggle word wrap

  2. ディレクトリーに ceph.dir.pin 拡張属性を設定します。

    構文

    setfattr -n ceph.dir.pin -v RANK DIRECTORY
    Copy to Clipboard Toggle word wrap

    例

    [user@client ~]$ setfattr -n ceph.dir.pin -v 2 /temp
    Copy to Clipboard Toggle word wrap

    この例では、/temp ディレクトリーとそのすべてのサブディレクトリーを rank 2 に割り当てます。

関連情報

5.6. Metadata Server デーモンのランクからディレクトリーツリーの解除
リンクのコピー

特定のアクティブなメタデータサーバー (MDS) ランクからディレクトリーの関連付けを解除します。

前提条件

  • Ceph File System (CephFS) クライアントノードへのユーザーアクセス
  • マウントされた CephFS を持つクライアントノードに attr パッケージがインストールされていることを確認します。

手順

  • ディレクトリーの ceph.dir.pin 拡張属性を -1 に設定します。

    構文

    setfattr -n ceph.dir.pin -v -1 DIRECTORY
    Copy to Clipboard Toggle word wrap

    例

    [user@client ~]$ setfattr -n ceph.dir.pin -v -1 /home/ceph-user
    Copy to Clipboard Toggle word wrap

    注記

    /home/ceph-user/ の個別にマッピングされたサブディレクトリーは影響を受けません。

関連情報

5.7. データプールの追加
リンクのコピー

Ceph File System (CephFS) では、データの保存に使用する複数のプールの追加をサポートします。これは以下に役立ちます。

  • ログデータの冗長性プールの削減。
  • SSD または NVMe プールへのユーザーのホームディレクトリーの保存。
  • 基本的なデータ分離。

Ceph File System で別のデータプールを使用する前に、このセクションで説明されているように追加する必要があります。

デフォルトでは、ファイルデータを保存するために、CephFS は作成中に指定された初期データプールを使用します。セカンダリーデータプールを使用するには、ファイルシステム階層の一部を設定して、そのプールにファイルデータを保存するか、必要に応じてそのプールの名前空間内にファイルデータを保存し、ファイルおよびディレクトリーのレイアウトを使用します。

前提条件

  • Ceph Monitor ノードへの root レベルのアクセス。

手順

  1. 新しいデータプールを作成します。

    構文

    ceph osd pool create POOL_NAME
    Copy to Clipboard Toggle word wrap

    以下を置き換えます。

    • POOL_NAME は、プールの名前に置き換えます。

    例

    [ceph: root@host01 /]# ceph osd pool create cephfs_data_ssd

pool 'cephfs_data_ssd' created
    Copy to Clipboard Toggle word wrap

  2. メタデータサーバーの制御の下に、新たに作成されたプールを追加します。

    構文

    ceph fs add_data_pool FS_NAME POOL_NAME
    Copy to Clipboard Toggle word wrap

    以下を置き換えます。

    • FS_NAME は、ファイルシステムの名前に置き換えます。
    • POOL_NAME は、プールの名前に置き換えます。

    たとえば、以下のようになります。

    [ceph: root@host01 /]# ceph fs add_data_pool cephfs cephfs_data_ssd

added data pool 6 to fsmap
    Copy to Clipboard Toggle word wrap

  3. プールが正常に追加されたことを確認します。

    例

    [ceph: root@host01 /]# ceph fs ls

name: cephfs, metadata pool: cephfs_metadata, data pools: [cephfs_data cephfs_data_ssd]
    Copy to Clipboard Toggle word wrap

  4. オプション: ファイルシステムからデータプールを削除します。

    構文

    ceph fs rm_data_pool FS_NAME POOL_NAME
    Copy to Clipboard Toggle word wrap

    たとえば、以下のようになります。

    [ceph: root@host01 /]# ceph fs rm_data_pool cephfs cephfs_data_ssd

removed data pool 6 from fsmap
    Copy to Clipboard Toggle word wrap

    1. プールが正常に削除されたことを確認します。

      例

      [ceph: root@host01 /]# ceph fs ls

name: cephfs, metadata pool: cephfs_metadata, data pools: [cephfs.cephfs.data]
      Copy to Clipboard Toggle word wrap

  5. cephx 認証を使用する場合は、クライアントが新しいプールにアクセスできることを確認してください。

関連情報

5.8. Ceph File System クラスターの停止
リンクのコピー

down フラグを true に設定すると、Ceph File System (CephFS) クラスターを停止することができます。これにより、ジャーナルをメタデータプールにフラッシュして Metadata Server (MDS) デーモンを正常にシャットダウンし、すべてのクライアント I/O が停止します。

また、CephFS クラスターを迅速に停止してファイルシステムの削除をテストし、メタデータサーバー (MDS) デーモン (障害復旧シナリオなど) を停止することもできます。これにより、MDS のスタンバイデーモンがファイルシステムをアクティベートしないように jointable フラグが設定されます。

前提条件

  • Ceph Monitor ノードへの root レベルのアクセス。

手順

  1. CephFS クラスターが停止しているには、以下を実行します。

    構文

    ceph fs set FS_NAME down true
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph fs set cephfs down true
    Copy to Clipboard Toggle word wrap

    1. CephFS クラスターを起動するには、以下をバックアップします。

      構文

      ceph fs set FS_NAME down false
      Copy to Clipboard Toggle word wrap

      例

      [ceph: root@host01 /]# ceph fs set cephfs down false
      Copy to Clipboard Toggle word wrap

    または

  1. CephFS クラスターを迅速に停止するには、以下を実行します。

    構文

    ceph fs fail FS_NAME
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph fs fail cephfs
    Copy to Clipboard Toggle word wrap

    注記

    CephFS クラスターのバックアップを作成するには、cephfs を joinable に設定します。

    構文

    ceph fs set FS_NAME joinable true
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph fs set cephfs joinable true

cephfs marked joinable; MDS may join as newly active.
    Copy to Clipboard Toggle word wrap

5.9. Ceph ファイルシステムの削除
リンクのコピー

Ceph File System (CephFS) を削除できます。その前に、すべてのデータのバックアップを作成し、すべてのクライアントがローカルにファイルシステムのマウントを解除していることを確認します。

警告

この操作は破壊的で、Ceph File System に保存されているデータが永続的にアクセスできないようにします。

前提条件

  • データのバックアップを作成します。
  • Ceph Monitor ノードへの root レベルのアクセス。

手順

  1. ストレージクラスターに down のマークを付けます。

    構文

    ceph fs set FS_NAME down true
    Copy to Clipboard Toggle word wrap

    置き換え
    • FS_NAME は、削除する Ceph File System の名前に置き換えます。

    例

    [ceph: root@host01 /]# ceph fs set cephfs down true

cephfs marked down.
    Copy to Clipboard Toggle word wrap

  2. Ceph File System のステータス表示 

    ceph fs status
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph fs status

cephfs - 0 clients
======
+-------------------+----------+-------+-------+
|       POOL        |   TYPE   |  USED | AVAIL |
+-----------------+------------+-------+-------+
|cephfs.cephfs.meta | metadata | 31.5M |  52.6G|
|cephfs.cephfs.data |   data   |    0  |  52.6G|
+-----------------+----------+-------+---------+
               STANDBY MDS
cephfs.ceph-host01
cephfs.ceph-host02
cephfs.ceph-host03
    Copy to Clipboard Toggle word wrap

  3. Ceph ファイルシステムを削除します。

    構文

    ceph fs rm FS_NAME --yes-i-really-mean-it
    Copy to Clipboard Toggle word wrap

    置き換え
    • FS_NAME は、削除する Ceph File System の名前に置き換えます。

    例

    [ceph: root@host01 /]# ceph fs rm cephfs --yes-i-really-mean-it
    Copy to Clipboard Toggle word wrap

  4. ファイルシステムが正常に削除されたことを確認します。

    例

    [ceph: root@host01 /]# ceph fs ls
    Copy to Clipboard Toggle word wrap

  5. 任意です。削除されたファイルシステムに関連付けられたデータおよびメタデータプールを削除します。

関連情報

  • Red Hat Ceph Storage ストレージストラテジーガイド の プールの削除 セクションを参照してください。

5.10. ceph mds fail コマンドの使用
リンクのコピー

ceph mds fail コマンドを使用して、以下を実行します。

  • MDS デーモンを失敗としてマークします。デーモンがアクティブで適切なスタンバイデーモンが利用可能な場合で、standby-replay 設定を無効にした後にスタンバイデーモンがアクティブな場合には、このコマンドを使用すると standby デーモンへのフェイルオーバーを強制します。standby-replay デーモンを無効にすることで、新規の standby-replay デーモンが割り当てられないようにします。
  • 実行中の MDS デーモンを再起動します。デーモンがアクティブで、適切なスタンバイデーモンが利用できる場合には、"failed" デーモンはスタンバイデーモンになります。

前提条件

  • Ceph MDS デーモンのインストールおよび設定

手順

  • デーモンが失敗するには、以下を実行します。

    構文

    ceph mds fail MDS_NAME
    Copy to Clipboard Toggle word wrap

    MDS_NAME は、MDS ノード standby-replay の名前です。

    例

    [ceph: root@host01 /]# ceph mds fail example01
    Copy to Clipboard Toggle word wrap

    注記

    Ceph MDS 名は、ceph fs status コマンドで確認することができます。

5.11. クライアント機能
リンクのコピー

Ceph File System (CephFS) 機能を設定する際には、クライアントが Ceph File Systems を使用できるようにサポートしておく必要のある場合があります。これらの機能がないクライアントでは、他の CephFS クライアントを中断したり、予期せぬ動作をすることがあります。また、古いものや、クライアントが Ceph File System に接続しないように、新機能が必要になる場合があります。

重要

新たに追加された機能がない CephFS クライアントは自動的にエビクトされます。

fs features ls コマンドを使用して、すべての CephFS 機能をリスト表示できます。fs required_client_features コマンドを使用して要件を追加または削除できます。

構文

fs required_client_features FILE_SYSTEM_NAME add FEATURE_NAME
fs required_client_features FILE_SYSTEM_NAME rm FEATURE_NAME
Copy to Clipboard Toggle word wrap

機能の説明

reply_encoding
説明
Ceph Metadata Server(MDS) は、クライアントがこの機能をサポートする場合は、拡張可能な形式で応答要求をエンコードします。
reclaim_client
説明
Ceph MDS により、新しいクライアントがデッド、クライアントの状態が停止するなど、別のクライアントを回収できます。この機能は、NFS Ganesha により使用されます。
lazy_caps_wanted
説明
古いクライアントが再開すると、Ceph MDS は、クライアントがこの機能をサポートしている場合に限り、明示的に必要な機能を再発行する必要があります。
multi_reconnect
説明
Ceph MDS フェイルオーバーのイベントの後に、クライアントは再接続メッセージを MDS に送信してキャッシュ状態を再確立します。クライアントは、大きな再接続メッセージを複数のメッセージに分割できます。
deleg_ino
説明
Ceph MDS は、クライアントがこの機能に対応していると、inode 数をクライアントに委譲します。inode 番号を委譲することは、クライアントが非同期ファイルの作成を行うための前提条件です。
metric_collect
説明
CephFS クライアントは、パフォーマンスメトリックを Ceph MDS に送信することができます。
alternate_name
説明
CephFS クライアントは、ディレクトリーエントリーの代替名を設定して理解することができます。この機能により、暗号化されたファイル名を使用できます。

5.12. Ceph File System クライアントのエビクション
リンクのコピー

Ceph File System (CephFS) クライアントが応答しない、または不正な動作をする場合、強制的に終了したり、CephFS にアクセスしないようにエビクトする必要がある場合があります。CephFS クライアントをエビクトすると、さらにメタデータサーバー (MDS) デーモンおよび Ceph OSD デーモンと通信できなくなります。CephFS クライアントがエビクション時に CephFS に I/O をバッファーする場合、フラッシュされていないデータはすべて失われます。CephFS クライアントのエビクションプロセスは、すべてのクライアントタイプに適用されます。FUSE マウント、カーネルマウント、NFS ゲートウェイ、および libcephfs API ライブラリーを使用するプロセス。

CephFS クライアントを自動的にエビクトできます。これにより、MDS デーモンと一時的に通信できない場合、または手動での通信を行うことができます。

自動クライアントエビクション

以下のシナリオにより、CephFS クライアントの自動エビクションが発生します。

  • CephFS クライアントがデフォルトの 300 秒にわたってアクティブな MDS デーモンと通信していない場合、または session_autoclose オプションで設定した場合。
  • mds_cap_revoke_eviction_timeout オプションが設定されている場合、CephFS クライアントは設定される期間 (秒単位) の制限メッセージに対応しない。mds_cap_revoke_eviction_timeout オプションはデフォルトで無効にされています。
  • MDS の起動またはフェイルオーバー時に、MDS デーモンは、すべての CephFS クライアントが新しい MDS デーモンに接続するのを待機する再接続フェーズを通過します。CephFS クライアントがデフォルトの時間枠内に 45 秒以内に再接続できない場合、または mds_reconnect_timeout オプションで設定した場合。

5.13. ブロックリスト Ceph File System クライアント
リンクのコピー

Ceph File System (CephFS) クライアントのブロック機能は、デフォルトで有効になっています。エビクションコマンドを単一の Metadata Server (MDS) デーモンに送信すると、拒否リストが他の MDS デーモンに伝播されます。これは、CephFS クライアントがデータオブジェクトにアクセスできないようにするため、他の CephFS クライアントを更新し、拒否されたクライアントエントリーを含む最新の Ceph OSD マップと共に MDS デーモンを更新する必要があります。

Ceph OSD マップの更新時に内部の “osdmap epoch barrier“ メカニズムが使用されます。バリアは、ENOSPC やエビクションからのブロックリスト化されたクライアントなど、同じ RADOS オブジェクトへのアクセスが許可される可能性のある機能が割り当てられている前に、CephFS クライアントが機能を受信するために十分な最近の Ceph OSD マップがあることを検証することです。

低速なノードまたは信頼できないネットワークが原因で CephFS クライアントのエビクションが頻繁に行われていて、根本的な問題を修正できない場合、MDS により厳格に見なっているよう依頼できます。MDS セッションを単純にドロップすることで、遅い CephFS クライアントに応答することができますが、CephFS クライアントがセッションを再度開いたことを許可し、Ceph OSD との通信を継続できます。mds_session_blocklist_on_timeout および mds_session_blocklist_on_evict オプションを false に設定すると、このモードが有効になります。

注記

ブロックリストが無効になっている場合、エビクトされた CephFS クライアントはコマンドの送信先となる MDS デーモンにのみ影響を与えます。複数のアクティブな MDS デーモンがあるシステムでは、エビクションコマンドを各アクティブなデーモンに送信する必要があります。

5.14. Ceph File System クライアントの手動エビクト
リンクのコピー

Ceph File System (CephFS) クライアントを手動でエビクトして、クライアントの誤作動やクライアントノードへのアクセスがない場合や、クライアントの動作がタイムアウトするのを待たずに、クライアントセッションがタイムアウトするのを待たずに、Ceph File System (CephFS) クライアントを手動でエビクトする場合があります。

前提条件

  • Ceph Monitor ノードへの root レベルのアクセス。

手順

  1. クライアントリストを確認します。

    構文

    ceph tell DAEMON_NAME client ls
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph tell mds.0 client ls
[
    {
        "id": 4305,
        "num_leases": 0,
        "num_caps": 3,
        "state": "open",
        "replay_requests": 0,
        "completed_requests": 0,
        "reconnecting": false,
        "inst": "client.4305 172.21.9.34:0/422650892",
        "client_metadata": {
            "ceph_sha1": "79f0367338897c8c6d9805eb8c9ad24af0dcd9c7",
            "ceph_version": "ceph version 16.2.8-65.el8cp (79f0367338897c8c6d9805eb8c9ad24af0dcd9c7)",
            "entity_id": "0",
            "hostname": "senta04",
            "mount_point": "/tmp/tmpcMpF1b/mnt.0",
            "pid": "29377",
            "root": "/"
        }
    }
]
    Copy to Clipboard Toggle word wrap

  2. 指定した CephFS クライアントをエビクトします。

    構文

    ceph tell DAEMON_NAME client evict id=ID_NUMBER
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph tell mds.0 client evict id=4305
    Copy to Clipboard Toggle word wrap

5.15. ブロックリストからの Ceph File System クライアントの削除
リンクのコピー

場合によっては、以前のブロックリストされた Ceph File System (CephFS) クライアントがストレージクラスターに再接続できるようにすることが役に立つ場合があります。

重要

blocklist から CephFS クライアントを削除すると、データの整合性はリスクに伴います。また、その結果、CephFS クライアントが完全に確実に機能することを保証することはありません。エビクション後に完全に正常な CephFS クライアントを取得するには、CephFS クライアントをアンマウントして新規マウントを行うのが最適です。その他の CephFS クライアントが、拒否リストされた CephFS クライアントによってバッファーされた I/O を実行してデータの破損につながるファイルにアクセスしている場合は、データが破損する可能性があります。

前提条件

  • Ceph Monitor ノードへの root レベルのアクセス。

手順

  1. ブロックリストを確認します。

    例

    [ceph: root@host01 /]# ceph osd blocklist ls

listed 1 entries
127.0.0.1:0/3710147553 2022-05-09 11:32:24.716146
    Copy to Clipboard Toggle word wrap

  2. ブロックリストから CephFS クライアントを削除します。

    構文

    ceph osd blocklist rm CLIENT_NAME_OR_IP_ADDR
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph osd blocklist rm 127.0.0.1:0/3710147553

un-blocklisting 127.0.0.1:0/3710147553
    Copy to Clipboard Toggle word wrap

  3. オプションで、ブロックリストからカーネルベースの CephFS クライアントを自動的に再接続できます。カーネルベースの CephFS クライアントで、手動マウントを行う場合は clean に以下のオプションを設定するか、/etc/fstab ファイルのエントリーで自動的にマウントします。 

    recover_session=clean
    Copy to Clipboard Toggle word wrap

  4. 任意で、ブロックリストから削除すると、FUSE ベースの CephFS クライアントを自動的に再接続できます。FUSE クライアントで、手動マウントを行う場合は以下のオプションを true に設定するか、/etc/fstab ファイルのエントリーで自動的にマウントします。 

    client_reconnect_stale=true
    Copy to Clipboard Toggle word wrap

第6章 NFS クラスターとエクスポート管理
リンクのコピー

ストレージ管理者は、NFS クラスターを作成してカスタマイズし、NFS プロトコル経由で Ceph File System 名前空間をエクスポートできます。

前提条件

  • 実行中、および正常な Red Hat Ceph Storage クラスター
  • Ceph Metadata Server デーモン (ceph-mds) のインストールおよび設定
  • Ceph ファイルシステムを作成してマウントします。

6.1. NFS クラスターの作成
リンクのコピー

nfs cluster create コマンドを使用して NFS クラスターを作成します。これにより、すべての NFS Ganesha デーモン、クラスター名に基づく新しいユーザー、および共通の NFS Ganesha 設定 RADOS オブジェクトに共通の回復プールが作成されます。

前提条件

  • 実行中、および正常な Red Hat Ceph Storage クラスター
  • 既存の Ceph File System。
  • Ceph Monitor への root レベルのアクセス。
  • Ceph Manager ホスト上の nfs-ganesha、nfs-ganesha-ceph、nfs-ganesha -grace および nfs-ganesha-rados-urls パッケージをインストールします。
  • クライアントへの root レベルのアクセス。

手順

  1. Cephadm シェルにログインします。

    例

    [root@mds ~]# cephadm shell
    Copy to Clipboard Toggle word wrap

  2. Ceph Manager の NFS モジュールを有効にします。

    例

    [ceph: root@host01 /]# ceph mgr module enable nfs
    Copy to Clipboard Toggle word wrap

  3. NFS Ganesha クラスターを作成します。

    構文

    ceph nfs cluster create CLUSTER_NAME [PLACEMENT] [--ingress] [--virtual_ip IP_ADDRESS] [--ingress-mode {default|keepalive-only|haproxy-standard|haproxy-protocol}] [--port PORT]
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph nfs cluster create nfs-cephfs "host01 host02"
NFS Cluster Created Successfully
    Copy to Clipboard Toggle word wrap

    この例では、NFS Ganesha クラスター名は nfs-cephfs で、デーモンコンテナーは host01 および host02 にデプロイされます。

    重要

    Red Hat は、1 つのホストにつき 1 つの NFS Ganesha デーモンのみをサポートします。

  4. NFS-Ganesha クラスター情報を検証します。

    構文

    ceph nfs cluster info [CLUSTER_NAME]
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph nfs cluster info nfs-cephfs
{
    "nfs-cephfs": [
        {
            "hostname": "host01",
            "ip": "10.74.179.124",
            "port": 2049
        },
        {
            "hostname": "host02",
            "ip": "10.74.180.160",
            "port": 2049
        }
    ]
}
    Copy to Clipboard Toggle word wrap

    注記

    CLUSTER_NAME の指定は任意です。

6.2. NFS 設定のカスタマイズ
リンクのコピー

設定ファイルを使用して NFS クラスターをカスタマイズします。これにより、NFS クラスターは指定された設定を使用し、デフォルトの設定ブロックよりも優先されます。

前提条件

  • 実行中、および正常な Red Hat Ceph Storage クラスター
  • Ceph Metadata Server (MDS) ノードへのルートレベルのアクセス。
  • ceph nfs cluster create コマンドを使用して作成された NFS クラスター。

手順

  1. 設定ファイルを作成します。

    例

    [ceph: root@host01 /]# touch nfs-cephfs.conf
    Copy to Clipboard Toggle word wrap

  2. 次のブロックを使用して、設定ファイルでのログ記録を有効にします。

    例

    [ceph: root@host01 /]# vi nfs-cephfs.conf

LOG {
 COMPONENTS {
     ALL = FULL_DEBUG;
 }
}
    Copy to Clipboard Toggle word wrap

  3. 新しい設定を行います。

    構文

    ceph nfs cluster config set CLUSTER_NAME -i PATH_TO_CONFIG_FILE
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph nfs cluster config set nfs-cephfs -i nfs-cephfs.conf

NFS-Ganesha Config Set Successfully
    Copy to Clipboard Toggle word wrap

  4. カスタマイズされた NFS Ganesha 設定を表示します。

    構文

    ceph nfs cluster config get CLUSTER_NAME
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]#  ceph nfs cluster config get nfs-cephfs

LOG {
    COMPONENTS {
        ALL = FULL_DEBUG;
    }
}
    Copy to Clipboard Toggle word wrap

    これにより、ユーザー定義の設定の出力が提供されます (存在する場合)。

  5. オプション: ユーザー定義の設定を削除する場合は、次のコマンドを実行します。

    構文

    ceph nfs cluster config reset CLUSTER_NAME
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph nfs cluster config reset nfs-cephfs

NFS-Ganesha Config Reset Successfully
    Copy to Clipboard Toggle word wrap

6.3. NFS プロトコルを介した Ceph File System 名前空間のエクスポート (可用性に制限あり)
リンクのコピー

NFS Ganesha ファイルサーバーを使用して、Ceph File Systems (CephFS) 名前空間を NFS プロトコルでエクスポートすることができます。CephFS namespace をエクスポートするには、まず実行中の NFS Ganesha クラスターが必要です。

注記

この技術には、利用制限があります。詳細は、Deprecated functionality の章を参照してください。

重要

Red Hat は、NFS バージョン 4.0 以降のみをサポートします。

重要

NFS クライアントは、ネイティブ NFS マウント経由で CephFS スナップショットを作成できません。スナップショットの要件に合わせて、サーバー側のオペレーターツールを使用する必要があります。

前提条件

  • 実行中、および正常な Red Hat Ceph Storage クラスター
  • ceph nfs cluster create コマンドを使用して作成された NFS クラスター。

手順

  1. CephFS エクスポートを作成します。

    注記

    NFS エクスポートを作成するときに cmount_path オプションを使用しないでください。これは、値が '/' 以外の cmount_path を使用すると、以前に定義された NFS エクスポートにアクセスできなくなるという既知の問題があるためです。

    構文

    ceph nfs export create cephfs CLUSTER_NAME BINDING FILE_SYSTEM_NAME [--readonly] [--path=PATH_WITHIN_CEPHFS]
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph nfs export create cephfs nfs-cephfs /ceph cephfs01 --path=/

{
  "bind": "/ceph",
  "cluster": "nfs-cephfs",
  "fs": "cephfs01",
  "mode": "RW",
  "path": "/"
}
    Copy to Clipboard Toggle word wrap

    この例では、BINDING (/ceph) は pseudo root パスであり、これは一意のパスと絶対パスになります。

    注記

    --readonly オプションは、読み取り専用のパーミッションでパスをエクスポートし、デフォルトは read、および write のパーミッションになります。

    注記

    PATH_WITHIN_CEPHFS はサブボリュームになります。以下のコマンドを使用して、絶対サブボリュームパスを取得できます。

    構文

    ceph fs subvolume getpath VOLUME_NAME SUBVOLUME_NAME [--group_name SUBVOLUME_GROUP_NAME]
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph fs subvolume getpath cephfs sub0
    Copy to Clipboard Toggle word wrap

  2. 疑似ルート名に基づいてエクスポートブロックを表示します。

    構文

    ceph nfs export get CLUSTER_NAME BINDING
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph nfs export get nfs-cephfs /ceph
{
  "export_id": 1,
  "path": "/",
  "cluster_id": "nfs-cephfs",
  "pseudo": "/ceph",
  "access_type": "RW",
  "squash": "no_root_squash",
  "security_label": true,
  "protocols": [
    4
  ],
  "transports": [
    "TCP"
  ],
  "fsal": {
    "name": "CEPH",
    "user_id": "cephnfs11",
    "fs_name": "cephfs",
    "sec_label_xattr": ""
  },
  "clients": []
}
    Copy to Clipboard Toggle word wrap

  3. NFS エクスポートをリスト表示します。

    構文

    ceph nfs export ls CLUSTER_NAME [--detailed]
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph nfs export ls nfs-cephfs
[
  "/ceph/"
]
[ceph: root@host01 /]# ceph nfs export ls nfs-cephfs --detailed
[
  {
    "export_id": 100,
    "path": "/",
    "cluster_id": "nfs-cephfs",
    "pseudo": "/ceph/",
    "access_type": "RW",
    "squash": "no_root_squash",
    "security_label": true,
    "protocols": [
      4
    ],
    "transports": [
      "TCP"
    ],
    "fsal": {
      "name": "CEPH",
      "user_id": "nfstest01",
      "fs_name": "cephfs",
      "sec_label_xattr": ""
    },
    "clients": []
  }
]
    Copy to Clipboard Toggle word wrap

  4. NFS エクスポートの情報を取得します。

    構文

    ceph nfs export info CLUSTER_NAME [PSEUDO_PATH]
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph nfs export info nfs-cephfs /ceph

{
  "export_id": 1,
  "path": "/",
  "cluster_id": "nfs-cephfs",
  "pseudo": "/ceph",
  "access_type": "RW",
  "squash": "none",
  "security_label": true,
  "protocols": [
    4
  ],
  "transports": [
    "TCP"
  ],
  "fsal": {
    "name": "CEPH",
    "user_id": "nfs.nfs-cephfs.1",
    "fs_name": "cephfs"
  },
  "clients": []
}
    Copy to Clipboard Toggle word wrap

  5. クライアントホストで、エクスポートされた Ceph File System をマウントします。

    構文

    mount -t nfs -o port=GANESHA_PORT HOST_NAME:BINDING LOCAL_MOUNT_POINT
    Copy to Clipboard Toggle word wrap

    例

    [root@client01 ~]# mount -t nfs -o port=2049 host01:/ceph/ /mnt/nfs-cephfs
    Copy to Clipboard Toggle word wrap

    1. システムの起動時に自動的にマウントするには、改行を追加して /etc/fstab ファイルを開いて編集します。

      構文

      HOST_NAME:BINDING   LOCAL_MOUNT_POINT   nfs4   defaults,seclabel,vers=4.2,proto=tcp,port=2049  0  0
      Copy to Clipboard Toggle word wrap

      例

      host01:/ceph/   /mnt/nfs-cephfs   nfs4   defaults,seclabel,vers=4.2,proto=tcp,port=2049  0  0
      Copy to Clipboard Toggle word wrap

  6. クライアントホストで、Ingress サービスで作成されたエクスポートされた NFS Ceph File System をマウントするには、以下を実行します。

    構文

    mount -t nfs VIRTUAL_IP_ADDRESS:BINDING LOCAL_MOUNT_POINT
    Copy to Clipboard Toggle word wrap

    • VIRTUAL_IP_ADDRESS は、NFS クラスターの作成に使用される --ingress --virtual-ip IP アドレスに置き換えます。
    • BINDING は、擬似ルートパスに置き換えます。

    • LOCAL_MOUNT_POINT は、エクスポートをマウントするマウントポイントに置き換えます。

      例

      [root@client01 ~]# mount -t nfs 10.10.128.75:/nfs-cephfs /mnt
      Copy to Clipboard Toggle word wrap

      この例では、マウントポイント /mnt に --ingress --virtual-ip 10.10.128.75 で作成した NFS クラスターに存在するエクスポート nfs-cephfs をマウントします。

6.4. Ceph ファイルシステムのエクスポートの変更
リンクのコピー

設定ファイルを使用してエクスポート内の次のパラメーターを変更できます。

  • access_type: RW、RO、または NONE のいずれかになります。
  • squash: No_Root_Squash、None、または Root_Squash のいずれかになります。
  • security_label: これは true または false です。

前提条件

  • 実行中、および正常な Red Hat Ceph Storage クラスター
  • NFS エクスポートが作成されました。

手順

  1. 疑似ルート名に基づいてエクスポートブロックを表示します。

    構文

    ceph nfs export get CLUSTER_NAME BINDING
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph nfs export get nfs-cephfs /ceph
{
  "export_id": 1,
  "path": "/",
  "cluster_id": "nfs-cephfs",
  "pseudo": "/ceph",
  "access_type": "RO",
  "squash": "none",
  "security_label": true,
  "protocols": [
    4
  ],
  "transports": [
    "TCP"
  ],
  "fsal": {
    "name": "CEPH",
    "user_id": "cephnfs11",
    "fs_name": "cephfs",
    "sec_label_xattr": ""
  },
  "clients": []
}
    Copy to Clipboard Toggle word wrap

  2. 設定ファイルをエクスポートします。

    例

    [ceph: root@host01 /]# ceph nfs export get nfs-cephfs /ceph > export.conf
    Copy to Clipboard Toggle word wrap

  3. エクスポート情報を編集します。

    構文

    {
  "export_id": EXPORT_ID,
  "path": "/",
  "cluster_id": "CLUSTER_NAME",
  "pseudo": "CLUSTER_PSEUDO_PATH",
  "access_type": "RW/RO",
  "squash": "SQUASH",
  "security_label": SECURITY_LABEL,
  "protocols": [
    PROTOCOL_ID_
  ],
  "transports": [
    "TCP"
  ],
  "fsal": {
    "name": "NAME",
    "user_id": "USER_ID",
    "fs_name": "FILE_SYSTEM_NAME",
    "sec_label_xattr": ""
  },
  "clients": []
}
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# vi export.conf

{
  "export_id": 1,
  "path": "/",
  "cluster_id": "nfs-cephfs",
  "pseudo": "/ceph",
  "access_type": "RW",
  "squash": "none",
  "security_label": true,
  "protocols": [
    4
  ],
  "transports": [
    "TCP"
  ],
  "fsal": {
    "name": "CEPH",
    "user_id": "cephnfs11",
    "fs_name": "cephfs",
    "sec_label_xattr": ""
  },
  "clients": []
}
    Copy to Clipboard Toggle word wrap

    上記の例では、access_type が RO から RW に変更されます。

  4. 仕様を適用します。

    構文

    ceph nfs export apply CLUSTER_NAME PATH_TO_EXPORT_FILE
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph nfs export apply nfs-cephfs -i export.conf
Added export /ceph
    Copy to Clipboard Toggle word wrap

  5. 更新されたエクスポート情報を取得します。

    構文

    ceph nfs export get CLUSTER_NAME BINDING
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph nfs export get nfs-cephfs /ceph
{
  "export_id": 1,
  "path": "/",
  "cluster_id": "nfs-cephfs",
  "pseudo": "/ceph",
  "access_type": "RW",
  "squash": "none",
  "security_label": true,
  "protocols": [
    4
  ],
  "transports": [
    "TCP"
  ],
  "fsal": {
    "name": "CEPH",
    "user_id": "cephnfs11",
    "fs_name": "cephfs",
    "sec_label_xattr": ""
  },
  "clients": []
}
    Copy to Clipboard Toggle word wrap

6.5. カスタム Ceph ファイルシステムエクスポートの作成
リンクのコピー

Ceph File System (CepFS) エクスポートをカスタマイズし、設定を適用できます。

前提条件

  • 実行中、および正常な Red Hat Ceph Storage クラスター
  • ceph nfs cluster create コマンドを使用して作成された NFS クラスター。
  • CephFS が作成されている。

手順

  1. カスタムファイルを作成します。

    例

    [ceph: root@host01 /]# touch export_new.conf
    Copy to Clipboard Toggle word wrap

  2. カスタムファイルを使用してエクスポートを作成します。

    構文

    EXPORT {
  Export_Id = EXPORT_ID;
  Transports = TCP/UDP;
  Path = PATH;
  Pseudo = PSEUDO_PATH;
  Protocols = NFS_PROTOCOLS;
  Access_Type = ACCESS_TYPE;
  Attr_Expiration_Time = EXPIRATION_TIME;
  Squash = SQUASH;
  FSAL {
    Name = NAME;
    Filesystem = "CEPH_FILE_SYSTEM_NAME";
    User_Id = "USER_ID";
  }
}
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# cat export_new.conf
EXPORT {
  Export_Id = 2;
  Transports = TCP;
  Path = /;
  Pseudo = /ceph1/;
  Protocols = 4;
  Access_Type = RW;
  Attr_Expiration_Time = 0;
  Squash = None;
  FSAL {
    Name = CEPH;
    Filesystem = "cephfs";
    User_Id = "nfs.nfs-cephfs.2";
  }
}
    Copy to Clipboard Toggle word wrap

  3. 仕様を適用します。

    構文

    ceph nfs export apply CLUSTER_NAME -i PATH_TO_EXPORT_FILE
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph nfs export apply nfs-cephfs -i new_export.conf
Added export /ceph1
    Copy to Clipboard Toggle word wrap

  4. 更新されたエクスポート情報を取得します。

    構文

    ceph nfs export get CLUSTER_NAME BINDING
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph nfs export get nfs-cephfs /ceph1
{
  "export_id": 1,
  "path": "/",
  "cluster_id": "nfs-cephfs",
  "pseudo": "/ceph1",
  "access_type": "RW",
  "squash": "None",
  "security_label": true,
  "protocols": [
    4
  ],
  "transports": [
    "TCP"
  ],
  "fsal": {
    "name": "CEPH",
    "user_id": "nfs.nfs-cephfs.2",
    "fs_name": "cephfs",
    "sec_label_xattr": ""
  },
  "clients": []
}
    Copy to Clipboard Toggle word wrap

6.6. Ceph ファイルシステムのエクスポートの削除
リンクのコピー

Ceph Export rm コマンドを使用して、Ceph File System (CephFS) NFS エクスポートを削除できます。

前提条件

  • 実行中、および正常な Red Hat Ceph Storage クラスター
  • CephFS が作成されている。

手順

  • CephFS エクスポートを削除します。

    構文

    ceph nfs export rm CLUSTER_NAME BINDING
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph nfs export rm nfs-cephfs /ceph
    Copy to Clipboard Toggle word wrap

6.7. NFS クラスターの削除
リンクのコピー

nfs cluster rm コマンドを使用して、NFS クラスターを削除します。これにより、デプロイされたクラスターが削除されます。NFS デーモンと入力サービスの削除は非同期です。ceph orch ls コマンドで削除状況を確認します。

前提条件

  • 実行中、および正常な Red Hat Ceph Storage クラスター
  • Ceph Metadata Server (MDS) ノードへのルートレベルのアクセス。
  • ceph nfs cluster create コマンドを使用してデプロイされた NFS デーモン。

手順

  1. Cephadm シェルにログインします。

    例

    [root@mds ~]# cephadm shell
    Copy to Clipboard Toggle word wrap

  2. NFS Ganesha クラスターを削除します。

    構文

    ceph nfs cluster rm CLUSTER_NAME
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph nfs cluster rm nfs-cephfs
    Copy to Clipboard Toggle word wrap

第7章 Ceph File システムのクォータ
リンクのコピー

ストレージ管理者は、ファイルシステム内の任意のディレクトリーでクォータを表示、設定、および削除できます。クォータの制限は、バイト数またはディレクトリー内のファイル数に配置できます。

前提条件

  • 実行中、および正常な Red Hat Ceph Storage クラスター
  • Ceph File System のデプロイメント
  • attr パッケージがインストールされていることを確認します。

7.1. Ceph File システムのクォータ
リンクのコピー

Ceph File System (CephFS) のクォータにより、ディレクトリー構造に保存されたファイルの数またはバイト数を制限できます。Ceph File System のクォータは、FUSE クライアントまたはカーネルクライアント (バージョン 4.17 以降) を使用して完全にサポートされます。

制限

  • CephFS のクォータは、設定された制限に達するとデータの書き込みを停止するためにファイルシステムをマウントするクライアントとの協調に依存しています。ただし、クォータのみでは、信頼できないクライアントがファイルシステムを埋めないようにすることはできません。
  • ファイルシステムにデータを書き込むプロセスが、設定された制限に到達したら、データ量がクォータ制限を超えるか、プロセスがデータの書き込みを停止するまでの短い期間が長くなります。通常、期間 (秒) は数十秒で測定されます。ただし、プロセスは、その期間中データの書き込みを続けます。プロセスが書き込む追加データ量は、停止前の経過時間によって異なります。
  • パスベースのアクセス制限を使用する場合は、クライアントが制限されているディレクトリーのクォータを設定するか、その下でネスト化されたディレクトリーにクォータを設定してください。クライアントが MDS 機能に基づいて特定のパスへのアクセス制限があり、そのクォータがクライアントにアクセスできない上位ディレクトリーに設定されている場合、クライアントはクォータを強制しません。たとえば、クライアントが /home/ ディレクトリーにアクセスできず、クォータが /home/ で設定されている場合、クライアントは /home/user/ ディレクトリーのクォータを強制できません。
  • 削除または変更されたスナップショットファイルデータは、クォータに対してカウントされません。
  • setxattr の使用時、NFS クライアントを使用したクォータのサポートはありません。NFS のファイルレベルのクォータはサポートされません。NFS 共有でクォータを使用するには、サブボリュームをエクスポートし、--size オプションを設定します。

7.2. クォータの表示
リンクのコピー

getfattr コマンドおよび ceph.quota 拡張属性を使用して、ディレクトリーのクォータ設定を表示します。

注記

属性が inode に表示されると、そのディレクトリーにクォータが設定されている必要があります。属性が inode に表示されない場合は、ディレクトリーにはクォータセットがありませんが、親ディレクトリーにはクォータが設定されている可能性があります。拡張属性の値が 0 の場合、クォータは設定されません。

前提条件

  • Ceph クライアントノードへの root レベルのアクセス。
  • attr パッケージがインストールされます。

手順

  1. CephFS クォータを表示するには、以下を実行します。

    1. バイト制限クォータの使用:

      構文

      getfattr -n ceph.quota.max_bytes DIRECTORY
      Copy to Clipboard Toggle word wrap

      例

      [root@client ~]# getfattr -n ceph.quota.max_bytes /mnt/cephfs/
getfattr: Removing leading '/' from absolute path names
# file: mnt/cephfs/
ceph.quota.max_bytes="100000000"
      Copy to Clipboard Toggle word wrap

      この例では、100000000 は 100 MB となります。

    2. ファイル制限クォータの使用:

      構文

      getfattr -n ceph.quota.max_files DIRECTORY
      Copy to Clipboard Toggle word wrap

      例

      [root@client ~]# getfattr -n ceph.quota.max_files /mnt/cephfs/
getfattr: Removing leading '/' from absolute path names
# file: mnt/cephfs/
ceph.quota.max_files="10000"
      Copy to Clipboard Toggle word wrap

      この例では 10000 は 10,000 ファイルと等しくなります。

7.3. クォータの設定
リンクのコピー

このセクションでは、setfattr コマンドおよび ceph.quota 拡張属性を使用して、ディレクトリーのクォータを設定する方法を説明します。

前提条件

  • Ceph クライアントノードへの root レベルのアクセス。
  • attr パッケージがインストールされます。

手順

  • バイト制限クォータを使用して、ディレクトリーのクォータを設定します。

    注記

    バイト制限クォータとして値 K、Ki、M、Mi、G、Gi、T、および Ti がサポートされています。

    構文

    setfattr -n ceph.quota.max_bytes -v LIMIT_VALUE DIRECTORY
    Copy to Clipboard Toggle word wrap

    例

    [root@client ~]# setfattr -n ceph.quota.max_bytes -v 2T /cephfs/
    Copy to Clipboard Toggle word wrap

  • ファイル制限クォータを使用して、ディレクトリーのクォータを設定します。

    構文

    setfattr -n ceph.quota.max_files -v LIMIT_VALUE DIRECTORY
    Copy to Clipboard Toggle word wrap

    例

    [root@client ~]# setfattr -n ceph.quota.max_files -v 10000 /cephfs/
    Copy to Clipboard Toggle word wrap

    この例では 10000 は 10,000 ファイルと等しくなります。

    注記

    ファイル LIMIT_VALUE では数値のみがサポートされます。

7.4. クォータの削除
リンクのコピー

このセクションでは、setfattr コマンドおよび ceph.quota 拡張属性を使用して、ディレクトリーからクォータを削除する方法を説明します。

前提条件

  • Ceph クライアントノードへの root レベルのアクセス。
  • attr パッケージがインストールされていることを確認します。

手順

  1. CephFS クォータを削除するには、以下のコマンドを実行します。

    1. バイト制限クォータの使用:

      構文

      setfattr -n ceph.quota.max_bytes -v 0 DIRECTORY
      Copy to Clipboard Toggle word wrap

      例

      [root@client ~]# setfattr -n ceph.quota.max_bytes -v 0 /mnt/cephfs/
      Copy to Clipboard Toggle word wrap

    2. ファイル制限クォータの使用:

      構文

      setfattr -n ceph.quota.max_files -v 0 DIRECTORY
      Copy to Clipboard Toggle word wrap

      例

      [root@client ~]# setfattr -n ceph.quota.max_files -v 0 /mnt/cephfs/
      Copy to Clipboard Toggle word wrap

第8章 ファイルとディレクトリーのレイアウト
リンクのコピー

ストレージ管理者は、ファイルまたはディレクトリーのデータがオブジェクトにマップされる方法を制御できます。

このセクションでは、以下を行う方法を説明します。

前提条件

  • 実行中、および正常な Red Hat Ceph Storage クラスター
  • Ceph File System のデプロイメント
  • attr パッケージのインストール

8.1. ファイルとディレクトリーレイアウトの概要
リンクのコピー

このセクションでは、Ceph File System のコンテキストにおけるファイルおよびディレクトリーのレイアウトを説明します。

ファイルまたはディレクトリーのレイアウトは、そのコンテンツを Ceph RADOS オブジェクトにマッピングする方法を制御します。ディレクトリーレイアウトは、主にそのディレクトリー内の新しいファイルに継承されたレイアウトを設定します。

ファイルまたはディレクトリーのレイアウトを表示および設定するには、仮想拡張属性または拡張ファイル属性 (xattrs) を使用します。layout 属性の名前は、ファイルが通常のファイルかディレクトリーであるかによって異なります。

  • 通常ファイルのレイアウト属性は ceph.file.layout という名前です。
  • ディレクトリーのレイアウト属性は ceph.dir.layout と呼ばれます。

レイアウトの継承

ファイルは、作成時に、親ディレクトリーのレイアウトを継承します。ただし、後続の親ディレクトリーのレイアウトは子には影響を及ぼしません。ディレクトリーにレイアウトが設定されていない場合、ファイルはディレクトリー構造のレイアウトで最も近いディレクトリーからレイアウトを継承します。

8.2. ファイルとディレクトリーレイアウトフィールドの設定
リンクのコピー

setfattr コマンドを使用して、ファイルまたはディレクトリーにレイアウトフィールドを設定します。

重要

ファイルのレイアウトフィールドを修正すると、ファイルは空にする必要があります。指定しない場合は、エラーが発生します。

前提条件

  • ノードへのルートレベルのアクセス。

手順

  • ファイルまたはディレクトリーのレイアウトフィールドを変更するには、次のコマンドを実行します。

    構文

    setfattr -n ceph.TYPE.layout.FIELD -v VALUE PATH
    Copy to Clipboard Toggle word wrap

    以下を置き換えます。

    • TYPE を file または dir に変更。
    • FIELD をフィールドの名前に変更。
    • VALUE をフィールドの新しい値に変更。
    • PATH をファイルまたはディレクトリーへのパスに変更。

    例

    [root@mon ~]# setfattr -n ceph.file.layout.stripe_unit -v 1048576 test
    Copy to Clipboard Toggle word wrap

関連情報

8.3. ファイルとディレクトリーのレイアウトフィールドの表示
リンクのコピー

getfattr コマンドを使用して、ファイルまたはディレクトリーのレイアウトフィールドを表示します。

前提条件

  • 稼働中の Red Hat Ceph Storage クラスターがある。
  • ストレージクラスター内のすべてのノードへの root レベルのアクセス。

手順

  • 1 つの文字列としてファイルまたはディレクトリーのレイアウトフィールドを表示するには、次のコマンドを実行します。

    構文

    getfattr -n ceph.TYPE.layout PATH
    Copy to Clipboard Toggle word wrap

    置き換え
    • PATH をファイルまたはディレクトリーへのパスに変更。
    • TYPE を file または dir に変更。

    例

    [root@mon ~]# getfattr -n ceph.dir.layout /home/test
ceph.dir.layout="stripe_unit=4194304 stripe_count=2 object_size=4194304 pool=cephfs_data"
    Copy to Clipboard Toggle word wrap

注記

ディレクトリーには、設定するまで明示的なレイアウトがありません。そのため、表示する変更がないため、最初に設定せずにレイアウトを表示しようとすると失敗します。

関連情報

8.4. 個々のレイアウトフィールドの表示
リンクのコピー

getfattr コマンドを使用して、ファイルまたはディレクトリーの個別のレイアウトフィールドを表示します。

前提条件

  • 稼働中の Red Hat Ceph Storage クラスターがある。
  • ストレージクラスター内のすべてのノードへの root レベルのアクセス。

手順

  • ファイルまたはディレクトリーの個別のレイアウトフィールドを表示するには、次のコマンドを実行します。

    構文

    getfattr -n ceph.TYPE.layout.FIELD _PATH
    Copy to Clipboard Toggle word wrap

    置き換え
    • TYPE を file または dir に変更。
    • FIELD をフィールドの名前に変更。
    • PATH をファイルまたはディレクトリーへのパスに変更。

    例

    [root@mon ~]# getfattr -n ceph.file.layout.pool test
ceph.file.layout.pool="cephfs_data"
    Copy to Clipboard Toggle word wrap

    注記

    pool フィールドのプールは、名前で示されます。ただし、新規作成されたプールは ID で識別できます。

関連情報

  • getfattr(1) man ページ

8.5. ディレクトリーレイアウトの削除
リンクのコピー

setfattr コマンドを使用して、ディレクトリーからレイアウトを削除します。

注記

ファイルレイアウトを設定する場合は、ファイルの変更や削除ができません。

前提条件

  • レイアウトを含むディレクトリー。

手順

  1. ディレクトリーからレイアウトを削除するには、以下のコマンドを実行します。

    構文

    setfattr -x ceph.dir.layout DIRECTORY_PATH
    Copy to Clipboard Toggle word wrap

    例

    [user@client ~]$ setfattr -x ceph.dir.layout /home/cephfs
    Copy to Clipboard Toggle word wrap

  2. pool_namespace フィールドを削除するには、以下を実行します。

    構文

    setfattr -x ceph.dir.layout.pool_namespace DIRECTORY_PATH
    Copy to Clipboard Toggle word wrap

    例

    [user@client ~]$ setfattr -x ceph.dir.layout.pool_namespace /home/cephfs
    Copy to Clipboard Toggle word wrap

    注記

    pool_namespace フィールドは、個別に削除できる唯一のフィールドです。

関連情報

  • setfattr(1) man ページ

第9章 Ceph ファイルシステムのスナップショット
リンクのコピー

ストレージ管理者は、Ceph File System (CephFS) ディレクトリーの特定の時点のスナップショットを取得できます。CephFS スナップショットは非同期で、作成するディレクトリースナップショットを選択できます。

前提条件

  • 実行中、および正常な Red Hat Ceph Storage クラスター
  • Ceph File System のデプロイメント

9.1. Ceph ファイルシステムのスナップショット
リンクのコピー

Ceph File System (CephFS) のスナップショット機能は、新しい Ceph File Systems でデフォルトで有効になっていますが、既存の Ceph File Systems で手動で有効にする必要があります。CephFS スナップショットは、Ceph File System のイミュータブルな、ポイントインタイムビューを作成します。CephFS スナップショットは非同期で、CephFS ディレクトリーの特別な非表示ディレクトリー (.snap) に保存されます。Ceph ファイルシステム内の任意のディレクトリーのスナップショット作成を指定できます。ディレクトリーを指定すると、スナップショットにはその中のすべてのサブディレクトリーも含まれます。

警告

各 Ceph Metadata Server (MDS) クラスターは snap 識別子を別個に割り当てます。1 つのプールを共有する複数の Ceph ファイルシステムのスナップショットを使用すると、スナップショットの競合が発生し、ファイルデータがありません。

9.2. Ceph ファイルシステムのスナップショットの作成
リンクのコピー

Ceph File System (CephFS) のイミュータブル (ポイントインタイムビュー) を作成するには、スナップショットを作成します。

注記

新しい Ceph ファイルシステムの場合、スナップショットはデフォルトで有効になります。

前提条件

  • 実行中、および正常な Red Hat Ceph Storage クラスター
  • Ceph File System のデプロイメント
  • Ceph Metadata Server (MDS) ノードへのルートレベルのアクセス。

手順

  1. Cephadm シェルにログインします。

    例

    [root@mds ~]# cephadm shell
    Copy to Clipboard Toggle word wrap

  2. 既存の Ceph ファイルシステムの場合は、スナップショット化機能を有効にします。

    構文

    ceph fs set FILE_SYSTEM_NAME allow_new_snaps true
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@mds ~]# ceph fs set cephfs01 allow_new_snaps true
    Copy to Clipboard Toggle word wrap

  3. .snap ディレクトリーに新しい snapshot サブディレクトリーを作成します。

    構文

    mkdir NEW_DIRECTORY_PATH
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@mds ~]# mkdir /.snap/new-snaps
    Copy to Clipboard Toggle word wrap

    この例では new-snaps サブディレクトリーを作成し、これにより Ceph Metadata Server (MDS) がスナップショットの作成を開始するように通知します。

    1. スナップショットを削除するには、以下のコマンドを実行します。

      構文

      rmdir NEW_DIRECTORY_PATH
      Copy to Clipboard Toggle word wrap

      例

      [ceph: root@mds ~]# rmdir /.snap/new-snaps
      Copy to Clipboard Toggle word wrap

      重要

      基礎となるスナップショットが含まれる可能性のある root レベルのスナップショットの削除を試みると、失敗します。

第10章 Ceph File System スナップショットのスケジューリング
リンクのコピー

ストレージ管理者は、Ceph File System (CephFS) ディレクトリーの特定の時点のスナップショットを取得できます。CephFS スナップショットは非同期で、作成するディレクトリースナップショットを選択できます。

前提条件

  • 実行中、および正常な Red Hat Ceph Storage クラスター
  • Ceph File System のデプロイメント

10.1. Ceph ファイルシステムのスナップショットスケジュール
リンクのコピー

Ceph File System (CephFS) は、ファイルシステムディレクトリーのスナップショットをスケジュールできます。スナップショットのスケジューリングは Ceph Manager によって管理され、Python タイマーに依存します。スナップショットスケジュールデータは CephFS メタデータプールにオブジェクトとして保存され、ランタイム時に、スケジュールデータはすべてシリアライズされた SQLite データベースに置かれます。

重要

スケジューラーは、ストレージクラスターが通常の負荷がかかる場合に、スナップショットを個別に維持するために指定された時間に基づいて正確です。Ceph Manager の負荷が高い場合は、スナップショットがすぐにスケジュールされない可能性があり、スナップショットが若干遅延させる可能性があります。この場合、次のスケジュールされたスナップショットは遅延がないかのように動作します。遅延しているスケジュールされたスナップショットでは、スケジュール全体にドリフトが発生しません。

使用方法

Ceph File System (CephFS) のスナップショットスケジューリングは、snap_schedule Ceph Manager モジュールにより管理されます。このモジュールは、スナップショットスケジュールを追加、クエリー、削除し、保持ポリシーを管理するインターフェイスを提供します。このモジュールは ceph fs snap-schedule コマンドも実装し、スケジュールを管理する複数のサブコマンドと保持ポリシーも実装します。すべてのサブコマンドは、CephFS ボリュームパスと subvolume パス引数を取り、複数の Ceph File Systems を使用する場合のファイルシステムパスを指定します。CephFS ボリュームパスを指定しない場合、引数は fs_map にリスト表示されている最初のファイルシステムに対してデフォルトで設定され、subvolume パス引数は何も指定しません。

スナップショットスケジュールは、ファイルシステムパス、繰り返しの間隔、および開始時間で識別されます。繰り返し間隔は、2 つの後続のスナップショットの間隔を定義します。間隔の形式は、数 + 時間指定 h(our)、d(ay)、w(eek) です。たとえば、間隔が 4h であれば、4 時間ごとに 1 つのスナップショットが必要になります。開始時間は ISO 形式の文字列の値 %Y-%m-%dT%H:%M:%S です。指定されていない場合、開始時間は最後の midnight のデフォルト値を使用します。たとえば、デフォルトの開始時間値を使用して、スナップショットを 14:45 にスケジュールすると、繰り返される間隔が 1h になると、最初のスナップショットは 15:00 に作成されます。

保持ポリシーは、ファイルシステムパスと保持ポリシーの仕様で識別されます。保持ポリシーの定義は、COUNT TIME_PERIOD の形式で、数字と時間指定のペア、または連結されたペアのいずれかで構成されます。このポリシーにより、スナップショットの数も保持され、スナップショットは少なくとも特定の期間にわたって保持されます。期間指定子は、h (our)、d (ay)、w (eek)、M (onth)、Y (ear)、n です。n の時間指定は特別な修飾子であり、タイミングに関係なくスナップショットの最後の数を保持します。たとえば、4d は、1 日以上経過した 4 つのスナップショットを保持します。

10.2. Ceph ファイルシステムのスナップショットスケジュールの追加
リンクのコピー

まだ存在しない CephFS パスのスナップショットスケジュールを追加します。1 つのパスに対して 1 つ以上のスケジュールを作成できます。繰り返される間隔と開始時間が異なる場合、スケジュールは異なると見なされます。

CephFS パスには保持ポリシーを 1 つだけ指定できますが、保持ポリシーは複数のカウントタイムペアを持つことができます。

注記

スケジューラーモジュールが有効になると、ceph fs snap-schedule コマンドを実行すると、利用可能なサブコマンドと、その使用形式が表示されます。

前提条件

  • 実行中、および正常な Red Hat Ceph Storage クラスター
  • Ceph File System のデプロイメント
  • Ceph Manager および Metadata Server (MDS) ノードへのルートレベルのアクセス。
  • ファイルシステムで CephFS スナップショットを有効にします。

手順

  1. Ceph Manager ノードで Cephadm シェルにログインします。

    例

    [root@host01 ~]# cephadm shell
    Copy to Clipboard Toggle word wrap

  2. snap_schedule モジュールを有効にします。

    例

    [ceph: root@host01 /]# ceph mgr module enable snap_schedule
    Copy to Clipboard Toggle word wrap

  3. クライアントノードにログインします。

    例

    [root@host02 ~]# cephadm shell
    Copy to Clipboard Toggle word wrap

  4. Ceph File System の新しいスケジュールを追加します。

    構文

    ceph fs snap-schedule add FILE_SYSTEM_VOLUME_PATH REPEAT_INTERVAL [START_TIME] --fs CEPH_FILE_SYSTEM_NAME
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host02 /]# ceph fs snap-schedule add /cephfs_kernelf739cwtus2/pmo9axbwsi 1h 2022-06-27T21:50:00 --fs mycephfs
    Copy to Clipboard Toggle word wrap

    注記

    START_TIME は、ISO8601 形式で表されます。

    この例では、ファイルシステム mycephfs 内のパス /cephfs のスナップショットスケジュールを作成し、1 時間ごとにスナップショットを作成し、2022 年 6 月 27 日午後 9 時 50 分に開始します。

  5. CephFS ボリュームパスのスナップショット用に新たな保持ポリシーを追加します。

    構文

    ceph fs snap-schedule retention add FILE_SYSTEM_VOLUME_PATH [COUNT_TIME_PERIOD_PAIR] TIME_PERIOD COUNT
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host02 /]# ceph fs snap-schedule retention add /cephfs h 14
    1 
    
[ceph: root@host02 /]# ceph fs snap-schedule retention add /cephfs d 4
    2 
    
[ceph: root@host02 /]# ceph fs snap-schedule retention add /cephfs 14h4w
    3
    Copy to Clipboard Toggle word wrap

    1
    この例では、14 スナップショットを 1 時間以上保持します。
    2
    この例では、4 つのスナップショットを 1 日以上保持します。
    3
    この例では、14 時間ごとに 1 週間、また 4 週間のスナップショットを保持します。

  6. スナップショットスケジュールを一覧表示して、新しいスケジュールが作成されたことを確認します。

    構文

    ceph fs snap-schedule list FILE_SYSTEM_VOLUME_PATH [--format=plain|json] [--recursive=true]
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host02 /]# ceph fs snap-schedule list /cephfs --recursive=true
    Copy to Clipboard Toggle word wrap

    この例では、ディレクトリーツリーのすべてのスケジュールをリスト表示しています。

  7. スナップショットスケジュールのステータスを確認します。

    構文

    ceph fs snap-schedule status FILE_SYSTEM_VOLUME_PATH [--format=plain|json]
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host02 /]# ceph fs snap-schedule status /cephfs --format=json
    Copy to Clipboard Toggle word wrap

    以下の例では、CephFS /cephfs パスのスナップショットスケジュールのステータスを JSON 形式で表示しています。デフォルトの形式はプレーンテキストで、指定されていない場合はプレーンテキストになります。

10.3. Ceph File System サブボリュームのスナップショットスケジュールの追加
リンクのコピー

Ceph File System (CephFS) サブボリュームスナップショットの保持ポリシーを管理するために、1 つのパスに対して異なるスケジュールを設定できます。

繰り返される間隔と開始時間が異なる場合、スケジュールは異なると見なされます。

まだ存在しない CephFS ファイルパスのスナップショットスケジュールを追加します。CephFS パスには保持ポリシーを 1 つだけ指定できますが、保持ポリシーは複数のカウントタイムペアを持つことができます。

注記

スケジューラーモジュールが有効になると、ceph fs snap-schedule コマンドを実行すると、利用可能なサブコマンドと、その使用形式が表示されます。

前提条件

  • Ceph File System (CephFS) がデプロイされた稼働中の Red Hat Ceph Storage クラスター。
  • Ceph Monitor での少なくとも読み取りアクセス。
  • Ceph Manager ノードの読み取りおよび書き込み機能。
  • CephFS サブボリュームとサブボリュームグループが作成されました。

以下のスナップショットスケジュールを作成できます。

  • サブボリューム内のディレクトリー。
  • デフォルトグループ内のサブボリューム。
  • デフォルト以外のグループ内のサブボリューム。

ただし、コマンドは異なります。

手順

  • サブボリューム内のディレクトリーのスナップショットスケジュールを作成するには、以下を実行します。

    1. ディレクトリーが存在するサブボリュームの絶対パスを取得します。

      構文

      ceph fs subvolume getpath VOLUME_NAME SUBVOLUME_NAME SUBVOLUME_GROUP_NAME
      Copy to Clipboard Toggle word wrap

      例

      [ceph: root@host02 /]# ceph fs subvolume getpath cephfs subvol_1 subvolgroup_1
      Copy to Clipboard Toggle word wrap

    2. サブボリューム内のディレクトリーにスナップショットスケジュールを追加します。

      構文

      ceph fs snap-schedule add SUBVOLUME_DIR_PATH SNAP_SCHEDULE [START_TIME] --fs CEPH_FILE_SYSTEM_NAME --subvol SUBVOLUME_NAME
      Copy to Clipboard Toggle word wrap

      注記

      snap-schedule コマンドのパスは <absolute_path_of_ subvolume>/<relative_path_of_test_dir> になります。サブボリュームの absolute_path については、手順 1 を参照してください。

      例

      [ceph: root@host02 /]# ceph fs snap-schedule add /cephfs_kernelf739cwtus2/pmo9axbwsi 1h 2022-06-27T21:50:00 --fs cephfs --subvol subvol_1
Schedule set for path /..
      Copy to Clipboard Toggle word wrap

      注記

      START_TIME は、ISO8601 形式で表されます。

      この例では、サブボリュームパスのスナップショットスケジュールを作成し、1 時間ごとにスナップショットを作成します。2022 年 6 月 27 日午後 9 時 50 分に開始します。

  • デフォルトグループ内のサブボリュームのスナップショットスケジュールを作成するには、次のコマンドを実行します。

    構文

    ceph fs snap-schedule add /.. SNAP_SCHEDULE [START_TIME] --fs CEPH_FILE_SYSTEM_NAME --subvol _SUBVOLUME_NAME
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host02 /]# ceph fs snap-schedule add - 2M --subvol sv_non_def_1
    Copy to Clipboard Toggle word wrap

    注記

    パスは定義する必要があり、空のままにすることはできません。パス文字列の値には依存関係がないため、/、-`、または /.. として定義できます。

  • デフォルト以外のグループ内のサブボリュームのスナップショットスケジュールを作成するには、次のコマンドを実行します。

    構文

    ceph fs snap-schedule add /.. SNAP_SCHEDULE [START_TIME] --fs CEPH_FILE_SYSTEM_NAME --subvol _SUBVOLUME_NAME --group NON_DEFAULT_SUBVOLGROUP_NAME
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host02 /]# ceph fs snap-schedule add - 2M --fs cephfs --subvol sv_non_def_1 --group svg1
    Copy to Clipboard Toggle word wrap

    注記

    パスは定義する必要があり、空のままにすることはできません。パス文字列の値には依存関係がないため、/、-`、または /.. として定義できます。

10.3.1. CephFS ボリュームパスのスナップショットスケジュールの保持ポリシーを追加する
リンクのコピー

常にボリュームパスに保持するスナップショットの数を定義するには、スナップショットスケジュールを作成した後、保持ポリシーを追加する必要があります。

保持ポリシーは、サブボリュームグループ内のディレクトリー、デフォルトグループ内のサブボリューム、デフォルト以外のグループ内のサブボリュームに対して作成できます。

前提条件

  • Ceph File System (CephFS) がデプロイされた、稼働中の正常な IBM Storage Ceph クラスター。
  • Ceph モニターに対する最小限の読み取りアクセス。
  • Ceph Manager ノードの読み取りおよび書き込み機能。
  • CephFS サブボリュームとサブボリュームグループが作成されました。
  • スナップショットスケジュール。

手順

  • CephFS サブボリュームのディレクトリーに、スナップショットスケジュールの新しい保持ポリシーを追加します。

    構文

    ceph fs snap-schedule retention add SUBVOLUME_DIR_PATH [COUNT_TIME_PERIOD_PAIR] TIME_PERIOD COUNT
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host02 /]# ceph fs snap-schedule retention add /volumes/_nogroup/subvol_1/85a615da-e8fa-46c1-afc3-0eb8ae64a954/.. h 14
    1 
    
[ceph: root@host02 /]# ceph fs snap-schedule retention add /volumes/_nogroup/subvol_1/85a615da-e8fa-46c1-afc3-0eb8ae64a954/.. d 4
    2 
    
[ceph: root@host02 /]# ceph fs snap-schedule retention add /volumes/_nogroup/subvol_1/85a615da-e8fa-46c1-afc3-0eb8ae64a954/.. 14h4w
    3 
    

Retention added to path /volumes/_nogroup/subvol_1/85a615da-e8fa-46c1-afc3-0eb8ae64a954/..
    Copy to Clipboard Toggle word wrap

    1
    この例では、14 スナップショットを 1 時間以上保持します。
    2
    この例では、4 つのスナップショットを 1 日以上保持します。
    3
    この例では、14 時間ごとに 1 週間、また 4 週間のスナップショットを保持します。

  • デフォルトグループ内のサブボリューム用に作成されたスナップショットスケジュールに、保持ポリシーを追加します。

    構文

    ceph fs snap-schedule retention add / [COUNT_TIME_PERIOD_PAIR] TIME_PERIOD_COUNT --fs CEPH_FILE_SYSTEM_NAME --subvol SUBVOLUME_NAME
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host02 /]# ceph fs snap-schedule retention add / 5h --fs cephfs --subvol sv_sched
Retention added to path /volumes/sv_sched/e704342a-ff07-4763-bb0b-a46d9dda6f27/..
    Copy to Clipboard Toggle word wrap

    重要

    パス (/) を定義する必要があり、空のままにすることはできません。パス文字列の値には依存関係がないため、/、-、または /…​ として定義できます。

  • デフォルト以外のグループ内のサブボリュームグループ用に作成されたスナップショットスケジュールに、保持ポリシーを追加します。

    構文

    ceph fs snap-schedule retention add / [COUNT_TIME_PERIOD_PAIR] TIME_PERIOD_COUNT --fs CEPH_FILE_SYSTEM_NAME --subvol SUBVOLUME_NAME --group NON_DEFAULT_SUBVOLGROUP_NAME
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host02 /]# ceph fs snap-schedule retention add / 5h --fs cephfs --subvol sv_sched --group subvolgroup_cg
Retention added to path /volumes/subvolgroup_cg/sv_sched/e704342a-ff07-4763-bb0b-a54j0dda7f16/..
    Copy to Clipboard Toggle word wrap

    重要

    パス (/) を定義する必要があり、空のままにすることはできません。パス文字列の値には依存関係がないため、/、-、または /…​ として定義できます。

10.3.2. CephFS スナップショットスケジュールのリスト表示
リンクのコピー

スナップショットスケジュールをリスト化し、それに従うことで、堅牢なデータ保護と効率的な管理が可能になります。

前提条件

  • Ceph File System (CephFS) がデプロイされた、稼働中の正常な IBM Storage Ceph クラスター。
  • Ceph モニターに対する最小限の読み取りアクセス。
  • Ceph Manager ノードの読み取りおよび書き込み機能。
  • CephFS サブボリュームとサブボリュームグループが作成されました。
  • スナップショットスケジュール。

手順

  • スナップショットスケジュールをリスト表示します。

    構文

    ceph fs snap-schedule list SUBVOLUME_VOLUME_PATH [--format=plain|json] [--recursive=true]
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host02 /]# ceph fs snap-schedule list / --recursive=true

/volumes/_nogroup/subv1/85a615da-e8fa-46c1-afc3-0eb8ae64a954/.. 4h
    Copy to Clipboard Toggle word wrap

    この例では、ディレクトリーツリーのすべてのスケジュールをリスト表示しています。

10.3.3. CephFS スナップショットスケジュールのステータスを確認する
リンクのコピー

サブボリューム内のディレクトリーに作成されたスナップショット、デフォルトのサブボリュームグループ内のサブボリューム、デフォルト以外のグループに作成されたサブボリュームについては、手順内のコマンドを使用してスナップショットスケジュールのステータスを確認できます。

前提条件

  • Ceph File System (CephFS) がデプロイされた、稼働中の正常な IBM Storage Ceph クラスター。
  • Ceph モニターに対する最小限の読み取りアクセス。
  • Ceph Manager ノードの読み取りおよび書き込み機能。
  • CephFS サブボリュームとサブボリュームグループが作成されました。
  • スナップショットスケジュール。

手順

  • サブボリューム内のディレクトリーに対して作成されたスナップショットスケジュールのステータスを確認します。

    構文

    ceph fs snap-schedule status SUBVOLUME_DIR_PATH [--format=plain|json]
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host02 /]# ceph fs snap-schedule status /volumes/_nogroup/subv1/85a615da-e8fa-46c1-afc3-0eb8ae64a954/.. --format=json

{"fs": "cephfs", "subvol": "subvol_1", "path": "/volumes/_nogroup/subvol_1/85a615da-e8fa-46c1-afc3-0eb8ae64a954/..", "rel_path": "/..", "schedule": "4h", "retention": {"h": 14}, "start": "2022-05-16T14:00:00", "created": "2023-03-20T08:47:18", "first": null, "last": null, "last_pruned": null, "created_count": 0, "pruned_count": 0, "active": true}
    Copy to Clipboard Toggle word wrap

    この例では、/volumes/_nogroup/subv1/85a615da-e8fa-46c1-afc3-0eb8ae64a954/.. パスのスナップショットスケジュールのステータスを JSON 形式で表示します。デフォルトの形式はプレーンテキストで、指定されていない場合はプレーンテキストになります。

  • デフォルトグループ内のサブボリュームに対して作成されたスナップショットスケジュールのステータスを確認します。

    構文

    ceph fs snap-schedule status --fs CEPH_FILE_SYSTEM_NAME --subvol SUBVOLUME_NAME
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host02 /]# ceph fs snap-schedule status --fs cephfs --subvol sv_sched
{"fs": "cephfs", "subvol": "sv_sched", "group": "subvolgroup_cg", "path": "/volumes/subvolgroup_cg/sv_sched/e704342a-ff07-4763-bb0b-a46d9dda6f27/..", "rel_path": "/volumes/subvolgroup_cg/sv_sched/e704342a-ff07-4763-bb0b-a46d9dda6f27/..", "schedule": "1h", "retention": {"h": 5}, "start": "2024-05-21T00:00:00", "created": "2024-05-21T09:18:58", "first": null, "last": null, "last_pruned": null, "created_count": 0, "pruned_count": 0, "active": true}
    Copy to Clipboard Toggle word wrap

    重要

    パス (/) を定義する必要があり、空のままにすることはできません。パス文字列の値には依存関係がないため、/、-、または /…​ として定義できます。

  • デフォルト以外のグループのサブボリュームに対して作成されたスナップショットスケジュールのステータスを確認します。.Syntax 
ceph fs snap-schedule status --fs _CEPH_FILE_SYSTEM_NAME_ --subvol _SUBVOLUME_NAME_ --group _NON-DEFAULT_SUBVOLGROUP_NAME_
Copy to Clipboard Toggle word wrap

例

[ceph: root@host02 /]# ceph fs snap-schedule status --fs cephfs --subvol sv_sched --group subvolgroup_cg
{"fs": "cephfs", "subvol": "sv_sched", "group": "subvolgroup_cg", "path": "/volumes/subvolgroup_cg/sv_sched/e564329a-kj87-4763-gh0y-b56c8sev7t23/..", "rel_path": "/volumes/subvolgroup_cg/sv_sched/e704342a-ff07-4763-bb0b-a46d9dda6f27/..", "schedule": "1h", "retention": {"h": 5}, "start": "2024-05-21T00:00:00", "created": "2024-05-21T09:18:58", "first": null, "last": null, "last_pruned": null, "created_count": 0, "pruned_count": 0, "active": true}
Copy to Clipboard Toggle word wrap

+ 重要: パス (/) を定義する必要があり、空のままにすることはできません。パス文字列の値には依存関係がないため、/、-、または /…​ として定義できます。

10.4. Ceph ファイルシステムのスナップショットスケジュールのアクティブ化
リンクのコピー

このセクションでは、Ceph ファイルシステム (CephFS) のスナップショットスケジュールを手動でアクティブに設定する手順を説明します。

前提条件

  • Ceph File System (CephFS) がデプロイされた稼働中の Red Hat Ceph Storage クラスター。
  • Ceph Monitor での少なくとも読み取りアクセス。
  • Ceph Manager ノードの読み取りおよび書き込み機能。

手順

  • スナップショットスケジュールを有効にします。

    構文

    ceph fs snap-schedule activate FILE_SYSTEM_VOLUME_PATH [REPEAT_INTERVAL]
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph fs snap-schedule activate /cephfs
    Copy to Clipboard Toggle word wrap

    以下の例では、CephFS /cephfs パスのすべてのスケジュールを有効にします。

10.5. Ceph ファイルシステムサブボリュームのスナップショットスケジュールのアクティブ化
リンクのコピー

このセクションでは、Ceph ファイルシステム (CephFS) サブボリュームのスナップショットスケジュールを手動でアクティブに設定する手順を説明します。

前提条件

  • Ceph File System (CephFS) がデプロイされた稼働中の Red Hat Ceph Storage クラスター。
  • Ceph Monitor での少なくとも読み取りアクセス。
  • Ceph Manager ノードの読み取りおよび書き込み機能。

手順

  • サブボリューム内のディレクトリーに対して作成されたスナップショットスケジュールをアクティブ化します。

    構文

    ceph fs snap-schedule activate SUBVOL_DIR_PATH [REPEAT_INTERVAL]
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph fs snap-schedule activate /volumes/_nogroup/subvol_1/85a615da-e8fa-46c1-afc3-0eb8ae64a954/..
    Copy to Clipboard Toggle word wrap

    この例では、CephFS /volumes/_nogroup/subvol_1/85a615da-e8fa-46c1-afc3-0eb8ae64a954/.. パスのすべてのスケジュールをアクティブ化します。

  • デフォルトグループのサブボリュームに対して作成されたスナップショットスケジュールをアクティブ化します。

    構文

    ceph fs snap-schedule activate /.. REPEAT_INTERVAL --fs CEPH_FILE_SYSTEM_NAME --subvol SUBVOLUME_NAME
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host02 /]# ceph fs snap-schedule activate / --fs cephfs --subvol sv_sched
Schedule activated for path /volumes/subvolgroup_cg/sv_sched/e704342a-ff07-4763-bb0b-a46d9dda6f27/..
    Copy to Clipboard Toggle word wrap

    重要

    パス (/) を定義する必要があり、空のままにすることはできません。パス文字列の値には依存関係がないため、/、-、または /…​ として定義できます。

  • デフォルト以外のグループのサブボリュームに対して作成されたスナップショットスケジュールをアクティブ化します。

    構文

    ceph fs snap-schedule activate /.. [REPEAT_INTERVAL] --fs CEPH_FILE_SYSTEM_NAME --subvol SUBVOLUME_NAME --group NON-DEFAULT_GROUP_NAME
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host02 /]# ceph fs snap-schedule activate / --fs cephfs --subvol sv_sched --group subvolgroup_cg
Schedule activated for path /volumes/subvolgroup_cg/sv_sched/e704342a-ff07-4763-bb0b-a46d9dda6f27/..
    Copy to Clipboard Toggle word wrap

    重要

    パス (/) を定義する必要があり、空のままにすることはできません。パス文字列の値には依存関係がないため、/、-、または /…​ として定義できます。

10.6. Ceph ファイルシステムのスナップショットスケジュールの非アクティブ化
リンクのコピー

このセクションでは、Ceph ファイルシステム (CephFS) のスナップショットスケジュールを手動で非アクティブに設定する手順を説明します。このアクションにより、スナップショットは、再度アクティブ化されるまで、スケジュールから除外されます。

前提条件

  • Ceph File System (CephFS) がデプロイされた稼働中の Red Hat Ceph Storage クラスター。
  • Ceph Monitor での少なくとも読み取りアクセス。
  • Ceph Manager ノードの読み取りおよび書き込み機能。
  • スナップショットスケジュールが作成され、アクティブな状態になっています。

手順

  • CephFS パスのスナップショットスケジュールを非アクティブにします。

    構文

    ceph fs snap-schedule deactivate FILE_SYSTEM_VOLUME_PATH [REPEAT_INTERVAL]
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host02 ~]# ceph fs snap-schedule deactivate /cephfs 1d
    Copy to Clipboard Toggle word wrap

    この例では、/cephfs パスの日次のスナップショットを非アクティブ化して、それ以降のスナップショットの作成を一時停止します。

このセクションでは、Ceph ファイルシステム (CephFS) サブボリュームのスナップショットスケジュールを手動で非アクティブに設定する手順を説明します。このアクションにより、スナップショットは再びアクティブ化されるまでスケジュールから除外されます。

前提条件

  • Ceph File System (CephFS) がデプロイされた稼働中の Red Hat Ceph Storage クラスター。
  • Ceph Monitor での少なくとも読み取りアクセス。
  • Ceph Manager ノードの読み取りおよび書き込み機能。
  • スナップショットスケジュールが作成され、アクティブな状態になっています。

手順

  • CephFS サブボリューム内のディレクトリーのスナップショットスケジュールを非アクティブ化します。

    構文

    ceph fs snap-schedule deactivate SUBVOL_DIR_PATH [REPEAT_INTERVAL]
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host02 ~]# ceph fs snap-schedule deactivate /volumes/_nogroup/subvol_1/85a615da-e8fa-46c1-afc3-0eb8ae64a954/.. 1d
    Copy to Clipboard Toggle word wrap

    この例では、/volumes/_nogroup/subvol_1/85a615da-e8fa-46c1-afc3-0eb8ae64a954/.. パスの日次スナップショットを非アクティブ化し、それ以降のスナップショットの作成を一時停止します。

  • デフォルトグループのサブボリュームに対して作成されたスナップショットスケジュールを非アクティブ化します。

    構文

    ceph fs snap-schedule deactivate / REPEAT_INTERVAL --fs CEPH_FILE_SYSTEM_NAME --subvol SUBVOLUME_NAME
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host02 ~]# ceph fs snap-schedule deactivate / --fs cephfs --subvol sv_sched
Schedule deactivated for path /volumes/subvolgroup_cg/sv_sched/e704342a-ff07-4763-bb0b-a46d9dda6f27/..
    Copy to Clipboard Toggle word wrap

    重要

    パス (/) を定義する必要があり、空のままにすることはできません。パス文字列の値には依存関係がないため、/、-、または /…​ として定義できます。

  • デフォルト以外のグループのサブボリュームに対して作成されたスナップショットスケジュールを非アクティブ化します。

    構文

    ceph fs snap-schedule deactivate / REPEAT_INTERVAL --fs CEPH_FILE_SYSTEM_NAME --subvol SUBVOLUME_NAME --group NON-DEFAULT_GROUP_NAME
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host02 ~]# ceph fs snap-schedule deactivate / --fs cephfs --subvol sv_sched --group subvolgroup_cg
Schedule deactivated for path /volumes/subvolgroup_cg/sv_sched/e704342a-ff07-4763-bb0b-a46d9dda6f27/..
    Copy to Clipboard Toggle word wrap

    重要

    パス (/) を定義する必要があり、空のままにすることはできません。パス文字列の値には依存関係がないため、/、-、または /…​ として定義できます。

10.8. Ceph ファイルシステムのスナップショットスケジュールの削除
リンクのコピー

このセクションでは、Ceph ファイルシステム (CephFS) のスナップショットスケジュールを削除する手順を説明します。

前提条件

  • Ceph File System (CephFS) がデプロイされた稼働中の Red Hat Ceph Storage クラスター。
  • Ceph Monitor での少なくとも読み取りアクセス。
  • Ceph Manager ノードの読み取りおよび書き込み機能。
  • スナップショットスケジュールが作成されます。

手順

  1. 特定のスナップショットスケジュールを削除します。

    構文

    ceph fs snap-schedule remove FILE_SYSTEM_VOLUME_PATH [REPEAT_INTERVAL] [START_TIME]
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host02 ~]# ceph fs snap-schedule remove /cephfs 4h 2022-05-16T14:00:00
    Copy to Clipboard Toggle word wrap

    この例では、4 時間ごとにスナップショットを作成し、2022 年 5 月 16 日午後 2:00 に開始する、/cephfs ボリュームの特定のスナップショットスケジュールを削除します。

  2. 特定の CephFS ボリュームパスのすべてのスナップショットスケジュールを削除します。

    構文

    ceph fs snap-schedule remove FILE_SYSTEM_VOLUME_PATH
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host02 ~]# ceph fs snap-schedule remove /cephfs
    Copy to Clipboard Toggle word wrap

    この例では、/cephfs ボリュームパスのすべてのスナップショットスケジュールを削除します。

10.9. Ceph ファイルシステムサブボリュームのスナップショットスケジュールの削除
リンクのコピー

このセクションでは、Ceph ファイルシステム (CephFS) サブボリュームのスナップショットスケジュールを削除する手順を説明します。

前提条件

  • Ceph File System (CephFS) がデプロイされた稼働中の Red Hat Ceph Storage クラスター。
  • Ceph Monitor での少なくとも読み取りアクセス。
  • Ceph Manager ノードの読み取りおよび書き込み機能。
  • スナップショットスケジュールが作成されます。

手順

  • CephFS サブボリューム内のディレクトリーに対して作成された特定のスナップショットスケジュールを削除します。

    構文

    ceph fs snap-schedule remove SUBVOL_DIR_PATH [REPEAT_INTERVAL] [START_TIME]
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host02 ~]# ceph fs snap-schedule remove /volumes/_nogroup/subvol_1/85a615da-e8fa-46c1-afc3-0eb8ae64a954/.. 4h 2022-05-16T14:00:00
    Copy to Clipboard Toggle word wrap

    この例では、2022 年 5 月 16 日午後 2:00 に開始する、4 時間ごとにスナップショットを作成する /volumes/_nogroup/subvol_1/85a615da-e8fa-46c1-afc3-0eb8ae64a954/.. ボリュームの特定のスナップショットスケジュールを削除します。

  • デフォルトグループ内のサブボリュームに対して作成された特定のスナップショットスケジュールを削除します。

    構文

    ceph fs snap-schedule remove / --fs CEPH_FILESYSTEM_NAME --subvol SUBVOLUME_NAME
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host02 ~]# ceph fs snap-schedule remove / --fs cephfs --subvol sv_sched
Schedule removed for path /volumes/subvolgroup_cg/sv_sched/e704342a-ff07-4763-bb0b-a46d9dda6f27/..
    Copy to Clipboard Toggle word wrap

    重要

    パス (/) を定義する必要があり、空のままにすることはできません。パス文字列の値には依存関係がないため、/、-、または /…​ として定義できます。

  • デフォルト以外のグループ内のサブボリュームに対して作成された特定のスナップショットスケジュールを削除します。

    構文

    ceph fs snap-schedule remove / --fs CEPH_FILESYSTEM_NAME --subvol SUBVOLUME_NAME --group NON-DEFAULT_GROUP_NAME
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host02 ~]# ceph fs snap-schedule remove / --fs cephfs --subvol sv_sched --group subvolgroup_cg
Schedule removed for path /volumes/subvolgroup_cg/sv_sched/e704342a-ff07-4763-bb0b-a46d9dda6f27/..
    Copy to Clipboard Toggle word wrap

    重要

    パス (/) を定義する必要があり、空のままにすることはできません。パス文字列の値には依存関係がないため、/、-、または /…​ として定義できます。

10.10. Ceph ファイルシステムのスナップショットスケジュール保持ポリシーの削除
リンクのコピー

このセクションでは、Ceph ファイルシステム (CephFS) のスケジュールされたスナップショットの保持ポリシーを削除する手順について説明します。

前提条件

  • Ceph File System (CephFS) がデプロイされた稼働中の Red Hat Ceph Storage クラスター。
  • Ceph Monitor での少なくとも読み取りアクセス。
  • Ceph Manager ノードの読み取りおよび書き込み機能。
  • CephFS ボリュームパス用に作成されたスナップショットスケジュール。

手順

  • CephFS パスの保持ポリシーを削除します。

    構文

    ceph fs snap-schedule retention remove FILE_SYSTEM_VOLUME_PATH [COUNT_TIME_PERIOD_PAIR] TIME_PERIOD COUNT
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host02 ~]# ceph fs snap-schedule retention remove /cephfs h 4
    1 
    
[ceph: root@host02 ~]# ceph fs snap-schedule retention remove /cephfs 14d4w
    2
    Copy to Clipboard Toggle word wrap

    1
    この例では、4 時間のスナップショットを削除します。
    2
    この例では、14 日次とスナップショット 4 週間を削除します。

このセクションでは、Ceph ファイルシステム (CephFS) サブボリュームのスケジュールされたスナップショットの保持ポリシーを削除する手順について説明します。

前提条件

  • Ceph File System (CephFS) がデプロイされた稼働中の Red Hat Ceph Storage クラスター。
  • Ceph Monitor での少なくとも読み取りアクセス。
  • Ceph Manager ノードの読み取りおよび書き込み機能。
  • CephFS サブボリュームパス用に作成されたスナップショットスケジュール。

手順

  • CephFS サブボリューム内のディレクトリーの保持ポリシーを削除します。

    構文

    ceph fs snap-schedule retention remove SUBVOL_DIR_PATH [COUNT_TIME_PERIOD_PAIR] TIME_PERIOD COUNT
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host02 ~]# ceph fs snap-schedule retention remove /volumes/_nogroup/subvol_1/85a615da-e8fa-46c1-afc3-0eb8ae64a954/.. h 4
    1 
    
[ceph: root@host02 ~]# ceph fs snap-schedule retention remove /volumes/_nogroup/subvol_1/85a615da-e8fa-46c1-afc3-0eb8ae64a954/.. 14d4w
    2
    Copy to Clipboard Toggle word wrap

    1
    この例では、4 時間のスナップショットを削除します。
    2
    この例では、14 日次とスナップショット 4 週間を削除します。

  • デフォルトグループ内のサブボリュームのスナップショットスケジュールで作成された保持ポリシーを削除します。

    構文

    ceph fs snap-schedule retention remove / TIME_PERIOD_PAIR TIME_PERIOD COUNT --fs CEPH_FILESYSTEM_NAME --subvol SUBVOLUME_NAME
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host02 ~]# ceph fs snap-schedule retention remove / 5h --fs cephfs --subvol sv_sched --group subvolgroup_cg
Retention removed from path /volumes/subvolgroup_cg/sv_sched/e704342a-ff07-4763-bb0b-a46d9dda6f27/..
    Copy to Clipboard Toggle word wrap

    重要

    パス (/) を定義する必要があり、空のままにすることはできません。パス文字列の値には依存関係がないため、/、-、または /…​ として定義できます。

  • デフォルト以外のグループのサブボリュームのスナップショットスケジュールで作成された保持ポリシーを削除します。

    構文

    ceph fs snap-schedule retention remove / TIME_PERIOD_PAIR TIME_PERIOD COUNT --fs CEPH_FILESYSTEM_NAME --subvol SUBVOLUME_NAME --group NON-DEFAULT_GROUP_NAME
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host02 ~]# ceph fs snap-schedule retention remove / 5h --fs cephfs --subvol sv_sched --group subvolgroup_cg
Retention removed from path /volumes/subvolgroup_cg/sv_sched/e704342a-ff07-4763-bb0b-a46d9dda6f27/..
    Copy to Clipboard Toggle word wrap

    重要

    パス (/) を定義する必要があり、空のままにすることはできません。パス文字列の値には依存関係がないため、/、-、または /…​ として定義できます。

第11章 Ceph File System スナップショットのミラーリング
リンクのコピー

ストレージ管理者は、別の Red Hat Ceph Storage クラスターのリモート Ceph File System に Ceph File System (CephFS) を複製できます。

前提条件

  • ソースおよびターゲットストレージクラスターは、Red Hat Ceph Storage 6.0 以降を実行している必要があります。

Ceph File System (CephFS) は、別の Red Hat Ceph Storage クラスター上のリモート CephFS へのスナップショットの非同期レプリケーションをサポートします。スナップショットの同期は、スナップショットデータをリモートの Ceph ファイルシステムにコピーし、同じ名前のリモートターゲットに新しいスナップショットを作成します。スナップショット同期用に特定のディレクトリーを設定できます。

CephFS スナップショットミラーリングの管理は、CephFS ミラーリングデーモン (cephfs-mirror) によって行われます。このスナップショットデータは、リモートの CephFS への一括コピーを実行することで同期されます。スナップショットのペアの同期順序は、snap-id を使用して作成時に決定されます。

重要

ハードリンクの同期はサポートされていません。ハードリンクされたファイルは、通常のファイルとして同期されます。

CephFS スナップショットのミラーリングには、スナップショットインカーネーションや高可用性などの機能が含まれます。これらは、推奨される制御インターフェイスである Ceph Manager mirroring モジュールを介して管理できます。

Ceph Manager モジュールとインターフェイス

Ceph Manager mirroring モジュールは、デフォルトでは無効になっています。ディレクトリースナップショットのミラーリングを管理するためのインターフェイスを提供します。Ceph Manager インターフェイスは、ほとんどの場合、CephFS ミラーリングを管理するためのモニターコマンドのラッパーです。これらは、推奨される制御インターフェイスです。

Ceph Manager mirroring モジュールは、Ceph Manager プラグインとして実装されます。これは、Synchronization のためにディレクトリーを cephfs-mirror デーモンに割り当てるロールを果たします。

Ceph Manager の mirroring モジュールは、ディレクトリースナップショットのミラーリングを制御するコマンドのファミリーも提供します。mirroring モジュールは、cephfs-mirror デーモンを管理しません。cephfs-mirror デーモンの停止、起動、再起動、および有効化は systemctl によって制御されますが、cephadm によって管理されます。

注記

ミラーリングモジュールコマンドは、fs mirror 接頭辞を使用する監視コマンドと比較して、fs snapshot mirror 接頭辞を使用します。module コマンド接頭辞を使用して、ディレクトリースナップショットのミラーリングを制御していることを確認してください。

スナップショットの再生成

スナップショットが削除され、同じ名前で異なる内容で再作成される場合があります。ユーザーは以前に "古い" スナップショットを同期し、ミラーリングが無効になったときにスナップショットを再作成できました。スナップショット名を使用して継続点を推測すると、"新しい" スナップショットが生成され、同期のために取得されることはありません。

セカンダリーファイルシステムのスナップショットには、同期元のスナップショットのスナップ ID が格納されます。このメタデータは、Ceph メタデータサーバーの SnapInfo 構造に保存されます。

高可用性

複数の cephfs-mirror デーモンを 2 つ以上のノードにデプロイして、ディレクトリースナップショットの同期で同時実行を実現できます。cephfs-mirror デーモンがデプロイまたは終了されると、Ceph Manager mirroring モジュールは変更された cephfs-mirror デーモンのセットを検出し、新しいセット間でディレクトリーの割り当てを再調整して、高可用性を提供します。

cephfs-mirror デーモンは、単純な M/N ポリシーを使用して同期負荷を共有します。ここで、M はディレクトリーの数、N は cephfs-mirror デーモンの数です。

Ceph File System ミラーピアの再追加

別のクラスター内の CephFS にピアを再追加または再割り当てする場合は、すべてのミラーデーモンがピアへの同期を停止していることを確認してください。これは、fs mirror status コマンドを使用して確認できます。ピア UUID はコマンド出力に表示されません。

別の CephFS に再追加する前に、同期されたディレクトリーをピアからパージします。特に、新しいプライマリーファイルシステムに存在する可能性のあるディレクトリーを削除します。以前に同期した同じプライマリーファイルシステムにピアを再度追加する場合、これは必要ありません。

11.1. Ceph ファイルシステムのスナップショットミラーの設定
リンクのコピー

Ceph File System (CephFS) を設定して、リモートの Red Hat Ceph Storage クラスターの別の CephFS にスナップショットを複製するようにミラーリングできます。

注記

リモートストレージクラスターへの同期にかかる時間は、ファイルのサイズとミラーリングパス内のファイルの合計数によって異なります。

前提条件

  • ソースおよびターゲットストレージクラスターは、Red Hat Ceph Storage 7.0 以降を実行していて正常である必要があります。
  • ソースおよびターゲットストレージクラスターの Ceph Monitor ノードへのルートレベルのアクセス。
  • ストレージクラスターにデプロイされた少なくとも 1 つの Ceph ファイルシステム。

手順

  1. Cephadm シェルにログインします。

    例

    [root@host01 ~]# cephadm shell
    Copy to Clipboard Toggle word wrap

  2. ソースストレージクラスターで、CephFS ミラーリングデーモンをデプロイします。

    構文

    ceph orch apply cephfs-mirror ["NODE_NAME"]
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph orch apply cephfs-mirror "node1.example.com"
Scheduled cephfs-mirror update...
    Copy to Clipboard Toggle word wrap

    このコマンドにより、cephfs-mirror という名前の Ceph ユーザーが作成され、特定のノードに cephfs-mirror デーモンがデプロイされます。

    1. オプション: 複数の CephFS ミラーリングデーモンをデプロイし、高可用性を実現します。

      構文

      ceph orch apply cephfs-mirror --placement="PLACEMENT_SPECIFICATION"
      Copy to Clipboard Toggle word wrap

      例

      [ceph: root@host01 /]# ceph orch apply cephfs-mirror --placement="3 host1 host2 host3"
Scheduled cephfs-mirror update...
      Copy to Clipboard Toggle word wrap

      この例では、3 つの cephfs-mirror デーモンを異なるホストにデプロイします。

      警告

      次のエラーが発生するため、ホストをコンマで区切らないでください。 

      Error EINVAL: name component must include only a-z, 0-9, and -
      Copy to Clipboard Toggle word wrap

  3. ターゲットストレージクラスターで、それぞれの CephFS ピア用にユーザーを作成します。

    構文

    ceph fs authorize FILE_SYSTEM_NAME CLIENT_NAME / rwps
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph fs authorize cephfs client.mirror_remote / rwps
[client.mirror_remote]
        key = AQCjZ5Jg739AAxAAxduIKoTZbiFJ0lgose8luQ==
    Copy to Clipboard Toggle word wrap

  4. ソースストレージクラスターで、CephFS ミラーリングモジュールを有効にします。

    例

    [ceph: root@host01 /]# ceph mgr module enable mirroring
    Copy to Clipboard Toggle word wrap

  5. ソースストレージクラスターで、Ceph File System でミラーリングを有効にします。

    構文

    ceph fs snapshot mirror enable FILE_SYSTEM_NAME
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph fs snapshot mirror enable cephfs
    Copy to Clipboard Toggle word wrap

    1. オプション: スナップショットミラーリングを無効にします。

      構文

      ceph fs snapshot mirror disable FILE_SYSTEM_NAME
      Copy to Clipboard Toggle word wrap

      例

      [ceph: root@host01 /]# ceph fs snapshot mirror disable cephfs
      Copy to Clipboard Toggle word wrap

      警告

      ファイルシステムでスナップショットミラーリングを無効にすると、設定されたピアが削除されます。ピアをブートストラップして再度インポートする必要があります。

  6. ターゲットピアストレージクラスターを準備します。

    1. ターゲットノードで、mirroring Ceph Manager モジュールを有効にします。

      例

      [ceph: root@host01 /]# ceph mgr module enable mirroring
      Copy to Clipboard Toggle word wrap

    2. 同じターゲットノードで、ピアブートストラップを作成します。

      構文

      ceph fs snapshot mirror peer_bootstrap create FILE_SYSTEM_NAME CLIENT_NAME SITE_NAME
      Copy to Clipboard Toggle word wrap

      SITE_NAME は、ターゲットのストレージクラスターを識別するユーザー定義の文字列です。

      例

      [ceph: root@host01 /]# ceph fs snapshot mirror peer_bootstrap create cephfs client.mirror_remote remote-site
{"token": "eyJmc2lkIjogIjBkZjE3MjE3LWRmY2QtNDAzMC05MDc5LTM2Nzk4NTVkNDJlZiIsICJmaWxlc3lzdGVtIjogImJhY2t1cF9mcyIsICJ1c2VyIjogImNsaWVudC5taXJyb3JfcGVlcl9ib290c3RyYXAiLCAic2l0ZV9uYW1lIjogInNpdGUtcmVtb3RlIiwgImtleSI6ICJBUUFhcDBCZ0xtRmpOeEFBVnNyZXozai9YYUV0T2UrbUJEZlJDZz09IiwgIm1vbl9ob3N0IjogIlt2MjoxOTIuMTY4LjAuNTo0MDkxOCx2MToxOTIuMTY4LjAuNTo0MDkxOV0ifQ=="}
      Copy to Clipboard Toggle word wrap

      次の手順で使用する二重引用符の間のトークン文字列をコピーします。

  7. ソースストレージクラスターで、ターゲットストレージクラスターからブートストラップトークンをインポートします。

    構文

    ceph fs snapshot mirror peer_bootstrap import FILE_SYSTEM_NAME TOKEN
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph fs snapshot mirror peer_bootstrap import cephfs eyJmc2lkIjogIjBkZjE3MjE3LWRmY2QtNDAzMC05MDc5LTM2Nzk4NTVkNDJlZiIsICJmaWxlc3lzdGVtIjogImJhY2t1cF9mcyIsICJ1c2VyIjogImNsaWVudC5taXJyb3JfcGVlcl9ib290c3RyYXAiLCAic2l0ZV9uYW1lIjogInNpdGUtcmVtb3RlIiwgImtleSI6ICJBUUFhcDBCZ0xtRmpOeEFBVnNyZXozai9YYUV0T2UrbUJEZlJDZz09IiwgIm1vbl9ob3N0IjogIlt2MjoxOTIuMTY4LjAuNTo0MDkxOCx2MToxOTIuMTY4LjAuNTo0MDkxOV0ifQ==
    Copy to Clipboard Toggle word wrap

  8. ソースストレージクラスターで、CephFS ミラーピアをリスト表示します。

    構文

    ceph fs snapshot mirror peer_list FILE_SYSTEM_NAME
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph fs snapshot mirror peer_list cephfs
{"e5ecb883-097d-492d-b026-a585d1d7da79": {"client_name": "client.mirror_remote", "site_name": "remote-site", "fs_name": "cephfs", "mon_host": "[v2:10.0.211.54:3300/0,v1:10.0.211.54:6789/0] [v2:10.0.210.56:3300/0,v1:10.0.210.56:6789/0] [v2:10.0.210.65:3300/0,v1:10.0.210.65:6789/0]"}}
    Copy to Clipboard Toggle word wrap

    1. オプション: スナップショットピアを削除します。

      構文

      ceph fs snapshot mirror peer_remove FILE_SYSTEM_NAME PEER_UUID
      Copy to Clipboard Toggle word wrap

      例

      [ceph: root@host01 /]# ceph fs snapshot mirror peer_remove cephfs e5ecb883-097d-492d-b026-a585d1d7da79
      Copy to Clipboard Toggle word wrap

      注記

      ピア UUID 値を見つける方法は、Ceph ファイルシステムのミラーステータスの表示 を参照してください。

  9. ソースストレージクラスターで、スナップショットミラーリングのディレクトリーを設定します。

    構文

    ceph fs snapshot mirror add FILE_SYSTEM_NAME PATH
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph fs snapshot mirror add cephfs /volumes/_nogroup/subvol_1
    Copy to Clipboard Toggle word wrap

    重要

    Ceph ファイルシステム内の絶対パスのみが有効です。

    注記

    Ceph Manager の mirroring モジュールは、パスを正規化します。たとえば、/d1/d2/../dN ディレクトリーは /d1/d2 と同等です。ミラーリング用にディレクトリーが追加されると、その上位ディレクトリーおよびサブディレクトリーがミラーリング用に追加されなくなります。

    1. オプション: ディレクトリーのスナップショットミラーリングを停止します。

      構文

      ceph fs snapshot mirror remove FILE_SYSTEM_NAME PATH
      Copy to Clipboard Toggle word wrap

      例

      [ceph: root@host01 /]# ceph fs snapshot mirror remove cephfs /home/user1
      Copy to Clipboard Toggle word wrap

11.2. Ceph File システムのミラーステータスの表示
リンクのコピー

Ceph File System (CephFS) ミラーデーモン (cephfs-mirror) は、CephFS ミラーリングステータスの変更に関する非同期通知とピアの更新と共に行われます。CephFS ミラーリングモジュールは、ミラーデーモンのステータスを確認するためのミラーデーモンステータスインターフェイスを提供します。詳細については、コマンドを使用して cephfs-mirror 管理ソケットにクエリーを実行し、ミラーのステータスとピアのステータスを取得できます。

前提条件

  • 稼働中の Red Hat Ceph Storage クラスターがある。
  • ミラーリングが有効にされている Ceph File System のデプロイメントを少なくとも 1 つ。
  • CephFS ミラーリングデーモンを実行するノードへのルートレベルのアクセス。

手順

  1. Cephadm シェルにログインします。

    例

    [root@host01 ~]# cephadm shell
    Copy to Clipboard Toggle word wrap

  2. cephfs-mirror デーモンのステータスを確認します。

    構文

    ceph fs snapshot mirror daemon status
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph fs snapshot mirror daemon status
[
  {
    "daemon_id": 15594,
    "filesystems": [
      {
        "filesystem_id": 1,
        "name": "cephfs",
        "directory_count": 1,
        "peers": [
          {
            "uuid": "e5ecb883-097d-492d-b026-a585d1d7da79",
            "remote": {
              "client_name": "client.mirror_remote",
              "cluster_name": "remote-site",
              "fs_name": "cephfs"
            },
            "stats": {
              "failure_count": 1,
              "recovery_count": 0
            }
          }
        ]
      }
    ]
  }
]
    Copy to Clipboard Toggle word wrap

    詳細については、以下で説明する管理ソケットインターフェイスを使用してください。

  3. CephFS ミラーリングデーモンを実行しているノードで Ceph File System ID を見つけます。

    構文

    ceph --admin-daemon PATH_TO_THE_ASOK_FILE help
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph --admin-daemon /var/run/ceph/1011435c-9e30-4db6-b720-5bf482006e0e/ceph-client.cephfs-mirror.node1.bndvox.asok help
{
    ...
    "fs mirror peer status cephfs@11 1011435c-9e30-4db6-b720-5bf482006e0e": "get peer mirror status",
    "fs mirror status cephfs@11": "get filesystem mirror status",
    ...
}
    Copy to Clipboard Toggle word wrap

    この例の Ceph File System ID は cephfs@11 です。

    注記

    ミラーリングが無効になっている場合、ファイルシステムのそれぞれの fs mirror status コマンドは、help コマンドに表示されません。

  4. ミラーステータスを表示します。

    構文

    ceph --admin-daemon PATH_TO_THE_ASOK_FILE fs mirror status FILE_SYSTEM_NAME@_FILE_SYSTEM_ID
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph --admin-daemon /var/run/ceph/1011435c-9e30-4db6-b720-5bf482006e0e/ceph-client.cephfs-mirror.node1.bndvox.asok fs mirror status cephfs@11
{
  "rados_inst": "192.168.0.5:0/1476644347",
  "peers": {
      "1011435c-9e30-4db6-b720-5bf482006e0e": {
    1 
    
          "remote": {
              "client_name": "client.mirror_remote",
              "cluster_name": "remote-site",
              "fs_name": "cephfs"
          }
      }
  },
  "snap_dirs": {
      "dir_count": 1
  }
}
    Copy to Clipboard Toggle word wrap

    1
    これは、固有のピア UUID です。

  5. ピアステータスを表示します。

    構文

    ceph --admin-daemon PATH_TO_ADMIN_SOCKET fs mirror status FILE_SYSTEM_NAME@FILE_SYSTEM_ID PEER_UUID
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph --admin-daemon /var/run/ceph/cephfs-mirror.asok fs mirror peer status cephfs@11 1011435c-9e30-4db6-b720-5bf482006e0e
{
  "/home/user1": {
      "state": "idle",
    1 
    
      "last_synced_snap": {
          "id": 120,
          "name": "snap1",
          "sync_duration": 0.079997898999999997,
          "sync_time_stamp": "274900.558797s"
      },
      "snaps_synced": 2,
    2 
    
      "snaps_deleted": 0,
    3 
    
      "snaps_renamed": 0
  }
}
    Copy to Clipboard Toggle word wrap

    state は、以下の 3 つの値のいずれかになります。

    1
    idle は、ディレクトリーが現在同期していないことを意味します。
    2
    syncing とは、ディレクトリーが現在同期中であることを意味します。
    3
    failed の原因は、ディレクトリーが連続した失敗の上限に達したことを意味します。

連続する失敗のデフォルト数は 10 で、デフォルトの再試行間隔は 60 秒です。

  1. cephfs-mirror デーモンがマップされているディレクトリーを表示します。

    構文

    ceph fs snapshot mirror dirmap FILE_SYSTEM_NAME PATH
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@host01 /]# ceph fs snapshot mirror dirmap cephfs /volumes/_nogroup/subvol_1
{
  "instance_id": "25184",
    1 
    
  "last_shuffled": 1661162007.012663,
  "state": "mapped"
}
    Copy to Clipboard Toggle word wrap

    1
    instance_id は、cephfs-mirror デーモンに関連付けられた RADOS インスタンス ID です。

    例

    [ceph: root@host01 /]# ceph fs snapshot mirror dirmap cephfs /volumes/_nogroup/subvol_1
{
  "reason": "no mirror daemons running",
  "state": "stalled"
    1 
    
}
    Copy to Clipboard Toggle word wrap

    1
    stalled 状態は、CephFS ミラーリングが停止していることを意味します。

    2 番目の例は、ミラーデーモンが実行されていないときのコマンド出力を示しています。

11.3. Ceph File System スナップショットミラーリングのメトリクスを表示する
リンクのコピー

これらのメトリクスを表示すると、パフォーマンスと同期の進行状況を監視するのに役立ちます。カウンターダンプを使用して、Ceph File System スナップショットミラーの健全性とボリュームメトリクスを確認します。

前提条件

  • 実行中の IBM Storage Ceph クラスター。
  • Ceph File System スナップショットミラーリングのデプロイメントが、少なくとも 1 つ有効になっている。
  • Ceph File System ミラーリングデーモンを実行しているノードへのルートレベルのアクセス。

手順

  1. asok ファイルの名前を取得します。asok ファイルはミラーリングデーモンが実行されている場所で使用でき、cephadm シェル内の /var/run/ceph/ に配置されています。

  2. CephFS ミラーリングデーモンを実行しているノードで次のコマンドを実行して、ミラーリングメトリクスと同期ステータスを確認します。

    構文

    [ceph: root@mirror-host01 /]# ceph --admin-daemon ASOK_FILE_NAME counter dump
    Copy to Clipboard Toggle word wrap

    例

    [ceph: root@mirror-host01 /]# ceph --admin-daemon ceph-client.cephfs-mirror.ceph1-hk-n-0mfqao-node7.pnbrlu.2.93909288073464.asok counter dump

[
  {
    "key": "cephfs_mirror",
    "value": [
      {
        "labels": {},
        "counters": {
          "mirrored_filesystems": 1,
          "mirror_enable_failures": 0
        }
      }
    ]
  },
  {
    "key": "cephfs_mirror_mirrored_filesystems",
    "value": [
      {
        "labels": {
          "filesystem": "cephfs"
        },
        "counters": {
          "mirroring_peers": 1,
          "directory_count": 1
        }
      }
    ]
  },
  {
    "key": "cephfs_mirror_peers",
    "value": [
      {
        "labels": {
          "peer_cluster_filesystem": "cephfs",
          "peer_cluster_name": "remote_site",
          "source_filesystem": "cephfs",
          "source_fscid": "1"
        },
        "counters": {
          "snaps_synced": 1,
          "snaps_deleted": 0,
          "snaps_renamed": 0,
          "sync_failures": 0,
          "avg_sync_time": {
            "avgcount": 1,
            "sum": 4.216959457,
            "avgtime": 4.216959457
          },
          "sync_bytes": 132
        }
      }
    ]
  }
]
    Copy to Clipboard Toggle word wrap

メトリクスの説明:

Labeled Perf Counters は、OCP および ACM ダッシュボードやその他の場所での地理的レプリケーションを監視するための、OCP/ODF ダッシュボードで使用できるメトリクスを生成します。

これにより、cephfs_mirror 同期の進行状況が生成され、監視機能が提供されます。エクスポートされたメトリクスにより、次のアラートに基づく監視が可能になります。

mirroring_peers
ミラーリングに関与するピアの数。
directory_count
同期されているディレクトリーの総数。
mirrored_filesystems
ミラーリングされているファイルシステムの総数。
mirror_enable_failures
ミラーリングの失敗を有効にします。
snaps_synced
正常に同期されたスナップショットの総数。
sync_bytes
同期されている合計バイト数。
sync_failures
失敗したスナップショット同期の総数。
snaps_deleted
削除されたスナップショットの総数。
snaps_renamed
名前が変更されたスナップショットの総数。
avg_synced_time
すべてのスナップショット同期にかかる平均時間。
last_synced_start
最後に同期されたスナップショットの同期開始時刻。
last_synced_end
最後に同期されたスナップショットの同期終了時刻。
last_synced_duration
最後の同期の期間。
last_synced_bytes
最後に同期されたスナップショットで同期された合計バイト数。

付録A Ceph File System のヘルスメッセージ
リンクのコピー

クラスターのヘルスチェック

Ceph Monitor デーモンは、メタデータサーバー (MDS) の特定の状態に応じてヘルスメッセージを生成します。以下は、ヘルスメッセージとその説明です。

mds rank(s) <ranks> have failed
現在、1 つ以上の MDS ランクが MDS デーモンに割り当てられていません。ストレージクラスターは、適切な置き換えデーモンが開始するまで回復しません。
mds rank(s) <ranks> are damaged
MDS ランクク 1 つまたは複数で、保存されたメタデータに重大な破損が生じ、メタデータが修復されるまで再度起動できません。
MDS クラスターが動作が低下しています。
現在、MDS のランク 1 つ以上が稼働していないため、この状況が解決されるまで、クライアントはメタデータ I/O を一時停止する可能性があります。これには、実行に失敗したか、破損したランクが含まれます。また、MDS で実行していても active 状態でないランクも含まれます (例: replay 状態)。
mds <names> are laggy
MDS デーモンは、mds_beacon_interval オプションで指定した間隔で、監視にメッセージを送る必要があり、デフォルトは 4 秒です。MDS デーモンが、mds_beacon_grace オプションで指定された時間内にメッセージ送信に失敗した場合、デフォルトは 15 秒です。Ceph Monitor は MDS デーモンに laggy とマークし、利用可能な場合には自動的にスタンバイデーモンに置き換えます。

デーモンでレポートされたヘルスチェック

MDS デーモンは、さまざまな不要な状況を特定し、それらを ceph status コマンドの出力で返すことができます。これらの条件には人が判読できるメッセージがあり、JSON の出力に表示される MDS_HEALTH を開始するための一意のコードもあります。以下は、デーモンメッセージ、それらのコード、および説明のリストです。

"Behind on trimming…​"

コード: MDS_HEALTH_TRIM

CephFS は、ログセグメントに分割されるメタデータジャーナルを維持します。ジャーナルの長さ (セグメント数) は、mds_log_max_segments 設定で制御されます。セグメントの数が設定を超えた場合、MDS はメタデータの書き込みを開始し、最も古いセグメントを削除 (トリミング) できるようにします。このプロセスの速度が遅い場合や、ソフトウェアのバグがトリミングされると、この健全性メッセージが表示されます。このメッセージに表示されるしきい値は、セグメントの数が double mds_log_max_segments となるものです。

注記

トリム警告が発生した場合は、mds_log_max_segments を増やすことを推奨します。ただし、クラスターの健全性が回復し、トリム警告が表示されなくなったら、必ずこの設定をデフォルトにリセットしてください。MDS がトリミングに追いつくことができるように、mds_log_max_segments を 256 に設定することを推奨します。

"Client <name> failing to respond to capability release"

コード: MDS_HEALTH_CLIENT_LATE_RELEASE, MDS_HEALTH_CLIENT_LATE_RELEASE_MANY

CephFS クライアントは、MDS により機能が発行されます。この機能はロックのように機能します。たとえば、別のクライアントがアクセスする必要がある場合、MDS はクライアントに対してその機能を解放するよう要求します。クライアントが応答しない場合は、プロンプトが表示されたら、またはこれをまったく使用できない可能性があります。このメッセージは、クライアントが mds_revoke_cap_timeout オプションで指定された時間 (デフォルトは 60 秒) に準拠するために時間がかかる場合に表示されます。

"Client <name> failing to respond to cache pressure"

コード: MDS_HEALTH_CLIENT_RECALL, MDS_HEALTH_CLIENT_RECALL_MANY

クライアントはメタデータキャッシュを維持します。クライアントキャッシュ内の inode などの項目は、MDS キャッシュでも固定されます。MDS がキャッシュサイズの制限内に留まるように MDS を縮小する必要がある場合、MDS はメッセージをクライアントに送信してキャッシュを縮小します。クライアントが応答しない場合は、MDS がキャッシュサイズ内に適切に残らないようにすることができます。また、MDS は最終的にメモリーを使い果たし、予期せずに終了する可能性があります。このメッセージは、クライアントが mds_recall_state_timeout オプションで指定された時間 (デフォルトは 60 秒) に準拠するために時間がかかる場合に表示されます。詳細は、Metadata Server キャッシュサイズの制限 のセクションを参照してください。

"Client name failing to advance its oldest client/flush tid"

コード: MDS_HEALTH_CLIENT_OLDEST_TID, MDS_HEALTH_CLIENT_OLDEST_TID_MANY

クライアントと MDS サーバー間で通信するための CephFS プロトコルは、oldest tid というフィールドを使用して、MDS が対応するためにクライアント要求が完全に完了している MDS に通知するものです。反応しないクライアントがこのフィールドを進めない場合、MDS はクライアント要求によって使用されるリソースを適切にクリーンアップできなくなる可能性があります。このメッセージは、クライアントが max_completed_requests オプション (デフォルトは 100000) で指定された数値よりも多くのリクエストがある場合に表示されます。これは、MDS 側では完全でも、クライアントの 最も古い tid 値について考慮されていないことを示しています。

"Metadata damage detected"

コード: MDS_HEALTH_DAMAGE

メタデータプールから読み取り時に、破損したメタデータまたは欠落しているメタデータが見つかりました。このメッセージは、MDS が動作を継続するために十分な破損した分離されたことを示しています。ただし、クライアントが破損したサブツリーへのアクセスにより I/O エラーが返されることを示します。damage ls administration socket コマンドを使用して、破損の詳細を表示します。このメッセージは、破損が発生するとすぐに表示されます。

"MDS in read-only mode"

Code: MDS_HEALTH_READ_ONLY

MDS は読み取り専用モードに入力されており、メタデータの変更を試みるクライアント操作に EROFS エラーコードを返します。MDS は読み取り専用モードに入ります。

  • メタデータプールへの書き込み中に書き込みエラーが発生した場合
  • force_readonly 管理ソケットコマンドを使用して、管理者が MDS を読み取り専用モードに強制するとき。
"<N> slow requests are blocked"

コード: MDS_HEALTH_SLOW_REQUEST

1 つ以上のクライアント要求が完了しておらず、MDS が非常に遅いか、バグが発生したことを示しています。ops 管理ソケットコマンドを使用して、未処理のメタデータ操作をリスト表示します。このメッセージは、クライアントの要求が mds_op_complaint_time オプションで指定した値よりも時間がかかる場合に表示されます (デフォルトは 30 秒)。

"Too many inodes in cache"
コード: MDS_HEALTH_CACHE_OVERSIZED

MDS は、管理者が設定した制限に準拠するためにキャッシュをトリミングできませんでした。MDS キャッシュが大きすぎると、デーモンは利用可能なメモリーを使い切ったり、予期せずに終了する可能性があります。デフォルトでは、MDS キャッシュサイズが制限よりも 50% を超えると、このメッセージが表示されます。

関連情報

付録B Metadata Server デーモン設定リファレンス
リンクのコピー

メタデータサーバー (MDS) デーモンの設定に使用できる、このコマンドリストを参照してください。

mon_force_standby_active
説明
true に設定した場合は、スタンバイ再生モードの MDS を強制的にアクティブにします。Ceph 設定ファイルの [mon] または [global] セクションで設定します。
型
Boolean
デフォルト
true
max_mds
説明
クラスター作成時にアクティブな MDS デーモンの数。Ceph 設定ファイルの [mon] または [global] セクションで設定します。
型
32 ビット整数
デフォルト
1
mds_cache_memory_limit
説明
MDS がキャッシュに強制するメモリー制限。Red Hat は、mds cache size パラメーターの代わりにこのパラメーターを使用することを推奨します。
型
64 ビット整数未署名
デフォルト
4294967296
mds_cache_reservation
説明
MDS キャッシュが維持するキャッシュ予約、メモリー、または inode。この値は、設定された最大キャッシュの割合です。MDS が予約にデップを開始したら、キャッシュサイズが縮小して予約を復元するまで、クライアントの状態をやり直します。
型
浮動小数点 (Float)
デフォルト
0.05
mds_cache_size
説明
キャッシュする inode の数。値が 0 の場合は、無制限の数字を示します。Red Hat は、MDS キャッシュが使用するメモリー量を制限するために mds_cache_memory_limit を使用することを推奨します。
型
32 ビット整数
デフォルト
0
mds_cache_mid
説明
キャッシュ LRU 内の新しい項目の挿入ポイント (トップ)
型
浮動小数点 (Float)
デフォルト
0.7
mds_dir_commit_ratio
説明
部分的な更新ではなく、Ceph が完全な更新を使用してコミットする前に、ディレクトリーの一部に誤った情報が含まれています。
型
浮動小数点 (Float)
デフォルト
0.5
mds_dir_max_commit_size
説明
ディレクトリー更新の最大サイズ (MB 単位)。これを上回ると Ceph がディレクトリーを小規模なトランザクションに分割します。
型
32 ビット整数
デフォルト
90
mds_decay_halflife
説明
MDS キャッシュ温度の半減期。
型
浮動小数点 (Float)
デフォルト
5
mds_beacon_interval
説明
モニターに送信されるメッセージの頻度 (秒単位)。
型
浮動小数点 (Float)
デフォルト
4
mds_beacon_grace
説明
Ceph が MDS laggy を宣言する前に acons がなく、置き換えることができる間隔。
型
浮動小数点 (Float)
デフォルト
15
mds_blacklist_interval
説明
OSD マップの失敗した MDS デーモンのブラックリスト期間。
型
浮動小数点 (Float)
デフォルト
24.0*60.0
mds_session_timeout
説明
Ceph の機能およびリースがタイムアウトするまでのクライアントの非アクティブの間隔 (秒単位)。
型
浮動小数点 (Float)
デフォルト
60
mds_session_autoclose
説明
Ceph が laggy クライアントセッションを閉じるまでの間隔 (秒単位)。
型
浮動小数点 (Float)
デフォルト
300
mds_reconnect_timeout
説明
MDS の再起動時にクライアントが再接続するまで待機する間隔 (秒単位)。
型
浮動小数点 (Float)
デフォルト
45
mds_tick_interval
説明
MDS が内部周期的タスクを実行する頻度。
型
浮動小数点 (Float)
デフォルト
5
mds_dirstat_min_interval
説明
ツリーで再帰的な統計の伝播を回避する最小間隔 (秒単位)。
型
浮動小数点 (Float)
デフォルト
1
mds_scatter_nudge_interval
説明
ディレクトリー統計の急速な変更が反映されます。
型
浮動小数点 (Float)
デフォルト
5
mds_client_prealloc_inos
説明
クライアントセッションごとに事前割り当てする inode 番号の数。
型
32 ビット整数
デフォルト
1000
mds_early_reply
説明
MDS により、クライアントがジャーナルにコミットする前にリクエスト結果を確認できるかどうかを決定します。
型
Boolean
デフォルト
true
mds_use_tmap
説明
ディレクトリーの更新には、trivialmap を使用します。
型
Boolean
デフォルト
true
mds_default_dir_hash
説明
ディレクトリーフラグメント間でファイルをハッシュ化するために使用する関数。
型
32 ビット整数
デフォルト
2、つまり rjenkins
mds_log
説明
MDS がジャーナルメタデータの更新を行う必要がある場合は、true に設定します。ベンチマークのみを無効にします。
型
Boolean
デフォルト
true
mds_log_skip_corrupt_events
説明
MDS がジャーナルの再生中に破損したジャーナルイベントをスキップするかどうかを決定します。
型
Boolean
デフォルト
false
mds_log_max_events
説明
Ceph がトリミングを開始する前に、ジャーナルの最大イベント。制限を無効にするには -1 に設定します。
型
32 ビット整数
デフォルト
-1
mds_log_max_segments
説明
Ceph がトリミングを開始する前に、ジャーナルのセグメントまたはオブジェクトの最大数。制限を無効にするには -1 に設定します。
型
32 ビット整数
デフォルト
30
mds_log_max_expiring
説明
並行して期限切れになるセグメントの最大数。
型
32 ビット整数
デフォルト
20
mds_log_eopen_size
説明
EOpen イベントにおける inode の最大数。
型
32 ビット整数
デフォルト
100
mds_bal_sample_interval
説明
断片化の決定を行うとき、ディレクトリー温度のサンプル頻度を決定します。
型
浮動小数点 (Float)
デフォルト
3
mds_bal_replicate_threshold
説明
Ceph がメタデータを他のノードに複製するまでの最大温度。
型
浮動小数点 (Float)
デフォルト
8000
mds_bal_unreplicate_threshold
説明
Ceph が他のノードへのメタデータの複製を停止する前の最小温度。
型
浮動小数点 (Float)
デフォルト
0
mds_bal_frag
説明
MDS がディレクトリーをフラグメント化するかどうかを決定します。
型
Boolean
デフォルト
false
mds_bal_split_size
説明
MDS がディレクトリーのフラグメントを小規模なビットに分割する前にの最大ディレクトリーサイズ。root ディレクトリーには、デフォルトのフラグメントサイズが 10000 です。
型
32 ビット整数
デフォルト
10000
mds_bal_split_rd
説明
Ceph がディレクトリーのフラグメントを分割するまでの最大ディレクトリー読み取り温度。
型
浮動小数点 (Float)
デフォルト
25000
mds_bal_split_wr
説明
Ceph がディレクトリーのフラグメントを分割するまでの最大ディレクトリー書き込み温度。
型
浮動小数点 (Float)
デフォルト
10000
mds_bal_split_bits
説明
ディレクトリーフラグメントを分割するビット数。
型
32 ビット整数
デフォルト
3
mds_bal_merge_size
説明
Ceph が隣接ディレクトリーフラグメントをマージしようとする前の最小ディレクトリーサイズ。
型
32 ビット整数
デフォルト
50
mds_bal_merge_rd
説明
Ceph が隣接するディレクトリーフラグメントのマージ前の最小限の読み取り温度。
型
浮動小数点 (Float)
デフォルト
1000
mds_bal_merge_wr
説明
Ceph が隣接するディレクトリーのフラグメントをマージする前に最小の書き込み温度。
型
浮動小数点 (Float)
デフォルト
1000
mds_bal_interval
説明
MDS ノード間のワークロード交換の頻度 (秒単位)。
型
32 ビット整数
デフォルト
10
mds_bal_fragment_interval
説明
ディレクトリーの断片化を調整する頻度 (秒単位)。
型
32 ビット整数
デフォルト
5
mds_bal_idle_threshold
説明
Ceph がサブツリーをその親に移行する前の最小温度。
型
浮動小数点 (Float)
デフォルト
0
mds_bal_max
説明
Ceph が停止する前にバランサーを実行する反復数。テストの目的でのみ使用してください。
型
32 ビット整数
デフォルト
-1
mds_bal_max_until
説明
Ceph が停止するまでのバランサーを実行する秒数。テストの目的でのみ使用してください。
型
32 ビット整数
デフォルト
-1
mds_bal_mode
説明

MDS 負荷を計算する方法:

  • 1 = ハイブリッド
  • 2 = リクエストレートとレイテンシー。
  • 3 = CPU 負荷
型
32 ビット整数
デフォルト
0
mds_bal_min_rebalance
説明
Ceph の移行前の最小サブツリーの温度。
型
浮動小数点 (Float)
デフォルト
0.1
mds_bal_min_start
説明
Ceph がサブツリーを検索するまでの最小サブツリーの温度。
型
浮動小数点 (Float)
デフォルト
0.2
mds_bal_need_min
説明
許可するターゲットサブツリーの最小分数。
型
浮動小数点 (Float)
デフォルト
0.8
mds_bal_need_max
説明
許可するターゲットサブツリーサイズの最大分数。
型
浮動小数点 (Float)
デフォルト
1.2
mds_bal_midchunk
説明
Ceph は、ターゲットサブツリーサイズのこの分を超えるサブツリーを移行します。
型
浮動小数点 (Float)
デフォルト
0.3
mds_bal_minchunk
説明
Ceph は、ターゲットサブツリーサイズのこの分よりも小さいサブツリーを無視します。
型
浮動小数点 (Float)
デフォルト
0.001
mds_bal_target_removal_min
説明
Ceph が MDS マップから古い MDS ターゲットを削除する前に、バランサーの反復回数。
型
32 ビット整数
デフォルト
5
mds_bal_target_removal_max
説明
Ceph が MDS マップから古い MDS ターゲットを削除するまでのバランサー反復の最大数。
型
32 ビット整数
デフォルト
10
mds_replay_interval
説明
ジャーナルは、hot standby の standby-replay モードの場合にポーリングする間隔です。
型
浮動小数点 (Float)
デフォルト
1
mds_shutdown_check
説明
MDS のシャットダウン中にキャッシュをポーリングする間隔。
型
32 ビット整数
デフォルト
0
mds_thrash_exports
説明
Ceph はノード間でサブツリーをランダムエクスポートします。テストの目的でのみ使用してください。
型
32 ビット整数
デフォルト
0
mds_thrash_fragments
説明
Ceph の無作為に断片化したり、ディレクトリーをマージしたりします。
型
32 ビット整数
デフォルト
0
mds_dump_cache_on_map
説明
Ceph は MDS キャッシュの内容を各 MDS マップのファイルにダンプします。
型
Boolean
デフォルト
false
mds_dump_cache_after_rejoin
説明
Ceph は、リカバリー中にキャッシュを再度参加した後に MDS キャッシュの内容をファイルにダンプします。
型
Boolean
デフォルト
false
mds_verify_scatter
説明
Ceph は、さまざまな scatter/gather invariants が true であることをアサートします。開発者向けの使用のみ。
型
Boolean
デフォルト
false
mds_debug_scatterstat
説明
Ceph は、バリアント内のさまざまな再帰統計が true であるアサートされます。開発者向けの使用のみ。
型
Boolean
デフォルト
false
mds_debug_frag
説明
Ceph は、使用時にディレクトリーの断片化を変えるように検証します。開発者向けの使用のみ。
型
Boolean
デフォルト
false
mds_debug_auth_pins
説明
デバッグ認証のバリアント。開発者向けの使用のみ。
型
Boolean
デフォルト
false
mds_debug_subtrees
説明
サブツリーのバリアントのデバッグ開発者向けの使用のみ。
型
Boolean
デフォルト
false
mds_kill_mdstable_at
説明
Ceph は、MDS テーブルコードに MDS 障害を挿入します。開発者向けの使用のみ。
型
32 ビット整数
デフォルト
0
mds_kill_export_at
説明
Ceph は、サブツリーのエクスポートコードに MDS の失敗を注入します。開発者向けの使用のみ。
型
32 ビット整数
デフォルト
0
mds_kill_import_at
説明
Ceph は、サブツリーのインポートコードに MDS の失敗を注入します。開発者向けの使用のみ。
型
32 ビット整数
デフォルト
0
mds_kill_link_at
説明
Ceph は、ハードリンクコードに MDS 障害を挿入します。開発者向けの使用のみ。
型
32 ビット整数
デフォルト
0
mds_kill_rename_at
説明
Ceph は、名前変更コードに MDS の失敗を注入します。開発者向けの使用のみ。
型
32 ビット整数
デフォルト
0
mds_wipe_sessions
説明
Ceph は、起動時にすべてのクライアントセッションを削除します。テストの目的でのみ使用してください。
型
Boolean
デフォルト
0
mds_wipe_ino_prealloc
説明
Ceph は、起動時に inode 事前割り当てメタデータを削除します。テストの目的でのみ使用してください。
型
Boolean
デフォルト
0
mds_skip_ino
説明
起動時にスキップする inode 番号の数。テストの目的でのみ使用してください。
型
32 ビット整数
デフォルト
0
mds_standby_for_name
説明
MDS デーモンは、この設定で指定された名前の別の MDS デーモンに対するスタンバイです。
型
String
デフォルト
該当なし
mds_standby_for_rank
説明
MDS デーモンのインスタンスは、このランクの別の MDS デーモンインスタンスに対するスタンバイです。
型
32 ビット整数
デフォルト
-1
mds_standby_replay
説明
MDS デーモンが hot standby として使用する場合にアクティブな MDS のログをポーリングおよび再生するかどうかを決定します。
型
Boolean
デフォルト
false

付録C ジャーナル設定の参照
リンクのコピー

ジャーナルャー設定に使用できる list コマンドのリファレンス

journaler_write_head_interval
説明
ジャーナルヘッドオブジェクトを更新する頻度。
型
Integer
必須
いいえ
デフォルト
15
journaler_prefetch_periods
説明
ジャーナル再生に先行するストライプ期間の数。
型
Integer
必須
いいえ
デフォルト
10
journaler_prezero_periods
説明
書き込み位置が 0 より進んだストライプ期間の数。
型
Integer
必須
いいえ
デフォルト
10
journaler_batch_interval
説明
人為的に発生する最大レイテンシー (秒単位)。
型
Double
必須
いいえ
デフォルト
.001
journaler_batch_max
説明
フラッシュを遅延させる最大バイト。
型
64 ビット未署名の整数
必須
いいえ
デフォルト
0

付録D Ceph File System ミラー設定リファレンス
リンクのコピー

このセクションでは、Ceph ファイルシステム (CephFS) ミラーの設定オプションを一覧表示します。

cephfs_mirror_max_concurrent_directory_syncs
説明
cephfs-mirror デーモンが同時に同期できるディレクトリースナップショットの最大数。同期スレッドの数を制御します。
型
Integer
デフォルト
3
Min
1
cephfs_mirror_action_update_interval
説明
保留中のミラー更新アクションを処理する間隔 (秒単位)。
型
secs
デフォルト
2
Min
1
cephfs_mirror_restart_mirror_on_blocklist_interval
説明
ブロックリストに登録されたミラーインスタンスを再起動する間隔 (秒単位)。ゼロ (0) に設定すると、ブロックリストに登録されたインスタンスの再起動が無効になります。
型
secs
デフォルト
30
Min
0
cephfs_mirror_max_snapshot_sync_per_cycle
説明
ディレクトリーがワーカースレッドによってミラーリングのために選択されたときに、ミラーリングするスナップショットの最大数。
型
Integer
デフォルト
3
Min
1
cephfs_mirror_directory_scan_interval
説明
スナップショットミラーリング用に設定されたディレクトリーをスキャンする間隔 (秒単位)。
型
Integer
デフォルト
10
Min
1
cephfs_mirror_max_consecutive_failures_per_directory
説明
ディレクトリーを “failed” としてマークする連続したスナップショット同期の失敗の数。失敗したディレクトリーは、同期のために再試行される頻度が低くなります。
型
Integer
デフォルト
10
Min
0
cephfs_mirror_retry_failed_directories_interval
説明
失敗したディレクトリーの同期を再試行する間隔 (秒単位)。
型
Integer
デフォルト
60
Min
1
cephfs_mirror_restart_mirror_on_failure_interval
説明
失敗したミラーインスタンスを再起動する間隔 (秒単位)。ゼロ (0) に設定すると、失敗したミラーインスタンスの再起動が無効になります。
型
secs
デフォルト
20
Min
0
cephfs_mirror_mount_timeout
説明
cephfs-mirror デーモンによるプライマリーまたはセカンダリー CephFS のマウントのタイムアウト (秒単位)。これをより高い値に設定すると、クラスターに到達できない場合にファイルシステムをマウントするときに、ミラーデーモンが停止する可能性があります。このオプションは、通常の client_mount_timeout をオーバーライドするために使用されます。
型
secs
デフォルト
10
Min
0

法律上の通知
リンクのコピー

Copyright © 2024 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat