DB2 Version 10.1 for Linux, UNIX, and Windows

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 diagram
>>-db2ckgpfs--+-----+--+--------------+------------------------->
              '- -d-'  '- -l--logFile-'   

>--+- -v--install | media---+--+-----+-------------------------><
   +- -s--install | media---+  +- -h-+   
   '- -c-- -n--cluster-name-'  '- -?-'   

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.

Example

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 db2cluster