8acf0432cb
git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@13314 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
99 lines
2.3 KiB
Plaintext
99 lines
2.3 KiB
Plaintext
=head1 NAME
|
|
|
|
B<rmdef> - Use this command to remove xCAT data object definitions.
|
|
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
B<rmdef> [B<-h>|B<--help>] [B<-t> I<object-types>]
|
|
|
|
B<rmdef> [B<-V>|B<--verbose>] [B<-a>|B<--all>] [B<-t> I<object-types>] [B<-o> I<object-names>]
|
|
[B<-f>|B<--force>] [I<noderange>]
|
|
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
This command is used to remove xCAT object definitions that are stored in the xCAT database.
|
|
|
|
|
|
=head1 OPTIONS
|
|
|
|
=over 10
|
|
|
|
=item B<-a|--all>
|
|
|
|
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.
|
|
|
|
=item B<-f|--force>
|
|
|
|
Use this with the all option as an extra indicator that ALL definitions are to be removed.
|
|
|
|
=item B<-h|--help>
|
|
|
|
Display a usage message.
|
|
|
|
=item I<noderange>
|
|
|
|
A set of comma delimited node names and/or group names. See the "noderange" man page for details on supported formats.
|
|
|
|
=item B<-o> I<object-names>
|
|
|
|
A set of comma delimited object names.
|
|
|
|
=item B<-t> I<object-types>
|
|
|
|
A set of comma delimited object types.
|
|
|
|
=item B<-V|--verbose>
|
|
|
|
Verbose mode.
|
|
|
|
=back
|
|
|
|
=head1 RETURN VALUE
|
|
|
|
0 The command completed successfully.
|
|
|
|
1 An error has occurred.
|
|
|
|
|
|
=head1 EXAMPLES
|
|
|
|
=over 3
|
|
|
|
=item 1. To remove a range of node definitions.
|
|
|
|
rmdef -t node node1-node4
|
|
|
|
=item 2. To remove all node definitions for the nodes contained in the group bpcnodes.
|
|
|
|
rmdef -t node -o bpcnodes
|
|
|
|
=item 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.)
|
|
|
|
=back
|
|
|
|
=head1 FILES
|
|
|
|
$XCATROOT/bin/rmdef
|
|
|
|
(The XCATROOT environment variable is set when xCAT is installed. The
|
|
default value is "/opt/xcat".)
|
|
|
|
|
|
=head1 NOTES
|
|
|
|
This command is part of the xCAT software product.
|
|
|
|
=head1 SEE ALSO
|
|
|
|
L<mkdef(1)|mkdef.1>, L<lsdef(1)|lsdef.1>, L<chdef(1)|chdef.1>, L<xcatstanzafile(5)|xcatstanzafile.5>
|