- -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.
- -A -s cell_hw_path
Configures the I/O components associated with the specified Cell.
This operation is required, because when a Cell is added to
the system, the attached I/O components are not configured in by
default, so they have to be explicitly configured using this option.
- -a slot_id
Prepare to add a card to the system at the specified slot.
Critical Resource Analysis (CRA) is run to ensure that the current card
addition onto the system will not cause disruption to the overall
system operation. 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 description for the
-f
option.
- -C slot_id
Runs Critical Resource Analysis (CRA) routine only on the specified
slot_id
and displays the results.
It checks for critical resources on all affected hardware paths associated
with the specified slot. It analyzes file systems, volumes, processes,
networking, swap, dump and generates a report of affected resources.
It lists the severity levels and the meanings for each.
- CRA_SUCCESS
no affected resources in use.
- CRA_WARNINGS
resources in use on affected device(s) but none are deemed critical.
- CRA_DATA_CRITICAL
probable data loss, only proceed with the user's permission.
- CRA_SYS_CRITICAL
likely to bring down the user's system.
- CRA_FAILURE
some internal CRA error encountered.
Users are advised to use this option first to check out whether the intended
OL* operation is safe and would not cause disruption in the functioning
of the system.
- -c slot_id
Displays the device information (such as Device_ID, Vendor_ID, and Revision_ID)
of all the interface devices at the indicated slot.
- -D slot_id
This performs the post delete operation. This should always be
performed after an
olrad -d slot_id
operation to complete the delete operation of a card at the slot.
- -d slot_id
Delete a card on the system at the specified slot.
Critical Resource Analysis is run to ensure that the
current card removal on the system will not cause
disruption to the system operation. The driver
script
(prep_delete)
associated with the current slot is run prior to
the deletion. The target slot is powered off and
the driver instances and associated data structures
are removed. The attention LED is set to BLINK at the
corresponding slot when the operation is in progress.
When it completes, the
post_delete
driver scripts are run.
If the
-f
option is specified, it overrides critical analysis (CRA) results.
See the description for the
-f
option.
- -d -t driver_name
This option is reserved for future use.
- -d -u driver_name
This option is reserved for future use.
- -e slot_id
Lists the affected slot IDs for the specified slot.
- -F
Displays the output in machine readable format.
It can be used with the following options:
-q,
-c,
-h,
and
-v.
- -f
The
-f
option, if specified, overrides the "data critical" errors returned by CRA.
It is important to note that
olrad
will not allow "system critical" errors to be overridden and that
olrad
automatically overrides "warnings".
Irrespective of whether
-f
is specified or not, Critical Resource Analysis (CRA) routines are run before
an OLA/R/D operation, to ensure that the current OLA/R/D operation does not
interrupt the normal operation of the system; in other words, to identify
"critical" errors.
The "data critical" errors are typically not critical
to the system, but they may be critical to the user.
Hence, the user needs to decide whether or not to
use the
-f
option for overriding these types of
errors.
- -g hw_path
Displays the slot ID for the specified device or interface hardware path.
- -h slot_id
Displays the hardware paths of the interface node(s) for the specified
slot.
- -I flag slot_id
Controls the state of the Attention LED for the given slot. The valid
values for this
flag
option are:
ATTN
(LED blinking)
and
OFF.
Based on the
flag
value, the slot
Attention LED is set to the appropriate state. The flags are
not case-sensitive.
- -n
Display the number of OLA/R/D capable slots in the system.
- -P flag slot_id
Controls the state of the
power indicator. Currently, the only valid
value for this
flag
option is:
RAIL.
The
-P
option can be used with
RAIL
to set the power indicator to follow the specified slot's power state;
in other words, the power indicator is turned solid ON if the slot
power is ON, or the power indicator is turned OFF, if the slot
power is OFF.
The flag is not case sensitive.
- -q
Displays the status of all OLA/R/D capable slots in the system.
In the output, slots with the same bus number are treated as
shared slots. Output fields are detailed below; some descriptions
are platform dependent.
Slot
displays the
slot_id.
Path
displays the
slot_hw_path.
Bus Number
identifies the I/O Bus corresponding to the slot.
Max Spd
displays the maximum operating speed of the
PCI Bus attached to the slot.
Spd
displays the current operating speed of the PCI Bus
attached to the slot. The card inserted into the slot
determines the current operating speed, together
with the capability of the slot's PCI Bus.
Pwr
displays the slot power status.
Occu
displays whether the slot is occupied or not.
Susp
displays if the card in the slot is suspended or not.
Driver(s) Capable
displays the OL* capability of the interface driver/s that
claimed the PCI device/s present in the slot.
OLAR
field displays whether the interface driver/s are capable
of OnLine Add/Replace operations.
OLD
field displays whether the interface driver/s are capable
of OnLine Deletion operation.
Max mode
displays the maximum operating mode of the
PCI Bus attached to the slot.
Mode
displays the current operating mode of the PCI Bus
attached to the slot. The card inserted into the slot
determines the current operating mode, together
with the capability of the slot's PCI Bus.
PCI and PCI-X are examples of different operating modes.
- -R slot_id
Post Replace phase. The target slot power is turned ON. The suspended
drivers are resumed and the driver scripts
(post_replace)
for the current
slot and the affected slots (if any) are run. The attention LED at the
corresponding slot is set to OFF.
On systems with the capability to handle certain PCI
hardware errors during the operation of PCI I/O cards,
the post replace phase can be used to attempt recovery
of the PCI card and corresponding I/O slot from such
errors.
- -r slot_id
Prepare to replace a card on the system at the specified slot.
Critical Resource Analysis (CRA) is run to ensure that the current card
replacement on the system will not cause disruption in the functioning of
the system. The driver scripts
(pref_replace
and
prep_replace)
for the affected slots (if any) and the current slot are run.
The drivers associated with the current slot and affected slots are suspended.
The target slot is powered off and the attention LED is set to BLINK at the
corresponding slot.
If the
-f
option is specified, it overrides critical analysis (CRA) results.
See the description 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
indicate 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 normally 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 normally 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.
Printable version
