Installing the Lustre client - FSx for Lustre
Amazon LinuxCentOS, Rocky Linux, and Red HatUbuntuSUSE Linux

Installing the Lustre client

To mount your Amazon FSx for Lustre file system from a Linux instance, first install the open-source Lustre client. Then, depending on your operating system version, use one of the following procedures. For kernel support information, see Lustre file system and client kernel compatibility.

If your compute instance isn't running the Linux kernel specified in the installation instructions, and you can't change the kernel, you can build your own Lustre client. For more information, see Compiling Lustre on the Lustre Wiki.

Amazon Linux

  1. Open a terminal on your client.

  2. Determine which kernel is currently running on your compute instance by running the following command.

    uname -r

  3. Review the system response and compare it to the following minimum kernel requirement for installing the Lustre client on Amazon Linux 2023:

    • 6.1 kernel minimum requirement - 6.1.79-99.167.amzn2023

    If your EC2 instance meets the minimum kernel requirement, proceed to the step and install the Lustre client.

    If the command returns a result less than the kernel minimum requirement, update the kernel and reboot your Amazon EC2 instance by running the following command.

    sudo dnf -y update kernel && sudo reboot

    Confirm that the kernel has been updated using the uname -r command.

  4. Download and install the Lustre client with the following command.

    sudo dnf install -y lustre-client

  1. Open a terminal on your client.

  2. Determine which kernel is currently running on your compute instance by running the following command.

    uname -r

  3. Review the system response and compare it to the following minimum kernel requirements for installing the Lustre client on Amazon Linux 2:

    • 5.10 kernel minimum requirement - 5.10.144-127.601.amzn2

    • 5.4 kernel minimum requirement - 5.4.214-120.368.amzn2

    • 4.14 kernel minimum requirement - 4.14.294-220.533.amzn2

    If your EC2 instance meets the minimum kernel requirements, proceed to the step and install the Lustre client.

    If the command returns a result less than the kernel minimum requirement, update the kernel and reboot your Amazon EC2 instance by running the following command.

    sudo yum -y update kernel && sudo reboot

    Confirm that the kernel has been updated using the uname -r command.

  4. Download and install the Lustre client with the following command.

    sudo amazon-linux-extras install -y lustre

    If you are unable to upgrade the kernel to the kernel minimum requirement, you may install the legacy 2.10 client with the following command.

    sudo amazon-linux-extras install -y lustre2.10

  1. Open a terminal on your client.

  2. Determine which kernel is currently running on your compute instance by running the following command. The Lustre client requires Amazon Linux kernel 4.14, version 104 or higher. 

    uname -r

  3. Do one of the following:

    • If the command returns 4.14.104-78.84.amzn1.x86_64 or a higher version of 4.14, download and install the Lustre client using the following command.

      sudo yum install -y lustre-client

    • If the command returns a result less than 4.14.104-78.84.amzn1.x86_64, update the kernel and reboot your Amazon EC2 instance by running the following command. 

      sudo yum -y update kernel && sudo reboot

      Confirm that the kernel has been updated using the uname -r command. Then download and install the Lustre client as described previously.

CentOS, Rocky Linux, and Red Hat

You can install and update Lustre client packages that are compatible with Red Hat Enterprise Linux (RHEL) and Rocky Linux from the Amazon FSx Lustre client yum package repository. These packages are signed to help ensure that they have not been tampered with before or during download. The repository installation fails if you don't install the corresponding public key on your system.

To add the Amazon FSx Lustre client yum package repository

  1. Open a terminal on your client.

  2. Install the Amazon FSx rpm public key by using the following command.

    curl https://fsx-lustre-client-repo-public-keys.s3.amazonaws.com/fsx-rpm-public-key.asc -o /tmp/fsx-rpm-public-key.asc

  3. Import the key by using the following command.

    sudo rpm --import /tmp/fsx-rpm-public-key.asc

  4. Add the repository and update the package manager using the following command.

    sudo curl https://fsx-lustre-client-repo.s3.amazonaws.com/el/9/fsx-lustre-client.repo -o /etc/yum.repos.d/aws-fsx.repo
To configure the Amazon FSx Lustre client yum repository

The Amazon FSx Lustre client yum package repository is configured by default to install the Lustre client that is compatible with the kernel version that initially shipped with the latest supported Rocky Linux and RHEL 9 release. To install a Lustre client that is compatible with the kernel version you are using, you can edit the repository configuration file.

