mmchmgr command

Assigns a new file system manager node or cluster manager node.

Synopsis

mmchmgr {Device | -c} [Node]

Availability

Available on all IBM Spectrum Scale™ editions.

Description

The mmchmgr command assigns a new file system manager node or cluster manager node.

Parameters

Device
The device name of the file system for which the file system manager node is to be changed. File system names need not be fully-qualified. fs0 is just as acceptable as /dev/fs0.
-c
Changes the cluster manager node.
Node
The target node to be appointed as either the new cluster manager node or the new file system manager node. Target nodes for manager functions are selected according to the following criteria:
  • Target nodes for the cluster manager function must be specified from the list of quorum nodes.
  • Target nodes for the file system manager function should be specified from the list of manager nodes, although this is not strictly required.
If Node is not specified, the new manager is selected automatically.

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 mmchmgr 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

  1. Assume the file system manager for the file system gpfs1 is currently k164n05. To migrate the file system manager responsibilities to k164n06, issue this command: 
    mmchmgr gpfs1 k164n06
    The system displays information similar to: 
    GPFS: 6027-628 Sending migrate request to current manager node 89.116.68.69 (k164n05).
GPFS: 6027-629 [N] Node 89.116.68.69 (k164n05) resigned as manager for gpfs1.
GPFS: 6027-630 [N] Node 89.116.68.70 (k164n06) appointed as manager for gpfs1.
    To verify the change, issue the command:
    mmlsmgr gpfs1
    The system displays information similar to:
    file system manager node [from 89.116.68.69 (k164n06)]
---------------- ------------------
gpfs1 89.116.68.69 (k164n06)
  2. To change the cluster manager node, issue the command:
    mmchmgr -c c5n107
    The system displays information similar to:
    Appointing node 9.114.132.107 (c5n107) as cluster manager
Node 9.114.132.107 (c5n107) has taken over as cluster manager
    To verify the change, issue the command:
    mmlsmgr -c
    The system displays information similar to:
    Cluster manager node: 9.114.132.107 (c5n107)

See also

Location

/usr/lpp/mmfs/bin
Parent topic: Command reference