NAME

rmdef - Use this command to remove xCAT data object definitions.


SYNOPSIS

rmdef [-h|--help] [-t object-types]

rmdef [-V|--verbose] [-a|--all] [-t object-types] [-o object-names] [-f|--force] [-C|--cleanup] [noderange]


DESCRIPTION

This command is used to remove xCAT object definitions that are stored in the xCAT database.


OPTIONS

-a|--all

Clear the whole xCAT database. A backup of the xCAT definitions should be saved before using this option as the xCAT daemons will no longer work once cleared.

To restore:

  1. export XCATBYPASS=1 and run the restorexCATdb command.

    or

  2. Run xcatconfig -d which initializes the database the same as when xCAT was installed.
-f|--force

Use this with the --all option as an extra indicator that ALL definitions are to be removed.

-h|--help

Display a usage message.

noderange

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

-o object-names

A set of comma delimited object names.

-t object-types

A set of comma delimited object types.

-C|--cleanup

Perform additional cleanup by running nodeset offline on the objects specified in the noderange.

-V|--verbose

Verbose mode.


RETURN VALUE

0 The command completed successfully.

1 An error has occurred.


EXAMPLES

  1. To remove a range of node definitions.
     rmdef -t node node1-node4
  2. To remove all node definitions for the nodes contained in the group bpcnodes.
     rmdef -t node -o bpcnodes
  3. To remove the group called bpcnodes.
     rmdef -t group -o bpcnodes

    (This will also update the values of the "groups" attribute of the member nodes.)


FILES

$XCATROOT/bin/rmdef

(The XCATROOT environment variable is set when xCAT is installed. The default value is "/opt/xcat".)


NOTES

This command is part of the xCAT software product.


SEE ALSO

mkdef(1), lsdef(1), chdef(1), xcatstanzafile(5)