File Storage – High Performance

1. Overview

The File Storage - High Performance service is now available for Baremetal infrastructure in the Japan region. To request access, please contact Sales or Technical Support and provide the following information:

• Requested storage quota
• Subnet to connect

2. User Guide

A. Using image provided by FPT AI FACTORY

If you are using images provided by FPT AI FACTORY, the DDN client is already pre-installed. Please follow the steps below:

Step 1: Create mount directory

# Create Mount Point
mkdir /mnt/hps

Step 2: Manually mount the file system

# Create Mount Point
mount -t lustre 100.69.252.1@o2ib,100.69.252.2@o2ib:100.69.252.3@o2ib,100.69.252.4@o2ib:100.69.252.5@o2ib,100.69.252.6@o2ib:100.69.252.7@o2ib,100.69.252.8@o2ib:/scratch /mnt/hps

Step 3: Configure auto-mount on boot

Edit the file /etc/fstab:

## LustreFS ##
100.69.252.1@o2ib,100.69.252.2@o2ib:100.69.252.3@o2ib,100.69.252.4@o2ib:100.69.252.5@o2ib,100.69.252.6@o2ib:100.69.252.7@o2ib,100.69.252.8@o2ib:/scratch /mnt/hps lustre flock,defaults 0 0

Explanation

• "100.69.252.1@o2ib,100.69.252.2@o2ib:...:100.69.252.8@o2ib:/scratch"
  • 100.69.252.1 to 100.69.252.8 are fixed endpoint addresses.
  • /scratch is the filesystem path on the Lustre server.
• /mnt/hps
  • Mount point on the client (created in step 1).

Note: Run the following command to check for mount errors:

mount -a

Step 4: Verify

df -h -t lustre

Expected output:

Filesystem                    Size  Used Avail Use% Mounted on
...:/scratch                 11T   8.0K   11T   1%   /mnt/hps

B. If you are using a custom Ubuntu image

If you are using a custom image, you need to build the packages manually by following the instructions below:

Step 1: Build Lustre Client

You may skip this step if the client has already been built for your current kernel.

wget https://s3-sgn10.fptcloud.com/file-storage-resource/exa-client-6.3.2.tar.gz
tar xzvf exa-client-6.3.2.tar.gz
cd exa-client
./exa_client_deploy.py

# Select option 2
# Wait for configure and build
# After installation is finished, select option 6
# (compiled packages are saved in /opt/ddn/exascaler/debs)

If your Ubuntu OS is running kernel 5.15.0-130-generic, you can skip the build and use pre-built packages below:

# Install Lustre Pkg (for kernel 5.15.0-130-generic)

wget https://s3-sgn10.fptcloud.com/package-pub/lustre-dev_2.14.0-ddn184-1_amd64.deb
wget https://s3-sgn10.fptcloud.com/package-pub/lustre-client-modules-5.15.0-130-generic_2.14.0-ddn184-1_amd64.deb
wget https://s3-sgn10.fptcloud.com/package-pub/lustre-client-utils_2.14.0-ddn184-1_amd64.deb

Step 2: Install Lustre Client

Install the Lustre Client using .deb packages built in step 1 or downloaded above.

• Only perform this step if the matching .deb packages are available.
• If not, return to Step 1 to build the required packages.
• If the kernel version does not match the package, errors may occur and a rebuild will be necessary.

# Install Lustre Pkg (for kernel 5.15.0-130-generic)

sudo dpkg -i lustre-dev_2.14.0-ddn184-1_amd64.deb \
             lustre-client-modules-5.15.0-130-generic_2.14.0-ddn184-1_amd64.deb \
             lustre-client-utils_2.14.0-ddn184-1_amd64.deb

Step 3: Optimize configuration

Edit /etc/modprobe.d/lustre.conf:

# Edit or create file /etc/modprobe.d/lustre.conf like below 
[/etc/modprobe.d/lustre.conf]
options lnet networks=o2ib(bond0)    <==HERE!
options ko2iblnd peer_credits=32 peer_credits_hiw=16 concurrent_sends=64

Edit /etc/lustre_client:

# Edit or create file /etc/lustre_client like below
[/etc/lustre_client]

#++++++++++++++++++++++++++++++++++++
# LNET Interface
IF1=bond0        <==HERE!
IF2=none
IF3=none
IF4=none
IF5=none
IF6=none
IF7=none
IF8=none

Step 4: Create mount point

# Create Mount Point
mkdir /mnt/hps

Step 5: Manually mount the file system

# Create Mount Point

mount -t lustre 100.69.252.1@o2ib,100.69.252.2@o2ib:100.69.252.3@o2ib,100.69.252.4@o2ib:100.69.252.5@o2ib,100.69.252.6@o2ib:100.69.252.7@o2ib,100.69.252.8@o2ib:/scratch /mnt/hps

Step 6: Configure auto-mount

Edit the file /etc/fstab:

# Write followings entries to /etc/fstab
##LustreFS##

100.69.252.1@o2ib,100.69.252.2@o2ib:100.69.252.3@o2ib,100.69.252.4@o2ib:100.69.252.5@o2ib,100.69.252.6@o2ib:100.69.252.7@o2ib,100.69.252.8@o2ib:/scratch /mnt/hps lustre flock,defaults 0 0

Explanation

• "100.69.252.1@o2ib,100.69.252.2@o2ib:...:100.69.252.8@o2ib:/scratch"
  • 100.69.252.1 to 100.69.252.8 are fixed endpoint addresses.
  • /scratch is the filesystem path on the Lustre server.
• /mnt/hps
  • Mount point on the client (created in step 1).

Note: Run the command below to check if the mount configuration is valid:

mount -a

Step 7: Verify

df -h -t lustre