olrad.1m (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

olrad(1M) olrad(1M)

NAME

olrad - command for OnLine Addition/Replacement/Deletion of PCI I/O cards and Online

Addition/Deletion of I/O chassis

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

Deleting Card Commands

/usr/bin/olrad

[-f] -d slot_id

/usr/bin/olrad -D

slot_id

I/O Chassis Add Command

/usr/bin/olrad -A -s

cell_hw_path

I/O Chassis Delete Command

/usr/bin/olrad [-f]

-D -s cell_hw_path

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 -K cell_hw_path

/usr/bin/olrad -I|

-P ﬂag slot_id

/usr/bin/olrad -d -u driver_name

/usr/bin/olrad -d -t driver_name

/usr/bin/olrad -C|

-e slot_id

DESCRIPTION

The

olrad command provides the ability to perform On-Line Addition, Replacement and Deletion of I/O

cards.

olrad performs Critical Resource Analysis (CRA) of the system before performing any OLA/R/D opera-

tion. This is to ensure that the system is not left in an inconsistent state after a PCI card is

added/replaced/deleted.

The

olrad command also provides the ability to perform On-Line Addition and Deletion of an I/O

chassis associated with a Cell.

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, as described in the PCI

Error Recovery Support Matrix at http://www.hp.com/go/hpux-networking-docs

Arguments

The following arguments are used in the olrad command.

slot_id Slot ID of an OLA/R/D 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 certain platforms, the slot ID contains only the

slot number. On certain other platforms, including Superdome, the format of the slot

ID is:

Cabinet#-Bay#-Chassis#-Slot#

slot_hw_path Hardware path of an OLA/R/D capable slot.

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (8 pages)

PAGE 1
olrad(1M) olrad(1M) NAME olrad - command for OnLine Addition/Deletion of I/O chassis Addition/Replacement/Deletion of PCI I/O cards and Online 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 Deleting Card Commands /usr/bin/olrad [-f] -d slot_id /usr/bin/olrad -D slot_id I/O Chassis Add Command /usr/bin/olrad -A -s cell_hw_path I/O Chassis Delete Command /usr/bin/olrad [-f] -D -s
PAGE 2
olrad(1M) olrad(1M) interface_hw_path Hardware path of an interface under an OLA/R/D capable slot. device_hw_path Any hardware path under an OLA/R/D capable slot. cell_hw_path Hardware path of a Cell in the system. The user can use the ioscan command to find the hardware path. The cell_hw_path is also equivalent to the global slot number as used with the parolrad command. Options The following options are supported. -A slot_id Post add phase.
PAGE 3
olrad(1M) olrad(1M) Vendor_ID displays the PCI Vendor ID that identifies the manufacturer of the device. Subsystem_ID and Subsystem_Vendor_ID display PCI Subsystem ID and PCI Subsystem Vendor ID which uniquely identify the various interface cards manufactured by the same vendor. Revision_ID specifies an interface specific revision identifier. The value for this field is chosen by the vendor. Class displays the PCI Class that identifies the generic function of the interface.
PAGE 4
olrad(1M) olrad(1M) -d -t driver_name Re-attaches the driver module to the attach chain. This command should only be run if a previous olrad -d -u driver_name operation failed, so as to not leave the driver in detached state. The driver name should correspond to the name shown in the ioscan output. This option is provided for driver developers only. It will not work as a standalone command and can only be invoked from the "DLKM (Dynamically Loadable Kernel Module)" unload context.
PAGE 5
olrad(1M) olrad(1M) descriptions of the fields displayed for such slots. 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.
PAGE 6
olrad(1M) -v hw_path olrad(1M) 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.
PAGE 7
olrad(1M) olrad(1M) Logging olrad uses the NetTL subsystem to log errors and audit trail for all OLA/R/D operations performed on slots. See nettl (1M). olrad makes use of the sysadmin subsystem formatter to format the log messages. The following details are not logged: • • • CRA report when performing OLA/R/D, CRA report when using the -C option, Output of view information options such as -v, -c, -g, -h, -q, and -n.
PAGE 8
olrad(1M) olrad(1M) WARNINGS Any changes to an I/O chassis configuration done by adding or removing I/O cards while the I/O chassis is in inactive state will not be effective by default. I/O Chassis can be in inactive state either because it is connected to an inactive cell or it has been deconfigured using the olrad chassis delete operation. The supported procedure for inserting or removing PCI I/O cards in such an inactive I/O chassis is as follows: 1.