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-4.2.2-0.x86_64.rpm

Wrote: /tmp/deb/gpfs.gplbin_4.2.2-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.

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 Debian and Ubuntu Linux.

-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