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


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

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


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



Clear the whole xCAT database. A backup of the xCAT definitions should be saved before using this option. Once all the data is removed the xCAT daemon will no longer work. Most xCAT commands will fail. In order to use xCAT commands again, you have two options. You can restore your database from your backup by switching to bypass mode, and running the restorexCATdb command. You switch to bypass mode by setting the XCATBYPASS environmant variable. (ex. “export XCATBYPASS=yes”) A second option is to run xcatconfig -d. This will restore the initial setup of the database as when xCAT was initially installed. You can then restart xcatd and run xCAT commands.


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


Display a usage message.


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.


Verbose mode.


0 The command completed successfully.

1 An error has occurred.


  1. To remove a range of node definitions.
rmdef -t node node1-node4
  1. To remove all node definitions for the nodes contained in the group bpcnodes.
rmdef -t node -o bpcnodes
  1. 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.)



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


This command is part of the xCAT software product.


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