Apsara File Storage NAS:Mount a NAS file system on multiple ECS instances at a time

Prerequisites

A file system is created. For more information, see Create a file system.

Network

You can use the ECS console to mount your file system on multiple ECS instances if your business network meets the requirements in the following scenarios:

• The ECS instances and the mount target of the NAS file system reside in the same virtual private cloud (VPC).

• The ECS instances and the mount target of the NAS file system reside in the classic network. The private IP addresses of the ECS instances are authorized in the permission group that is attached to the mount target. For more information, see Manage a permission group.

• The ECS instances and the mount target of the NAS file system reside in different VPCs, and the ECS instances can access and be accessed by the file system across VPCs. The private IP addresses of the ECS instances are authorized in the permission group that is attached to the mount target. For more information, see Mount a file system across VPCs in the same region.

Limits

• Operating system

  You can mount the file system only on a Linux ECS instance. Linux distributions such as CoreOS, FreeBSD, and Fedora CoreOS do not support the mount feature of the NAS console. If your ECS instance runs Red Hat Enterprise Linux (RHEL), you must install the Cloud Assistant client by using the RPM Package Manager (RPM) package before you mount your file system. For more information, see Install Cloud Assistant Agent on a Linux instance.

• Status of Cloud Assistant and ECS instances

  • You can mount your file system only on ECS instances that are in the Running state. If the ECS instances are in the Starting or Stopped state, change the status of each ECS instance to Running.

  • Cloud Assistant must run as expected.

• ECS instances

  The ECS instances and the NAS file system must reside in the same region. You cannot use Cloud Assistant to mount a file system on an ECS instance that resides in a different region.

Procedure

1. Log on to the ECS console.

2. In the left-side navigation pane, choose Maintenance & Monitoring > ECS Cloud Assistant.

3. In the upper-left corner of the top navigation bar, select a region.

4. On the Common Commands tab, enter ACS-NAS-ClickMount-Mount-Linux-NFS.sh in the search box to search for the name of the mount command. After the command name appears, click Create Task in the Actions column.

5. In the Create Task panel, configure the parameters in the Command Information section and select the ECS instances on which you want to mount the file system. The following table describes the parameters.

   Parameter	Description
   Command Information
   Command	Click View to view the command.
   Execution plan	Select a point in time at which you want to run the command. If you do not have special requirements, we recommend that you select Immediate execution. Immediate execution: The command is immediately run after you click Run. After the next startup of the system: The command is run the next time the selected instances are started after you click Run. After each system startup: The command is run each time the selected instances are started after you click Run.
   Username	Specify the username that is used to run the command on ECS instances. You must run the command as the root user or the system user. By default, Cloud Assistant commands are run by the root user on Linux instances and by the System user on Windows instances.
   Command Parameters	In the Command Parameters field, enter values for the custom parameters that are specified in the command. mounttargetdomain: the domain name of the mount target of the NAS file system. On the details page of the NAS file system in the NAS console, you can query the domain name of the mount target. For example, the domain name is ****.nas.aliyuncs.com. For more information, see View the domain name of a mount target. ecslocalpath: the local directory of the NAS file system that resides on the current ECS instance. The value must be an empty absolute path that starts with /. Example: /mnt. nasremotepath: the name of the shared directory in the NAS file system. You can enter the root directory of the NAS file system such as / or a subdirectory such as /abc. protocoltype: the protocol type of the NAS file system. General-purpose NAS file systems support NFSv3 and NFSv4.0. Extreme NAS file systems support NFSv3. Important We recommend that you specify a valid value for this parameter. This parameter is case-sensitive. Make sure that the value of this parameter is not preceded or followed by spaces. If the value of this parameter is invalid, the command fails. automountonboot: specifies whether to enable automatic mounting of the NAS file system when the ECS instance starts. Valid values: true and false. After you enable automatic mounting at startup, you do not need to re-mount the file system when you restart the ECS instance. Important We recommend that you specify a valid value for this parameter. The value can contain only lowercase letters. Make sure that the value of this parameter is not preceded or followed by spaces. If the value of the parameter is invalid, the command fails. mountparam: the mount parameters. By default, this parameter is not specified. You can configure this parameter based on your business scenario. For more information, see the mount parameters described in Mount an NFS file system on a Linux ECS instance.
   Select Instances
   Select Instances	Select one or more ECS instances on which you want to mount the NAS file system. If you have multiple instances, you can search for instances by ID, name, or tag, and filter results by client status.

6. Click Create Task.

Query the output of a command

After you mount, unmount, or query a NAS file system, you can use Cloud Assistant to query the results.

1. Log on to the ECS console.

2. In the left-side navigation pane, choose Maintenance & Monitoring > ECS Cloud Assistant.

3. In the upper-left corner of the top navigation bar, select a region.

4. On the Command Execution Result tab, select Command Name from the drop-down list, enter the name of the command whose output you want to query, and then click the icon.

   • Mount command: ACS-NAS-ClickMount-Mount-Linux-NFS.sh

   • Unmount command: ACS-NAS-ClickMount-Unmount-Linux-NFS.sh

   • Query command: ACS-NAS-ClickMount-Check-Linux-NFS.sh

5. In the Command Execution Result list, find the command name and click View in the Actions column.

6. In the Execution Details panel, click the icon before the instance name to view the command output.

7. After the query is complete, click Close.

Error messages

The following table describes the error messages that may be returned in the output of a command.

What to do next

If you want to query multiple ECS instances or unmount a file system from multiple ECS instances at a time, you can use Cloud Assistant to run commands.

FAQ

• Which mount options are supported by the batch mount feature?

• Can I use the batch mount feature to mount a file system on a host in a self-managed data center?

• Why does the new protocol type or the new value of a mount parameter not take effect when I use the batch mount feature?

• FAQ about mounting