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

add -b & -p options for SN backup support

Browse Source 
git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@8582 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
This commit is contained in:
nott 2011-01-07 21:54:53 +00:00
parent 0a8ed425de
commit ae78ab8d3b
4 changed files with 43 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
xCAT-client/pods/man1/mkdsklsnode.1.pod
View File

@ -4,9 +4,9 @@ B<mkdsklsnode> - Use this xCAT command to define and initialize AIX/NIM diskless
=head1 SYNOPSIS
B<mkdsklsnode [-h|--help ]>
y<mkdsklsnode [-h|--help ]>
B<mkdsklsnode [-V|--verbose] [-f|--force] [--hfi] [-n|--newname] [-i osimage_name] noderange [attr=val [attr=val ...]]>
B<mkdsklsnode [-V|--verbose] [-f|--force] [--hfi] [-n|--newname] [-i osimage_name] [-p|--primarySN] [-b|--backupSN] noderange [attr=val [attr=val ...]]>
=head1 DESCRIPTION
@ -14,6 +14,8 @@ This xCAT command can be used to define and/or initialize AIX/NIM diskless machi
The command can be used to define and initialize a new NIM machine object or it may be used to reinitialize an existing machine to use a different operating system image.
If you are using xCAT service nodes the B<mkdsklsnode> command will automatically determine the correct server(s) for the node and create the NIM definitions on that server(s).
When creating a new NIM machine definition the default is to use the same name as the xCAT node name that is provided.
You can use the "-n" option of the mkdsklsnode command to create and initialize an alternate NIM machine definition for the same physical nodes. This option allows you to set up a new image to use when a node is next rebooted while the node is currently running. This is possible because the NIM name for a machine definition does not have to be the hostname of the node. This allows you to have multiple NIM machine definitions for the same physical node. The naming convention for the new NIM machine name is "<xcat_node_name>_<image_name>", (Ex. "node01_61spot"). Since all the NIM initialization can be done while the node is running the downtime for for the node is reduced to the time it takes to reboot.
@ -64,6 +66,10 @@ Specifies the type dump to be collected at the client. The values are "selectiv
=back
=item B<-b |--backupSN>
When using backup service nodes only update the backup. The default is to update both the primary and backup service nodes.
=item B<-f |--force>
Use the force option to reinitialize the NIM machines.
@ -84,6 +90,10 @@ The name of an existing xCAT osimage definition. If this information is not prov
Create a new NIM machine object name for the xCAT node. Use the naming convention "<xcat_node_name>_<image_name>" for the new NIM machine definition.
=item B<-p|--primarySN>
When using backup service nodes only update the primary. The default is to update both the primary and backup service nodes.
=item B<noderange>
A set of comma delimited node names and/or group names. See the "noderange" man page for details on additional supported formats.

12
xCAT-client/pods/man1/nimnodeset.1.pod
View File

