unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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



 rad(1M)							     rad(1M)




 NAME
      rad - perform OLA/R functions without any comprehensive checks

 SYNOPSIS
      /usr/bin/rad -q

      /usr/bin/rad -n

      /usr/bin/rad -f|P flag  slot_id

      /usr/bin/rad -a|c|d|h|i|o|r|s slot_id

      /usr/bin/rad -C|D|N|R|S|V hw_path

 DESCRIPTION
      The rad command provides the ability to perform on-line addition and
      replacement of I/O cards.	 This command should be used while the
      system is in single-user state, when SAM is unavailable.

      This tool provides OLA/R capabilities, but is not as comprehensive as
      the SAM implementation.  The command does not make extensive
      environmental or critical resource checks since it is expected to be
      executed when the system is in a minimal operating state with few, if
      any, applications running.

      This command is an administrative command and therefore will only
      allow root privileged users to perform the OLA/R functions.

    Options
      slot_id		  Slot ID of an OLA/R capable slot. A slot ID is a
			  list of one or more numbers separated by dashes.
			  Each number represents a component of the physical
			  location of the slot.	 The user can use the slot
			  ID to locate the slot.  The sequence of numbers in
			  the slot ID is platform dependent.  On the N and L
			  classes, the slot ID contains only the slot
			  number.  On all other platforms, including
			  SuperDome, the format of the slot ID is:

			  Cabinet#-Bay#-Chassis#-Slot#

      slot_hw_path	  Hardware path of an OLA/R capable slot

      device_hw_path	  Hardware path of a device as reported by ioscan.
			  A single slot_hw_path can be a part of multiple
			  device_hw_paths for a multi-function or a multi-
			  port card.

      -a slot_id	  List the affected (same power-domain) slot IDs of
			  the specified slot.




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






 rad(1M)							     rad(1M)




      -C device_hw_path	  Display the device information (Device_ID,
			  Vendor_ID, Revision_ID, etc.) of the device at the
			  indicated hardware path.

      -c slot_id	  Display the device information (Device_ID,
			  Vendor_ID, Revision_ID, etc.) of all the interface
			  devices at the indicated slot.

      -d slot_id	  Reserved for future use.

      -D device_hw_path	  Reserved for future use.

      -f  flag	slot_id	  Set the attention indicator LED of the specified
			  slot.	 The flag must be one of the following
			  values: ON, ATTENTION, or OFF.

      -P  flag	slot_id	  RAIL the power LED of the specified slot.  The
			  flag value must be: RAIL.  Power LED will reflect
			  the slot power status during OLAR operations
			  performed from rad/SAM.  During OLAR operations
			  initiated via Doorbell (aka Attention Button on
			  supported platforms), the power LED may continue
			  to remain blinking under certain circumstances.
			  The -P option will put the power LED back to a
			  state reflecting the slot power status.

      -h slot_id	  List the hardware paths of the interface node(s)
			  for the specified slot.

      -i slot_id	  Power ON the indicated slot.	The other slots, if
			  any, that are on the same power-domain will have
			  their power turned ON as well (potentially harmful
			  to the system operations).

      -n		  Display the number of OLA/R capable slots in the
			  system.

      -N slot_hw_path | device_hw_path
			  Find the slot ID of the specified slot or device
			  hardware path.

      -o slot_id	  Power OFF the indicated slot.	 The other slots, if
			  any, that are on the same power-domain will have
			  their power turned OFF as well (potentially
			  harmful to the system operations).

      -q		  Display the status of all OLA/R slots on the
			  system.

      -r slot_id	  Resume the operations of the indicated slot and
			  its affected slots (same power-domain).



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






 rad(1M)							     rad(1M)




      -R device_hw_path	  Resume the instance of the driver at the specified
			  hardware path.

      -s slot_id	  Suspend the operations of the indicated slot and
			  its affected slots (same power-domain)
			  (potentially harmful to the system operations).

      -S device_hw_path	  Suspend the instance of the driver at the
			  specified hardware path.

      -V device_hw_path	  Display the OLA/R driver information (current
			  state, timeout values in seconds, etc.) for the
			  driver at the specified hardware path.

    Note
      In some cases, administrators must initiate certain actions before
      hardware I/O controller cards are replaced or deleted; other cases
      require activity after cards are replaced or added. Pre- and Post-OLAR
      scripts will be used to perform these necessary activities.  These
      scripts, named according to the driver name (if the driver is
      foodriver then the script is foodriver), are located in
      /usr/sbin/olrad.d directory.  These scripts has the following
      synopsis:

	   /usr/sbin/olrad.d/driver  action  hardware_path

      action is one of:

	   post_add	       Execute post add actions.
	   pref_replace	       Execute preface to replace actions.
	   prep_replace	       Execute prepare to replace actions.
	   post_replace	       Execute post replace actions.
	   pref_delete	       Execute preface to delete actions.
	   prep_delete	       Execute prepare to delete actions.
	   post_delete	       Execute post delete actions.

      hardware_path is the hardware path of the interface node.

      For a detailed description of what each script does, please view the
      individual scripts.

 EXAMPLES
    Adding a new card
      The command invocation sequence for adding a new card:

      1.   Get information about all the OLA/R capable slots.  Make note of
	   the slot_id field.

		/usr/bin/rad -q





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






 rad(1M)							     rad(1M)




      2.   Set the attention indicator LED of the desired slot to make sure
	   that the correct slot_id was used.

		/usr/bin/rad -f ATTENTION slot_id

      3.   Get the affected slot_ids for this slot; that is, check to see if
	   other slots will be powered down with this slot.  If other slots
	   are affected by this slot and if these slots are occupied, then
	   you must suspend them by using the -s option to the rad command.

		/usr/bin/rad -a slot_id

      4.   Turn off the power to the slot.  Note that the power to the other
	   slots in the same power-domain (if any), will be turned off as
	   well.

		/usr/bin/rad -o slot_id

      5.   Insert the new card into the slot.

      6.   Turn the power on to the slot.

		/usr/bin/rad -i slot_id

      7.   Turn the attention indicator LED off.

		/usr/bin/rad -f OFF slot_id

      8.   Run the /usr/sbin/ioscan command with the appropriate options to
	   configure the new card.

    Replacing a card
      The command invocation sequence for replacing a card:

      1.   Get information about all the OLA/R capable slots.  Make note of
	   the slot_id field.

		/usr/bin/rad -q

      2.   Set the attention indicator LED of the desired slot to make sure
	   that the correct slot_id was used.

		/usr/bin/rad -f ATTENTION slot_id

      3.   Get the affected slot_ids for this slot; that is, check to see if
	   other slots will be powered down with this slot.

		/usr/bin/rad -a slot_id

      4.   Suspend the software drivers of this slot as well as the other
	   slots that are affected (-a option) by this slot.



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






 rad(1M)							     rad(1M)




		/usr/bin/rad -s slot_id

      5.   Turn off the power to this slot as well as the other slots that
	   are affected (-a option) by this slot.

		/usr/bin/rad -o slot_id

      6.   Replace the faulty card in the slot with a working card.  The new
	   card must be identical (same HP product number) as the card being
	   replaced.

      7.   Turn the power on to this slot as well as the other slots that
	   are affected (-a option) by this slot.

		/usr/bin/rad -i slot_id

      8.   Resume the software drivers of this slot as well as the other
	   slots that are affected (-a option) by this slot.

		/usr/bin/rad -r slot_id

      9.   Turn the attention indicator LED off.

		/usr/bin/rad -f OFF slot_id

 RETURN VALUE
      rad returns 0 on success.	 On failure, rad returns -1 and prints an
      appropriate error message to standard error.

 SEE ALSO
      ioscan(1M), sam(1M).

      Interface Card OL* Support Guide and Interface Card OL* Support Matrix
      documents available at the http://docs.hp.com website.




















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