Install

Updated at：2025-11-03

Fuse module installation

Before installing bosfs, users must ensure the FUSE kernel module has been installed in the target system. This can be verified using the ls /dev/fuse or modprobe fuse command. If the module is not installed, perform the following steps:

For CentOS system, execute yum -y install fuse fuse-devel with root permission.
For Ubuntu system, execute apt install libfuse2 libfuse-dev with root permission;
If installation fails or the version of Fuse installed in the system is below 2.9.4, source code installation is required:
Download libfuse Source Package and compile and install it by yourself (./configure && make && sudo make insatll);
Due to the low kernel versions in Linux systems of low versions, the bosfs process is prone to disconnections or other problems during running.
Therefore, it is recommended that users upgrade their OS to CentOS 7.0 or Ubuntu 14.04 and above, and bosfs to 1.0.0.12 and above.

Ubuntu system installation

Install dependency packages required for bosfs

Plain Text

1sudo apt-get -y install build-essential
2sudo apt-get install autoconf
3sudo apt-get install uuid-dev
4sudo apt-get install libssl-dev
5sudo apt-get install libcurl4-openssl-dev
6
7 If the system fuse installation fails or the system version is below 2.9.4,
8 you need to install fuse with source codes, download the libfuse source package and install it
9tar -xzvf fuse-2.9.4.tar.gz
10cd fuse-2.9.4
11./configure
12sudo make && sudo make install

Note: If your libstdc++ version is low, the following errors will be displayed after the bosfs is installed successfully:
Plain Text
1bosfs: /usr/lib64/libstdc++.so.6: version `GLIBCXX_3.4.14' not found (required by bosfs)
2bosfs: /usr/lib64/libstdc++.so.6: version `GLIBCXX_3.4.15' not found (required by bosfs)
It is recommended that the relevant libstdc++ should be upgraded manually or the gcc/g++ should be updated to support -std=c++11.

Download the bosfs Source Package.
Compile and install the package.
Plain Text
```
1tar -xzvf bosfs-1.0.0.13.1.tar.gz
2cd bosfs-1.0.0.13.1
3sudo sh build.sh
```
Note:
(1) If "'rpl_malloc' was not declared in this scope" is displayed during the compilation, this is due to a conflict between your system malloc and bosfs. The solution is to comment out AC_FUNC_MALLOC in the configure.ac file in the compilation directory.
(2) If the compilation of relevant dependency packages fails, view the process using sh -x and modify build.sh accordingly.
After installation, you can view the version using the bosfs -v command.
Note:
(1) If your fuse version is low, libfuse provided on the official website is recommended.
(2) The error "libfuse.so.2: cannot open Shared object file：No such file or directory
" is displayed during mounting. The reason is that the path for libfuse.so generation is not in the dynamic link path. Solutions:
1. echo /usr/local/lib >> /etc/ld.so.conf: Add /usr/local/lib to the link path.
2. ldconfig: Reload it into the system.

CentOS system installation

Since BOS FS depends on the environment, ensure that all necessary dependency packages are installed before compiling the source package. For instance, using Baidu AI Cloud's CentOS 6.5 virtual machine:

Install dependency packages required for bosfs

Plain Text

1sudo yum install gcc-c++
2sudo yum install autoconf
3sudo yum install automake
4sudo yum install libuuid-devel
5sudo yum install openssl-devel
6sudo yum install libcurl-devel  
7
8 If the system fuse installation fails or the system version is below 2.9.4,
9 you need to install fuse with source codes, download the libfuse source package and install it
10tar -xzvf fuse-2.9.4.tar.gz
11cd fuse-2.9.4
12./configure
13sudo make && sudo make install

Note: If your libstdc++ version is low, the following errors will be displayed after the bosfs is installed successfully:
Plain Text
1bosfs: /usr/lib64/libstdc++.so.6: version `GLIBCXX_3.4.14' not found (required by bosfs)
2bosfs: /usr/lib64/libstdc++.so.6: version `GLIBCXX_3.4.15' not found (required by bosfs)
It is recommended that the relevant libstdc++ should be upgraded manually or the gcc/g++ should be updated to support -std=c++11.

Download the bosfs Source Package.
Compile and install the package.

(1) Unzip the BOS FS source package
(2) Compile the source code:
- For default compilation: Directly execute build.sh;
- For custom compilation: First enter the cppsdk directory and execute configure, make and make install with custom parameters. Then, enter the bosfs directory and execute configure, makeand make install with custom parameters.
- Finally, obtain the binary executable file bosfs.
Note:
(1) If "'rpl_malloc' was not declared in this scope" is displayed during the compilation, this is due to a conflict between your system malloc and bosfs. The solution is to comment out AC_FUNC_MALLOC in the configure.ac file in the compilation directory.
(2) If the compilation of relevant dependency packages fails, view the process using sh -x and modify build.sh accordingly.
After installation, you can view the version using the bosfs -v command.
Note:
(1) If your fuse version is low, libfuse provided on the official website is recommended.
(2) The error "libfuse.so.2: cannot open Shared object file：No such file or directory
" is displayed during mounting. The reason is that the path for libfuse.so generation is not in the dynamic link path. Solutions:
1. echo /usr/local/lib >> /etc/ld.so.conf: Add /usr/local/lib to the link path.
2. ldconfig: Reload it into the system.

FAQs

Configuration