Cloud Parallel File Storage:Mount a file system using a CPFS-NFS client (Recommended)

Usage notes

Step 1: Download and install the CPFS-NFS client

This client is open source. You can visit the GitHub repository to obtain the source code or compile it manually.

1. Log on to the ECS instance where you want to mount the CPFS file system. For more information, see Select a method to connect to an ECS instance.

2. Download and install the CPFS-NFS client.

   Alibaba Cloud Linux

   1. Download the CPFS-NFS client.

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

   2. Install the CPFS-NFS client.

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

   CentOS

   1. Download the CPFS-NFS client.

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

   2. Install the CPFS-NFS client.

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

   Ubuntu

   1. Download the CPFS-NFS client.

      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. Install the CPFS-NFS client.

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

   Debian

   1. Download the CPFS-NFS client.

      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. Install the CPFS-NFS client.

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

   SUSE

   1. Download the CPFS-NFS client.

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

   2. Install the CPFS-NFS client.

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

3. Verify the installation of the CPFS-NFS client.

   which mount.cpfs-nfs

   The following is an example of a successful response:

   /usr/sbin/mount.cpfs-nfs

Step 2: Mount the file system using the CPFS-NFS client

1. You can mount the CPFS file system.

   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

   The following table describes the parameters for the mount command.

   Parameter	Description
   file-system-id.region.cpfs.aliyuncs.com:/share/path /mnt	This indicates <mount_address> <local_mount_path>. Replace them with your actual values. Mount address: The mount address of the export directory. In the File Storage NAS console, go to the file system list page. Click Manage next to the target file system to go to the Protocol Service page. In the Actions column, click Export Directory to open the Export Directory panel and obtain the mount address. Example: cpfs-196f91a8e58b****-195ceeac7b6ac****.cn-chengdu.cpfs.aliyuncs.com:/share/fileset Local mount path: The root directory (/) or any subdirectory (for example, /mnt) on the Linux ECS instance. If it is a subdirectory, make sure the subdirectory exists.
   vers	The version of the file system. CPFS supports mounting file systems only with the NFSv3 protocol.
   Mount options	You can select multiple mount options when you mount a file system. Separate the options with commas (,). The options are described as follows: rsize: Defines the size of the block for reading data between the client and the file system. Recommended value: 1048576. wsize: Defines the size of the block for writing data between the client and the file system. Recommended value: 1048576. Note To change the I/O size parameters (rsize and wsize), use the maximum value (1048576) to avoid performance degradation. hard: If CPFS is temporarily unavailable, local applications that use a file on the file system stop and wait until the file system is back online. We recommend that you enable this parameter. timeo: Specifies the time, in tenths of a second, that the CPFS-NFS client waits for a response before it retries sending a request to the file system. Recommended value: 600 (60 seconds). Note If you must change the timeout parameter (timeo), use a value of 150 or greater. The unit for the timeo parameter is tenths of a second, so 150 represents 15 seconds. retrans: The number of times the CPFS-NFS client retries a request. Recommended value: 2. noresvport: Uses a new TCP port when the network reconnects. This ensures that the connection is not interrupted during network fault recovery. We recommend that you enable this parameter. Important We do not recommend using the soft option because it poses a data consistency threat. If you use the soft option, you are responsible for any associated threats. Avoid setting any other mount options that differ from the default values. If you change the read or write buffer size or disable the attribute cache, performance may decrease.

2. Run the mount -l command to verify the mount.

   After the file system is mounted, you can run the df -h command to view its capacity.

3. Optional: Configure automatic mounting at startup.

   To prevent mount information from being lost when an ECS instance restarts, you can configure the /etc/fstab file on the Linux ECS instance. This enables the CPFS file system to be automatically mounted when the ECS instance restarts.

   1. Open the /etc/fstab configuration file and add the mount configuration.

      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

      For a description of the main parameters in the example, see Mount command parameters. The other parameters are described as follows.

      Parameter	Description
      _netdev	Prevents the client from starting to mount the file system before the network is ready.
      0 (the first item after noresvport)	A non-zero value indicates that the file system should be backed up by the dump command. For CPFS file systems, this value is 0 by default.
      0 (the second item after noresvport)	This value indicates the order in which fsck checks file systems at startup. For CPFS file systems, this value is 0 by default, which means that fsck does not run at startup.

   2. Run the reboot command to restart the ECS instance.

      Note

      Before you restart the ECS instance, confirm that the manual mount was successful to avoid a restart failure. If the automatic mount is configured successfully, you can run the df -h command after the ECS instance restarts to verify that the CPFS file system is mounted.

Client configuration

Configuration file

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

[mount]
stunnel_debug_enabled = false

# Validate the certificate hostname on mount. This option is not supported by certain stunnel versions.
stunnel_check_cert_hostname = false

# Use OCSP to check certificate validity. This option is not supported by certain stunnel versions.
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 configuration

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

• What do I do if the "Failed to resolve domain: file-system-id.region.cpfs.aliyuncs.com" error occurs when I mount a CPFS file system?

• What are the differences between a CPFS-POSIX client and a CPFS-NFS client?

• How do I remove residual configuration information from an uninstalled ECS instance?

• What do I do if the "[FATAL] B: Could not connect to B via ssh" error occurs when I mount a CPFS file system?

References

• CPFS data flow

• Data monitoring

• Access control

• Uninstalling a file system