Help Center/ Object Storage Service/ Tool Guide (obsfs) (Paris Region)/ Environment Preparation/ Downloading and Installing obsfs
Updated on 2024-02-29 GMT+08:00
View PDF
Share

Downloading and Installing obsfs

For common Linux distributions, such as CentOS 7 and Ubuntu 16, there are obsfs installation packages available for download. After downloading obsfs, configure the Linux environment and then use the mount command to mount the parallel file system.

Downloading obsfs Software Packages

Table 1 obsfs download links

Linux Distribution

Download Link

CentOS 7

https://obsfs.oss.eu-west-0.prod-cloud-ocb.orange-business.com/obsfs_CentOS7.6_amd64.tar.gz

Ubuntu 16

https://obsfs.oss.eu-west-0.prod-cloud-ocb.orange-business.com/obsfs_Ubuntu16.04_amd64.tar.gz
  • Before installing obsfs, check the operating system distribution you are using, so that you can download a right obsfs installation package.
  • obsfs software packages support only OpenSSL 1.0.0 and earlier versions.

Installing obsfs

  1. On a PC running Windows, download the obsfs software package based on the version of the Linux distribution.
  2. Use a common cross-platform transmission tool (such as WinSCP) to transfer the software package to your Linux OS.
  3. Run the following decompression command on the computer running Linux: 
    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 will add a scheduled task for compressing and dumping obsfs logs. The dump path is /var/log/obsfs/.

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

Configuring a Runtime Environment

The operating environment of obsfs depends on the software packages such as openssl-devel, fuse, and fuse-devel. Before running obsfs, you need to run commands to configure the dependent environment.

  • obsfs supports libfuse 2.9.7, 2.9.8, or 2.9.9. If your system has a different version of libfuse installed, remove it and install the correct version by referring to libfuse Installation Guide.
  • You can view the libfuse version by running the system's version query command or run the following command: 
    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.

If there is an error message in the command output, run the openssl version command to check whether the OpenSSL version is 1.0.0 or an earlier one.

Parent topic: Environment Preparation