Cloud Parallel File Storage：Mount sistem file menggunakan klien CPFS-NFS (direkomendasikan)

Catatan penggunaan

Langkah 1: Unduh dan instal klien CPFS-NFS

Klien ini bersifat open source. Untuk kode sumber atau cara kompilasi manual, kunjungi repositori GitHub.

1. Login ke instans ECS tempat Anda ingin memasang sistem file CPFS. Untuk informasi selengkapnya, lihat Pilih metode untuk terhubung ke instans ECS.

2. Unduh dan instal klien CPFS-NFS.

   Alibaba Cloud Linux

   1. Unduh klien CPFS-NFS.

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

   2. Instal klien CPFS-NFS.

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

   CentOS

   1. Unduh klien CPFS-NFS.

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

   2. Instal klien CPFS-NFS.

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

   Ubuntu

   1. Unduh klien 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. Instal klien CPFS-NFS.

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

   Debian

   1. Unduh klien 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. Instal klien CPFS-NFS.

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

   SUSE

   1. Unduh klien CPFS-NFS.

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

   2. Instal klien CPFS-NFS.

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

3. Periksa apakah instalasi berhasil.

   which mount.cpfs-nfs

   Tanggapan sukses ditampilkan pada contoh berikut:

   /usr/sbin/mount.cpfs-nfs

Langkah 2: Mount file system menggunakan klien CPFS-NFS

1. Mount sistem file CPFS.

   1. Skenario 1: Mount umum (path default)

      Skenario ini berlaku untuk sebagian besar lingkungan yang tidak mengaktifkan AppArmor, SELinux, atau pembatasan akses path khusus.

      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

   2. Skenario 2: Mount di lingkungan keamanan tinggi (seperti sistem dengan SELinux atau AppArmor aktif)

      Jika penguatan keamanan diaktifkan pada sistem operasi Anda melalui kebijakan seperti AppArmor atau SELinux, mount default dapat menyebabkan pengecualian akses. Dalam kasus ini, Anda dapat secara eksplisit menentukan path menggunakan `hp_config_dir`. Saat menjalankan perintah, ganti <custom_directory> dengan path yang diizinkan oleh kebijakan keamanan sistem Anda.

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

2. Parameter perintah mount

   Parameter	Deskripsi
   file-system-id.region.cpfs.aliyuncs.com:/share/path /mnt	Mewakili <mount_path> <local_path_to_mount_on_the_server>. Ganti sesuai kebutuhan. Path mount: Path mount dari direktori ekspor. Di Konsol Penyimpanan File NAS, buka halaman daftar Sistem File dan klik Manage di sebelah sistem file target. Pada halaman Protocol Service, klik Export Directory di kolom Actions. Di panel Export Directory yang muncul, dapatkan path mount. Contoh: cpfs-196f91a8e58b****-195ceeac7b6ac****.cn-chengdu.cpfs.aliyuncs.com:/share/fileset Path lokal untuk mount di server: Direktori root (/) atau subdirektori apa pun (misalnya, /mnt) pada instans ECS Linux. Jika berupa subdirektori, pastikan subdirektori tersebut ada.
   vers	Versi sistem file. CPFS hanya mendukung pemasangan sistem file dengan protokol NFSv3.
   Opsi pemasangan	Anda dapat memilih beberapa opsi mount. Pisahkan dengan koma (,). Opsi tersebut dijelaskan sebagai berikut: rsize: Menentukan ukuran blok data untuk membaca data antara klien dan sistem file. Nilai yang direkomendasikan: 1048576. wsize: Menentukan ukuran blok data untuk menulis data antara klien dan sistem file. Nilai yang direkomendasikan: 1048576. Catatan Untuk mengubah parameter ukuran I/O (rsize dan wsize), gunakan nilai maksimum (1048576) bila memungkinkan untuk menghindari degradasi performa. hard: Jika sistem file CPFS sementara tidak tersedia, aplikasi lokal yang menggunakan file pada sistem file tersebut akan berhenti dan menunggu hingga sistem file kembali online. Mengaktifkan parameter ini direkomendasikan. timeo: Waktu dalam sepersepuluh detik yang ditunggu klien CPFS-NFS untuk respons sebelum mencoba ulang permintaan ke sistem file. Nilai yang direkomendasikan: 600 (60 detik). Catatan Jika Anda harus mengubah parameter timeout (timeo), gunakan nilai 150 atau lebih besar. Satuan parameter timeo adalah sepersepuluh detik, sehingga 150 merepresentasikan 15 detik. retrans: Jumlah kali klien CPFS-NFS mencoba ulang permintaan. Nilai yang direkomendasikan: 2. noresvport: Menggunakan port TCP baru saat koneksi jaringan dipulihkan untuk memastikan koneksi tidak terputus selama pemulihan kesalahan jaringan. Mengaktifkan parameter ini direkomendasikan. Penting Jangan gunakan opsi `soft`. Opsi ini menimbulkan ancaman terhadap konsistensi data. Jika Anda menggunakan opsi `soft`, Anda mengasumsikan semua ancaman terkait. Hindari menyetel opsi mount lain yang berbeda dari nilai default. Mengubah ukuran buffer baca/tulis atau menonaktifkan caching atribut dapat menurunkan performa. hp_config_dir: (Opsional) Secara eksplisit menentukan direktori untuk file konfigurasi haproxy. Tetapkan parameter ini jika sistem operasi Anda memiliki Security Enforcement (seperti AppArmor atau SELinux) atau kebijakan keamanan tinggi lain yang membatasi proses hanya membaca konfigurasi atau berjalan di path tertentu. Rekomendasi pemilihan path: Pilih direktori yang sesuai dari daftar putih kebijakan keamanan sistem Anda dan pastikan path tersebut diotorisasi oleh modul keamanan. Logika: Klien CPFS pertama-tama mencoba menggunakan direktori yang ditentukan oleh parameter ini. Jika tidak ditentukan, klien mencoba mengurai daftar putih kebijakan keamanan secara otomatis. Jika penguraian gagal, klien menggunakan path default /var/run/cpfs.

