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...]
ormmvdisk nodeclass add --node-class NcName -N Node[,Node...]
ormmvdisk nodeclass delete --node-class NcName -N Node[,Node...]
ormmvdisk nodeclass delete --node-class NcName [--confirm]
ormmvdisk nodeclass list [--node-class {all | NcName[,NcName...]}] [--custom-config] [-Y]
ormmvdisk nodeclass change --node-class NcName --set-custom-config [Attribute[,Attribute...]]
ormmvdisk nodeclass change --node-class NcName --add-custom-config [Attribute[,Attribute...]]
ormmvdisk 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 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.
- 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