2.16. NFS-Ganesha への名前空間のエクスポート

作業を開始する前に

1. NFS-Ganesha を実行する前に、NFS-Ganesha を実行するホストで実行中のカーネル NFS サービスインスタンスをすべて無効にします。NFS-Ganesha は、別の NFS インスタンスが実行している場合は起動しません。

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

   Red Hat Enterprise Linux 7

   # subscription-manager repos --enable=rhel-7-server-rhceph-4-tools-rpms

   Red Hat Enterprise Linux 8

   # subscription-manager repos --enable=rhceph-4-tools-for-rhel-8-x86_64-rpms

3. rpcbind サービスが実行していることを確認します。

   # systemctl start rpcbind

   注記

   rpcbind を提供する rpcbind パッケージは通常、デフォルトでインストールされます。そうでない場合は、最初にパッケージをインストールします。

   NFS の rpcbind の使用方法の詳細は、Red Hat Enterprise Linux 7 のストレージ管理ガイドの 必要なサービス セクションを参照してください。

4. nfs-service サービスが実行中である場合は、これを停止して無効にします。

   # systemctl stop nfs-server.service
   # systemctl disable nfs-server.service

NFS-Ganesha インスタンスの設定

1. nfs-ganesha-rgw パッケージをインストールします。

   # yum install nfs-ganesha-rgw

2. Ceph Monitor ノードから NFS-Ganesha ホストの /etc/ceph/ ディレクトリーに Ceph 設定ファイルをコピーし、必要に応じて編集します。

   # scp <mon-host>:/etc/ceph/ceph.conf <nfs-ganesha-rgw-host>:/etc/ceph

   注記

   Ceph 設定ファイルには、有効な [client.rgw.{instance-name}] セクションと、rgw_data、keyring、rgw_frontends など、必要なさまざまな Gateway 設定変数が含まれている必要があります。有効な S3 バケットの命名要件に準拠していない Swift コンテナーをエクスポートする場合は、Ceph 設定ファイルの [client.rgw] セクションで rgw_relaxed_s3_bucket_names を true に設定します。たとえば、Swift コンテナー名にアンダースコアが含まれる場合、これは有効な S3 バケット名ではなく、rgw_relaxed_s3_bucket_names が true に設定されていない限り同期されません。NFS 外にオブジェクトおよびバケットを追加すると、これらのオブジェクトは、デフォルトで rgw_nfs_namespace_expire_secs によって設定された時間に NFS 名前空間に表示されます。デフォルトでは約 5 分です。Ceph 設定ファイルの rgw_nfs_namespace_expire_secs のデフォルト値を上書きして、更新レートを変更します。

3. NFS-Ganesha 設定ファイルを開きます。

   # vim /etc/ganesha/ganesha.conf

4. FSAL (File System Abstraction Layer) ブロックを使用して EXPORT セクションを設定します。ID、S3 ユーザー ID、S3 アクセスキー、およびシークレットを指定します。NFSv4 の場合は、以下のようになります。

   EXPORT
   {
           Export_ID={numeric-id};
           Path = "/";
           Pseudo = "/";
           Access_Type = RW;
           SecType = "sys";
           NFS_Protocols = 4;
           Transport_Protocols = TCP;
           Squash = No_Root_Squash;
   
           FSAL {
                   Name = RGW;
                   User_Id = {s3-user-id};
                   Access_Key_Id ="{s3-access-key}";
                   Secret_Access_Key = "{s3-secret}";
           }
   }

   Path オプションは、エクスポートを見つける場所を Ganesha に指示します。VFS FSAL の場合は、これはサーバーの名前空間内の場所になります。他の FSAL の場合は、その FSAL の名前空間が管理するファイルシステム内の場所になる可能性があります。たとえば、CephFSAL を使用して CephFS ボリューム全体をエクスポートする場合、Path は / になります。

   Pseudo オプションは、Ganesha に対して NFS v4 の擬似ファイルシステムの名前空間内にエクスポートを配置するよう指示します。NFS v4 は、エクスポートの実際の場所に対応しない疑似名前空間を構築する可能性があるサーバーを指定し、その疑似ファイルシステムの一部は NFS サーバーのレルム内にのみ存在し、物理ディレクトリーに対応しない可能性があります。さらに、NFS v4 サーバーはすべてのエクスポートを 1 つの名前空間に配置します。単一のエクスポートを疑似ファイルシステムの root としてエクスポートすることは可能ですが、複数のエクスポートを疑似ファイルシステムに配置する方がはるかに一般的です。従来の VFS では、多くの場合、Pseudo の場所は Path の場所と同じです。/ を Path として使用して CephFS エクスポート例に戻る場合、複数のエクスポートが必要な場合は、エクスポートに Pseudo オプションが他にない可能性があります。たとえば、/ceph です。

   NFSv3 に対応する EXPORT ブロックには、NFS_Protocols 設定でバージョン 3 を含める必要があります。さらに、NFSv3 は、UDP トランスポートをサポートする最後のメジャーバージョンになります。標準の初期バージョンには UDP が含まれていましたが、RFC 7530 ではその使用が禁止されています。UDP を有効にするには、Transport_Protocols 設定に追加します。以下に例を示します。

   EXPORT {
   ...
       NFS_Protocols = 3,4;
       Transport_Protocols = UDP,TCP;
   ...
   }

   SecType = sys; を設定することで、クライアントは Kerberos 認証なしで接続できます。

   Squash = No_Root_Squash; を設定すると、ユーザーは NFS マウント内のディレクトリー所有権を変更できます。

   従来の OS ネイティブ NFS 4.1 クライアントを使用する NFS クライアントは通常、移行先サーバーの pseudofs root で定義されるエクスポートされたファイルシステムのフェデレーションされた名前空間を表示します。これらの任意の数を Ceph Object Gateway エクスポートに指定できます。

   各エクスポートには、name、User_Id、Access_Key、および Secret_Access_Key という独自のタプルがあり、指定されたユーザーが確認できるオブジェクトの名前空間のプロキシーを作成します。

   ganesha.conf のエクスポートには、NFSV4 ブロックを含めることもできます。Red Hat Ceph Storage では、idmapper プログラムを設定する代わりに、Allow_Numeric_Owners パラメーターおよび Only_Numberic_Owners パラメーターサポートされます。

   NFSV4 {
       Allow_Numeric_Owners = true;
       Only_Numeric_Owners = true;
   }

