mmbuildgpl command

Manages prerequisite packages for Linux and builds the GPFS™ portability layer.

Synopsis

mmbuildgpl [--quiet] [--build-package] [-v]

Availability

Available on all IBM Spectrum Scale™ editions. Available and needed only on Linux.

Description

Use the mmbuildgpl command to manage and verify prerequisite packages for Linux and build the GPFS portability layer. If all packages are installed correctly, mmbuildgpl builds the GPFS portability layer. If any packages are missing, the package names are displayed. The missing packages can be installed manually.

Parameters

--quiet

Specifies that when there are any missing packages, the mmbuildgpl command installs the prerequisite packages automatically by using the default package manager.

--build-package

Builds an installable package (gpfs.gplbin) for the portability layer binaries after compilation is successful. This option builds an RPM package on SLES and RHEL Linux and a Debian package on Debian and Ubuntu Linux.

When the command finishes, it displays the location of the generated package similar to:

Wrote: /root/rpmbuild/RPMS/x86_64/gpfs.gplbin-3.10.0-229.el7.x86_64-5.0.1-0.x86_64.rpm

Wrote: /tmp/deb/gpfs.gplbin_5.0.1-0_amd64.deb

You can then copy the generated package to other machines for deployment. The generated package can only be deployed to machines with identical architecture, distribution level, Linux kernel, and IBM Spectrum Scale maintenance level. If the gpfs.gplbin package is installed, installing the gpfs.gpl package is not required.

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.

-v

Specifies that the output is verbose and contains information for debugging purposes.

Exit status

0: Successful completion.
nonzero: A failure has occurred.

Security

You must have root authority to run the mmbuildgpl command.

Examples

To build the GPFS portability layer, issue this command:

mmbuildgpl

The system displays information similar to:

--------------------------------------------------------
mmbuildgpl: Building GPL module begins at Fri Jun 13 16:37:50 EDT 2014.
--------------------------------------------------------

Verifying Kernel Header...
  kernel version = 3001300 (3.0.13-0.27)
  kernel module dir = /lib/modules/3.0.13-0.27-default/build/include
  kernel source dir = /usr/src/linux-3.0.13-0.27/include
  Found a valid kernel include directory:  /lib/modules/3.0.13-0.27-default/build/include
Verifying Compiler...
  make is present at /usr/bin/make
  cpp is present at /usr/bin/cpp
  gcc is present at /usr/bin/gcc
  g++ is present at /usr/bin/g++
  ld is present at /usr/bin/ld
make World ...
make Install ...
----------------------------------------------------------
mmbuildgpl: Building GPL module completed successfully at Fri Jun 13 16:39:08 EDT 2014.
----------------------------------------------------------

Location

/usr/lpp/mmfs/bin