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

o
olrad(1M) olrad(1M)
If the -f option is specified, it overrides critical analysis (CRA) results. See the descrip-
tion for the -f option.
-v hw_path Displays driver information, such as current state, time-out, and so on. Output fields
are detailed below.
Name displays the interface driver name.
State displays the interface driver state. State will be RUNNING if the driver is
active. State will be SUSPENDED if the driver is suspended. When the driver is in a
transition state (say from RUNNING state to SUSPENDED state), this field will indi-
cate a state change in progress. For the rare occurrence of any internal errors during a
driver state transition, this field will indicate an operation timed out status.
Suspend time displays the approximate time required to suspend the interface
driver. The value displayed accounts for worst case scenarios, and the time taken would
normally be less than this.
Resume time displays the approximate time required to resume the interface driver.
The value displayed accounts for worst case scenarios, and the time taken would nor-
mally be less than this.
Remove time displays the approximate time required to delete the driver instance.
The value displayed accounts for worst case scenarios, and the time taken would nor-
mally be less than this. This field will be valid only if the target operating environment
supports OnLine Deletion.
Error time field is for future enhancements.
During the On-Line Replace operation of a card at a slot, olrad runs pref_replace and
prep_replace driver scripts during the pre-replace of the card (olrad -r slot_id) and
post_replace driver script in the post-OLR phase (olrad -R slot_id).
During the On-Line Addition operation of a card at the slot, olrad runs the post_add driver script in
the post add phase. Note that there are no
preface and prepare driver scripts for OLA (
olrad -A
slot_id).
During the On-Line Delete operation of a card at the slot, olrad runs prep_delete and the
post_delete driver scripts associated with the card at the slot.
For a given OL* operation on a slot, pref_replace driver scripts will always be run for all the affected
slots (meaning, slots sharing the same power domain)
An audit trail is logged onto NetTL log file whenever an OLA/OLR/OLD operation is initiated (see
nettl(1M)). This information is also written to standard output.
PCI Error Handling
Some systems have the capability to handle certain PCI hardware errors during the operation of PCI I/O
cards. When such errors occur, the operating system will automatically try and recover from the error.
However, on certain occasions the system cannot recover from the error automatically. In this scenario, the
software states of the components in error will be marked ERROR in ioscan output. If this occurs, the
following sequence can be tried from the olrad command to attempt a manual recovery at the slot:
1. If the slot is not already suspended, suspend it using:
olrad -r slot_id
2. Try a post replace operation at the slot using:
olrad -R slot_id
If the card/slot is recovered from the error and the post replace operation succeeds, software states of
the components recovered from the error will be restored to CLAIMED in ioscan output. If the post
replace operation fails and the error persists, one of the reasons could be that the card has gone bad.
The card in error can be replaced with another card of the same type, and a post replace operation can
be tried with the replaced card.
A complete description on PCI Error Handling is not covered here. For more details refer to documents on
PCI Error Handling available under the High Availability section at the http://docs.hp.com web-
site. Note that the sequence mentioned here for PCI Error Handling is generic. This is subject to changes
depending on different platforms and operating system releases.
HP-UX 11i Version 3: February 2007 − 4 − Hewlett-Packard Company 121