This section describes how to determine which kernel you are running, whether you need to edit the repository configuration, and how to edit the configuration file.

  1. Determine which kernel is currently running on your compute instance by using the following command.

    uname -r

  2. Do one of the following:

    • If the command returns 5.14.0-427*, you don't need to modify the repository configuration. Continue to the To install the Lustre client procedure.

    • If the command returns 5.14.0-362.18.1, you must edit the repository configuration so that it points to the Lustre client for the Rocky Linux and RHEL 9.3 release.

    • If the command returns 5.14.0-70*, you must edit the repository configuration so that it points to the Lustre client for the Rocky Linux and RHEL 9.0 release.

  3. Edit the repository configuration file to point to a specific version of RHEL using the following command. Replace specific_RHEL_version with the RHEL version you need to use.

    sudo sed -i 's#9#specific_RHEL_version#' /etc/yum.repos.d/aws-fsx.repo

    For example, to point to release 9.3, substitute specific_RHEL_version with 9.3 in the command, as in the following example.

    sudo sed -i 's#9#9.3#' /etc/yum.repos.d/aws-fsx.repo

  4. Use the following command to clear the yum cache.

    sudo yum clean all
To install the Lustre client

  • Install the packages from the repository using the following command.

    sudo yum install -y kmod-lustre-client lustre-client

The commands preceding install the two packages that are necessary for mounting and interacting with your Amazon FSx file system. The repository includes additional Lustre packages, such as a package containing the source code and packages containing tests, and you can optionally install them. To list all available packages in the repository, use the following command.

yum --disablerepo="*" --enablerepo="aws-fsx" list available

To download the source rpm, containing a tarball of the upstream source code and the set of patches that we've applied, use the following command.

 sudo yumdownloader --source kmod-lustre-client

When you run yum update, a more recent version of the module is installed if available and the existing version is replaced. To prevent the currently installed version from being removed on update, add a line like the following to your /etc/yum.conf file.

installonlypkgs=kernel, kernel-PAE, installonlypkg(kernel), installonlypkg(kernel-module), 
              installonlypkg(vm), multiversion(kernel), kmod-lustre-client

This list includes the default install only packages, specified in the yum.conf man page, and the kmod-lustre-client package.

You can install and update Lustre client packages that are compatible with Red Hat Enterprise Linux (RHEL), Rocky Linux, and CentOS from the Amazon FSx Lustre client yum package repository. These packages are signed to help ensure that they have not been tampered with before or during download. The repository installation fails if you don't install the corresponding public key on your system.

To add the Amazon FSx Lustre client yum package repository

  1. Open a terminal on your client.

  2. Install the Amazon FSx rpm public key by using the following command.

    curl https://fsx-lustre-client-repo-public-keys.s3.amazonaws.com/fsx-rpm-public-key.asc -o /tmp/fsx-rpm-public-key.asc

  3. Import the key by using the following command.

    sudo rpm --import /tmp/fsx-rpm-public-key.asc

  4. Add the repository and update the package manager using the following command.

    sudo curl https://fsx-lustre-client-repo.s3.amazonaws.com/el/8/fsx-lustre-client.repo -o /etc/yum.repos.d/aws-fsx.repo
To configure the Amazon FSx Lustre client yum repository

The Amazon FSx Lustre client yum package repository is configured by default to install the Lustre client that is compatible with the kernel version that initially shipped with the latest supported CentOS, Rocky Linux, and RHEL 8 release. To install a Lustre client that is compatible with the kernel version you are using, you can edit the repository configuration file.

