> ## Documentation Index
> Fetch the complete documentation index at: https://docs.siflow.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 挂载 GPFS 文件系统

挂载 GPFS 文件系统后，CES 实例或 CKS 集群节点可以通过本地目录访问文件系统中的数据。

## 前提条件

* GPFS 文件系统状态为 `Running`。
* 待挂载的 CES 实例或 CKS 集群节点与 GPFS 文件系统位于同一地域。

  GPFS 文件系统不可跨地域挂载。只有与文件系统位于同一地域的计算节点可以挂载该文件系统。
* 需要挂载的本地路径已规划完成。
  * 如果只挂载文件系统中的子目录，需确保该子目录已存在。
  * 同一个 CES 实例上如果有多个挂载，挂载路径应各不相同。

## 操作步骤

### 通过文件系统页面挂载

1. 登录控制台，打开 **CPFS** > **文件系统**。

2. 选择需要挂载的文件系统，单击**挂载**。

3. 选择需要挂载的 CES 实例，并配置路径。

   | 参数       | 说明                                                                  |
   | -------- | ------------------------------------------------------------------- |
   | CES 挂载路径 | 文件系统在 CES 上的挂载路径。挂载完成后，进入该路径即可访问文件系统中的数据。                           |
   | 文件路径     | 文件系统中的远端路径。填写 `/` 表示挂载整个文件系统；填写 `/path_to_your_dir` 表示只挂载文件系统中的子目录。 |

4. 单击**确定**，然后查看挂载结果。

   挂载成功时，结果显示为 `success`。如果挂载失败，对话框会显示错误信息。

### 通过实例页面挂载

1. 登录控制台，打开**实例**页面。

2. 选择需要挂载文件系统的 CES 实例，单击**挂载文件系统**。

3. 在弹出的对话框中，按照提示完成操作。

   | 配置项       | 说明                       |
   | --------- | ------------------------ |
   | GPFS 挂载服务 | 选择 GPFS 挂载服务和 VPC。       |
   | 绑定文件系统    | 如果新建挂载服务，需为存储卷绑定对应的文件系统。 |
   | 客户端管理     | 选择客户端节点。                 |
   | 挂载文件系统    | 配置挂载路径。                  |

4. 单击**确定**，然后查看挂载结果。

   挂载成功时，结果显示为 `success`。如果挂载失败，对话框会显示错误信息。

## 通过命令行手动挂载

如果需要在服务器上手动挂载，可使用以下命令格式：

```bash theme={null}
mount.xstor-gpfs -o tenantid=<tenant-id> xstor-<fsid>.<fsid>-001.aries:/ <mount-dir>
```

其中：

* `<tenant-id>` 是租户 ID。
* `xstor-<fsid>` 是文件系统 ID。
* `<mount-dir>` 是本地挂载目录。

示例：

```bash theme={null}
mount.xstor-gpfs -o tenantid=sXXXXXXyyyyyy xstor-01b12345.01b12345-001.aries:/ /data
```

## 挂载失败处理

挂载失败时，请先检查：

| 检查项    | 说明                           |
| ------ | ---------------------------- |
| 文件系统状态 | 文件系统状态应为 `Running`。          |
| 地域     | CES 实例或 CKS 集群节点应与文件系统在同一地域。 |
| 本地挂载路径 | 挂载路径不应与已有挂载冲突。               |
| 远端路径   | **文件路径** 指定的子目录应已存在。         |

如果仍无法解决，请记录错误信息并联系技术支持。