Specifications

24
8.1.7 Mapping commands
Access to SCSI devices is via Fibre Port and Fibre LUN addresses mapped to SCSI bus, target and LUNs.
CLI commands are used to modify the mapping. See Appendix A for samples of the RouteXxxxx
command interaction showing actual commands and their output to the Services port.
The RouteXxxxx and AutoMap commands
provide the mechanism to map Fibre Channel
Port/LUN to SCSI bus/target/LUN. Host
applications use the Fibre Port and Fibre LUN to
access specific SCSI devices.
AutoMap establishes a default mapping of Fibre
ports and Fibre LUNs, and the RouteXxxxx
commands manage the mapping, including
display of current mapping and modification.
RouteDisplay displays the current mapping, in
Fibre port, Fibre LUN order, showing the mapped
SCSI bus/target/LUN, and the current status of the
device (online, offline, unavailable, going
offline). RouteDisplay may be used at any time.
RouteOffline, RouteChange, and RouteOnline
modify the mapping as required (e.g. to make a
device inaccessible, to replace a non-functioning
mapped unit with another, to manage wear on tape
drives).
Before modifying a map, set it
offline
via the
RouteOffline command. This process notifies the
FibreBridge to stop accepting SCSI commands
(e.g. data transfers, inquiry, etc.) for the mapped
device.
The RouteOffline command takes effect in two
stages:
1
The device is marked
Going Offline
, indicating
the FibreBridge will complete any current SCSI
commands for the mapped device, and will
reject any subsequent SCSI commands for that
device.
2
When all current SCSI commands for the
device are complete, the device status
transitions to
Offline
, and the FibreBridge
rejects any subsequent SCSI commands for
that device.
After the device is
Offline
(verify this with the
RouteDisplay command), use the RouteChange
command to change its mapping. Use the
RouteDisplay command to review the changes
before setting the affected devices online.
When all changes are complete and correct, use
the RouteOnline command to set the affected
devices online. It is not necessary to set all
mapped devices online: SCSI commands sent to
offline devices are rejected.
Appendix A shows the sequence of AutoMap and
RouteXxxxx commands.
AutoMap
Automatically maps all currently operational SCSI devices attached to the FibreBridge and distributes the devices among optional, user-specified
FibreChannel ports.
Limits: Automapping skips unavailable (offline or failed) Fibre Channel and SCSI ports.
Actions:
.
AutoMap
Distributes devices across all FC ports
.
AutoMap fp
Distributes devices across fp
DispFcPortDB
Used to display the contents of the specified FC port’s internal port database which contains Fibre Channel addressing information for each FC
target device visible to the FibreBridge.
Action:
none
Information:
DispFcPortDB <fp>
Returns: Node name, 24-bit port ID, 8-bit internal loop ID of each FC
device