Setting up instances to mount and connect to the Lustre filesystem


This page documents manual installation and configuration of the Lustre Client on Centos7 base OS. We recommend using Automated Client Setup tool for new installs. 

Installing the Client

In order to mount a Lustre filesystem as a client, the intended client instances must have the Lustre client software installed.


If the client instances do not have a specific kernel version requirements, the easiest way to proceed is to install an older kernel along with the Lustre packages from this repository: https://build.whamcloud.com/job/lustre-b2_10/arch=x86_64,build_type=client,distro=el7,ib_stack=inkernel/


If you desire, you can create a yum repository for this by creating a file as follows on your client instances:

# cat <<EOF >/etc/yum.repos.d/lustre-client.repo
[lustre-client]
name=Lustre Client
gpgcheck=0
baseurl=https://build.whamcloud.com/job/lustre-b2_10/arch=x86_64%2Cbuild_type=client,distro=el7,ib_stack=inkernel/lastSuccessfulBuild/artifact/artifacts/

EOF


In order to use these prebuilt packages, however, you'll need to download and install the older kernel:

wget http://mirror.centos.org/centos/7/updates/x86_64/Packages/kernel-3.10.0-862.9.1.el7.x86_64.rpm
rpm -ivh --oldpackage kernel-3.10.0-862.9.1.el7.x86_64.rpm
/sbin/grubby --set-default=/boot/vmlinuz-3.10.0-862.9.1.el7.x86_64



Reboot


After rebooting and verifying that you have the correct kernel, you may run the following command to install the Lustre client packages:

yum install lustre-client


You will then need to log into the "MGT" instance and run the the following command as root to learn the MGS NID needed for your client mount command:

lctl list_nids


This will give you a NID something like 10.0.2.13@tcp, which you then add to a client mount command (adjusting NID and filesystem name for actual values):

mount -t lustre 10.0.2.13@tcp:/scratch /mnt/scratch


If this command completes successfully, you will have an active Lustre mount, and you may then verify that the filesystem behaves and performs as expected.





It is also possible to build the Lustre client packages against a more recent kernel, which is a more involved process as described here: https://wiki.whamcloud.com/display/PUB/Rebuilding+the+Lustre-client+rpms+for+a+new+kernel