This section describes how to determine which kernel you are running, whether you need to edit the repository configuration, and how to edit the configuration file.

  1. Determine which kernel is currently running on your compute instance by using the following command.

    uname -r

  2. Do one of the following:

    • If the command returns 4.18.0-553*, you don't need to modify the repository configuration. Continue to the To install the Lustre client procedure.

    • If the command returns 4.18.0-513*, you must edit the repository configuration so that it points to the Lustre client for the CentOS, Rocky Linux, and RHEL 8.9 release.

    • If the command returns 4.18.0-477*, you must edit the repository configuration so that it points to the Lustre client for the CentOS, Rocky Linux, and RHEL 8.8 release.

    • If the command returns 4.18.0-425*, you must edit the repository configuration so that it points to the Lustre client for the CentOS, Rocky Linux, and RHEL 8.7 release.

    • If the command returns 4.18.0-372*, you must edit the repository configuration so that it points to the Lustre client for the CentOS, Rocky Linux, and RHEL 8.6 release.

    • If the command returns 4.18.0-348*, you must edit the repository configuration so that it points to the Lustre client for the CentOS, Rocky Linux, and RHEL 8.5 release.

    • If the command returns 4.18.0-305*, you must edit the repository configuration so that it points to the Lustre client for the CentOS, Rocky Linux, and RHEL 8.4 release.

    • If the command returns 4.18.0-240*, you must edit the repository configuration so that it points to the Lustre client for the CentOS and RHEL 8.3 release.

    • If the command returns 4.18.0-193*, you must edit the repository configuration so that it points to the Lustre client for the CentOS and RHEL 8.2 release.

  3. Edit the repository configuration file to point to a specific version of RHEL using the following command.

    sudo sed -i 's#8#specific_RHEL_version#' /etc/yum.repos.d/aws-fsx.repo

    For example, to point to release 8.9, substitute specific_RHEL_version with 8.9 in the command.

    sudo sed -i 's#8#8.9#' /etc/yum.repos.d/aws-fsx.repo

  4. Use the following command to clear the yum cache.

    sudo yum clean all
To install the Lustre client

  • Install the packages from the repository using the following command.

    sudo yum install -y kmod-lustre-client lustre-client

The commands preceding install the two packages that are necessary for mounting and interacting with your Amazon FSx file system. The repository includes additional Lustre packages, such as a package containing the source code and packages containing tests, and you can optionally install them. To list all available packages in the repository, use the following command. 

yum --disablerepo="*" --enablerepo="aws-fsx" list available

To download the source rpm, containing a tarball of the upstream source code and the set of patches that we've applied, use the following command.

 sudo yumdownloader --source kmod-lustre-client

When you run yum update, a more recent version of the module is installed if available and the existing version is replaced. To prevent the currently installed version from being removed on update, add a line like the following to your /etc/yum.conf file.

installonlypkgs=kernel, kernel-PAE, installonlypkg(kernel), installonlypkg(kernel-module), 
              installonlypkg(vm), multiversion(kernel), kmod-lustre-client

This list includes the default install only packages, specified in the yum.conf man page, and the kmod-lustre-client package.

You can install and update Lustre client packages that are compatible with Red Hat Enterprise Linux (RHEL) and CentOS from the Amazon FSx Lustre client yum package repository. These packages are signed to help ensure they have not been tampered with before or during download. The repository installation fails if you don't install the corresponding public key on your system.

To add the Amazon FSx Lustre client yum package repository

  1. Open a terminal on your client.

  2. Install the Amazon FSx rpm public key using the following command.

    curl https://fsx-lustre-client-repo-public-keys.s3.amazonaws.com/fsx-rpm-public-key.asc -o /tmp/fsx-rpm-public-key.asc

  3. Import the key using the following command.

    sudo rpm --import /tmp/fsx-rpm-public-key.asc

  4. Add the repository and update the package manager using the following command.

    sudo curl https://fsx-lustre-client-repo.s3.amazonaws.com/el/7/fsx-lustre-client.repo -o /etc/yum.repos.d/aws-fsx.repo
To configure the Amazon FSx Lustre client yum repository

The Amazon FSx Lustre client yum package repository is configured by default to install the Lustre client that is compatible with the kernel version that initially shipped with the latest supported CentOS and RHEL 7 release. To install a Lustre client that is compatible with the kernel version you are using, you can edit the repository configuration file.

