NAME
rad — perform OLA/R functions without any comprehensive checks
SYNOPSIS
/usr/bin/rad -q
/usr/bin/rad -n
/usr/bin/rad -f 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.
- -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.
- -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).
- -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
- 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.
/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.
Printable version
