rmdef.1

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:

export XCATBYPASS=1 and run the restorexCATdb command.

or

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, makeconservercf -d and makegocons --cleanup on the objects specified in the noderange.

-V|--verbose

Verbose mode.

RETURN VALUE

0 The command completed successfully.

1 An error has occurred.

EXAMPLES

To remove a range of node definitions.

rmdef -t node node1-node4

To remove all node definitions for the nodes contained in the group bpcnodes.

rmdef -t node -o bpcnodes

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.