This section describes how to determine which kernel you are running, whether you need to edit the repository configuration, and how to edit the configuration file.

  1. Determine which kernel is currently running on your compute instance by using the following command.

    uname -r

  2. Do one of the following:

    • If the command returns 3.10.0-1160*, you don't need to modify the repository configuration. Continue to the To install the Lustre client procedure.

    • If the command returns 3.10.0-1127*, you must edit the repository configuration so that it points to the Lustre client for the CentOS and RHEL 7.8 release.

    • If the command returns 3.10.0-1062*, you must edit the repository configuration so that it points to the Lustre client for the CentOS and RHEL 7.7 release.

  3. Edit the repository configuration file to point to a specific version of RHEL using the following command.

    sudo sed -i 's#7#specific_RHEL_version#' /etc/yum.repos.d/aws-fsx.repo

    To point to release 7.8, substitute specific_RHEL_version with 7.8 in the command.

    sudo sed -i 's#7#7.8#' /etc/yum.repos.d/aws-fsx.repo

    To point to release 7.7, substitute specific_RHEL_version with 7.7 in the command.

    sudo sed -i 's#7#7.7#' /etc/yum.repos.d/aws-fsx.repo

  4. Use the following command to clear the yum cache.

    sudo yum clean all
To install the Lustre client

  • Install the Lustre client packages from the repository using the following command.

    sudo yum install -y kmod-lustre-client lustre-client

The commands preceding install the two packages that are necessary for mounting and interacting with your Amazon FSx file system. The repository includes additional Lustre packages, such as a package containing the source code and packages containing tests, and you can optionally install them. To list all available packages in the repository, use the following command. 

yum --disablerepo="*" --enablerepo="aws-fsx" list available

To download the source rpm containing a tarball of the upstream source code and the set of patches that we've applied, use the following command.

 sudo yumdownloader --source kmod-lustre-client

When you run yum update, a more recent version of the module is installed if available, and the existing version is replaced. To prevent the currently installed version from being removed on update, add a line like the following to your /etc/yum.conf file.

installonlypkgs=kernel, kernel-big‐mem, kernel-enterprise, kernel-smp,
              kernel-debug, kernel-unsupported, kernel-source, kernel-devel, kernel-PAE,
              kernel-PAE-debug, kmod-lustre-client

This list includes the default install only packages, specified in the yum.conf man page, and the kmod-lustre-client package.

You can install and update Lustre client packages from the Amazon FSx Lustre client yum package repository that are compatible with CentOS 7 for Arm-based AWS Graviton-powered EC2 instances. These packages are signed to help ensure they have not been tampered with before or during download. The repository installation fails if you don't install the corresponding public key on your system.

To add the Amazon FSx Lustre client yum package repository

  1. Open a terminal on your client.

  2. Install the Amazon FSx rpm public key using the following command.

    curl https://fsx-lustre-client-repo-public-keys.s3.amazonaws.com/fsx-rpm-public-key.asc -o /tmp/fsx-rpm-public-key.asc
    curl https://fsx-lustre-client-repo-public-keys.s3.amazonaws.cn/fsx-rpm-public-key.asc -o /tmp/fsx-rpm-public-key.asc

  3. Import the key using the following command.

    sudo rpm --import /tmp/fsx-rpm-public-key.asc

  4. Add the repository and update the package manager using the following command.

    sudo curl https://fsx-lustre-client-repo.s3.amazonaws.com/centos/7/fsx-lustre-client.repo -o /etc/yum.repos.d/aws-fsx.repo
To configure the Amazon FSx Lustre client yum repository

The Amazon FSx Lustre client yum package repository is configured by default to install the Lustre client that is compatible with the kernel version that initially shipped with the latest supported CentOS 7 release. To install a Lustre client that is compatible with the kernel version you are using, you can edit the repository configuration file.

This section describes how to determine which kernel you are running, whether you need to edit the repository configuration, and how to edit the configuration file.

  1. Determine which kernel is currently running on your compute instance by using the following command.

    uname -r

  2. Do one of the following:

    • If the command returns 4.18.0-193*, you don't need to modify the repository configuration. Continue to the To install the Lustre client procedure.

    • If the command returns 4.18.0-147*, you must edit the repository configuration so that it points to the Lustre client for the CentOS 7.8 release.

  3. Edit the repository configuration file to point to the CentOS 7.8 release using the following command.

    sudo sed -i 's#7#7.8#' /etc/yum.repos.d/aws-fsx.repo

  4. Use the following command to clear the yum cache.

    sudo yum clean all
To install the Lustre client

  • Install the packages from the repository using the following command.

    sudo yum install -y kmod-lustre-client lustre-client

The commands preceding install the two packages that are necessary for mounting and interacting with your Amazon FSx file system. The repository includes additional Lustre packages, such as a package containing the source code and packages containing tests, and you can optionally install them. To list all available packages in the repository, use the following command. 