@ -6,12 +6,14 @@ B<nimnodeset> - Use this xCAT command to initialize AIX/NIM standalone machines.
B<nimnodeset [-h|--help ]>
B<nimnodeset [-V|--verbose] [-f|--force] [-i osimage_name] noderange [attr=val [attr=val ...]]>
B<nimnodeset [-V|--verbose] [-f|--force] [-i osimage_name] [-p|--primarySN] [-b|--backupSN] noderange [attr=val [attr=val ...]]>
=head1 DESCRIPTION
This xCAT command can be used to initialize AIX/NIM standalone machines. Once this step is completed the xCAT rnetboot command may be used to initiate a network boot of the nodes.
If you are using xCAT service nodes the B<nimnodeset> command will automatically determine the correct server(s) for the node and do the initialization on that server(s).
The osimage_name is the name of an xCAT osimage definition that contains the list of NIM resources to use when initializing the nodes. If the osimage_name is not provided on the command line the code checks the node definition for the value of the "profile" attribute (which is the name of an osimage definition). If the osimage_image is provided on the command line then the code will also set the "profile" attribute of the node definiions.
You can specify additional attributes and values using the "attr=val" command line option. This information will be passed on to the underlying call to the NIM "nim -o bos_inst" command. See the NIM documentation for information on valid command line options for the nim command. The "attr" must correspond to a NIM attribute supported for the NIM "bos_inst" operation. Information provided by the "attr=val" option will take precedence over the information provided in the osimage definition.
@ -33,6 +35,10 @@ You can supply your own scripts to be run on the mn or on the service node (if t
Specifies one or more "attribute equals value" pairs, separated by spaces. Attr=
val pairs must be specified last on the command line. These are used to specify additional values that can be passed to the underlying NIM commands, ("nim -o bos_inst ..."). See the NIM documentation for valid "nim" command line options. Note that you may specify multiple "script" and "installp_bundle" values by using a comma seperated list. (ex. "script=ascript,bscript").
=item B<-b|--backupSN>
When using backup service nodes only update the backup. The default is to update both the primary and backup service nodes
=item B<-f |--force>
Use the force option to reinitialize the NIM machines.
@ -45,6 +51,10 @@ Display usage message.
The name of an existing xCAT osimage definition.
=item B<-p|--primarySN>
When using backup service nodes only update the primary. The default is to update both the primary and backup service nodes.
=item B<noderange>
A set of comma delimited node names and/or group names. See the "noderange" man page for details on additional supported formats.

18
xCAT-client/pods/man1/rmdsklsnode.1.pod
View File

@ -6,7 +6,7 @@ B<rmdsklsnode> - Use this xCAT command to remove AIX/NIM diskless machine defini
B<rmdsklsnode [-h | --help ]>
B<rmdsklsnode [-V|--verbose] [-f|--force] [-i image_name] noderange>
B<rmdsklsnode [-V|--verbose] [-f|--force] [-i image_name] [-p|--primarySN] [-b|--backupSN] noderange>
=head1 DESCRIPTION
@ -14,9 +14,11 @@ Use this command to remove all NIM machine names that were created for the speci
The xCAT node definitions will not be removed.
The default is to assume that the NIM machine names are the same as the xCAT node names. If you had used the "-n" option when you created the NIM machine definitions with the mkdsklsnode command then the NIM machine names would be a combination of the xCAT node name and the osimage name used to initialize the NIM machine. To remove these definitions you must provide the name of the osimage that was used.
The default is to assume that the NIM machine names are the same as the xCAT node names. If you had used the "-n" option when you created the NIM machine definitions with the B<mkdsklsnode> command then the NIM machine names would be a combination of the xCAT node name and the osimage name used to initialize the NIM machine. To remove these definitions you must provide the name of the osimage that was used.
Use the xCAT rmdef command to remove xCAT node definitions.
If you are using xCAT service nodes the B<rmdsklsnode> command will automatically determine the correct server(s) for the node and remove the NIM definitions on that server(s).
Use the xCAT B<rmdef> command to remove xCAT node definitions.
=head1 OPTIONS
@ -26,6 +28,11 @@ Use the xCAT rmdef command to remove xCAT node definitions.
Use the force option to stop and remove running nodes. This handles the situation where a NIM machine definition indicates that a node is still running even though it is not.
=item B<-b |--backupSN>
When using backup service nodes only update the backup. The default is to updat
e both the primary and backup service nodes.
=item B<-h |--help>
Display usage message.
@ -38,6 +45,11 @@ The name of an xCAT image definition.
A set of comma delimited node names and/or group names. See the "noderange" man page for details on additional supported formats.
=item B<-p|--primarySN>
When using backup service nodes only update the primary. The default is to upda
te both the primary and backup service nodes.
=item B<-V |--verbose>
Verbose mode.

6
xCAT-client/pods/man1/xcat2nim.1.pod
View File

@ -6,7 +6,7 @@ B<xcat2nim> - Use this command to create and manage AIX NIM definitions based on
I<xcat2nim [-h|--help ]>
I<xcat2nim [-V|--verbose] [-u|--update] [-l|--list] [-r|--remove] [-f|--force] [-t object-types] [-o object-names] [-a|--allobjects] [noderange] [attr=val [attr=val...]] >
I<xcat2nim [-V|--verbose] [-u|--update] [-l|--list] [-r|--remove] [-f|--force] [-t object-types] [-o object-names] [-a|--allobjects] [-p|--primarySN] [-b|--backupSN] [noderange] [attr=val [attr=val...]] >
=head1 DESCRIPTION
@ -42,6 +42,8 @@ B<-a|--all> The list of objects will include all xCAT node, group an
B<attr=val [attr=val ...]> Specifies one or more "attribute equals value" pairs, separated by spaces. Attr=val pairs must be specified last on the command line. The attribute names must correspond to the attributes supported by the relevant NIM commands. When providing attr=val pairs on the command line you must not specify more than one object type.
B<-b|--backupSN> When using backup service nodes only update the backup. The default is to update both the primary and backup service nodes.
B<-f|--force> The force option will remove the existing NIM definition and create a new one.
B<-h|--help> Display the usage message.
@ -50,6 +52,8 @@ B<-l|--list> List NIM definitions corresponding to xCAT definitions.
B<-o object-names> A set of comma delimited xCAT object names. Objects must be of type node, group, or network.
B<-p|--primarySN> When using backup service nodes only update the primary. The default is to update both the primary and backup service nodes.
B<-r|--remove> Remove NIM definitions corresponding to xCAT definitions.
B<-t object-types> A set of comma delimited xCAT object types. Supported types include: node, group, and network.