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 サブボリュームとサブボリュームグループが作成されました。
以下のスナップショットスケジュールを作成できます。
- サブボリューム内のディレクトリー。
- デフォルトグループ内のサブボリューム。
- デフォルト以外のグループ内のサブボリューム。
ただし、コマンドは異なります。
手順
サブボリューム内のディレクトリーのスナップショットスケジュールを作成するには、以下を実行します。
ディレクトリーが存在するサブボリュームの絶対パスを取得します。
構文
ceph fs subvolume getpath VOLUME_NAME SUBVOLUME_NAME SUBVOLUME_GROUP_NAME
例
[ceph: root@host02 /]# ceph fs subvolume getpath cephfs subvol_1 subvolgroup_1
サブボリューム内のディレクトリーにスナップショットスケジュールを追加します。
構文
ceph fs snap-schedule add SUBVOLUME_DIR_PATH SNAP_SCHEDULE [START_TIME] --fs CEPH_FILE_SYSTEM_NAME --subvol SUBVOLUME_NAME
注記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 /..
注記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
例
[ceph: root@host02 /]# ceph fs snap-schedule add - 2M --subvol sv_non_def_1
注記パスは定義する必要があり、空のままにすることはできません。パス文字列の値には依存関係がないため、
/
、-`
、または/..
として定義できます。デフォルト以外のグループ内のサブボリュームのスナップショットスケジュールを作成するには、次のコマンドを実行します。
構文
ceph fs snap-schedule add /.. SNAP_SCHEDULE [START_TIME] --fs CEPH_FILE_SYSTEM_NAME --subvol _SUBVOLUME_NAME --group NON_DEFAULT_SUBVOLGROUP_NAME
例
[ceph: root@host02 /]# ceph fs snap-schedule add - 2M --fs cephfs --subvol sv_non_def_1 --group svg1
注記パスは定義する必要があり、空のままにすることはできません。パス文字列の値には依存関係がないため、
/
、-`
、または/..
として定義できます。
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
例
[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/..
デフォルトグループ内のサブボリューム用に作成されたスナップショットスケジュールに、保持ポリシーを追加します。
構文
ceph fs snap-schedule retention add / [COUNT_TIME_PERIOD_PAIR] TIME_PERIOD_COUNT --fs CEPH_FILE_SYSTEM_NAME --subvol SUBVOLUME_NAME
例
[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/..
重要パス (/) を定義する必要があり、空のままにすることはできません。パス文字列の値には依存関係がないため、/、-、または /… として定義できます。
デフォルト以外のグループ内のサブボリュームグループ用に作成されたスナップショットスケジュールに、保持ポリシーを追加します。
構文
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
例
[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/..
重要パス (/) を定義する必要があり、空のままにすることはできません。パス文字列の値には依存関係がないため、/、-、または /… として定義できます。
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]
例
[ceph: root@host02 /]# ceph fs snap-schedule list / --recursive=true /volumes/_nogroup/subv1/85a615da-e8fa-46c1-afc3-0eb8ae64a954/.. 4h
この例では、ディレクトリーツリーのすべてのスケジュールをリスト表示しています。
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]
例
[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}
この例では、
/volumes/_nogroup/subv1/85a615da-e8fa-46c1-afc3-0eb8ae64a954/..
パスのスナップショットスケジュールのステータスを JSON 形式で表示します。デフォルトの形式はプレーンテキストで、指定されていない場合はプレーンテキストになります。デフォルトグループ内のサブボリュームに対して作成されたスナップショットスケジュールのステータスを確認します。
構文
ceph fs snap-schedule status --fs CEPH_FILE_SYSTEM_NAME --subvol SUBVOLUME_NAME
例
[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}
重要パス (/) を定義する必要があり、空のままにすることはできません。パス文字列の値には依存関係がないため、/、-、または /… として定義できます。
- デフォルト以外のグループのサブボリュームに対して作成されたスナップショットスケジュールのステータスを確認します。.Syntax
ceph fs snap-schedule status --fs _CEPH_FILE_SYSTEM_NAME_ --subvol _SUBVOLUME_NAME_ --group _NON-DEFAULT_SUBVOLGROUP_NAME_
例
[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}
+ 重要: パス (/) を定義する必要があり、空のままにすることはできません。パス文字列の値には依存関係がないため、/、-、または /… として定義できます。