Qlogic Fast Fabric User Manual page 94

5 – Detailed Descriptions of Command LineTools
Fabric Analysis Tools
5.4.3.2
Topology Verification
iba_report provides a flexible way to identify changes to the fabric or the
appropriate reassembly of the fabric after a move (for example after staging and
testing the fabric in a remote location before final installation at a customer site).
In this mode of operation, all the above reports are available, however the types
of information output can be filtered. For example, using the -P option,
information which would not persist across a fabric reboot (such as LIDs and
error counters) will be omitted from the report (and marked out with xxx). Such
a report can be saved for later comparison to a future report. Since iba_report
produces simple text reports, standard tools such as sdiff (i.e., side by side
diff) can be used for easy comparison and analysis of what changed.
Given the wealth of reports available, the user can select the information they
want to save. For ease of use an all report is available which includes all the
reports of general interest.
If software configuration changes are anticipated (such as adjusting the timeouts
the SM configures in the fabric), the iba_report -H option can be used. This
will further limit the report to only include hardware information. This is a superset
of -P and omits more information.
A related but independent option is -N. This will omit all the node and IOC names
from the report. If changes are anticipated in this area, this option can be used
so future diffs will not report changes in names.
5.4.3.3
Focused Reports
One of the more powerful features of iba_report is the ability to focus a report
on a subset of the fabric. Using the -F option the user can specify a node name,
node name pattern, node guid, node type, port guid, IOC name, IOC name
pattern, ioc guid, ioc type, system image guid, port gid, port rate, lid or SM. The
subsequent report will indicate the total components in the fabric but will only
report on those which relate to the focus area. For example in a nodes report,
if a port is specified for focus, only the node containing that port will be reported
on. In a links report, only the link using that port will be reported.
Notice that a focus level that is different from the orientation of the report may
be chosen. For example if a node name is specified as the focus for the links
report, a report of all the links to that node will be provided. This could include
multiple switch ports or CA ports.
By carefully using this feature of report focus, reverse lookups can be done. For
example, doing a brnodes report with a focus on a LID will reverse lookup the
LID and indicate what node it is for.
5-40
Q
D000006-000 Rev A