Page tree
Skip to end of metadata
Go to start of metadata

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:,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
name=Lustre Client


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

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


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, which you then add to a client mount command (adjusting NID and filesystem name for actual values):

mount -t lustre /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:

  • No labels