Steps to reserve/allocate a range of instance numbers of virtual bus nodes (ext_bus class) (October 2009)

Steps to reserve/allocate a range of instance numbers of virtual
bus nodes (ext_bus class)
This document describes three scenarios, where you can move the instance number of virtual
buses found under FibreChannel or Tachlite Interface (HBA) Card. The three scenarios are as
follows:
1. Move the existing instance number of a virtual bus to greater than 255.
2. Reserve or block a set of instance numbers, so that these can be used on need basis for
the required virtual bus nodes.
3. Steps to allocate reserved instance number to a virtual bus node.
NOTE: In order to perform the above mentioned operations, a tool named “ioconfig_dump”
is required. Contact HP support team to get this tool.
The “ioconfig_dump” tool is available for PA-RISC and Integrity servers. The
ioconfig_dump-a-i command is used on an Integrity machine and the ioconfig_dump-a-
2 command is used on a PA-RISC machine.
Scenario 1:
How to move a single or range of instance numbers of a virtual
bus node to a range above 255?
Step 1: Using the ‘ioconfig_dump’ tool, create a file named “foo”, which is the ASCII
format of the current /stand/ext_ioconfig file on a system. Run the following command to
generate a “foo” file from the current “/stand/ext_ioconfig” file:
#ioconfig_dump-a-i -r -f /stand/ext_ioconfig -o foo
The format of the entries in the “foo” file after the dump will be as follows:
Class_name:instance_number:hwpath:driver_name:flag
Where:
Class_name – Class of the node.
instance_number- Current instance number of the node represented by below hardware
path.
hwpath – Existent hardware path.
driver_name: Name of the driver which claimed this node.
flag – An integer number, which is understood internally by HP-UX General I/O (GIO)
subsystem. The flag is driver-specific and while adding new entries, it is preferable to take the
flag value from the existing entries in the file “foo”. For example, if the value of the
fcd_vbus is 515, retain the same value for all the fcd_vbus entries that will be added to the
file “foo”.
Example:
The listing below (obtained by doing “cat foo | grep ext_bus”) shows a few typical
entries of ext_bus nodes that can be found in the “foo” file that is generated from an
/stand/ext_ioconfig file on a system. In this example, c8xx node has instance number 0,