This document defines the ATTO FibreBridge services and applications available to customers including:
• ATTO FibreBridge configuration
• ATTO FibreBridge maintenance
• ATTO FibreBridge diagnostics
• System diagnostics
These services are available through the RS-232 interface and Ethernet. In the future, the services may
be accessed through Fibre Channel.Examples in this document will be shown using the RS-232
interface.
ATTO FibreBridge Configuration Services
ATTO FibreBridge configuration services allow configuration of all ATTO FibreBridge interfaces and
general firmware operational parameters. The following is an abbreviated list of ATTO FibreBridge
Configuration Services:
• Serial Port Configuration
• Fibre Channel Port Configuration
• SCSI Port 1 & 2 Configuration
• Firmware Operation
ATTO FibreBridge Maintenance Services
ATTO FibreBridge maintenance services allow the performance of basic maintenance services on the
ATTO FibreBridge. The following is an abbreviated list of ATTO FibreBridge maintenance services:
• SCSI Enclosure Services Information (temperature, P/S status, etc.)
• Restarting firmware (causes power-on diagnostics to be executed)
ATTO FibreBridge Diagnostic Services
ATTO FibreBridge Diagnostic Services allow diagnostic tasks to be performed on the ATTO FibreBridge.
The diagnostics should aid in validating the correct operation of an ATTO FibreBridge. The following is an
abbreviated list of ATTO FibreBridge diagnostic services:
•Viewing Internal Error Log
System Diagnostic Services
System Diagnostic Services allow the use of the ATTO FibreBridge in determining the correct operation of
the complete system or isolating system level problems. The following is an abbreviated list of System
Diagnostic Services:
There are two methods of operation: Menu Interface and Command Line Interface (CLI ). The Menu
Interface is designed for human interface and follows a standard menu / choice model. The Command
Line Interface provides access to ATTO FibreBridge services through ASCII command lines. CLI is
designed primarily for use by applications such as ATTO BridgeTools as well as “power-users”. The
services accessible through CLI are a superset of those available through the Menu Interface.
Initial Display (RS-232)
The initial display, after powering up the unit or restarting the firmware will contain the following
information:
Firmware version mm.mm release date dd mmm yyyy, hh:mm:ss Build zzzz
Power-On Self-Test Completion Status: GOOD.
xx Megabytes of RAM Installed.
1 1.0624 Gb/s Fibre Channel Interface.
2 Differential SCSI Interface Ports.
Power Supply A: OK
Power Supply B: OK
∗ not applicable to the ATTO FibreBridge 2200 R/D.
World Wide Name = xx xx xx xx xx xx xx xx
FibreBridge Name = xxxxxxxx
Internal Temperature = xx
Error Log Contents: NO ERRORS
For help, type HELP. To enable the menu interface, type MENU.
Ready.
This completes the ATTO FibreBridge initial display. Now the ATTO FibreBridge is in the Command Line
Interface mode of operation. Typing the MENU command enters the menu system.
Chapter 3: Command Line Interface (ATTO FibreBridge 2200R/D, 3100R and 3200R)
The command line interface (CLI) provides access to FibreBridge services through a set of ASCII based
command lines. CLI commands may be entered while in CLI mode and Menu Interface mode.
CLI commands are context sensitive and generally follow a standard format.
[Get | Set ] Command [Parameter 1 [Parameter 2 […]]]\n
Note: In this document, braces ([]) indicate a choice of fields and (<>) indicates optional fields. A
subsequent version of this document will clarify the differences between the Get and Set
command syntax. Generally, a Set command requires one additional parameter than the related
Get command.
Commands generally have four types of operation: immediate, get , set and usage. The Get form returns
the value of a parameter or setting. The Set form changes the value of a parameter or configuration
setting. Set and get commands do not take effect until a SaveConfiguration command is carried out.
Immediate commands (signified by the immediate keyword in this document) cause an instantaneous
action to be carried out, and are not preceeded by the ‘get’ or ‘set’ keyword. If the form of operation
cannot be determined, it is assumed to be the Usage form and a brief help message is displayed.
The strings “get” and “set” may be abbreviated by ‘g’ and ‘s’, respectively.
All commands are case insensitive unless specifically noted.
Decimal numbers may be entered as raw numerical input (e.g. 123).
Octal numbers must be preceded by the number 0 (e.g. 0713).
Hexadecimal numbers must be preceded by the C-style 0x prefix (e.g. 0x1FA4).
Quoted strings will be treated as a single parameter for any command which expects character input,
regardless of spaces in the string.
Several commands require a save before their modified parameters take effect. When such a command
is executed an asterisk will appear next to the command-line prompt. Similarly, an asterisk will appear
next to a menu title if any menu parameters have been modified. Save the current configuration to store
any modified parameters and remove the asterisk.
CLI responses can take several forms:
All Responses are followed by the string “Ready.\n”.
Responses to Set Commands are either the error message or “Ready.”
Responses to Get Commands are specified in the Results: field for each command, followed by
“Ready.\n”
The following sections describe commands available through the command line interface.
Specifies whether ACK0 or ACK1 will be returned in response to a Class 2 FC data frame or
Sequence. Enable this option to send ACK0 at the end of a Sequence. Disable this option to
return an ACK1 frame for each data frame.
FcAddressTranslation
Syntax: set FcAddressTranslation [enabled | disabled]
Specifies the Fibre Channel port type to which the ATTO FibreBridge will attempt to login. Set
FcConnMode to ‘loop’ to enable FL_Port logins and FC_AL communications and addressing. Set
FcConnMode to ‘ptp’ to enable Point-to-Point connections (i.e. F_Port fabric connections).
Specifies the maximum number of payload bytes in a Fibre Channel frame. If the frame length is
not specified, the current frame length is displayed. The default frame length is 2,048 bytes.
The FcFullDuplex command is used to enable or disable full duplex mode communications
between the ATTO FibreBridge and Fibre Channel hosts. When this option is enabled the ATTO
FibreBridge may transmit and receive Fibre Channel data simultaneously.
The Fchard command is used to turn on or off Fibre Channel hard address assignment . The
current state of hard addressing is displayed when the optional parameter is missing. The default
is off or soft addressing. Under soft addressing, the ATTO FibreBridge loop address is assigned
during loop initialization.
The FcHardAddress command is used to set the value used as the FC-AL hard address. When
the optional address is not present, the current value used for hard addressing will be displayed.
The FcInitiator command is used to allow the FibreBridge to operate as an initiator on the Fibre
Channel network. This functionality is necessary for features such as Extended Copy /
Serverless Backuo to locate and send commands to Fibre Channel devices.
Specifies the SCSI status value returned when the ATTO FibreBridge is unable to accept the
command due to a temporary lack of internal resources. The factory default setting is to return a
SCSI status of Queue Full.
Specifies the name assigned to the ATTO FibreBridge. This is not the World Wide Name (WWN).
The ATTO FibreBridge name is an eight character name used by applications to identify
individual ATTO FibreBridge units. The specified name will be padded with spaces to a maximum
of eight characters.
Specifies the soft Target ID to be used by the ATTO FibreBridge when addressed by the host.
This ID is only taken from NVRAM when the soft ID enable is set to “enabled” AND when LUN
Translation has been enabled. PORT1 indicates that the displayed value is taken from the value
of the port 1 SCSI initiator ID. NVRAM indicates that the displayed value is taken from NVRAM.
FORCED indicates that FC address translation is enabled while soft IDs are disabled so the
ATTO FiberBridge ID is forced to 0.
FibreBridgeSoftLUNEnable
Syntax: set FibreBridgeSoftLUNEnable [enabled | disabled]
Specifies whether the SCSI ID used by the ATTO FibreBridge when addressed by the host is
determined by the FibreBridgeSoftLUN setting, or the port 0 SCSI IIDsetting. If this is ‘enabled’
and LUN translation is enabled, the FibreBridge will report its Target ID as the value of the
FibreBridgeSoftLUN setting.
FcWWName
Syntax: get FcWWName
Returns:
(terse)"NN NN NN NN NN NN NN NN"
(verbose)FcWWName = "NN NN NN NN NN NN NN NN"
Reports the World Wide Name (WWN) of the FibreChannel interface. Set is not available for this
command. The least Significant 6 bits of the WWN are used as the ethernet MAC address.
Returns:
(terse)nn
(verbose)RequestQueue Length = nn
Specifies the number of entries in the internal Fibre Channel request queue data structure. When
no entry count is specified, the current number of request queue entries will be displayed. When
the specified number of queue entries is zero, the request queue size will be changed to the
factory default value.
Returns:
(terse)nn
(verbose)ResponseQueueLength = nn
Specifies the number of entries in the internal Fibre Channel response queue data structure. If
the number of entries is not specified, the current number of response queue entries will be
displayed. When the specified number of queue entries is zero, the response queue size will be
changed to the factory default value.
ScsiIdSwitch
Syntax: set ScsiIdSwitch [PortNumber [enabled | disabled]]
Specifies whether the SCSI initiator ID for the specified port should be obtained by reading the
external SCSI ID switch or through the value stored in non-volatile RAM.
Specifies the SCSI initiator ID to be used on the specified SCSI port. This field contains either
the hardware switch setting (if ScsiIdSwitch is ENABLED) or the value in NVRAM (if ScsiIdSwitch
is DISABLED.)
ScsiPortResetOnStartup
Syntax: set ScsiPortResetOnStartup [PortNumber [enabled | disabled]]
Specifies whether synchronous SCSI transfers should be negotiated with devices on the specified
SCSI port. The default setting is 'enabled', enabling the ATTO FibreBridge to attempt negotiating
synchronous SCSI transfers with devices supporting synchronous SCSI for maximum
performance.
Should this be extended to enable/disable synchronous transfers based upon the physical
interface (SE, LVD, HVD, Ultra3, etc.).
ScsiPortTaggedQueuing
Syntax: set ScsiPortTaggedQueing [PortNumber [enabled | disabled]]
Specifies whether tagged command queuing is allowed on the SCSI port. The default setting is
on, allowing tagged commands to be sent to devices that support tagged command queuing for
maximum performance.
SCSIPortBusSpeed
Syntax: set ScsiPortBusSpeed [PortNumber [fast | ultra | ultra2]]
This option controls the transfer rate at which the FibreBridge will attempt to negotiate with its
SCSI devices. Choices are Fast SCSI, Ultra SCSI, and Ultra2 SCSI. The Ultra2 option is only
valid if the current FibreBridge has LVD capable SCSI ports. An error will be if this parameter is
selected on a FibreBridge that does not support LVD.
Specifies whether WIDE SCSI transfers should be negotiated. The default setting is on, allowing
wide transfer negotiation with devices supporting wide SCSI transfers.
[ sb ] [ st ] [ sl ] [ Dev Type ] [ Vendor Id ] [ Product Id ]
[Rev.][Serial Number]
[Revision][Serial Number]
Command returns a list of the SCSI devices, which are operational, on the referenced SCSI port.
The line count indicates the number of data lines following. This command is only available on the
ATTO FibreBridge 3200R when they use the latest version of firmware.
Configures the baud rate for the ATTO FibreBridge RS-232 serial port . The number of data bits
per character is fixed at 8 with no parity. The serial port supports the following baud rates: 2400,
9600, 19200, 38400, 57600 and 115200. The factory default baud rate is 9600.
Configures the number of stop bits per character for the ATTO FibreBridge RS-232 serial port .
The number of data bits per character is fixed at 8 with no parity. The number of stop bits may be
set to 1 or 2. The factory default is 1 stop bit.
get SerialPortBaudRate
get SerialPortStopBits
SerialPortHandshake
Syntax: set SerialPortHandshake [hard | xon | none]
get SerialPortHandshake
Returns:
(terse)[hard | xon | none]
(verbose)SerialPortHandshake = [hard | xon | none]
Configures the data handshaking method used for controlling the flow between the transmitter
and receiver. Serial port flow control may be managed using hardware flow control, software flow
control (Xon/Xoff) or no flow control. The default setting is no flow control.
Resets the specified SCSI bus. There is no get version of this command.
Temperature
Syntax: get Temperature
Returns:
(terse)xx C
(verbose)Temperature = xx C
Reports the temperature of the unit, in C.
MaxEnclTempAlrm
Syntax: set MaxEnclTempAlrm [5 – 40]
get MaxEnclTempAlrm
Returns:
(terse)xx C
(verbose)MaxEnclTempAlrm = xx C
This option sets/displays the maximum enclosure temperature alarm of the unit in degrees
Celsius. Valid entries are between 5 and 40 degrees and above the current minimum enclosure
temperature alarm.
MinEnclTempAlrm
Syntax: set MinEnclTempAlrm [5 – 40]
get MinEnclTempAlrm
Returns:
(terse)xx C
(verbose)MinEnclTempAlrm = xx C
This option sets/displays the minimum enclosure temperature alarm of the unit in degrees
Celsius. Valid entries are between 5 and 40 degrees and below the current maximum enclosure
temperature alarm.
ATTO FibreBridge Diagnostic Service Commands
The ATTO FibreBridge Diagnostic commands are intended to aid in validating ATTO FibreBridge
operation and diagnosing / isolating ATTO FibreBridge faults.
ErrorLog for ATTO FibreBridge 2100R
Syntax: set ErrorLog clear
get ErrorLog
Returns:[ Error Logs Cleared |
The last error code saved was xx
A xxx type error was detected since last error log clearing
Specific error text ]
Where xxx is : [ 960 |Static Memory | Synchronous DRAM | ISP2100 |
Symbios 876 A | Symbios 876 B | FibreChannel | Software]
and Specific error text is one line of descriptive error text.
Enabling this option will cause the 'Ready' LED on the front panel of the FibreBridge to blink. The
LED will continue to blink until this parameter is disabled.
DispEvent
Syntax: set DispEvent [subsystem][event_level][status]
The DispEvent command sets the switches which control the filtering performed when displaying
events. The switches have the following meanings and possible settings:
[subsystem] switch is a mask that controls which subsystem’s events are displayed.
get IdentifyFibreBridge
get DispEvent
The mask is a byte value with the following bit patterns corresponding to the currently
supported subsystems:
01FCP Processor/i960
Interaction
02SCSI Processor/i960
Interaction
04Ethernet
10GBIC Connector
20NVRAM & Flash
To display the events from several different subsystems, use a mask value equal to
ATTO Technology, Inc.
- -
15
Loading...
+ 46 hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.