UPFS Client Installation

UPFS is a distributed parallel file system that supports POSIX file semantics and uses FUSE-based user-space filesystem access. You need to install the client before using the product. UCloud supports installation via package managers and client installation packages.

Method 1: Installation via Package Manager

When installing via package manager, please ensure that the installation source of your operating system is the official operating system image provided by UCloud, and the cloud host type is a CPU type cloud host.

For users using CentOS8/7, Rocky8, it is recommended to install the client using this method. During the beta testing period, the restrictions on the cloud host operating system image versions that support client installation via package manager are as shown in the table below. If your business cloud host operating system version is not in the table, we recommend that you install the client using method 2.

• If it is a CentOS system host, you need to execute the following commands to ensure that the package manager version is the latest version:

  yum clean all && yum makecache

After the package manager version is updated, please execute the following command to install the UPFS client:

```shell
yum install upfs_client
```

• If it is a Rocky system host, you need to execute the following commands to ensure that the package manager version is the latest version:

  dnf clean all && dnf makecache

After the package manager version is updated, please execute the following command to install the UPFS client:

```shell
dnf install upfs_client
```

Method 2: Installation via Client Installation Package

When there is a lack of system installation sources or if the system’s discovered version is too low to install dependencies via the package manager, installation can also be done manually using the provided installation package.

1. Download the installation package.

wget https://upfs-public.cn-bj.ufileos.com/upfs_client-public-v1.tar.gz

2. Unzip the installation package.

tar zxvf upfs_client-public-v1.tar.gz

3. Execute the installation script.

cd ./upfs_client-public-v1 && ./install.sh

Please note that if the operating system type is Ubuntu, root permission is needed to execute the command, please refer to the following command:

cd ./upfs_client-public-v1 && sudo ./install.sh

Cautions:

• When installing the client during mounting via Linux method or K8s mounting, you can refer to both of the above methods.
• When installing the client during K8s mounting, the UPFS client needs to be installed on all K8s work nodes.