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 ボリューム、サブボリュームグループ、およびサブボリュームが作成されました。
手順
CephFS サブボリュームにメタデータを設定します。
構文
ceph fs subvolume metadata set VOLUME_NAME SUBVOLUME_NAME KEY_NAME VALUE [--group_name SUBVOLUME_GROUP_NAME]
例
[ceph: root@host01 /]# ceph fs subvolume metadata set cephfs sub0 test_meta cluster --group_name subgroup0
オプション:
KEY_NAMEにスペースを含むカスタムメタデータを設定します。例
[ceph: root@host01 /]# ceph fs subvolume metadata set cephfs sub0 "test meta" cluster --group_name subgroup0
これにより、
KEY_NAMEを持つ別のメタデータが VALUEclusterのtest metaとして作成されます。オプション: 同じメタデータに別の値を設定することもできます。
例
[ceph: root@host01 /]# ceph fs subvolume metadata set cephfs sub0 "test_meta" cluster2 --group_name subgroup0
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]
例
[ceph: root@host01 /]# ceph fs subvolume metadata get cephfs sub0 test_meta --group_name subgroup0 cluster
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]
例
[ceph: root@host01 /]# ceph fs subvolume metadata ls cephfs sub0 { "test_meta": "cluster" }
4.4.4. ファイルシステムサブボリュームからのカスタムメタデータの削除
ボリューム内、およびオプションで特定のサブボリュームグループ内の Ceph ファイルシステム (CephFS) のカスタムメタデータ (キーと値のペア) を削除できます。
前提条件
- 稼働中の Red Hat Ceph Storage クラスターがある。
- CephFS ボリューム、サブボリュームグループ、およびサブボリュームが作成されました。
- CephFS サブボリュームで作成されたカスタムメタデータ。
手順
CephFS サブボリュームのカスタムメタデータを削除します。
構文
ceph fs subvolume metadata rm VOLUME_NAME SUBVOLUME_NAME KEY_NAME [--group_name SUBVOLUME_GROUP_NAME]
例
[ceph: root@host01 /]# ceph fs subvolume metadata rm cephfs sub0 test_meta --group_name subgroup0
メタデータを一覧表示します。
例
[ceph: root@host01 /]# ceph fs subvolume metadata ls cephfs sub0 {}