3. Jalankan perintah mount -l untuk melihat hasil mount.

   Setelah mount berhasil, Anda dapat menjalankan perintah df -h untuk melihat informasi kapasitas sistem file saat ini.

4. (Opsional) Konfigurasikan mount otomatis saat startup

   Untuk mencegah informasi mount hilang setelah instans ECS direstart, Anda dapat mengonfigurasi file /etc/fstab. Jika Anda menggunakan parameter hp_config_dir saat mount manual, Anda juga harus mengonfigurasinya di sini.

   1. Buka file konfigurasi /etc/fstab dan tambahkan konfigurasi mount.

      • Konfigurasi untuk lingkungan umum:

        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

      • Contoh konfigurasi untuk lingkungan keamanan tinggi (menggunakan direktori kustom):

        Ganti <custom_directory> dengan path yang diizinkan oleh kebijakan keamanan sistem Anda.

        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,hp_config_dir=<custom_directory> 0 0

      • Deskripsi parameter lainnya

        Parameter	Deskripsi
        _netdev	Parameter ini mencegah klien melakukan mount sistem file sebelum jaringan siap.
        0 (item pertama setelah noresvport)	Nilai bukan nol menunjukkan bahwa sistem file harus dibackup oleh dump. Untuk sistem file CPFS, nilai ini adalah 0 secara default.
        0 (item kedua setelah noresvport)	Nilai ini menunjukkan urutan pemeriksaan sistem file oleh fsck saat startup. Untuk sistem file CPFS, nilai ini adalah 0 secara default, yang berarti fsck tidak dijalankan saat startup.

   2. Jalankan perintah reboot untuk merestart instans ECS.

      Sebelum merestart instans ECS, pastikan bahwa mount manual berhasil untuk mencegah instans gagal restart. Jika konfigurasi mount otomatis berhasil, Anda dapat menjalankan perintah df -h untuk melihat sistem file CPFS yang telah dimount setelah instans ECS direstart.

Konfigurasi klien

File konfigurasi

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

[mount]
stunnel_debug_enabled = false

# Validasi hostname sertifikat saat pemasangan. Opsi ini tidak didukung oleh versi stunnel tertentu.
stunnel_check_cert_hostname = false

# Gunakan OCSP untuk memeriksa validitas sertifikat. Opsi ini tidak didukung oleh versi stunnel tertentu.
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]

Konfigurasi 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

FAQ

• Apa yang harus saya lakukan jika muncul error 'Failed to resolve domain: file-system-id.region.cpfs.aliyuncs.com' saat saya mount sistem file CPFS?

• Apa perbedaan antara klien CPFS-POSIX dan klien CPFS-NFS?

• Bagaimana cara menghapus konfigurasi sisa untuk instans ECS yang telah di-uninstall?

• Apa yang harus saya lakukan jika muncul error '[FATAL] B: Could not connect to B via ssh' saat saya mount sistem file CPFS?

Referensi

• Alur data CPFS

• Pemantauan data

• Kontrol akses

• Unmount sistem file