5. NFS_CORE_PARAM ブロックを設定します。

   NFS_CORE_PARAM{
       mount_path_pseudo = true;
   }

   mount_path_pseudo 設定設定は、true に設定すると、NFS v3 および NFS v4.x のマウントが同じサーバー側パスを使用してエクスポートに到達させます。

       mount -o vers=3 <IP ADDRESS>:/export /mnt
       mount -o vers=4 <IP ADDRESS>:/export /mnt

   Path            Pseudo          Tag     Mechanism   Mount
   /export/test1   /export/test1   test1   v3 Pseudo   mount -o vers=3 server:/export/test1
   /export/test1   /export/test1   test1   v3 Tag      mount -o vers=3 server:test1
   /export/test1   /export/test1   test1   v4 Pseudo   mount -o vers=4 server:/export/test1
   /               /export/ceph1   ceph1   v3 Pseudo   mount -o vers=3 server:/export/ceph1
   /               /export/ceph1   ceph1   v3 Tag      mount -o vers=3 server:ceph1
   /               /export/ceph1   ceph1   v4 Pseudo   mount -o vers=4 server:/export/ceph1
   /               /export/ceph2   ceph2   v3 Pseudo   mount -o vers=3 server:/export/ceph2
   /               /export/ceph2   ceph2   v3 Tag      mount -o vers=3 server:ceph2
   /               /export/ceph2   ceph2   v4 Pseudo   mount -o vers=4

   mount_path_pseudo の設定設定を false に設定すると、NFS v3 は Path オプションを使用し、NFS v4.x マウントは Pseudo オプションを使用します。

   Path            Pseudo          Tag     Mechanism   Mount
   /export/test1   /export/test1   test1   v3 Path     mount -o vers=3 server:/export/test1
   /export/test1   /export/test1   test1   v3 Tag      mount -o vers=3 server:test1
   /export/test1   /export/test1   test1   v4 Pseudo   mount -o vers=4 server:/export/test1
   /               /export/ceph1   ceph1   v3 Path     mount -o vers=3 server:/
   /               /export/ceph1   ceph1   v3 Tag      mount -o vers=3 server:ceph1
   /               /export/ceph1   ceph1   v4 Pseudo   mount -o vers=4 server:/export/ceph1
   /               /export/ceph2   ceph2   v3 Path     not accessible
   /               /export/ceph2   ceph2   v3 Tag      mount -o vers=3 server:ceph2
   /               /export/ceph2   ceph2   v4 Pseudo   mount -o vers=4 server:/export/ceph2

6. RGW セクションを設定します。インスタンスの名前を指定し、Ceph 設定ファイルへのパスを指定し、任意の初期化引数を指定します。

   RGW {
       name = "client.rgw.{instance-name}";
       ceph_conf = "/etc/ceph/ceph.conf";
       init_args = "--{arg}={arg-value}";
   }

7. /etc/ganesha/ganesha.conf 設定ファイルを保存します。

8. nfs-ganesha サービスを有効にして開始します。

   # systemctl enable nfs-ganesha
   # systemctl start nfs-ganesha

9. 擬似ディレクトリーが非常に大きい場合には、ceph.conf ファイルの設定可能なパラメーター rgw_nfs_s3_fast_attrs を true に設定して、名前をイミュータブルかつ加速します。

   rgw_nfs_s3_fast_attrs= true

10. 各ゲートウェイノードから Ceph Object Gateway サービスを再起動します。

    # systemctl restart ceph-radosgw.target