Cloud Parallel File Storage:CPFS-NFS クライアントを使用したファイルシステムのマウント (推奨)

注意事項

ステップ 1: CPFS-NFS クライアントをダウンロードしてインストールする

このクライアントはオープンソースです。GitHub リポジトリにアクセスして、ソースコードを取得したり、手動でコンパイルしたりできます。

1. CPFS ファイルシステムをマウントする ECS インスタンスにログインします。詳細については、「ECS インスタンスへの接続方法の選択」をご参照ください。

2. CPFS-NFS クライアントをダウンロードしてインストールします。

   Alibaba Cloud Linux

   1. CPFS-NFS クライアントをダウンロードします。

      wget https://cpfs-hangzhou-nfs-client.oss-cn-hangzhou.aliyuncs.com/aliyun-alinas-utils-latest.al.noarch.rpm

   2. CPFS-NFS クライアントをインストールします。

      sudo yum install aliyun-alinas-utils-*.rpm

   CentOS

   1. CPFS-NFS クライアントをダウンロードします。

      wget https://cpfs-hangzhou-nfs-client.oss-cn-hangzhou.aliyuncs.com/aliyun-alinas-utils-latest.el.noarch.rpm

   2. CPFS-NFS クライアントをインストールします。

      sudo yum install aliyun-alinas-utils-*.rpm

   Ubuntu

   1. CPFS-NFS クライアントをダウンロードします。

      sudo wget https://cpfs-hangzhou-nfs-client.oss-cn-hangzhou.aliyuncs.com/aliyun-alinas-utils-latest.deb -O /tmp/aliyun-alinas-utils-latest.deb

   2. CPFS-NFS クライアントをインストールします。

      sudo apt-get update
      sudo apt-get install /tmp/aliyun-alinas-utils-latest.deb

   Debian

   1. CPFS-NFS クライアントをダウンロードします。

      sudo wget https://cpfs-hangzhou-nfs-client.oss-cn-hangzhou.aliyuncs.com/aliyun-alinas-utils-latest.deb -O /tmp/aliyun-alinas-utils-latest.deb

   2. CPFS-NFS クライアントをインストールします。

      sudo apt-get update
      sudo apt-get install /tmp/aliyun-alinas-utils-latest.deb

   SUSE

   1. CPFS-NFS クライアントをダウンロードします。

      wget https://cpfs-hangzhou-nfs-client.oss-cn-hangzhou.aliyuncs.com/aliyun-alinas-utils-latest.lp15.x86_64.rpm

   2. CPFS-NFS クライアントをインストールします。

      sudo zypper --no-gpg-checks install -y aliyun-alinas-utils-*.rpm

3. CPFS-NFS クライアントのインストールを確認します。

   which mount.cpfs-nfs

   以下は、成功した応答の例です。

   /usr/sbin/mount.cpfs-nfs

ステップ2：CPFS-NFS クライアントを使用したファイルシステムのマウント

1. CPFS ファイルシステムをマウントします。

   sudo mount -t cpfs-nfs -o vers=3,rsize=1048576,wsize=1048576,hard,timeo=600,retrans=2,noresvport file-system-id.region.cpfs.aliyuncs.com:/share/path /mnt

   次の表に、mount コマンドのパラメーターを説明します。

   パラメーター	説明
   file-system-id.region.cpfs.aliyuncs.com:/share/path /mnt	これは <マウントアドレス> <ローカルマウントパス> を示します。実際の値に置き換えてください。 マウントアドレス：エクスポートディレクトリのマウントアドレス。File Storage NAS コンソールで、ファイルシステムリストページに移動します。対象のファイルシステムの横にある [管理] をクリックして、[プロトコルサービス] ページに移動します。[操作] 列で、[エクスポートディレクトリ] をクリックして [エクスポートディレクトリ] パネルを開き、マウントアドレスを取得します。 例: cpfs-196f91a8e58b****-195ceeac7b6ac****.cn-chengdu.cpfs.aliyuncs.com:/share/fileset ローカルマウントパス：Linux ECS インスタンスのルートディレクトリ (/) または任意のサブディレクトリ (例：/mnt)。サブディレクトリの場合は、そのサブディレクトリが存在することを確認してください。
   vers	ファイルシステムのバージョン。CPFS は NFSv3 プロトコルでのみファイルシステムのマウントをサポートします。
   マウントオプション	ファイルシステムをマウントする際に、複数のマウントオプションを選択できます。オプションはカンマ (,) で区切ります。オプションは次のとおりです。 rsize：クライアントとファイルシステム間でデータを読み取るブロックのサイズを定義します。推奨値：1048576。 wsize：クライアントとファイルシステム間でデータを書き込むブロックのサイズを定義します。推奨値：1048576。 説明 I/O サイズパラメーター (rsize および wsize) を変更するには、パフォーマンスの低下を避けるために最大値 (1048576) を使用してください。 hard：CPFS が一時的に利用できなくなった場合、ファイルシステム上のファイルを使用するローカルアプリケーションは停止し、ファイルシステムがオンラインに戻るまで待機します。このパラメーターを有効にすることを推奨します。 timeo: CPFS-NFS クライアントがファイルシステムにリクエストを再送信する前に応答を待つ時間を 10 分の 1 秒単位で指定します。推奨値: 600 (60 秒)。 説明 タイムアウトパラメーター (timeo) を変更する必要がある場合は、150 以上の値を使用してください。timeo パラメーターの単位は 10 分の 1 秒なので、150 は 15 秒を表します。 retrans: CPFS-NFS クライアントがリクエストを再試行する回数。推奨値: 2。 noresvport：ネットワークが再接続するときに新しい TCP ポートを使用します。これにより、ネットワークエラーからの回復中に接続が中断されないことが保証されます。このパラメーターを有効にすることを推奨します。 重要 soft オプションはデータ整合性の脅威をもたらすため、使用を推奨しません。soft オプションを使用する場合、関連する脅威についてはお客様の責任となります。 デフォルト値と異なる他のマウントオプションを設定することは避けてください。読み取りまたは書き込みバッファサイズを変更したり、属性キャッシュを無効にしたりすると、パフォーマンスが低下する可能性があります。

