NAME

rmdsklsnode - Use this xCAT command to remove AIX/NIM diskless machine definitions.


SYNOPSIS

rmdsklsnode [-h | --help ]

rmdsklsnode [-V|--verbose] [-f|--force] [-i image_name] [-p|--primarySN] [-b|--backupSN] noderange


DESCRIPTION

Use this command to remove all NIM machine names that were created for the specified xCAT nodes.

The xCAT node definitions will not be removed.

The default is to assume that the NIM machine names are the same as the xCAT node names. If you had used the ``-n'' option when you created the NIM machine definitions with the mkdsklsnode command then the NIM machine names would be a combination of the xCAT node name and the osimage name used to initialize the NIM machine. To remove these definitions you must provide the name of the osimage that was used.

If you are using xCAT service nodes the rmdsklsnode command will automatically determine the correct server(s) for the node and remove the NIM definitions on that server(s).

Use the xCAT rmdef command to remove xCAT node definitions.


OPTIONS

-f |--force

Use the force option to stop and remove running nodes. This handles the situation where a NIM machine definition indicates that a node is still running even though it is not.

-b |--backupSN

When using backup service nodes only update the backup. The default is to updat e both the primary and backup service nodes.

-h |--help

Display usage message.

-i image_name

The name of an xCAT image definition.

noderange

A set of comma delimited node names and/or group names. See the ``noderange'' man page for details on additional supported formats.

-p|--primarySN

When using backup service nodes only update the primary. The default is to upda te both the primary and backup service nodes.

-V |--verbose

Verbose mode.


RETURN VALUE

  1. The command completed successfully.

  2. An error has occurred.


EXAMPLES

1) Remove the NIM machine definition for the xCAT node named ``node01''.

rmdsklsnode node01

2) Remove the NIM machine definition for xCAT node ``node02'' and the image ``61cosi''. (i.e. NIM machine name ``node02_61cosi''.)

rmdsklsnode -i 61cosi node02

3) Remove the NIM definitions for all xCAT nodes in the group ``aixnodes''. Remove the NIM definitions even if the NIM node state is set to ``currently running''.

rmdsklsnode -f aixnodes


FILES

/opt/xcat/bin/rmdsklsnode


NOTES

This command is part of the xCAT software product.


SEE ALSO

mkdsklsnode(1)