Mount and unmount a GPFS file system

Mount a GPFS file system to access shared data through a local directory on a compute node. You can start from either the file system page or the instance page in the console.

​

Prerequisites

• The file system is in the Running state and in the same region as the compute nodes. Cross-region mounting is not supported.
• The compute nodes have network connectivity to the mount service, and the Cloud Assistant components are running.
• The local mount path does not conflict with an existing mount. If you mount only a subdirectory of the file system, that subdirectory must already exist.

​

Mount from the file system page

1. Log in to the GPU Cloud console.
2. Go to GPFS > File System.
3. Select the file system and click Mount.
4. Select the CES instance and configure the paths.

   Parameter	Description
   Region	The region of the file system and CES instance.
   CES Instance	The instance that needs access to the file system.
   CES mount path	The local directory on the instance, such as /data. Use this directory to access data after mounting.
   File path	The remote path to mount. Enter / to mount the entire file system, or an existing subdirectory path to mount only that subdirectory.

5. Check the instance and paths, click Confirm, and wait for mounting to complete.
6. Find the mount path and log in to the instance to verify that you can access data through the target directory.

​

Mount from the instance page

1. Go to Instance and select the target instances on the GPU Instance or CPU Instance tab.
   • For a single instance, select Storage Operations > Mount File System from its more menu in the actions column.
   • For multiple instances, select them and click Mount File System in the bottom actions area.
2. In the GPFS Mount Service step of the Mount GPFS File System panel, select a mount service for the target instances. Create a service if no suitable one exists.

   Configuration item	Description
   Mount Service Name	Select an existing service, or select New Mount Service to create one.
   New Service Name	The name of the new mount service. Not required when you select an existing service.
   Region	The region of the mount service. Verify that it matches the target instances’ region.
   VPC	Shown after you select New Mount Service in regions with automatic node configuration. Select the VPC of the target instances. The system creates three Quorum nodes automatically.
   Quorum Nodes	Shown after you select New Mount Service in regions that require manual node configuration. Select three Quorum nodes. The mount service uses their VPC.

3. Click Next and complete the remaining steps in the wizard.

   Step	Action
   Bind File System	Bind the file system to the mount service.
   Client Management	Add the compute nodes that need file system access as clients.
   Mount File System	Configure the remote file system path and local mount path, then mount the file system.
   Result	Check the operation results.

4. Find the mount path and log in to the instances to verify data access. If any operations failed, record the error details and follow the checks in Troubleshoot mount failures.

​

Unmount a file system

Unmount a file system when an instance no longer needs access through a mount directory. The following steps use the CES instance page.

1. On the GPU Instance or CPU Instance tab of the Instance page, select one or more instances.
2. Select Unmount from the more menu in the bottom actions area.
3. Configure and verify the parameters in the Umount File System panel.

   Parameter	Description
   Mount Path	The local mount path to unmount.
   Nodes	The nodes on which to unmount the file system. Verify that all target instances are included.

4. Click Umount and wait for the operation to complete.
5. Find the mount paths again and verify that the target path is no longer mounted on the selected nodes.

Unmounting a file system, removing a client, and unbinding a file system are separate operations. To also clean up mount service configurations, manage the clients and file system bindings after unmounting.

​

Troubleshoot mount failures

If mounting fails, check the following: If the issue persists, contact technical support with the file system ID, mount service ID, instance ID, mount path, and error information.