第11章 Ceph File System スナップショットのミラーリング

手順

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

   例

   [root@host01 ~]# cephadm shell

2. ソースストレージクラスターで、CephFS ミラーリングデーモンをデプロイします。

   構文

   ceph orch apply cephfs-mirror ["NODE_NAME"]

   例

   [ceph: root@host01 /]# ceph orch apply cephfs-mirror "node1.example.com"
   Scheduled cephfs-mirror update...

   このコマンドにより、cephfs-mirror という名前の Ceph ユーザーが作成され、特定のノードに cephfs-mirror デーモンがデプロイされます。

   1. オプション: 複数の CephFS ミラーリングデーモンをデプロイし、高可用性を実現します。

      構文

      ceph orch apply cephfs-mirror --placement="PLACEMENT_SPECIFICATION"

      例

      [ceph: root@host01 /]# ceph orch apply cephfs-mirror --placement="3 host1 host2 host3"
      Scheduled cephfs-mirror update...

      この例では、3 つの cephfs-mirror デーモンを異なるホストにデプロイします。

      警告

      次のエラーが発生するため、ホストをコンマで区切らないでください。

      Error EINVAL: name component must include only a-z, 0-9, and -

3. ターゲットストレージクラスターで、それぞれの CephFS ピア用にユーザーを作成します。

   構文

   ceph fs authorize FILE_SYSTEM_NAME CLIENT_NAME / rwps

   例

   [ceph: root@host01 /]# ceph fs authorize cephfs client.mirror_remote / rwps
   [client.mirror_remote]
           key = AQCjZ5Jg739AAxAAxduIKoTZbiFJ0lgose8luQ==

4. ソースストレージクラスターで、CephFS ミラーリングモジュールを有効にします。

   例

   [ceph: root@host01 /]# ceph mgr module enable mirroring

5. ソースストレージクラスターで、Ceph File System でミラーリングを有効にします。

   構文

   ceph fs snapshot mirror enable FILE_SYSTEM_NAME

   例

   [ceph: root@host01 /]# ceph fs snapshot mirror enable cephfs

   1. オプション: スナップショットミラーリングを無効にします。

      構文

      ceph fs snapshot mirror disable FILE_SYSTEM_NAME

      例

      [ceph: root@host01 /]# ceph fs snapshot mirror disable cephfs

      警告

      ファイルシステムでスナップショットミラーリングを無効にすると、設定されたピアが削除されます。ピアをブートストラップして再度インポートする必要があります。

6. ターゲットピアストレージクラスターを準備します。

   1. ターゲットノードで、mirroring Ceph Manager モジュールを有効にします。

      例

      [ceph: root@host01 /]# ceph mgr module enable mirroring

   2. 同じターゲットノードで、ピアブートストラップを作成します。

      構文

      ceph fs snapshot mirror peer_bootstrap create FILE_SYSTEM_NAME CLIENT_NAME SITE_NAME

      SITE_NAME は、ターゲットのストレージクラスターを識別するユーザー定義の文字列です。

      例

      [ceph: root@host01 /]# ceph fs snapshot mirror peer_bootstrap create cephfs client.mirror_remote remote-site
      {"token": "eyJmc2lkIjogIjBkZjE3MjE3LWRmY2QtNDAzMC05MDc5LTM2Nzk4NTVkNDJlZiIsICJmaWxlc3lzdGVtIjogImJhY2t1cF9mcyIsICJ1c2VyIjogImNsaWVudC5taXJyb3JfcGVlcl9ib290c3RyYXAiLCAic2l0ZV9uYW1lIjogInNpdGUtcmVtb3RlIiwgImtleSI6ICJBUUFhcDBCZ0xtRmpOeEFBVnNyZXozai9YYUV0T2UrbUJEZlJDZz09IiwgIm1vbl9ob3N0IjogIlt2MjoxOTIuMTY4LjAuNTo0MDkxOCx2MToxOTIuMTY4LjAuNTo0MDkxOV0ifQ=="}

      次の手順で使用する二重引用符の間のトークン文字列をコピーします。

7. ソースストレージクラスターで、ターゲットストレージクラスターからブートストラップトークンをインポートします。

   構文

   ceph fs snapshot mirror peer_bootstrap import FILE_SYSTEM_NAME TOKEN

   例

   [ceph: root@host01 /]# ceph fs snapshot mirror peer_bootstrap import cephfs eyJmc2lkIjogIjBkZjE3MjE3LWRmY2QtNDAzMC05MDc5LTM2Nzk4NTVkNDJlZiIsICJmaWxlc3lzdGVtIjogImJhY2t1cF9mcyIsICJ1c2VyIjogImNsaWVudC5taXJyb3JfcGVlcl9ib290c3RyYXAiLCAic2l0ZV9uYW1lIjogInNpdGUtcmVtb3RlIiwgImtleSI6ICJBUUFhcDBCZ0xtRmpOeEFBVnNyZXozai9YYUV0T2UrbUJEZlJDZz09IiwgIm1vbl9ob3N0IjogIlt2MjoxOTIuMTY4LjAuNTo0MDkxOCx2MToxOTIuMTY4LjAuNTo0MDkxOV0ifQ==

8. ソースストレージクラスターで、CephFS ミラーピアをリスト表示します。

   構文

   ceph fs snapshot mirror peer_list FILE_SYSTEM_NAME

   例

   [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]"}}

   1. オプション: スナップショットピアを削除します。

      構文

      ceph fs snapshot mirror peer_remove FILE_SYSTEM_NAME PEER_UUID

      例

      [ceph: root@host01 /]# ceph fs snapshot mirror peer_remove cephfs e5ecb883-097d-492d-b026-a585d1d7da79

      注記

      ピア UUID 値を確認する方法は、Ceph File System のミラーリングステータスの表示 を参照してください。

9. ソースストレージクラスターで、スナップショットミラーリングのディレクトリーを設定します。

   構文

   ceph fs snapshot mirror add FILE_SYSTEM_NAME PATH

   例

   [ceph: root@host01 /]# ceph fs snapshot mirror add cephfs /volumes/_nogroup/subvol_1

   重要

   Ceph File System 内の絶対パスのみが有効です。

   注記

   Ceph Manager の mirroring モジュールは、パスを正規化します。たとえば、/d1/d2/../dN ディレクトリーは /d1/d2 と同等です。ミラーリング用にディレクトリーが追加されると、その上位ディレクトリーおよびサブディレクトリーがミラーリング用に追加されなくなります。

   1. オプション: ディレクトリーのスナップショットミラーリングを停止します。

      構文

      ceph fs snapshot mirror remove FILE_SYSTEM_NAME PATH

      例

      [ceph: root@host01 /]# ceph fs snapshot mirror remove cephfs /home/user1