add man pages for new nimnodecust command

git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@2246 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd

xCAT-client/pods/man1/nimnodecust.1.pod

@@ -0,0 +1,110 @@
+=head1 NAME
+
+B<nimnodecust> - Use this xCAT command to customize AIX/NIM standalone machines.
+
+=head1 SYNOPSIS
+
+B<nimnodecust [-h|--help ]>
+
+B<nimnodecust [-V] -s lpp_source_name [-p packages] [-b installp_bundles] noderange [attr=val [attr=val ...]]>
+
+=head1 DESCRIPTION
+
+This xCAT command can be used to customize AIX/NIM standalone machines. 
+
+The software packages that you wish to install on the nodes must be copied to the appropriate directory locations in the NIM lpp_source resource provided by the "-s" option.  For example, if the location of your lpp_source resource is "/install/nim/lpp_source/61lpp/" then you would copy RPM packages to "/install/nim/lpp_source/61lpp/RPMS/ppc" and you would copy your installp packages to "/install/nim/lpp_source/61lpp/installp/ppc". Typically you would want to copy the packages to the same lpp_source that was used to install the node.  You can find the location for an lpp_source with the AIX lsnim command. (Ex. "lsnim -l <lpp_source_name>")
+
+The packages you wish to install on the nodes may be specified with either a comma-separated list of package names or by a comma-separated list of installp_bundle names. The installp_bundle names are what were used when creating the corresponding NIM installp_bundle definitions. The installp_bundle definitions may also be used when installing the nodes.
+
+A bundle file contains a list of package names.  The RPMs must have a prefix of "R:" and the installp packages must have a prefix of "I:".  For example, the contents of a simple bundle file might look like the following.
+
+ # RPM
+ R:expect-5.42.1-3.aix5.1.ppc.rpm
+ R:ping-2.4b2_to-1.aix5.3.ppc.rpm
+
+ #installp
+ I:openssh.base
+ I:openssh.license
+
+To create a NIM installp_bundle definition you can use the "nim -o define" operation.  For example, to create a definition called "mypackages" for a bundle file located at "/install/nim/mypkgs.bnd" you could issue the following command. 
+
+=over 5
+
+"nim -o define -t installp_bundle -a server=master -a location=/install/nim/mypkgs.bnd mypackages".
+
+=back
+
+See the AIX documantation for more information on using installp_bundle files.
+
+The xCAT nimnodecust command will automatically handle the distribution of the packages to AIX service nodes when using an xCAT hierachical environment.
+
+=head1 OPTIONS
+
+=over 10
+
+=item 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. These are used to specify
+additional values that can be passed to the underlying NIM commands, ("nim -o cust..."). See the NIM documentation for valid "nim" command line options. 
+
+=item B<-b installp_bundle_names>
+
+	A comma separated list of NIM installp_bundle names.
+
+=item B<-h |--help>
+
+Display usage message.
+
+=item B<-p package_names>
+
+A comma-separated list of software packages to install.  Packages may be RPM or installp.
+
+=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.
+
+=item B<-V |--verbose>
+
+Verbose mode.
+
+=back
+
+=head1 RETURN VALUE
+
+=over 3
+
+=item 0
+
+The command completed successfully.
+
+=item 1
+
+An error has occurred.
+
+=back
+
+=head1 EXAMPLES
+
+1) Install the installp package "openssh.base.server" on an xCAT node named "node01".  Assume that the package has been copied to the NIM lpp_source resource called "61lppsource".  
+
+=over 5
+
+B<nimnodecust -s 61lppsource -p openssh.base.server node01>
+
+=back
+
+2) Install the product software contained in the two bundles called "llbnd" and "pebnd" on all AIX nodes contained in the xCAT node group called "aixnodes".  Assume that all the software packages have been copied to the NIM lpp_source resource called "61lppsource".
+
+=over 5
+
+B<nimnodecust -s 61lppsource -b llbnd,pebnd  aixnodes>
+
+=back
+
+=head1 FILES
+
+/opt/xcat/bin/nimnodecust
+
+=head1 NOTES
+
+This command is part of the xCAT software product.