arif/xcat-core
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Add new options.

Browse Source 
git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@5084 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
This commit is contained in:
nott 2010-01-29 14:43:21 +00:00
parent aeb650690b
commit 0df467d3df
1 changed files with 42 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

61
xCAT-client/pods/man1/rmnimimage.1.pod
View File

@ -1,29 +1,34 @@
=head1 NAME
B<rmnimimage> - Use this xCAT command to remove an xCAT osimage definition and the associated NIM resources.
B<rmnimimage> - Use this xCAT command to remove NIM resources specified in an xCAT osimage definition.
=head1 SYNOPSIS
B<rmnimimage [-h|--help]>
B<rmnimimage [-V] [-d|--delete] [-s servicenoderange] osimage_name>
B<rmnimimage [-V|--verbose] [-d|--delete] [-x|--xcatdef] [-M|--managementnode] [-s servicenoderange] osimage_name>
=head1 DESCRIPTION
Use this xCAT command to remove the xCAT osimage definition as well as all the AIX resources specified in the definition.
Use this xCAT command to remove the AIX resources specified in an xCAT osimage definition.
The command will remove all the NIM resources on the xCAT management node in addition to all the resources that were replicated on any xCAT service nodes.
To list the contents of the xCAT osimage definition use the xCAT B<lsdef> command ("lsdef -t osimage -l -o <osimage_name>"). B<Before running the rmnimimage command you should be absolutely certain that you really want to remove all the NIM resources specified in the xCAT osimage definition!>
The "nim -o remove" operation is used to remove the NIM resource definitions. If you wish to completely remove all the files and directories (left behind by the NIM command) you must specify the "-d" option when you run rmnimimage.
The default behavior of this command is to remove all the NIM resources on the xCAT management node in addition to all the resources that were replicated on any xCAT service nodes.
If you wish to remove the NIM resource from one or more xCAT service nodes without completely removing the osimage from the management node you can use the "-s <servicenoderange>" option. In this case the NIM resources specified in the xCAT osimage definition will be remove from the service nodes ONLY. The osimage definition and the NIM resources on the management node will not be removed.
This command may also be used to clean up individual xCAT service nodes and remove the xCAT osimage definitions.
The "nim -o remove" operation is used to remove the NIM resource definitions. If you wish to completely remove all the files and directories (left behind by the NIM command) you must specify the "-d" option when you run B<rmnimimage>.
If you wish to remove the NIM resource from one or more xCAT service nodes without removing the resources from the management node you can use the "-s <servicenoderange>" option. In this case the NIM resources specified in the xCAT osimage definition will be removed from the service nodes ONLY. The NIM resources on the management node will not be removed.
If you wish to remove NIM resources on the management node only, you can specify the "-M" option.
If you wish to also remove the xCAT osimage definition you must specify the "-x" option.
This command will not remove NIM resources if they are currently allocated. You must deallocate the resources before they can be removed. See the B<xcat2nim> and B<rmdsklsnode> commands for information on how to deallocate and remove NIM machine definitions for standalone and diskless nodes.
To list the contents of the xCAT image definition use the xCAT B<lsdef> command ("lsdef -t osimage -l -o <osimage_name>").
See the AIX NIM documentation for details on how to deallocate and remove unwanted NIM objects.
See the AIX NIM documentation for additional details on how to deallocate and remove unwanted NIM objects.
=head1 OPTIONS
@ -35,19 +40,27 @@ Display usage message.
=item B<-d|--delete>
Delete any files or directories that were left after the "nim -o remove" command was run.
Delete any files or directories that were left after the "nim -o remove" command was run. (Such as the lpp_source directories.) When this command completes all definitions and files will be completely erased so use with caution!
=item B<-M|--managementnode>
Remove NIM resources from the xCAT management node only.
=item B<-s servicenoderange>
Remove the NIM resources on these xCAT service nodes only. Do not remove the xCAT osimage definition and do not remove the NIM resources from the xCAT management node. (or NIM primary server).
Remove the NIM resources on these xCAT service nodes only. Do not remove the NIM resources from the xCAT management node.
=item B<osimage_name>
The name of the xCAT osimage definition.
=item B<-V |--verbose>
=item B<-V|--verbose>
Verbose mode.
Verbose mode. This option will display the underlying NIM commands that are being called.
=item B<-x|--xcatdef>
Remove the xCAT osimage definition.
=back
@ -67,20 +80,30 @@ An error has occurred.
=head1 EXAMPLES
1) Remove the xCAT osimage definition named "53image" along with all NIM resources specified in the definition.
1) Remove all NIM resources specified in the xCAT "61image" definition.
B<rmnimimage 53cosi>
B<rmnimimage 61image>
The "nim -o remove" operation will be used to remove the NIM resource definitions. This NIM operation does not completely remove all files and directories associated with the NIM resources.
The "nim -o remove" operation will be used to remove the NIM resource definitions on the management node as well as any service nodes where the resource has been replicated. This NIM operation does not completely remove all files and directories associated with the NIM resources.
2) Remove the xCAT "61rte" osimage definition along with all the specified NIM resources. Delete ALL files and directories associated with the NIM resources.
2) Remove all the NIM resources specified by the xCAT "61rte" osimage definition. Delete ALL files and directories associated with the NIM resources.
B<rmnimimage -d 61rte>
3) Remove the NIM resources specified in the "614dskls" osimage definition on the xcatsn1 and xcatsn2 service nodes. Delete all files or directories associated with the NIM resources.
3) Remove all the NIM resources specified by the xCAT "614img" osimage definition and also remove the xCAT definition.
B<rmnimimage -x -d 614img>
Note: When this command completes all definitions and files will be completely erased, so use with caution!
4) Remove the NIM resources specified in the "614dskls" osimage definition on the xcatsn1 and xcatsn2 service nodes. Delete all files or directories associated with the NIM resources.
B<rmnimimage -d -s xcatsn1,xcatsn2 614dskls>
5) Remove the NIM resources specified in the "614old" osimage definition on the xCAT management node only.
B<rmnimimage -M -d 614old>
=head1 FILES
/opt/xcat/bin/rmnimimage