mmhadoopctl command

Installs and sets up the GPFS™ connector for a Hadoop distribution; starts or stops the GPFS connector daemon on a node.

Synopsis

mmhadoopctl connector {start |stop |getstate} 
      [-N {Node[,Node...] | NodeFile | NodeClass}]

mmhadoopctl connector {attach |detach} 
      --distribution HadoopDistribution 
      [-N {Node[,Node...] | NodeFile | NodeClass}]

Availability

Available on all IBM Spectrum Scale™ editions.

Description

Use the mmhadoopctl command to install and set up the GPFS connector for a Hadoop distribution, or to start or stop the GPFS connector daemon on a node.

Parameters

connector

Controls the GPFS connector daemon with one of the following actions:

start

Starts the connector daemon.

stop

Stops the connector daemon.

getstate

Detects whether the connector daemon is running and shows its process ID.

attach

Installs the GPFS connector daemon and required libraries into the designated Hadoop distribution.

detach

Uninstalls the GPFS connector daemon and required libraries from the designated Hadoop distribution.

--distribution HadoopDistribution

Designates a Hadoop distribution. Currently, the following values are accepted:

BigInsights
Apache

-N {Node[,Node...] | NodeFile | NodeClass}

Specifies the node or nodes on which the command is to be run (if you want to run the command not only on the local host but also on one or more other nodes). If you do not specify this option, the command is run on the local host only.

For general information on how to specify node names, see Specifying nodes as input to GPFS commands.

Exit status

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

Security

You must have root authority to run the mmhadoopctl command.

The node on which the command is issued must be able to execute remote shell commands on any other node in the cluster without the use of a password and without producing any extraneous messages. For more information, see Requirements for administering a GPFS file system.

Examples

To start the GPFS connector daemon, issue this command:

mmhadoopctl connector start

The system displays output similar to this:

Hadoop connector 'gpfs-connector-daemon' started

Location

/usr/lpp/mmfs/bin