db2ckgpfs - Display the name, version information, and status of the GPFS cluster command

Displays information regarding the IBM® General Parallel File System (GPFS) cluster.

You can display information regarding the GPFS cluster using the db2ckgpfs command.

This command can be found in the DB2DIR/install/gpfs directory (where DB2DIR represents the location where the Db2® copy is installed.)

Command syntax

Read syntax diagramSkip visual syntax diagramdb2ckgpfs -d -llogFile -vinstall | media -sinstall | media -c -ncluster-name -h -?

Command parameters

-d
Turns debug mode on.
-l logFile
Writes the log to the file name specified.
-v install | media
Displays the GPFS version already installed on the system, or, the GPFS version on the installation media.
  • 0 - Success
  • 7 - GPFS is not installed on the system
  • 8 - GPFS is not on the media
-s install | media
Prints the efix string of GPFS version.
-c
Displays the name of the GPFS cluster (if it exists.) The cluster information is indicated by a return code value:
  • 9 - No cluster
  • 0 - Online cluster
  • 10 - Cluster exists, but is not online
-n cluster-name
This parameter must be used with the -c parameter. Displays the status of a specific GPFS cluster. The cluster information is indicated by a return code value:
  • 9 - No cluster
  • 0 - Online cluster
  • 10 - Cluster exists, but is not online
-h | -?
Displays the usage information.

Examples

To display the GPFS version level installed in your Db2 pureScale® environment, use the following db2ckgpfs command:
db2ckgpfs -v install
To display the GPFS version level on the installation media, use the following db2ckgpfs command:
db2ckgpfs -v media
To display the status of a specific GPFS cluster, use the following db2ckgpfs command:
db2ckgpfs -c -n gpfs-cluster-name
The GPFS cluster name can be retrieved with the db2cluster command. For example: 
db2cluster -cfs -list -domain