yum --disablerepo="*" --enablerepo="aws-fsx" list available

To download the source rpm, containing a tarball of the upstream source code and the set of patches that we've applied, use the following command.

 sudo yumdownloader --source kmod-lustre-client

When you run yum update, a more recent version of the module is installed if available, and the existing version is replaced. To prevent the currently installed version from being removed on update, add a line like the following to your /etc/yum.conf file.

installonlypkgs=kernel, kernel-big‐mem, kernel-enterprise, kernel-smp,
              kernel-debug, kernel-unsupported, kernel-source, kernel-devel, kernel-PAE,
              kernel-PAE-debug, kmod-lustre-client

This list includes the default install only packages, specified in the yum.conf man page, and the kmod-lustre-client package.

Ubuntu

You can get Lustre packages from the Ubuntu 22.04 Amazon FSx repository. To validate that the contents of the repository have not been tampered with before or during download, a GNU Privacy Guard (GPG) signature is applied to the metadata of the repository. Installing the repository fails unless you have the correct public GPG key installed on your system.

  1. Open a terminal on your client.

  2. Follow these steps to add the Amazon FSx Ubuntu repository:

    1. If you have not previously registered an Amazon FSx Ubuntu repository on your client instance, download and install the required public key. Use the following command.

      wget -O - https://fsx-lustre-client-repo-public-keys.s3.amazonaws.com/fsx-ubuntu-public-key.asc | gpg --dearmor | sudo tee /usr/share/keyrings/fsx-ubuntu-public-key.gpg >/dev/null

    2. Add the Amazon FSx package repository to your local package manager using the following command.

      sudo bash -c 'echo "deb [signed-by=/usr/share/keyrings/fsx-ubuntu-public-key.gpg] https://fsx-lustre-client-repo.s3.amazonaws.com/ubuntu jammy main" > /etc/apt/sources.list.d/fsxlustreclientrepo.list && apt-get update'

  3. Determine which kernel is currently running on your client instance, and update as needed. The Lustre client on Ubuntu 22.04 requires kernel 5.15.0-1015-aws or later for both x86-based EC2 instances and Arm-based EC2 instances powered by AWS Graviton processors.

    1. Run the following command to determine which kernel is running.

      uname -r

    2. Run the following command to update to the latest Ubuntu kernel and Lustre version and then reboot.

      sudo apt install -y linux-aws lustre-client-modules-aws && sudo reboot

      If your kernel version is greater than 5.15.0-1015-aws for both x86-based EC2 instances and Graviton-based EC2 instances, and you don’t want to update to the latest kernel version, you can install Lustre for the current kernel with the following command. 

      sudo apt install -y lustre-client-modules-$(uname -r)

      The two Lustre packages that are necessary for mounting and interacting with your FSx for Lustre file system are installed. You can optionally install additional related packages such as a package containing the source code and packages containing tests that are included in the repository.

    3. List all available packages in the repository by using the following command. 

      sudo apt-cache search ^lustre

    4. (Optional) If you want your system upgrade to also always upgrade Lustre client modules, make sure that the lustre-client-modules-aws package is installed using the following command.

      sudo apt install -y lustre-client-modules-aws
Note

If you get a Module Not Found error, see To troubleshoot missing module errors.

Lustre 2.12 clients are supported on Ubuntu 20.04 with kernel 5.15.0-1015-aws or later. Lustre 2.10 clients are supported on Ubuntu 20.04 with kernel 5.4.0-1011-aws or later on x86-based EC2 instances and kernel 5.4.0-1015-aws or later on Arm-based EC2 instances powered by AWS Graviton processors.

