unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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



 fruled(1)							   fruled(1)




 NAME
      fruled - flash/turn off attention LEDs (cell, cabinet and I/O chassis
      attention LEDs)

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

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

      fruled -b cabinet [-b...] [-f|-o]
	   [ -u username -h IPaddress|hostname
	   | -g -h IPaddress|hostname ]

      fruled -C|-I [-l cabinet] [-l...] [-f]
	   [ -u username -h IPaddress|hostname
	   | -g -h IPaddress|hostname ]

 DESCRIPTION
      The fruled command flashes/turns off attention LEDs of cells or I/O
      chassis in the local complex.  The command can also be used to start
      flashing or stop flashing cabinet number LEDs.  If either the -u
      option or the -g option is specified, the scope of the command will be
      the specified target complex.

      If a cell or I/O chassis attention LED is made to flash, the cabinet
      number LED of the cabinet that contains the cell/ I/O chassis can also
      be made to flash by using the -B option.	Likewise, if a cell or I/O
      chassis's LED is being turned off, the cabinet number LED can also be
      made to stop flashing using the -B option.

      Note:  This command does not read or display the state of any LED.
      Users must observe the hardware itself to determine the state.

      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 exist only
      if NPartition product is installed.

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

      -f	     Turn off specified attention LED(s).  This is the
		     default.




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






 fruled(1)							   fruled(1)




      -o	     Start flashing specified attention LED(s).

		     The -o option is unavailable with -C or -I.  The -f and
		     -o options are mutually exclusive.

      -B	     Start or stop flashing the cabinet number LED of the
		     cabinet that contains the cell or I/O chassis.  The -B
		     option is only available with the -c and -i options.

      -u username    Specifies the required authorization to access a
		     partition other than the local partition (but can also
		     be used as a loopback access to the local partition).
		     The complex to be modified 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.	 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	    - 2 -      HP-UX 11i Version 1: Sep 2004






 fruled(1)							   fruled(1)




		     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	     Flash/Turn off the specified cell attention LED.

		     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  Flash/Turn off the specified I/Ochassis attention LED.

		     An I/Ochassis 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



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






 fruled(1)							   fruled(1)




		     chassis slot 1 is identified as 0/1/1.

      -b cabinet     Start flashing or stop flashing the cabinet number LED
		     of the specified cabinet.

      -C	     Turn off all cell attention LEDs.

      -I	     Turn off all I/O chassis LEDs.

      -l cabinet     Limit the scope of the -C or -I option to a given
		     cabinet.

    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".
      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 fruled command exits with one of the following values:

      0	   Successful completion.

      1	   Error condition occurred.

      2	   No LED associated with specified object.

 EXAMPLES
      Flash the attention LED of the cell located in cabinet 0 slot 4 and
      also flash the attention LED of the cabinet in which it is contained.

	   fruled -o -B -c 0/4

      Turn off the attention LEDs of 2 cells located in cabinet 0, slot 4
      and cabinet 0, slot 6.





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






 fruled(1)							   fruled(1)




	   fruled -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
      fruled was developed by the Hewlett-Packard Company.

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

      /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
      frupower(1M), 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	    - 5 -      HP-UX 11i Version 1: Sep 2004