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

Modified pod source for xcat2nim man page.

Browse Source 
git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@178 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
This commit is contained in:
nott 2007-12-12 19:29:13 +00:00
parent cfd2e1221a
commit 929070fe76
1 changed files with 29 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

@ -1,23 +1,22 @@
=head1 NAME
B<xcat2nim> - Use this command to create AIX NIM definitions from xCAT object definitions.
B<xcat2nim> - Use this command to create and manage AIX NIM definitions based on xCAT object definitions.
=head1 SYNOPSIS
I<xcat2nim [-h | --help ]>
I<xcat2nim [-V | --verbose] [-a | --all] [-t object-types] [-o object-names]>
I<[-f | --force] [noderange] [attr=val [attr=val...]] >
I<xcat2nim [-V | --verbose] [-a | --all] [-l | --list] [-u | --update] [-r | --remove] [-t object-types] [-o object-names] [noderange] [attr=val [attr=val...]] >
=head1 DESCRIPTION
The xcat2nim command uses xCAT node and group object definitions to create or update corresponding NIM machine and group definitions.
The xcat2nim command uses xCAT node and group object definitions to create, update, list, or remove corresponding NIM machine and group definitions.
The xCAT definitions must be created and the NIM master must be installed and configured before running this command.
xcat2nim uses xCAT database information, command line input, and default values to run the appropriate NIM commands to create the NIM definitions.
xcat2nim uses xCAT database information, command line input, and default values to run the appropriate NIM commands.
The default behavior is to create new NIM definitions but not apply updates to existing definitions. If you use wish to update existing NIM definitions then you must use the force option.
The default behavior is to create new NIM definitions but not apply updates to existing definitions. If you use wish to update existing NIM definitions then you must use the update option.
=head1 OPTIONS
@ -25,17 +24,19 @@ B<-a |--all> Create NIM definitions corresponding to all xCAT node a
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<-f |--force> Use the force option to update existing NIM definitions.
B<-h |--help> Display the usage message.
B<-h |--help> Display usage message.
B<-l | --list> List NIM definitions corresponding to xCAT definitions.
B<noderange> A set of comma delimited node names and/or group names. (must be the first parameter) See the "noderange" man page for details on supported formats.
B<noderange> A set of comma delimited node names and/or group names, (must be the first parameter). See the "noderange" man page for details on supported formats.
B<-o object-names> A set of comma delimited xCAT object names.
B<-t object-types> A set of comma delimited xCAT object types. Supported types include: node and group.
Supported types include: node and group.
B<-r | --remove> Remove NIM definitions corresponding to xCAT definitions.
B<-u | --update> Update existing NIM definitions based on xCAT definitions.
B<-V |--verbose> Verbose mode.
@ -57,19 +58,32 @@ I<xcat2nim -t node>
3. To create a NIM machine definition corresponding to the xCAT clstrn01 node definition.
I<xcat2nim -t node clstrn01>
I<xcat2nim -t node -o clstrn01>
4. To create a NIM machine group definition corresponding to the xCAT aix61nodes group definition.
I<xcat2nim -t group aix61nodes>
I<xcat2nim -t group -o aix61nodes>
5. Convert all node definitions in the xCAT group AIXNodes to NIM machine definitions.
I<xcat2nim -t node AIXNodes>
I<xcat2nim -t node -o AIXNodes>
4. To create NIM machine definitions for each node that is a member of the xCAT lpar_grp group and specify attribute values that will be applied to each definition. (In this example the name of the NIM primary network is master_net.)
4. To create NIM machine definitions for each node that is a member of the xCAT "lpar_grp" group and specify attribute values that will be applied to each definition.
I<xcat2nim -t node -o lpar_grp machinetype=standalone netboot_kernel=mp cable_type="N/A">
5. To update the NIM definition of node clstrn01 to have a "cable_type" of "bnc".
I<xcat2nim -t node -o clstrn01 cable_type=bnc>
6. To list the NIM definition for node clstrn02.
I<xcat2nim -t node -l -o clstrn02>
7. To remove the NIM definition for the group "AIXnodes".
I<xcat2nim -t group -r -o AIXnodes>
I<xcat2nim -t node lpar_grp machinetype=standalone netboot_kernel=mp network_name=master_net cable_type="N/A">
=head1 FILES