Rate This Document
Findability
Accuracy
Completeness
Readability

Deploying the FUSE Client

This section describes how to deploy the FUSE client.

Perform the operations in this section on the FUSE client.

  1. Obtain the binary file and configuration file from the compilation server.
    mkdir -p /var/log/3fs 
    mkdir -p /opt/3fs/{bin,etc} 
    mkdir -p /home/fio 
    rsync -avz meta:/home/3fs/build/bin/hf3fs_fuse_main /opt/3fs/bin 
    rsync -avz meta:/home/3fs/build/bin/admin_cli /opt/3fs/bin 
    rsync -avz meta:/home/3fs/configs/{hf3fs_fuse_main_launcher.toml,hf3fs_fuse_main.toml,hf3fs_fuse_main_app.toml} /opt/3fs/etc 
    rsync -avz meta:/home/3fs/deploy/systemd/hf3fs_fuse_main.service /usr/lib/systemd/system 
    rsync -avz meta:/home/3fs/build/src/lib/api/libhf3fs_api_shared.so /usr/lib
    rsync -avz meta:/opt/3fs/etc/token.txt /opt/3fs/etc 
    rsync -avz meta:/usr/lib64/libfdb_c.so /usr/lib64
    rsync -avz meta:/home/3fs/benchmarks/fio_usrbio/hf3fs_usrbio.so /usr/lib64
    rsync -avz meta:/home/fio/fio /home/fio
  2. Create a mount point.
    mkdir -p /3fs/stage
  3. Update the hf3fs_fuse_main_launcher.toml configuration file.
    1. Open /opt/3fs/etc/hf3fs_fuse_main_launcher.toml.
      vim /opt/3fs/etc/hf3fs_fuse_main_launcher.toml
    2. Press i to enter the insert mode and modify the configuration file as follows.
      ... 
      cluster_id = "stage" 
      mountpoint = '/3fs/stage' 
      token_file = '/opt/3fs/etc/token.txt' 
      ... 
      [mgmtd_client] 
      mgmtd_server_addresses = ["RDMA://192.168.65.10:8000"] 
      ...
    3. Press Esc to exit the insert mode. Type :wq! and press Enter to save the file and exit.
  4. Update the hf3fs_fuse_main.toml configuration file.
    1. Open /opt/3fs/etc/hf3fs_fuse_main.toml.
      vim /opt/3fs/etc/hf3fs_fuse_main.toml
    2. Press i to enter the insert mode and modify the configuration file as follows.
      ... 
      [mgmtd] 
      mgmtd_server_addresses = ["RDMA://192.168.65.10:8000"] 
      ... 
      [common.monitor.reporters.monitor_collector] 
      remote_ip = "192.168.65.10:10000" 
      ...
    3. Press Esc to exit the insert mode. Type :wq! and press Enter to save the file and exit.
  5. Update the configuration file to the Mgmtd node.
    /opt/3fs/bin/admin_cli -cfg /opt/3fs/etc/admin_cli.toml "set-config --type FUSE --file /opt/3fs/etc/hf3fs_fuse_main.toml"
  6. Start the service.
    systemctl start hf3fs_fuse_main
  7. Check the service status.
    systemctl status hf3fs_fuse_main

  8. Check the mount point.
    df -h 

    The command output is as follows:

    # Filesystem                         Size  Used Avail Use% Mounted on 
    # ... 
    # hf3fs.stage                         70T  650G   70T   1% /3fs/stage