HP-UX Reference (11i v2 07/12) - 1M System Administration Commands N-Z (vol 4)

o
olrad(1M) olrad(1M)
NAME
olrad - command for online addition/replacement of PCI IO cards
SYNOPSIS
Adding Card Commands
/usr/bin/olrad
[-f] -a slot_id
/usr/bin/olrad -A
slot_id
Replacing Card Commands
/usr/bin/olrad
[-f] -r slot_id
/usr/bin/olrad -R
slot_id
Other Commands
/usr/bin/olrad -n
|-q
/usr/bin/olrad
[-F] -q
/usr/bin/olrad
[-F] -h|-c slot_id
/usr/bin/olrad
[-F] -v interface_hw_path
/usr/bin/olrad -g device_hw_path|slot_hw_path
/usr/bin/olrad -I|-P
|-p flag slot_id
/usr/bin/olrad -C|-e
slot_id
DESCRIPTION
The
olrad command provides the ability to perform on-line addition and replacement of I/O cards.
olrad performs critical resource analysis of the system before performing any OLA/R operation. This is
to ensure that the system is not left in an inconsistent state after a PCI card is added/replaced.
Only users with root privileges may use this command.
On systems with the capability to handle certain PCI hardware errors during the operation of PCI I/O
cards, the olrad command provides the option to attempt recovery from such errors. The availability of
this feature is dependent on the platform and operating system environment.
Arguments
The following arguments are used in the olrad command.
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 an 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.
interface_hw_path Hardware path of an interface under an OLA/R capable slot.
device_hw_path Any hardware path under an OLA/R capable slot.
Options
The following options are supported.
-a slot_id Prepare to add a card to system at the specified slot. Critical resource analysis is run to
ensure that the current card addition onto the system will not cause disruption in the
functioning of the system. The driver scripts (pref_replace and prep_replace )
for affected slots (if any) are run and the drivers associated with the affected slots are
suspended. The slot power is turned OFF, and the attention LED at the corresponding
slot is set to BLINK mode.
If the -f option is specified, it overrides critical analysis (CRA) results. See the descrip-
tion for the -f option.
-A slot_id Post add phase. The slot power is turned ON, the drivers associated with all affected
slots are resumed. ioscan is run and if the card is claimed, the driver scripts,
post_add for the current slot and post_replace for affected slots (if any), are run
and the attention LED at the corresponding slot is turned OFF.
118 Hewlett-Packard Company − 1 − HP-UX 11i Version 2: December 2007 Update