unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 frupower(1M)							frupower(1M)




 NAME
      frupower - turn on/off or display current status of power for cells
      and I/O chassis

 SYNOPSIS
      frupower -c cell [-c...] [-d|-o|-f]
	   [ -u username -h IPaddress|hostname
	   | -g -h IPaddress|hostname ]

      frupower -i I/Ochassis [-i...] [-d|-o|-f]
	   [ -u username -h IPaddress|hostname
	   | -g -h IPaddress|hostname ]

      frupower -C|-I [-d] [-l cabinet]...
	   [ -u username -h IPaddress|hostname
	   | -g -h IPaddress|hostname ]

 DESCRIPTION
      The frupower command turns power on or off, or displays the current
      status of power for cells and I/O chassis.

      The operations allowed by this command are subject to the following
      conditions:

      +	 An active cell cannot be powered off.	An active cell is one that
	 is assigned to a partition and that is being used by the partition.

      +	 The -i option can be used to display the power state of any I/O
	 chassis, but can only control the power state of an I/O chassis in
	 the following two situations:

	 +  The I/O chassis is attached to an active cell and is powered
	    off.  The I/O chassis may be powered on, but will not become
	    active until the partition to which the cell is assigned has
	    been rebooted.

	 +  The I/O chassis is attached to an active cell and is powered on,
	    but the I/O chassis has not yet become active.  The I/O chassis
	    may be powered off.

      +	 If the target of the command is the local partition, meaning that
	 neither the -u nor -g option is used:

	 +  Any user can run the command to display the power state of cells
	    and I/O chassis.

	 +  Root permission is required to change the power state of a
	    component (cell or chassis).

	 +  Cell power operations are limited to free cells and inactive or
	    powered-off cells assigned to the local partition.	If the



 Hewlett-Packard Company	    - 1 -      HP-UX 11i Version 1: Sep 2004






 frupower(1M)							frupower(1M)




	    nPartition Configuration Privilege is restricted, then control
	    of free cells is not allowed.

	    Note: The nPartition Configuration Privilege state can only be
	    changed at the service processor's Command menu.

      +	 When connecting to a remote partition using the -u and -h options:

	 +  Any local user may run the command.	 Root permission is not
	    required, and the user's system need not be an nPartition.

	 +  The set of allowed operations depends on the privileges of
	    username on the remote partition, and the state of the
	    nPartition Configuration Privilege on the complex on which the
	    remote partition exists.  The rules and conditions are the same
	    as for the local partition description.

      +	 When connecting to the service processor of a complex using the -g
	 and -h options:

	 +  Any user may run the command.  Root permission is not required,
	    and the user's system need not be an nPartition.

	 +  The user may display the power state of any cell or I/O chassis.
	    Any powered off cell can be powered on, and any inactive cell
	    can be powered off, whether or not the cell is assigned to a
	    partition or is a free cell.  The state of the complex's
	    nPartition Configuration Privilege does not affect this mode of
	    command operation.

	 Note that knowledge of the -g gives the user full authorization to
	 carry out any of the above operations, regardless of her
	 permissions on her local system.

      Please refer to the HP System Partitions Guide for a description of
      the partition management terms used in this man page.

    Remote Management Options
      The -u and -g options will be available only if NParProvider and
      NPartition products are installed. The cplxmodify command will exists
      only if NPartition product is installed.

    Options and Arguments
      frupower recognizes the following command line options and arguments:

      -d	     Displays power status of specified cells or I/O
		     chassis.  This is the default.

      -o	     Powers on specified cells or I/O chassis.





 Hewlett-Packard Company	    - 2 -      HP-UX 11i Version 1: Sep 2004






 frupower(1M)							frupower(1M)




      -f	     Powers off specified cells or I/O chassis.

		     The -d, -o, and -f options are mutually exclusive.	 The
		     -o and -f options are unavailable with -C and -I.

      -u username    Specifies the required authorization to access a
		     partition other than the local partition and to control
		     components on it, subject to the conditions stated in
		     the DESCRIPTION section (but can also be used as a
		     loopback access to the local partition).  The target
		     complex is the one in which this target partition
		     resides.

		     The -h option is required if this option is used.

		     username specifies a configured user name on the target
		     partition.	 Any username can display the power state of
		     components on the target partition.  username must have
		     root permission to change any power state.	 If -u
		     username is specified, the command will prompt for the
		     password associated with the username.

		     Note: This command is a Web-Based Enterprise Management
		     (WBEM) Client Application.	 The -u option accesses the
		     target partition using a Secure Sockets Layer (SSL)
		     connection.  If errors are reported, check that the
		     conditions described in the DEPENDENCIES section are
		     satisfied.

		     Note: If the commands are used in a script, the user
		     password must be passed in a secured way. For example,

		     1. Save the user password in a variable and pass it to
			the command as,

			echo $passwd | parstatus -X -u username -h
			hostname/IP

		     2. Save the user password in a file and pass the file
			as input to the command like,

			parstatus -X -u username -h hostname/IP <&lt&lt&lt;
			passwd_file

			Note, for security reason, protect the file that has
			the user password by removing read permissions for
			non-privileged users.

      -h IPaddress|hostname
		     This option should only be used in combination with
		     either the -u or -g option.  IPaddress|hostname



 Hewlett-Packard Company	    - 3 -      HP-UX 11i Version 1: Sep 2004






 frupower(1M)							frupower(1M)




		     specifies the IP address or hostname of the target
		     partition (-u) or complex (-g).

      -g	     Allows access to the complex specified by the -h
		     option.  The accessed complex is then considered the
		     target complex.  Access is via the service processor's
		     LAN port.

		     The -h option is required if this option is used.

		     If -g is specified, the IPMI password of the service
		     processor should be passed when prompted.

		     If an error is reported when you attempt to connect
		     using this option, check to see that IPMI LAN access
		     has not been disabled on the remote service processor.
		     Access to the complex via IPMI over LAN can be enabled
		     or disabled by logging on to the service processor and
		     using the SA command from the Command Menu.

		     The -u and -g options are mutually exclusive.

		     Note: If the commands are used in a script, the IPMI
		     password must be passed in a secured way. For example,

		     1. Save the user password in a variable and pass it to
			the command as,

			echo $passwd | parstatus -X -g -h hostname/IP

		     2. Save the  user	password in a file and pass the file
			as input to the command like,

			parstatus -X -g -h hostname/IP <&lt&lt&lt; passwd_file

			Note, for security reason, protect the file that has
			the IPMI password by removing read permissions for
			non-privileged users.

      -c cell	     The specified cell is powered on/off or the power
		     status is displayed.  Refer to the DESCRIPTION section
		     for the conditions under which power control is
		     allowed.

		     If a power operation on multiple cells is specified,
		     the command processes each one, regardless of the
		     outcome of the operation on a particular cell.  It is
		     possible for an operation to succeed on one cell and
		     fail on another.





 Hewlett-Packard Company	    - 4 -      HP-UX 11i Version 1: Sep 2004






 frupower(1M)							frupower(1M)




		     A cell can be specified either in the local
		     (cabinet#/slot#) or global (cell#) format. For example,
		     the cell located in cabinet 0, slot 4 is locally
		     identified as 0/4 or globally as simply 4.

      -i I/Ochassis  The specified I/Ochassis is powered on/off or the power
		     status is displayed.  Refer to the DESCRIPTION section
		     for the conditions under which power control is
		     allowed.

		     If a power operation on multiple I/O chassis is
		     specified, the command processes each one, regardless
		     of the outcome of the operation on a particular I/O
		     chassis.  It is possible for an operation to succeed on
		     one I/O chassis and fail on another.

		     An I/O chassis id must be specified in the form of
		     cabinet#/enclosure#/chassis#.  For example, the I/O
		     chassis located in cabinet 0, enclosure 1 and I/O
		     chassis slot 3 is identified as 0/1/3.

      -C	     Displays power status of all cells.  If the -u or -g
		     option is specified, the operation applies to all
		     component cells of the accessed complex.

      -I	     Displays power status of all I/O chassis.	If the -u or
		     -g option is specified, the operation applies to all
		     I/O chassis of the accessed complex.

		     The -c, -i, -C, and -I options are all mutually
		     exclusive.

      -l cabinet     Limits the scope of the -C or -I option to the
		     specified cabinet(s).

    Mapping of Global Cell Numbers to Local Cell Numbers
      The cabinets in a complex are numbered starting from 0.  The cell
      slots in each cabinet are also numbered starting from 0.	Each cabinet
      can have a maximum of 8 cells.  For example, the cells located in
      cabinet 0 will have the following cell numbers in global format: 0, 1,
      2, 3, 4, 5, 6, 7.	 The cell numbers in corresponding local format will
      be 0/0, 0/1, 0/2, 0/3, 0/4, 0/5, 0/6, 0/7.

      Similarly the cells located in cabinet 1 will have the following cell
      numbers in global format: 8, 9, 10, 11, 12, 13, 14, 15.  The cell
      numbers in corresponding local format will be 1/0, 1/1, 1/2, 1/3, 1/4,
      1/5, 1/6, 1/7.

      From the above convention the cell located in cabinet 1, slot 0 is
      identified in the local format as 1/0 or in the global format as 8.
      The parstatus(1) command will display the above cell as "cab1,cell0".



 Hewlett-Packard Company	    - 5 -      HP-UX 11i Version 1: Sep 2004






 frupower(1M)							frupower(1M)




      The cell located in cabinet 1, slot 4 is identified in the local
      format as 1/4 or in the global format as 12.  The parstatus(1) command
      will display the above cell as "cab1,cell4".

 RETURN VALUE
      The frupower command exits with one of the following values:

      0	   Successful completion.
      1	   Error condition occurred.

 EXAMPLES
      Power on the cell located in cabinet 0 slot 4 of a partition
      identified by the hostname GreenRiver:

	   frupower -o -c 0/4 -u RemoteAdmin: -h GreenRiver

      RemoteAdmin must have root permissions on GreenRiver.  Since a
      password was not supplied on the command line, the command prompts for
      it.

      Power off two cells located in cabinet 0 slot 4 and cabinet 0 slot 6.

	   frupower -f -c 0/4 -c 0/6

 DEPENDENCIES
      This command uses the Web-Based Enterprise Management (WBEM) product
      and certain of its configuration settings.  If you encounter
      connection errors when using the -u option, check that the following
      two conditions are satisfied:

      +	 Use the cimconfig(1M) command to verify (and correct if necessary)
	 the setting of the following two variables:

	 +  enableRemotePrivilegedUserAccess=true
	 +  enableHttpsConnection=true

      +	 You must have appended the target partition's digital certificate
	 to the local partition's Trust Store file.  For the nPartition
	 commands, the Trust Store file is /opt/nparcmds/nparcmds.pem.

      Refer to the WBEM documents specified in the SEE ALSO section below
      for further information.

 AUTHOR
      frupower was developed by the Hewlett-Packard Company.

 FILES
      /usr/sbin/	     The partition commands under this directory do
			     not provide remote management feature.





 Hewlett-Packard Company	    - 6 -      HP-UX 11i Version 1: Sep 2004






 frupower(1M)							frupower(1M)




      /usr/lib/npar/	     The partition commands under this directory
			     provide remote management feature. These
			     commands use the nPartition Provider product.

      /opt/nparprovider/lib/installed
			     The presence of this file indicates that
			     nPartition Provider is installed.

 SEE ALSO
      cplxmodify(1M), fruled(1), parcreate(1M), parmgr(1M), parmodify(1M),
      parremove(1M), parstatus(1), parunlock(1M), partition(5),

      HP System Partitions Guide on docs.hp.com,

      HP WBEM Services for HP-UX System Administrator's Guide on
      docs.hp.com,

      HP WBEM Services for HP-UX 11i v2.0 on Integrity Servers Version
      A.01.05 Release Notes on docs.hp.com.



































 Hewlett-Packard Company	    - 7 -      HP-UX 11i Version 1: Sep 2004