You can get Lustre packages from the Ubuntu 20.04 Amazon FSx repository. To validate that the contents of the repository have not been tampered with before or during download, a GNU Privacy Guard (GPG) signature is applied to the metadata of the repository. Installing the repository fails unless you have the correct public GPG key installed on your system.

  1. Open a terminal on your client.

  2. Follow these steps to add the Amazon FSx Ubuntu repository:

    1. If you have not previously registered an Amazon FSx Ubuntu repository on your client instance, download and install the required public key. Use the following command.

      wget -O - https://fsx-lustre-client-repo-public-keys.s3.amazonaws.com/fsx-ubuntu-public-key.asc | gpg --dearmor | sudo tee /usr/share/keyrings/fsx-ubuntu-public-key.gpg >/dev/null

    2. Add the Amazon FSx package repository to your local package manager using the following command.

      sudo bash -c 'echo "deb [signed-by=/usr/share/keyrings/fsx-ubuntu-public-key.gpg] https://fsx-lustre-client-repo.s3.amazonaws.com/ubuntu focal main" > /etc/apt/sources.list.d/fsxlustreclientrepo.list && apt-get update'

  3. Determine which kernel is currently running on your client instance, and update as needed.

    1. Run the following command to determine which kernel is running.

      uname -r

    2. Run the following command to update to the latest Ubuntu kernel and Lustre version and then reboot.

      sudo apt install -y linux-aws lustre-client-modules-aws && sudo reboot

      If your kernel version is greater than 5.4.0-1011-aws for x86-based EC2 instances, or greater than 5.4.0-1015-aws for Graviton-based EC2 instances, and you don’t want to update to the latest kernel version, you can install Lustre for the current kernel with the following command. 

      sudo apt install -y lustre-client-modules-$(uname -r)

      The two Lustre packages that are necessary for mounting and interacting with your FSx for Lustre file system are installed. You can optionally install additional related packages such as a package containing the source code and packages containing tests that are included in the repository.

    3. List all available packages in the repository by using the following command. 

      sudo apt-cache search ^lustre

    4. (Optional) If you want your system upgrade to also always upgrade Lustre client modules, make sure that the lustre-client-modules-aws package is installed using the following command.

      sudo apt install -y lustre-client-modules-aws
Note

If you get a Module Not Found error, see To troubleshoot missing module errors.

Note

The last supported Ubuntu 18 kernel version is 5.4.0.1103.aws.

You can get Lustre packages from the Ubuntu 18.04 Amazon FSx repository. To validate that the contents of the repository have not been tampered with before or during download, a GNU Privacy Guard (GPG) signature is applied to the metadata of the repository. Installing the repository fails unless you have the correct public GPG key installed on your system.

  1. Open a terminal on your client.

  2. Follow these steps to add the Amazon FSx Ubuntu repository:

    1. If you have not previously registered an Amazon FSx Ubuntu repository on your client instance, download and install the required public key. Use the following command.

      wget -O - https://fsx-lustre-client-repo-public-keys.s3.amazonaws.com/fsx-ubuntu-public-key.asc | gpg --dearmor | sudo tee /usr/share/keyrings/fsx-ubuntu-public-key.gpg >/dev/null

    2. Add the Amazon FSx package repository to your local package manager using the following command.

      sudo bash -c 'echo "deb [signed-by=/usr/share/keyrings/fsx-ubuntu-public-key.gpg] https://fsx-lustre-client-repo.s3.amazonaws.com/ubuntu bionic main" > /etc/apt/sources.list.d/fsxlustreclientrepo.list && apt-get update'

  3. Determine which kernel is currently running on your client instance, and update as needed. The Lustre client on Ubuntu 18.04 requires kernel 4.15.0-1054-aws or later for x86-based EC2 instances and kernel 5.3.0-1023-aws or later for Arm-based EC2 instances powered by AWS Graviton processors.

    1. Run the following command to determine which kernel is running.

      uname -r

    2. Run the following command to update to the latest Ubuntu kernel and Lustre version and then reboot.

      sudo apt install -y linux-aws lustre-client-modules-aws && sudo reboot

      If your kernel version is greater than 4.15.0-1054-aws for x86-based EC2 instances, or greater than 5.3.0-1023-aws for Graviton-based EC2 instances, and you don’t want to update to the latest kernel version, you can install Lustre for the current kernel with the following command. 

      sudo apt install -y lustre-client-modules-$(uname -r)

      The two Lustre packages that are necessary for mounting and interacting with your FSx for Lustre file system are installed. You can optionally install additional related packages, such as a package containing the source code and packages containing tests that are included in the repository.

    3. List all available packages in the repository by using the following command.

      sudo apt-cache search ^lustre

    4. (Optional) If you want your system upgrade to also always upgrade Lustre client modules, make sure that the lustre-client-modules-aws package is installed using the following command.

      sudo apt install -y lustre-client-modules-aws
Note

If you get a Module Not Found error, see To troubleshoot missing module errors.

If you get a Module Not Found error while installing on any version of Ubuntu, do the following:

