diff --git a/xCAT-client/pods/man1/rpower.1.pod b/xCAT-client/pods/man1/rpower.1.pod index 8b5052f00..ac1e2bb7f 100644 --- a/xCAT-client/pods/man1/rpower.1.pod +++ b/xCAT-client/pods/man1/rpower.1.pod @@ -8,6 +8,10 @@ B I [B<--nodeps>] [B|B|B|B|B [B<-h>|B<--help>|B<-v>|B<--version>] +=head2 BMC (using IPMI) specific: + +B I [B|B|B|B|B|B|B|B|B|B [B<-w> I] [B<-o>] [B<-r>]] + =head2 PPC (with IVM or HMC) specific: B I [B<--nodeps>] {B} @@ -80,13 +84,40 @@ Reboot the service processor. If there are primary and secondary FSPs/BPAs of on Attempt to request clean shutdown of OS (may not detect failures in completing command) +For stateless osimage, the 'acpid' package needs to be added to the .pkglist configuration file for the stateless osimage to enable the 'softoff' function. + =item B Turn power off. =item B -Suspend the target nodes execution +Suspend the target nodes execution. + +The B action could be run together with B<-w> B<-o> B<-r>. + +Refer to the following steps to enable the B function: + +1. Add the 'acpid' and 'suspend' package to the .pkglist of your osimage so that the required package could be installed correctly to your target system. + +2. Add two configuration files for the base function: + + /etc/pm/config.d/suspend + S2RAM_OPTS="--force --vbe_save --vbe_post --vbe_mode" + + /etc/acpi/events/suspend_event + event=button/sleep.* + action=/usr/sbin/pm-suspend + +3. Add the hook files for your specific applications which need specific action before or after the suspend action. + +Refer to the 'pm-utils' package for how to create the specific hook files. + +=item B + +Wake up the target nodes which is in B state. + +Don't try to run B against the 'on' state node, it would cause the node gets to 'off' state. =item B|B @@ -134,6 +165,18 @@ Specify the the timeout, in minutes, to wait for the expectedstatus specified by Power off, then on. +=item B<-w> I + +To set the I for the B action to wait for the success. + +=item B<-o> + +To specify that the target node will be power down if B action failed. + +=item B<-r> + +To specify that the target node will be reset if B action failed. + =item B<-h>|B<--help> Prints out a brief usage message.