本文介绍安装、升级以及卸载 FSX 客户端的操作步骤。 ## 注意事项 * FSX 客户端处于邀测状态，如需试用，请提交工单。 * FSX 客户端支持的操作系统请参见[客户端支持的操作系统](https://www.volcengine.com/docs/6645/1333887#6565f166)。 * FSX 客户端会安装在`/opt/fsx`目录下，请确保该安装目录的磁盘可用空间大于 1GB，否则可能会导致安装失败或无法正常使用等问题。 * 安装 FSX 客户端时： * 客户端配置文件将存放在`/opt/tmp/fsx`目录，建议至少预留 2GiB 磁盘空间。 * 日志文件将存放在`/var/log/fsx`目录，当仅挂载 vePFS 时，建议至少预留 2GiB 磁盘空间；如需挂载多种存储类型，需要至少预留 2GiB × 存储类型个数的磁盘空间。 * 请确保您的系统中没有同名目录，否则可能会出现安装失败或无法正常使用等问题。 ## 安装 FSX 客户端 FSX 客户端支持多种操作系统，请您根据操作系统类型，选择合适的安装方式。基于 deb 的发行版（veLinux/Ubuntu/Debian） 1. 请根据操作系统类型，提交工单联系技术团队，获取最新的安装包。 2. 执行以下命令，安装客户端。 ```Bash dpkg -i fsx_amd64.deb ``` 3. 执行以下命令，查看客户端版本。 ```Bash fsx -v ``` 返回类似下方的版本信息，表示安装成功。

说明

示例版本号仅供参考，实际显示的版本号以您安装的客户端版本为准。

```Bash Version: 1.1.0.400 ``` 基于 RPM 的发行版（veLinux CentOS Compatible/CentOS） 1. 请根据操作系统类型，提交工单联系技术团队，获取最新的安装包。 2. 执行以下命令，安装客户端。 ```Bash rpm -ivh fsx_x86_64.rpm ``` 3. 执行以下命令，查看客户端版本。 ```Bash fsx -v ``` 返回类似下方的版本信息，表示安装成功。

说明

示例版本号仅供参考，实际显示的版本号以您安装的客户端版本为准。

```Bash Version: 1.1.0.400 ``` 其他 OS 系统 1. 请根据操作系统类型，提交工单联系技术团队，获取最新的安装包。 2. 执行以下命令，创建`/opt/fsx`目录。 ```Bash sudo mkdir -p /opt/fsx ``` 3. 执行以下命令，解压`fsx.tar.gz`至`/opt/fsx`目录。 ```Bash sudo tar -C /opt/fsx -xzf ./fsx.tar.gz ``` 4. 进入`/opt/fsx`目录，执行以下命令，安装 FSX。 ```Bash sudo ./fsx -m install ``` 5. 执行以下命令，查看客户端版本。 ```Bash sudo fsx -v ``` 返回类似下方的版本信息，表示安装成功。

说明

示例版本号仅供参考，实际显示的版本号以您安装的客户端版本为准。

```Bash Version: 1.1.0.400 ``` ## 升级 FSX 客户端

注意

升级客户端可能会有短时的业务抖动，建议您在业务低谷时执行升级操作。

基于 deb 的发行版（veLinux/Ubuntu/Debian） 1. 请根据操作系统类型，提交工单联系技术团队，获取最新的安装包。 2. 执行以下命令，升级客户端。 ```Bash dpkg -i fsx_amd64.deb ``` 3. 查看运行中的二进制版本与 dpkg 版本，确认客户端是否升级成功。

说明

若两个版本号一致，表示升级成功。

若两个版本号不一致，请提交工单联系技术支持。

1. 执行以下命令，查看运行中二进制版本。 ```Bash fsx -v ``` 返回如下版本信息。 ```Bash Version: 1.1.0.400 ``` 2. 执行以下命令，查看 dpkg 版本。 ```Bash dpkg -l fsx ``` 返回如下版本信息。 ```Bash ||/ Name Version Architecture Description +++-==============-============-============-================================================================================ ii fsx 1.1.0.400 amd64 fsx branch: fsx/xxx_09b1043bb962e8bb10****a71cb41477b9ce**** ``` 基于 RPM 的发行版（veLinux CentOS Compatible/CentOS） 1. 请根据操作系统类型，提交工单联系技术团队，获取最新的安装包。 2. 执行以下命令，升级客户端。 ```Bash rpm -Uvh fsx_x86_64.rpm ``` 3. 查看运行中的二进制版本与 dpkg 版本，确认客户端是否升级成功。

说明

若两个版本号一致，表示升级成功。

若两个版本号不一致，请提交工单联系技术支持。

1. 执行以下命令，查看运行中二进制版本。 ```Bash fsx -v ``` 返回如下版本信息。 ```Bash Version: 1.1.0.400 ``` 2. 执行以下命令，查看 dpkg 版本。 ```Bash rpm -qi fsx ``` 返回如下版本信息。 ```Bash Name : fsx Version : 1.1.0.400 Release : 1 Architecture: x86_64 Install Date: Mon 18 Nov 2024 04:30:00 PM CST ... ``` 其他 OS 系统 1. 请根据操作系统类型，提交工单联系技术团队，获取最新的安装包。 2. 执行以下命令，创建`/opt/fsx_temp`目录。 ```Bash sudo mkdir -p /opt/fsx_temp ``` 3. 执行以下命令，解压`fsx.tar.gz`至`/opt/fsx_temp`目录。以下命令中，客户端解压目录为`/opt/fsx_temp`，您可以据实际情况，使用其他目录。 ```Bash sudo tar -C /opt/fsx_temp -xzf ./fsx.tar.gz ``` 4. 进入`/opt/fsx_temp`目录，执行以下命令，升级客户端。 ```Bash sudo ./fsx -m update ``` 5. 升级完成后，您可以执行以下命令，删除安装包临时目录。 ```Bash sudo rm -rf /opt/fsx_temp ``` ## 卸载 FSX 客户端

注意

卸载客户端前，请确保您已在 Linux 系统卸载所有挂载目录，否则会导致 FSX 客户端卸载失败。

基于 deb 的发行版（veLinux/Ubuntu/Debian）执行以下命令，卸载 FSX 客户端。 ```Bash dpkg -P fsx ``` 基于 RPM 的发行版（veLinux CentOS Compatible/CentOS）执行以下命令，卸载 FSX 客户端。 ```Bash rpm -e fsx ``` 其他 OS 系统 1. 执行以下命令，进入`/opt/fsx`目录。 ```Bash sudo cd /opt/fsx ``` 2. 执行以下命令，卸载 FSX 客户端。 ```Bash sudo ./fsx -m uninstall ```

文件存储 vePFS