2. mount -l コマンドを実行してマウントを確認します。

   ファイルシステムがマウントされた後、df -h コマンドを実行してその容量を表示できます。

3. オプション：起動時の自動マウントを設定します。

   ECS インスタンスが再起動したときにマウント情報が失われるのを防ぐために、Linux ECS インスタンスの /etc/fstab ファイルを設定できます。これにより、ECS インスタンスが再起動したときに CPFS ファイルシステムが自動的にマウントされるようになります。

   1. /etc/fstab 構成ファイルを開き、マウント構成を追加します。

      file-system-id.region.nas.aliyuncs.com:/share/path /mnt cpfs-nfs vers=3,rsize=1048576,wsize=1048576,hard,timeo=600,retrans=2,_netdev,noresvport 0 0

      この例の主要なパラメーターの説明については、「mount コマンドのパラメーター」をご参照ください。その他のパラメーターは次のとおりです。

      パラメーター	説明
      _netdev	ネットワークの準備が整う前にクライアントがファイルシステムのマウントを開始するのを防ぎます。
      0 (noresvport の後の最初の項目)	ゼロ以外の値は、ファイルシステムが dump コマンドによってバックアップされるべきであることを示します。CPFS ファイルシステムの場合、この値はデフォルトで 0 です。
      0 (noresvport の後の 2 番目の項目)	この値は、起動時に fsck がファイルシステムをチェックする順序を示します。CPFS ファイルシステムの場合、この値はデフォルトで 0 であり、起動時に fsck が実行されないことを意味します。

   2. reboot コマンドを実行して ECS インスタンスを再起動します。

      説明

      ECS インスタンスを再起動する前に、再起動の失敗を避けるために手動マウントが成功したことを確認してください。自動マウントが正常に設定されている場合、ECS インスタンスの再起動後に df -h コマンドを実行して、CPFS ファイルシステムがマウントされていることを確認できます。

クライアントの設定

設定ファイル

[DEFAULT]
logging_level = INFO
logging_max_bytes = 1048576
logging_file_count = 10

[mount]
stunnel_debug_enabled = false

# マウント時に証明書のホスト名を検証します。 このオプションは、特定の stunnel バージョンではサポートされていません。
stunnel_check_cert_hostname = false

# OCSP を使用して証明書の有効性を確認します。 このオプションは、特定の stunnel バージョンではサポートされていません。
stunnel_check_cert_validity = false
proxy_port = 12049

cpfs_proxy_addr = 127.0.1.255
cpfs_proxy_port_min = 30000
cpfs_proxy_port_max = 60000

[mount-watchdog]
poll_interval_sec = 1
unmount_grace_period_sec = 30
dns_refresh_interval = 60

[client-tool]

haproxy の設定

global
    maxconn 4096

defaults
    mode    tcp
    balance leastconn
    timeout client      60s
    timeout server      60s
    timeout connect     3s
    retries 3

frontend cpfs2049
    bind 127.0.1.255:30000
    default_backend bk2049

backend bk2049
    server cpfs_primary 172.27.1.189:2049 maxconn 2048 check port 2049 inter 2s fall 5 rise 30 on-marked-up shutdown-backup-sessions
    server cpfs_backup  172.27.0.214:2049 maxconn 2048 check port 2049 inter 2s fall 5 rise 30 backup

よくある質問

• CPFS ファイルシステムのマウント時に「Failed to resolve domain: file-system-id.region.cpfs.aliyuncs.com」というエラーが発生した場合はどうすればよいですか？

• CPFS-POSIX クライアントと CPFS-NFS クライアントの違いは何ですか?

• アンインストールされた ECS インスタンスから残りの設定情報を削除するにはどうすればよいですか？

• CPFS ファイルシステムのマウント時に「[FATAL] B: Could not connect to B via ssh」というエラーが発生した場合はどうすればよいですか？

リファレンス

• CPFS データフロー

• データモニタリング

• アクセス制御

• ファイルシステムのアンインストール