Downgrade your kernel to the latest supported version. List all available versions of the lustre-client-modules package and install the corresponding kernel. To do this, use the following command.

sudo apt-cache search lustre-client-modules

For example, if the latest version that is included in the repository is lustre-client-modules-5.4.0-1011-aws, do the following:

  1. Install the kernel that this package was built for using the following commands.

    sudo apt-get install -y linux-image-5.4.0-1011-aws
    sudo sed -i 's/GRUB_DEFAULT=.\+/GRUB\_DEFAULT="Advanced options for Ubuntu>Ubuntu, with Linux 5.4.0-1011-aws"/' /etc/default/grub
    sudo update-grub

  2. Reboot your instance using the following command.

    sudo reboot

  3. Install the Lustre client using the following command.

    sudo apt-get install -y lustre-client-modules-$(uname -r)

SUSE Linux

To install the Lustre client on SUSE Linux 12 SP3

  1. Open a terminal on your client.

  2. Install the Amazon FSx rpm public key by using the following command.

    sudo wget https://fsx-lustre-client-repo-public-keys.s3.amazonaws.com/fsx-sles-public-key.asc

  3. Import the key by using the following command.

    sudo rpm --import fsx-sles-public-key.asc

  4. Add the repository for the Lustre client using the following command.

    sudo wget https://fsx-lustre-client-repo.s3.amazonaws.com/suse/sles-12/SLES-12/fsx-lustre-client.repo

  5. Download and install the Lustre client with the following commands.

    sudo zypper ar --gpgcheck-strict fsx-lustre-client.repo
sudo sed -i 's#SLES-12#SP3#' /etc/zypp/repos.d/aws-fsx.repo
sudo zypper refresh
sudo zypper in lustre-client
To install the Lustre client on SUSE Linux 12 SP4

  1. Open a terminal on your client.

  2. Install the Amazon FSx rpm public key by using the following command.

    sudo wget https://fsx-lustre-client-repo-public-keys.s3.amazonaws.com/fsx-sles-public-key.asc

  3. Import the key by using the following command.

    sudo rpm --import fsx-sles-public-key.asc

  4. Add the repository for the Lustre client using the following command.

    sudo wget https://fsx-lustre-client-repo.s3.amazonaws.com/suse/sles-12/SLES-12/fsx-lustre-client.repo

  5. Do one of the following:

    • If you installed SP4 directly, download and install the Lustre client with the following commands.

      sudo zypper ar --gpgcheck-strict fsx-lustre-client.repo
sudo sed -i 's#SLES-12#SP4#' /etc/zypp/repos.d/aws-fsx.repo
sudo zypper refresh
sudo zypper in lustre-client

    • If you migrated from SP3 to SP4 and previously added the Amazon FSx repository for SP3, download and install the Lustre client with the following commands.

      sudo zypper ar --gpgcheck-strict fsx-lustre-client.repo
sudo sed -i 's#SP3#SP4#' /etc/zypp/repos.d/aws-fsx.repo
sudo zypper ref
sudo zypper up --force-resolution lustre-client-kmp-default
To install the Lustre client on SUSE Linux 12 SP5

  1. Open a terminal on your client.

  2. Install the Amazon FSx rpm public key by using the following command.

    sudo wget https://fsx-lustre-client-repo-public-keys.s3.amazonaws.com/fsx-sles-public-key.asc

  3. Import the key by using the following command.

    sudo rpm --import fsx-sles-public-key.asc

  4. Add the repository for the Lustre client using the following command.

    sudo wget https://fsx-lustre-client-repo.s3.amazonaws.com/suse/sles-12/SLES-12/fsx-lustre-client.repo

  5. Do one of the following:

    • If you installed SP5 directly, download and install the Lustre client with the following commands.

      sudo zypper ar --gpgcheck-strict fsx-lustre-client.repo
sudo zypper refresh
sudo zypper in lustre-client

    • If you migrated from SP4 to SP5 and previously added the Amazon FSx repository for SP4, download and install the Lustre client with the following commands.

      sudo sed -i 's#SP4#SLES-12' /etc/zypp/repos.d/aws-fsx.repo
sudo zypper ref
sudo zypper up --force-resolution lustre-client-kmp-default
Note

You might need to reboot your compute instance for the client to finish installing.