Help Center/ Object Storage Service/ Tools Guide/ obsfs/ Environment Preparation/ Method 1: Downloading and Installing obsfs
Updated on 2026-07-29 GMT+08:00
View PDF
Share

Method 1: Downloading and Installing obsfs

For common Linux distributions, obsfs provides installation packages for certain operating system versions. You can download any of them directly. After downloading obsfs, configure the Linux environment and then use the mount command to mount either an OBS parallel file system.

Downloading obsfs Software Packages

Table 1 lists the obsfs download links.

Table 1 obsfs download links

Linux Distribution

Download Link

CentOS 7

https://obs-community-intl.obs.ap-southeast-1.myhuaweicloud.com/obsfs/current/obsfs_CentOS7.6_amd64.tar.gz

Ubuntu 16

https://obs-community-intl.obs.ap-southeast-1.myhuaweicloud.com/obsfs/current/obsfs_Ubuntu16.04_amd64.tar.gz
  • obsfs supports only specific Linux distribution versions. Before downloading obsfs, make sure your operating system version is supported.

Installing obsfs

  1. On a Windows PC, download the obsfs software package that matches your Linux VM.

    If you are running the following command on a Linux PC, skip 2.

    wget <obsfs-download-link>
  2. Use a common cross-platform transmission tool (such as WinSCP) to transfer the software package to your Linux VM.
  3. Run the following decompression command on the Linux VM: 
    tar -xzvf <absolute-path-of-the-obsfs-software-package>/obsfs_xxx.tar.gz

    You can also run the following command to decompress the software package to a specified directory:

    tar -xzvf <absolute-path-of-the-obsfs-software-package>/obsfs_xxx.tar.gz -C specified-directory
  4. Switch to user root, go to the directory where the obsfs package is decompressed, and run the following command to install obsfs: 
    bash install_obsfs.sh

    You must install obsfs as user root, or some functions will not work.

    After you run the installation command, crontab automatically adds a scheduled task that compresses and dumps obsfs logs. The dump path is /var/log/obsfs/.

    An example of a task added by crontab is as follows: */10 * * * * [ -f /opt/dfv/obsfs/obsfs_log_rotate.sh ] && bash /opt/dfv/obsfs/obsfs_log_rotate.sh.

Configuring a Runtime Environment

The runtime environment of obsfs depends on packages such as openssl-devel, fuse, and fuse-devel. Before running obsfs, you need to install and configure these dependencies using commands.

  • obsfs supports libfuse 2.9.7, 2.9.8, and 2.9.9. If your system has a different libfuse version installed, remove it and install the correct version by referring to libfuse Installation Guide.
  • To check the libfuse version, use the system's built-in version query command or run the following command to locate libfuse.so: 
    find / -name libfuse.so*
  • CentOS 7 
    yum install -y openssl-devel fuse fuse-devel
  • Ubuntu 16 
    apt-get install -y libfuse-dev libcurl4-openssl-dev

Verification

Go to the directory where obsfs has been installed and run the following command to verify the installation.

./obsfs --version

If the obsfs version is displayed in the command output, obsfs has been installed, and you can then start initializing and using obsfs.

Parent topic: Environment Preparation