mmvdisk nodeclass command

Manages mmvdisk recovery group server node classes for IBM Storage Scale RAID.

Synopsis

mmvdisk nodeclass create --node-class NcName -N Node[,Node...]
            
or
mmvdisk nodeclass add --node-class NcName -N Node[,Node...]
          
or
mmvdisk nodeclass delete --node-class NcName -N Node[,Node...]  
          
or
mmvdisk nodeclass delete --node-class NcName [--confirm]   
          
or
mmvdisk nodeclass list [--node-class {all | NcName[,NcName...]}] [--custom-config] [-Y]  
          
or
mmvdisk nodeclass change --node-class NcName --set-custom-config [Attribute[,Attribute...]]
or
mmvdisk nodeclass change --node-class NcName --add-custom-config [Attribute[,Attribute...]]
or
mmvdisk nodeclass change --node-class NcName --delete-custom-config [Attribute[,Attribute...] | all]

Availability

Available on all IBM Storage Scale editions.

Description

Use the mmvdisk nodeclass command to manage mmvdisk recovery group server node classes.

An mmvdisk node class is an IBM Storage Scale node class that can only be created, modified, or deleted through the mmvdisk command. Each IBM Storage Scale RAID recovery group managed by mmvdisk must be associated with an mmvdisk node class that contains only the servers for that recovery group.

The mmvdisk command uses the node class for a recovery group or recovery group pair to maintain the IBM Storage Scale RAID configuration settings for the recovery group and its servers. The node class is also used as a building block identifier for the common server and disk resources required to store file system data in the associated recovery group or recovery group pair.

The association between an mmvdisk node class and an mmvdisk recovery group can be established in two ways:
  1. The mmvdisk nodeclass create command is used to create a node class containing the intended servers for the recovery group, and the mmvdisk recoverygroup create command is used to create an mmvdisk recovery group using the node class.
  2. The mmvdisk recoverygroup convert command is used to convert two paired recovery groups and their two servers to mmvdisk management. The mmvdisk recoverygroup convert command must be supplied with a node class name to be used as the mmvdisk node class for the converted recovery group pair.

The mmvdisk nodeclass add and mmvdisk nodeclass delete commands can be used to modify or delete an mmvdisk node class that has not yet been configured to be IBM Storage Scale RAID recovery group servers. This can be useful for correcting the member servers of an unconfigured mmvdisk node class.

The mmvdisk nodeclass change commands can be used to modify the customized configuration attributes of an mmvdisk node class. The --set-custom-config option sets customized configuration attributes. All original customized configuration attributes are overwritten. The --add-custom-config option adds customized configuration attributes to the original customized configuration attributes. The --delete-custom-config option deletes customized configuration attributes from the original customized configuration attributes. If all is specified, it deletes all customized configuration attributes.

When a recovery group is associated with an mmvdisk node class, changes to the node class can only be made using the mmvdisk recoverygroup command. For example, the mmvdisk recoverygroup add --recovery-group RG01 -N server11 command will add the new server node both to the recovery group and to the mmvdisk node class for the recovery group.

To change an mmvdisk node class that is configured but not yet associated with a recovery group, the node class must first be unconfigured using the mmvdisk server unconfigure command.

The mmvdisk nodeclass list command can be used to list all mmvdisk node classes and show the associated recovery groups, or to also list the member servers of mmvdisk node classes. When the --custom-config option is specified, it shows all customized configuration attributes for node classes.

Parameters

mmvdisk nodeclass create
Create a new mmvdisk node class. The node class must not already exist.
mmvdisk nodeclass add
Add server nodes to an existing mmvdisk node class. The node class must not be configured or associated with a recovery group. The server nodes must not already belong to an mmvdisk node class.
mmvdisk nodeclass delete
Delete server nodes from an existing mmvdisk node class, or delete an entire mmvdisk node class. The node class must not be configured or associated with a recovery group..
mmvdisk nodeclass list
List all the mmvdisk node classes in an IBM Storage Scale cluster, or list the member servers in the specified mmvdisk node classes.
mmvdisk nodeclass change
Changes the mmvdisk node classes with customized configuration in an IBM Storage Scale cluster.
--node-class NcName
Specifies a single mmvdisk node class name to be either created, deleted, added to, or deleted from.
--node-class {all | NcName[,NcName...]}
For the mmvdisk nodeclass list command, specifies the mmvdisk node class names for which the member servers are also to be shown.
-N Node[,Node...]
Specifies the IBM Storage Scale cluster nodes with which to create an mmvdisk node class, or the list of cluster nodes to be added to or deleted from an mmvdisk node class.
--confirm
Confirms the deletion of an entire mmvdisk node class. This flag bypasses the interactive prompt that would otherwise be printed to confirm node class deletion.
--custom-config [Attribute[,Attribute...]]
Shows customized configuration attributes for the node class.
--set-custom-config [Attribute[,Attribute...]]
Sets customized configuration attributes for the node class that will not be checked by mmvdisk server command.
--add-custom-config [Attribute[,Attribute...]]
Adds customized configuration attributes for the node class that will not be checked by mmvdisk server command.
--delete-custom-config [Attribute[,Attribute...]]
Deletes customized configuration attributes for the node class that will not be checked by mmvdisk server command.
-Y
Specifies that the mmvdisk nodeclass list command produce colon-delimited raw output.

Exit status

0
Successful completion.
nonzero
A failure has occurred.

Security

You must have root authority to run the mmvdisk nodeclass 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.

Examples

  • To create an mmvdisk node class named ESS01 containing nodes server01 and server02:
    mmvdisk nodeclass create --node-class ESS01 -N server01,server02

The system displays output similar to the following:

mmvdisk: Node class 'ESS01' created.
  • To list the mmvdisk node classes in a cluster:
    mmvdisk nodeclass list

The system displays output similar to the following:

node class  recovery groups
----------  ---------------
ESS01       ESS01L, ESS01R
ESS02       ESS02L, ESS02R
  • To list all the mmvdisk node classes in a cluster and all their member nodes:
    mmvdisk nodeclass list --node-class all

The system displays output similar to the following:


node class  recovery groups  member nodes
----------  ---------------  ------------
NC01        RG01             s01, s02, s03, s04, s05, s06, s07, s08, s09, s10
NC02        RG02             s11, s12, s13, s14, s15, s16, s17, s18, s19, s20
  • To list the mmvdisk node classes in a cluster by using the --custom-config option, issue the following command:
    mmvdisk nodeclass list --custom-config

The system displays output similar to the following:


node class  recovery groups   custom config
----------  ---------------   -------------
ESS01       ESS01L, ESS01R     nsdRAIDSmallVdiskThreshold 
ESS02       ESS02L, ESS02R     workerThreads, numaMemoryInterleave

See also

Location

/usr/lpp/mmfs/bin