Page History

Setting up instances to mount and connect to the Lustre filesystem

This page documents manual installation and configuration of the Lustre Client. 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.hpdd.intelwhamcloud.com/job/lustre-b2_510/86/arch=x86_64,build_type=client,distro=el6el7,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.hpdd.intelwhamcloud.com/job/lustre-b2_5/8610/arch=x86_64%2Cbuild_type=client%2Cdistro=el6%2Cibclient,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://vaultmirror.centos.org/centos/6.57/updates/x86_64/Packages/kernel-23.610.320-431862.239.31.el6el7.x86_64.rpm

rpm -ivh --oldpackage kernel-23.610.320-431862.239.31.el6el7.x86_64.rpm

/sbin/grubby --set-default=/boot/vmlinuz-23.610.320-431862.239.31.el6el7.x86_6

64

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 -tlustret 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.hpdd.intelwhamcloud.com/display/PUB/Rebuilding+the+Lustre-client+rpms+for+a+new+kernel