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

Add new options and examples.

Browse Source 
git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@4664 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
This commit is contained in:
nott 2009-11-24 19:57:34 +00:00
parent 2aa3876007
commit 170fbf4025
1 changed files with 31 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

@ -4,17 +4,24 @@ B<rmnimimage> - Use this xCAT command to remove an xCAT osimage definition and t
=head1 SYNOPSIS
B<rmnimimage [-h | --help ]>
B<rmnimimage [-h|--help]>
B<rmnimimage [-V] osimage_name>
B<rmnimimage [-V] [-d|--delete] [-s servicenoderange] osimage_name>
=head1 DESCRIPTION
Use this xCAT command to remove all the AIX resource definitions included in the xCAT osimage definition as well as the xCAT image definition.
Use this xCAT command to remove the xCAT osimage definition as well as all the AIX resources specified in the definition.
This command will not remove NIM resources if they are currently allocated. Remove NIM machines and deallocate resources before running this command.
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 image definition use the xCAT lsdef command ("lsdef -t osimage -l -o <osimage_name>").
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.
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 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.
@ -26,6 +33,14 @@ See the AIX NIM documentation for details on how to deallocate and remove unwant
Display usage message.
=item B<-d|--delete>
Delete any files or directories that were left after the "nim -o remove" command was run.
=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).
=item B<osimage_name>
The name of the xCAT osimage definition.
@ -52,10 +67,20 @@ An error has occurred.
=head1 EXAMPLES
1) Remove all the NIM resources associated with the xCAT image definition named "53cosi".
1) Remove the xCAT osimage definition named "53image" along with all NIM resources specified in the definition.
B<rmnimimage 53cosi>
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.
2) Remove the xCAT "61rte" osimage definition along with all the specified NIM resources. 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.
B<rmnimimage -d -s xcatsn1,xcatsn2 614dskls>
=head1 FILES
/opt/xcat/bin/rmnimimage