diff --git a/perl-xCAT-2.0/db2man b/perl-xCAT-2.0/db2man index b14b51ea6..8483a562f 100755 --- a/perl-xCAT-2.0/db2man +++ b/perl-xCAT-2.0/db2man @@ -51,6 +51,23 @@ It consists of a series of tables, which are described below. To get more infor particular table, run man for that table name. The tables can be manipulated directly using the B or B commands. They can be viewed using B or B. +xCAT allows the use of different database applications, depending on the needs of your cluster. +The default database is SQLite, which is a daemonless, zero-config database. But you could instead +choose to use something like postgresql for greater scalability and remote access in the +hierarchical/service node case. To use a different database or a different location, create +the file /etc/xcat/cfgloc. The first line of the file should contain something like one of the examples +below: + +=over 4 + +=item SQLite:/var/xcat/cfg + +=item Pg:dbname=xcat;host=|| + +where mgmtnode is the hostname of the management node adapter on the cluster side + +=back + xCAT also supports regular expressions in the tables. This enables one row to represent many rows. For example, if you have many blades in your cluster and their hostnames have a regular pattern of blade1, blade2, etc., and your BladeCenter management modules also have a hostname diff --git a/xCAT-client-2.0/pods/man1/makedhcp.1.pod b/xCAT-client-2.0/pods/man1/makedhcp.1.pod index e3be85bbf..df42fd0fd 100644 --- a/xCAT-client-2.0/pods/man1/makedhcp.1.pod +++ b/xCAT-client-2.0/pods/man1/makedhcp.1.pod @@ -1,30 +1,35 @@ =head1 NAME -B -Creates new dhcp configuration files and updates live dhcp configuration using omapi. - +B - Creates new dhcp configuration files and updates live dhcp configuration using omapi. + =head1 SYNOPSIS - -I -I +B -I +B I [B<-s> I] + +B I<[h|--help]> =head1 DESCRIPTION -The makedhcp command with the -n option will create a dhcpd.conf file to allow xCAT to manage the DHCP configuration, including certain general parameters such as a dynamic range and omapi configuration. With a noderange, makedhcp will inject configuration data pertinent to the specified nodes that immediately takes effect without a reset. +The B command with the B<-n> option will create a dhcpd.conf file to allow xCAT to manage +the DHCP configuration, including certain general parameters such as a dynamic range and omapi configuration. +With a noderange, makedhcp will inject configuration data pertinent to the specified nodes that immediately +takes effect without a reset. + +The B command also uses the following attributes from the xCAT database: B, +B, B, +B, B + =head1 OPTIONS - - B<-h> Display usage message. -B<-n> Create a new dhcpd.conf file. - -B<-s> For the input noderange, the argument will be interpreted like dhcpd.conf text. +B<-n> Create a new dhcpd.conf file. +B<-s> For the input noderange, the argument will be interpreted like dhcpd.conf text. =head1 RETURN VALUE @@ -35,15 +40,9 @@ B<-s> For the input noderange, the argument will be interpreted like dh =head1 EXAMPLES -1. The following example, will cause dhcp on the next request to set root-path appropriately for only node5. Note some characters (e.g. ") must be doubly escaped (once for the shell, and once for the OMAPI layer). +1. The following example, will cause dhcp on the next request to set root-path appropriately for only node5. Note some characters (e.g. ") must be doubly escaped (once for the shell, and once for the OMAPI layer). -I - - - -=head1 FILES - -/opt/xcat/bin/mkdhcp +I =head1 NOTES diff --git a/xCAT-client-2.0/pods/man1/nodeset.1.pod b/xCAT-client-2.0/pods/man1/nodeset.1.pod new file mode 100644 index 000000000..8fcab1211 --- /dev/null +++ b/xCAT-client-2.0/pods/man1/nodeset.1.pod @@ -0,0 +1,182 @@ +=head1 Name + +B - set the boot state for a noderange + +=head1 B + +B [I] [I|I|I|I] + +B [I] [I|I|I] + +B [I] [I|I|I] + + +B [I] [I={I}] + + +B [I<-h>|I<--help>|I<-v>|I<--version>] + +=head1 B + +B sets the next cold or warm boot state for a single or range of +nodes or groups. This tells xCAT what you want to happen the next time the +nodes are booted up. See L. B accomplishes this by +changing the network boot files. Each xCAT node always boots from the +network and downloads a boot file with instructions on what action to +take next. + +B only supports PXELINUX, Etherboot, Etherboot/NBGRUB, and ELILO +as network boot loaders. B calls B, B, B +B, and B to perform the updates. + +Assume that /tftpboot is the root for tftpd (set in L). + +B makes changes to /tftpboot/pxelinux.0/{node hex ip} + +B makes changes to /etc/dhcpd.conf + +B makes changes to /tftpboot/grub/{node hostname}.grub + +B makes changes to /tftpboot/elilo/{node ip}.conf and +/tftpboot/elilo/{node hex ip}.conf + +B support both formats for xCAT patch elilo 2.5 and xCAT +patched elilo 3.x. + +B only sets the next boot state, but does not reboot. + +B is called by rinstall and winstall and is also called by the +installation process remotely to set the boot state back to "boot". + +When B is called to set a node for an installation state, a NODE- +TYPE-RESOURCE.BOOTTYPE template must exist in /tftpboot/xcat (or the +appropriate directory as defined in L), where NODETYPE is +defined per node in L, RESOURCE is defined per node or +group in L, and BOOTTYPE is defined per node in +L. + +=head1 B + +=over 7 + +=item B + +Instruct node to boot local harddisk 0 on next boot. + +=item B + +Instruct node to boot from network. This usually involves TFTP +downloading a kernel, initrd, and kernel options, then booting +the downloaded images to facilitate automated unattended +installation. + +=item B|B + +Display the next boot state. + +=item B + +Instruct node to boot from network image stage2. This involves +TFTP downloading a special prebuilt kernel, initrd, and kernel +options used for MAC address collection. For a new node this is +the default action and cannot be changed until a node entry +exists in L. It is not necessary to explicitly set +stage2, unless it is used for testing and development purposes. + +=item B + +Instruct node to boot from network image stage3. This involves +TFTP downloading a special prebuilt kernel, initrd, and kernel +options used for the automated programming of IBM service pro- +cessors. + +=item B + +Instruct node to boot from a network maintainance shell image. +This involves TFTP downloading a special prebuilt kernel, ini- +trd, and kernel options used for a limited RAMdisk-based main- +tainance shell. Only available for IA64 systems. + +=item B + +Instruct node to boot from network into clone mode. In clone +mode the node will poll the management node for nodes in clone- +server mode, once a clone lock is established the clone node +clones the cloneserver node. Usually called from L. + +=item B + +Instruct node to boot from network into cloneserver mode. In +cloneserver mode the node will wait for a node to attempt a +clone lock. Once a clone lock is established the clone node +clones the cloneserver node. All other requested will be +refused until node cloning is completed. + +=item B +Instruct node to boot from network and run Partition Imager to +create partition images. + +=item B=I + +Instruct node to boot from network load DOS and flash I. +Usually called from L. + +=item B<-h>|B<--help> + +Print help. + +=item B<-v>|B<--version> + +Print version. + +=back + + +=head1 B + +B table - +xCAT node hardware management file. See L for fur- +ther details. This is used to determine the network boot type: +PXE, Etherboot, ELILO, or NA. + +B table - +xCAT node resources file. See L for further +details. This is used to determine the node's resource group. + +B table - +xCAT node installation type file. See L for fur- +ther details. This is used to determine the node installation +image type. + +B table - +xCAT main configuration file. See L for further +details. This is used to determine the location of the TFTP +root directory and the TFTP xCAT subdirectory. /tftpboot and +/tftpboot/xcat is the default. + +B file - +xCAT dhcpd configuration file. See L for further +details. This is used by B to determine if a node will +only boot stage2 because no statically assigned IP exists for +that node. Also used by nodeset.eb to set the boot state for +Etherboot enabled nodes. + + +=head1 B + +B I I + +node5: install compute62-compute + +Install node5 with the compute62 image using resources from the compute +resource group. + + +=head1 B + +Egan Ford + +=head1 B B + +L, L, L, L, +L, L diff --git a/xCAT-client-2.0/pods/man1/nodestat.1.pod b/xCAT-client-2.0/pods/man1/nodestat.1.pod new file mode 100644 index 000000000..67cf25c6c --- /dev/null +++ b/xCAT-client-2.0/pods/man1/nodestat.1.pod @@ -0,0 +1,50 @@ +=head1 Name + +B - display the running status of a noderange + +=head1 B + +B [I] + +B [I<-h>|I<--help>|I<-v>|I<--version>] + +=head1 B + +B is a small utility used to display the running status of a +single or range of nodes or groups. See L. + +B will first check for pbs_mom, if that fails then B will +check for snmpd, then ping. If ping fails, then B returns "nop- +ing". + +=head1 B + +=over 5 + +=item B<-v>|B<--version> + +Print version. + +=item B<-h>|B<--help> + +Print help. + +=back + + +=head1 B + +I I + +node4 snmp +node5 pbs +node6 snmp +node7 noping + +=head1 B + +Egan Ford + +=head1 B B + +L, L, L, L diff --git a/xCAT-client-2.0/pods/man1/pcons.1.pod b/xCAT-client-2.0/pods/man1/pcons.1.pod new file mode 100644 index 000000000..17642f118 --- /dev/null +++ b/xCAT-client-2.0/pods/man1/pcons.1.pod @@ -0,0 +1,33 @@ + +=head1 NAME + +B - Runs a command on the noderange using the out-of-band console. + +=head1 SYNOPSIS + +B I I + +B +[B<-h>|B<--help>] + +B +[B<-v>|B<--version>] + + +=head1 DESCRIPTION + +Runs the a command to the noderange using the console. + +=head1 EXAMPLES + + + pcons 1,3 stat + pcons all,-129-256 stat + + + +=head1 AUTHOR + +Egan Ford Eegan@us.ibm.comE + + diff --git a/xCAT-client-2.0/pods/man1/pping.1.pod b/xCAT-client-2.0/pods/man1/pping.1.pod new file mode 100644 index 000000000..159dddd6c --- /dev/null +++ b/xCAT-client-2.0/pods/man1/pping.1.pod @@ -0,0 +1,56 @@ + +=head1 NAME + +B - parallel ping. + +=head1 SYNOPSIS + +B [B<-q>] [B<-s>] [B<-i> I] I + +B [B<-h>|B<--help>] + +B {B<-v>|B<--version>} + + +=head1 DESCRIPTION + +B is a utility used to ping list of nodes in parallel.See noderange(3). +B will return an unsorted list of nodes with a ping or noping status. The list is actually sorted by first ping, unless -s is specified. +B front-ends ping and fping if available. + +This command does not support the xcatd client/server communication. It must be run on the management node. + +=head1 OPTIONS + +B<-q> quiet, only show noping nodes + +B<-s> Ping serially + +B<-i interface> interface + +B<-h | help> help + +B<-v | version> version + + +=head1 EXAMPLES + + pping all + + blade7: ping + blade8: ping + blade9: ping + devmaster: ping + node4: ping + node2: noping + + pping -q all + + node2: noping + + +=head1 AUTHOR + +Egan Ford Eegan@us.ibm.comE + + diff --git a/xCAT-client-2.0/pods/man1/ppping.1.pod b/xCAT-client-2.0/pods/man1/ppping.1.pod new file mode 100644 index 000000000..5fc261532 --- /dev/null +++ b/xCAT-client-2.0/pods/man1/ppping.1.pod @@ -0,0 +1,52 @@ + +=head1 NAME + +B - parallel ping between nodes in cluster. + +=head1 SYNOPSIS + +B [B<-s>] [B<-i> I] I + +B [B<-h>|B<--help>] + +B {B<-v>|B<--version>} + + +=head1 DESCRIPTION + +B is a utility used to test ping between nodes in the noderange. +B will return an unsorted list of nodes with a ping or noping status. The list is actually sorted by first ping, unless -s is specified. +B front-ends ping and fping if available. + +This command does not support the xcatd client/server communication. It must be run on the management node. + + +=head1 OPTIONS + + +B<-s> Ping serially + +B<-i interface> interface + +B<-h | help> help + +B<-v | version> version + + +=head1 EXAMPLES + + ppping all + + blade7: node2: noping + blade8: node2: noping + blade9: node2: noping + devmaster: node2: noping + node2: noping + + + +=head1 AUTHOR + +Egan Ford Eegan@us.ibm.comE + + diff --git a/xCAT-client-2.0/pods/man1/prsync.1.pod b/xCAT-client-2.0/pods/man1/prsync.1.pod new file mode 100644 index 000000000..5d2a30e07 --- /dev/null +++ b/xCAT-client-2.0/pods/man1/prsync.1.pod @@ -0,0 +1,74 @@ +=head1 Name + +prsync - parallel rsync + +=head1 B + +B I [I I<...>] I + +B [I] [I I I<...>] [I I I<...>] +I + +B {B<-h>|B<--help>|B<-v>|B<--version>} + +=head1 B + +B is a front-end to rsync for a single or range of nodes and/or +groups in parallel. + +Note: this command does not support the xcatd client/server communication and therefore must be run on the management node. + +B is NOT multicast, but is parallel unicasts. + +=head1 B + +=over 7 + +=item B + +rsync options. See L. + +=item B + +A space delimited list of files to rsync. + +=item B + +A space delimited list of directories to rsync. + +=item B + +A L and destination directory. The : is required. + +=item B<-h>|B<--help> + +Print help. + +=item B<-v>|B<--version> + +Print version. + +=back + + +=head1 B + +=over 3 + +=item * + +B I B B<-cravz> I I + +=item * + +B I I I + +=back + +=head1 B + +Egan Ford + +=head1 B B + +L, L, L, L diff --git a/xCAT-client-2.0/pods/man1/pscp.1.pod b/xCAT-client-2.0/pods/man1/pscp.1.pod new file mode 100644 index 000000000..3c85b1780 --- /dev/null +++ b/xCAT-client-2.0/pods/man1/pscp.1.pod @@ -0,0 +1,67 @@ +=head1 Name + +B - parallel remote copy + +=head1 B + +B I [I I<...>] I + +B [B<-r>] [I I I<...>] [I I I<...>] +I + +B {B<-h>|B<--help>|B<-v>|B<--version>} + +=head1 B + +B is a utility used to copy a single or multiple set of files and/or +directories to a single or range of nodes and/or groups in parallel. + +B is a front-end to the remote copy B. + +Note: this command does not support the xcatd client/server communication and therefore must be run on the management node. + +B is NOT multicast, but is parallel unicasts. + +=head1 B + +=over 7 + +=item B<-r> + +Recursive copy through directories. + +=item B + +A space delimited list of files to copy. + +=item B + +A space delimited list of directories to copy. + +=item B + +A L and destination directory. The : is required. + +=item B<-h>|B<--help> + +Print help. + +=item B<-v>|B<--version> + +Print version. + +=back + + +=head1 B + +B B<-r> I I +B I I I + +=head1 B + +Egan Ford + +=head1 B B + +L, L, L, L diff --git a/xCAT-client-2.0/pods/man1/psh.1.pod b/xCAT-client-2.0/pods/man1/psh.1.pod new file mode 100644 index 000000000..7cbcd166c --- /dev/null +++ b/xCAT-client-2.0/pods/man1/psh.1.pod @@ -0,0 +1,80 @@ +=head1 Name + +psh - parallel remote shell + +=head1 B + +B [I<-s>] {I|B|I} I + +B {B<-h>|B<--help>|B<-v>|B<--version>} + +=head1 B + +B is a utility used to run a command across a list of nodes in parallel. + +B must be set up to allow no prompting for B to work. + +Note: this command does not support the xcatd client/server communication and therefore must be run on the management node. + +=head1 B + +=over 7 + +=item B<-s> + +Issues the commands serially. + +=item B + +See L. + +=item B + +Run against nodes owned by "me" as listed by PBS's L +command. + +=item B + +Run against nodes assigned to a PBS job as listed by PBS's +L command. + +=item B + +Command to be run in parallel. If no command is give then B +enters interactive mode. In interactive mode a ">" prompt is +displayed. Any command entered is executed in parallel to the +nodes in the noderange. Use "exit" or "Ctrl-D" to end the interactive session. + +=item B<-h>|B<--help> + +Print help. + +=item B<-v>|B<--version> + +Print version. + +=back + + +=head1 B + +B I I + +node4: Sun Aug 5 17:42:06 MDT 2001 +node5: Sun Aug 5 17:42:06 MDT 2001 +node6: Sun Aug 5 17:42:06 MDT 2001 + +B I I I<-f> I + +B I I<'rm> I<-f> I + +Notice the use of '' to forward shell expansion. This is not necessary +in interactive mode. + +=head1 B + +Egan Ford + +=head1 B B + +L, L, L, L diff --git a/xCAT-client-2.0/pods/man1/rbeacon.1.pod b/xCAT-client-2.0/pods/man1/rbeacon.1.pod new file mode 100644 index 000000000..6b610a00c --- /dev/null +++ b/xCAT-client-2.0/pods/man1/rbeacon.1.pod @@ -0,0 +1,35 @@ + +=head1 NAME + +B - Turns beacon on/off/blink or gives status of a node or noderange. + +=head1 SYNOPSIS + +B I {B|B|B|B} + +B [B<-h>|B<--help>] + +B {B<-v>|B<--version>} + + +=head1 DESCRIPTION + +B Turns beacon (a light on the front of the physical server) on/off/blink or gives status of a node or noderange. + +=head1 EXAMPLES + + rbeacon 1,3 off + rbeacon 14-56,70-203 on + rbeacon 1,3,14-56,70-203 blink + rbeacon all,-129-256 stat + + +=head1 SEE ALSO + +noderange(3), rpower(1) + +=head1 AUTHOR + +Egan Ford Eegan@us.ibm.comE + + diff --git a/xCAT-client-2.0/pods/man1/rbootseq.1.pod b/xCAT-client-2.0/pods/man1/rbootseq.1.pod new file mode 100644 index 000000000..a859c6556 --- /dev/null +++ b/xCAT-client-2.0/pods/man1/rbootseq.1.pod @@ -0,0 +1,88 @@ + +=head1 NAME + +B - Sets the boot order for BladeCenter blades. + +=head1 SYNOPSIS + +B I {B|B|B|B|B|B|B|B|B|B|B|B|B}B<,>I<...> + +B [B<-h>|B<--help>|B<-v>|B<--version>] + + +=head1 DESCRIPTION + +B sets the boot sequence of the specified blades. Up to four different medium can be listed, separated by commas. + +=head1 OPTIONS + +=over 7 + +=item B|B|B|B + +The first hard disk. + +=item B|B + +The second hard disk. + +=item B|B + +The third hard disk. + +=item B|B + +The fourth hard disk. + +=item B|B|B + +Boot over the network, using a PXE or BOOTP broadcast. + +=item B + +Boot to an iSCSI disk over the network. + +=item B + +?? + +=item B|B + +The CD or DVD drive. + +=item B|B|B + +A USB flash drive. + +=item B + +The floppy drive. + +=item B + +If it gets to this part of the sequence, do not boot. Can not be specified 1st, or before any real boot devices. + +=item B|B + +Display the current boot sequence. + +=back + +=head1 EXAMPLES + + + rbootseq 1,3 c,f,n,hd0 + rbootseq 14-56,70-203 c,f,n,hd0 + rbootseq 1,3,14-56,70-203 c,f,n,hd0 + rbootseq all,-129-256 c,f,n,hd0 + + +=head1 SEE ALSO + +rsetboot(1) + +=head1 AUTHOR + +Egan Ford Eegan@us.ibm.comE + + diff --git a/xCAT-client-2.0/pods/man1/rcons.1.pod b/xCAT-client-2.0/pods/man1/rcons.1.pod new file mode 100644 index 000000000..1fe271ea5 --- /dev/null +++ b/xCAT-client-2.0/pods/man1/rcons.1.pod @@ -0,0 +1,48 @@ +=head1 Name + +B - remote console + +=head1 B + +B I + +B [I<-h>|I<--help>|I<-v>|I<--version>] + +=head1 B + +B provides access to a single remote node serial console. + +=head1 B + +=over 5 + +=item B<-h>|B<--help> + +Print help. + +=item B<-v>|B<--version> + +Print version. + +=back + + +=head1 B + +B table - +xCAT node hardware management table. See L for +further details. This is used to determine the console access +method. + + +=head1 B + +B I + +=head1 B + +Egan Ford + +=head1 B B + +L, L, L diff --git a/xCAT-client-2.0/pods/man1/reventlog.1.pod b/xCAT-client-2.0/pods/man1/reventlog.1.pod new file mode 100644 index 000000000..a2dcf7a2e --- /dev/null +++ b/xCAT-client-2.0/pods/man1/reventlog.1.pod @@ -0,0 +1,66 @@ +=head1 Name + +B - retrieve or clear remote hardware event logs + +=head1 B + +B I {I|B|B} + +B [B<-h>|B<--help>|B<-v>|B<--version>] + +=head1 B + +B can display any number of remote hardware event log entries +or clear them for a range of nodes. Hardware event +logs are stored on each servers service processor. + +=head1 B + +=over 7 + +=item I + +Retrieve the specified number of entries from the nodes' service processors. + +=item B + +Retrieve all entries. + +=item B + +Clear event logs. + +=item B<-h>|B<--help> + +Print help. + +=item B<-v>|B<--version> + +Print version. + +=back + + +=head1 B + +B I I<5> + + node4: SERVPROC I 09/06/00 15:23:33 Remote Login Successful User ID = USERID[00] + node4: SERVPROC I 09/06/00 15:23:32 System spn1 started a RS485 connection with us[00] + node4: SERVPROC I 09/06/00 15:22:35 RS485 connection to system spn1 has ended[00] + node4: SERVPROC I 09/06/00 15:22:32 Remote Login Successful User ID = USERID[00] + node4: SERVPROC I 09/06/00 15:22:31 System spn1 started a RS485 connection with us[00] + node5: SERVPROC I 09/06/00 15:22:32 Remote Login Successful User ID = USERID[00] + node5: SERVPROC I 09/06/00 15:22:31 System spn1 started a RS485 connection with us[00] + node5: SERVPROC I 09/06/00 15:21:34 RS485 connection to system spn1 has ended[00] + node5: SERVPROC I 09/06/00 15:21:30 Remote Login Successful User ID = USERID[00] + node5: SERVPROC I 09/06/00 15:21:29 System spn1 started a RS485 connection with us[00] + +B I I + + node4: clear + node5: clear + +=head1 B + +rpower(1), startmon(1) diff --git a/xCAT-client-2.0/pods/man1/rinv.1.pod b/xCAT-client-2.0/pods/man1/rinv.1.pod new file mode 100644 index 000000000..273bfe4f9 --- /dev/null +++ b/xCAT-client-2.0/pods/man1/rinv.1.pod @@ -0,0 +1,100 @@ +=head1 Name + +B - remote hardware inventory + +=head1 B + +B I {B|B|B|B|B|B|B|B|B|B|B|B|B|B|B} + +B [B<-h>|B<--help>|B<-v>|B<--version>] + +=head1 B + +B retrieves hardware configuration information from the on-board +Service Processor for a single or range of nodes and groups. + +=head1 B + +=over 7 + +=item B + +Retrieves PCI bus information. + +=item B + +Retrieves number of processors, speed, total memory, and DIMM +locations. + +=item B + +Retrieves model number. + +=item B + +Retrieves serial number. + +=item B + +Retrieves asset tag. Usually it's the MAC address of eth0. + +=item B + +Same as specifying model, serial, deviceid, and mprom. + +=item B + +? + +=item B + +? + +=item B + +? + +=item B + +All of the above. + +=item B<-h>|B<--help> + +Print help. + +=item B<-v>|B<--version> + +Print version. + +=back + + +=head1 B + +B I I + + node5: Machine Type/Model 865431Z + node5: Serial Number 23C5030 + node5: Asset Tag 00:06:29:1F:01:1A + node5: PCI Information + node5: Bus VendID DevID RevID Description Slot Pass/Fail + node5: 0 1166 0009 06 Host Bridge 0 PASS + node5: 0 1166 0009 06 Host Bridge 0 PASS + node5: 0 5333 8A22 04 VGA Compatible Controller0 PASS + node5: 0 8086 1229 08 Ethernet Controller 0 PASS + node5: 0 8086 1229 08 Ethernet Controller 0 PASS + node5: 0 1166 0200 50 ISA Bridge 0 PASS + node5: 0 1166 0211 00 IDE Controller 0 PASS + node5: 0 1166 0220 04 Universal Serial Bus 0 PASS + node5: 1 9005 008F 02 SCSI Bus Controller 0 PASS + node5: 1 14C1 8043 03 Unknown Device Type 2 PASS + node5: Machine Configuration Info + node5: Number of Processors: + node5: Processor Speed: 866 MHz + node5: Total Memory: 512 MB + node5: Memory DIMM locations: Slot(s) 3 4 + + +=head1 B + +rpower(1) diff --git a/xCAT-client-2.0/pods/man1/rpower.1.pod b/xCAT-client-2.0/pods/man1/rpower.1.pod index 2371620d7..f165a3cec 100644 --- a/xCAT-client-2.0/pods/man1/rpower.1.pod +++ b/xCAT-client-2.0/pods/man1/rpower.1.pod @@ -1,22 +1,16 @@ =head1 NAME -rpower - remote power control +B - remote power control of nodes =head1 SYNOPSIS -B -I -B<[--nodeps]> B|B|B|B|B|B|B +B I [B<--nodeps>] {B|B|B|B|B|B|B} -B -[B<-h>|B<--help>] - -B -[B<-v>|B<--version>] +B [B<-h>|B<--help>|B<-v>|B<--version>] =head1 DESCRIPTION -I controls the power for a single or range of nodes. +B controls the power for a single or range of nodes, via the out-of-band path. =head1 OPTIONS @@ -42,7 +36,7 @@ Send a hard reset. If off, then power on. If on, then hard reset. -The option is recommended over B. +This option is recommended over B. =item B @@ -52,66 +46,39 @@ Power off, then on. Do not use dependency table (default is to use dependency table). Valid only with on|off|boot|reset|cycle for blade power method. -=item B<-h>, B<--help> +=item B<-h>|B<--help> -Help. -Prints out a brief help message. +Prints out a brief usage message. =item B<-v>, B<--version> -Version. Display the version number. -=back - -=head1 ENVIRONMENT - -=over 4 - - =back =head1 EXAMPLES -=begin roff +=over 3 -\fIrpower node4,node5 stat\fR +=item * -node4: on -.br -node5: off +B I -\fIrpower node5 on\fR + node4: on + node5: off -node5: on +=item * -=end roff +B I -=begin html -rpower node5 on -
-
-node4: on -
-node5: off -
-
-rpower node5 on -
-
-node5: on + node5: on -=end html +=back -=head1 FILES +=head1 SEE ALSO -/opt/xcat/bin/rpower - - -=head1 NOTES - -This command is part of the xCAT software product. +noderange(3), rcons(1), rinv(1), rvitals(1), rscan(1) diff --git a/xCAT-client-2.0/pods/man1/rsetboot.1.pod b/xCAT-client-2.0/pods/man1/rsetboot.1.pod new file mode 100644 index 000000000..2644e4db5 --- /dev/null +++ b/xCAT-client-2.0/pods/man1/rsetboot.1.pod @@ -0,0 +1,58 @@ + +=head1 NAME + +B - Sets the boot order for servers with BMC service processors. + +=head1 SYNOPSIS + +B I {B|B|B|B|B} + +B [B<-h>|B<--help>|B<-v>|B<--version>] + + +=head1 DESCRIPTION + +B sets the boot media to be used on the next boot of the specified nodes. + +=head1 OPTIONS + +=over 7 + +=item B + +Boot from the hard disk. + +=item B + +Boot over the network, using a PXE or BOOTP broadcast. + +=item B + +Boot from the CD or DVD drive. + +=item B|B + +Boot using the default set in BIOS. + +=item B + +Display the current boot setting. + +=back + +=head1 EXAMPLES + + rsetboot 1,3 net + rsetboot 14-56,70-203 stat + rsetboot 1,3,14-56,70-203 default + + +=head1 SEE ALSO + +rsetboot(1) + +=head1 AUTHOR + +Egan Ford Eegan@us.ibm.comE + + diff --git a/xCAT-client-2.0/pods/man1/rspconfig.1.pod b/xCAT-client-2.0/pods/man1/rspconfig.1.pod new file mode 100644 index 000000000..19a915ebf --- /dev/null +++ b/xCAT-client-2.0/pods/man1/rspconfig.1.pod @@ -0,0 +1,80 @@ +=head1 NAME + +B - remote power control of nodes + +=head1 SYNOPSIS + +B I {B|B|B|B} + +B I B={B|B|B|B} + +B I B=I + +B I B={B|I} + +B I B=I