Apsara File Storage NAS:Mount an SMB file system on a Linux ECS instance

Manually mount the file system

1. Connect to the Linux ECS instance. For more information, see Connection methods.

2. Run the following command to mount the file system:

   sudo mount -t cifs //file-system-id.region.nas.aliyuncs.com/myshare /mnt -o vers=2.0,guest,uid=0,gid=0,dir_mode=0755,file_mode=0755,mfsymlinks,cache=strict,rsize=1048576,wsize=1048576

   Command syntax: sudo mount -t cifs //<Domain name of the mount target>/myshare <Mount directory> -o <Mount options>

   Parameter	Description
   File system type	To mount an SMB file system on a Linux ECS instance, you must specify the -t cifs parameter.
   Domain name of the mount target	The domain name of the mount target is automatically generated when you create the mount target. Replace the domain name with the actual value. To obtain the domain name of the mount target, perform the following steps: Log on to the NAS console. On the File System List page, click the file system ID. Click the Mount Targets tab. Then, move the pointer over the icon in the Mount Target column.
   myshare	The name of the shared directory for the SMB file system. You cannot change the name after you specify this parameter.
   Path of the shared directory	The path of the directory on which the SMB file system is mounted. For example, you can specify /mnt/sharepath.
   Mount options	Specify the required mount options by adding the -o parameter in the mount command: vers: specifies the version of the SMB protocol. Specify 2.0 or later for the option. guest: specifies the identity that you want to use to mount the file system. You must use the guest identity that is authenticated based on the New Technology LAN Manager (NTLM) protocol. rsize: specifies the maximum size of a data packet that the SMB client can read from the SMB file system. In most cases, set this option to 1048576 (1 MB). wsize: specifies the maximum size of a data packet that the SMB client can write to the SMB file system. In most cases, set this option to 1048576 (1 MB). Specify the mount options by adding the -o parameter: uid: specifies the user to which the files in the file system belong after a successful mount. The default value of uid is 0. gid: specifies the user group to which the files in the file system belong after a successful mount. The default value of gid is 0. dir_mode: specifies the read, write, and execute permissions that you want to grant to the user on the specified directories. The value must start with 0, for example, 0755 and 0644. The default value of dir_mode is 0755. file_mode: specifies the read, write, and execute permissions that you want to grant to the user on files. The value must start with 0, for example, 0755 and 0644. The default value of file_mode is 0755. mfsymlinks: specifies whether symbol links are supported. cache: If you set this option to strict, caching is enabled for the SMB client. The default value of cache is strict. If you set this option to none, caching is disabled for the SMB client. atime|relatime: If file access time does not affect your business, we recommend that you do not set this option to atime. The default value of this option is relatime. Note An authorized administrator of the Linux ECS instance has full control over the SMB file system. If you want to view the details of a mount target, run the mount | grep cifs command. We recommend that you use a Linux distribution whose kernel version is later than 3.10.0-514. If you use a Linux distribution whose kernel version is 3.7 or earlier, set the cache option to strict. You can run the uname -a command to view the kernel version.

3. Run the mount -l command to view the mount result.

   If a command output similar to the following example appears, the file system is mounted.

   

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

   If the file system failed to be mounted, troubleshoot the issue. For more information, see Mount an SMB file system on a Linux ECS instance.

4. Read data from and write data to the file system.

   You can access the SMB file system the same way you access a regular directory. The following figure shows an example.

   

Automatically mount the file system

When you restart the ECS instance on which a file system is mounted, the mount information about the file system may be lost. To prevent this issue, you can modify the /etc/fstab configuration file on the Linux ECS instance to enable automatic mounting at startup for an SMB file system.

1. Open the /etc/fstab configuration file.

   //<Domain name of the mount target>/myshare /mnt cifs vers=3,guest,uid=0,gid=0,dir_mode=0755,file_mode=0755,mfsymlinks,cache=strict,rsize=1048576,wsize=1048576 0 0

   For more information, see Mount parameters. The following table describes the parameters that are not included in the preceding table.

   Parameter	Description
   0 (the first value after wsize)	Specifies whether to back up the file system by running the dump command. A non-zero value indicates that a file system is backed up. The default value is 0 for NAS file systems.
   0 (the second value after wsize)	Specifies the order in which the fsck command checks a file system at startup. The default value is 0 for NAS file systems. The default value 0 indicates that the fsck command is not run at startup.

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

   If you restart the ECS instance, services are interrupted. We recommend that you perform the operation during off-peak hours.

   Note

   Before you restart the ECS instance, make sure that the manual mounting is successful. Otherwise, the ECS instance may fail to restart. If automatic mounting is enabled, you can run the df -h command to view the mounted NAS file systems after the ECS instance is restarted.