Using the Autoconfig tool to build the GPFS portability layer on Linux nodes
To simplify the build process, GPFS provides an automatic configuration tool called Autoconfig.
The following example shows the commands required to build the GPFS portability layer by using the Autoconfig
tool:
cd /usr/lpp/mmfs/src
make Autoconfig
make World
make InstallImages
Each kernel module is specific to a Linux® version and platform. If you have multiple nodes running exactly the same operating system level on the same platform, or if you have a compiler available on only one node, you can build the kernel module on one node, then create an installable package that contains the binary module for ease of distribution.
If you choose to generate an installable package for portability layer binaries, perform the following additional step:
make rpm for SLES and RHEL Linux
make deb for Ubuntu Linux
When the command finishes, it displays the location of the generated package as in
the following
examples:
Wrote: /root/rpmbuild/RPMS/x86_64/gpfs.gplbin-4.18.0-305.12.1.el8_4.x86_64-5.2.3-x.x86_64.rpm
orWrote: /tmp/deb/gpfs.gplbin-5.4.0-81-generic_5.2.3-x_amd64.deb
You
can then copy the generated package to other machines for deployment. By default, the generated
package can be deployed only to machines whose architecture, distribution level, Linux kernel, and IBM
Storage Scale maintenance level are identical with those of the machine on which the
gpfs.gplbin package was built. However, you can install the generated package
on a machine with a different Linux kernel by setting the
MM_INSTALL_ONLY
environment variable before you install the generated
package. If you install the
gpfs.gplbin package, you do not need to install the
gpfs.gpl package.Note: During the package generation, temporary files are
written to the /tmp/rpm or /tmp/deb directory, so be sure there is sufficient space
available. By default, the generated package goes to /usr/src/packages/RPMS/<arch> for
SUSE Linux Enterprise Server,
/usr/src/redhat/RPMS/<arch> for Red Hat Enterprise Linux, and /tmp/deb for Ubuntu Linux.
Important:
- The GPFS portability layer is specific to both the current kernel and the GPFS version. If either the kernel or the GPFS version changes, a new GPFS portability layer needs to be built.
- Although operating system kernels might upgrade to a new version, they are not active until after a reboot. Thus, a GPFS portability layer for this new kernel must be built after a reboot of the operating system.
- Before you install a new GPFS portability layer, make sure to uninstall the prior version of the GPFS portability layer first.