ATTO ATTO Technology, Inc. ATTO FibreBridge Product Modules Software Manual ATTO FibreBridge 2100R, 2200 R/D, 3100R and 3200R Product Modules © 2000 ATTO Technology, Incorporated. All rights reserved. All brand or product names are trademarks of their respective holders. No part of this manual may be reproduced in any form or by any means without the express written permission of ATTO Technology, Incorporated. Rev.
ATTO Technology, Inc. ATTO FibreBridge Software Manual ATTO Technology, Inc.
ATTO Technology, Inc. ATTO FibreBridge Software Manual Table of Contents CHAPTER 1: ATTO FIBREBRIDGE SERVICES .................................................................................. 1 ATTO FIBREB RIDGE CONFIGURATION S ERVICES .................................................................................... 1 ATTO FIBREB RIDGE MAINTENANCE S ERVICES....................................................................................... 1 ATTO FIBREB RIDGE D IAGNOSTIC S ERVICES .................
ATTO Technology, Inc. ATTO FibreBridge Software Manual LANGUAGE ELEMENT FOR STATUS PAGE............................................................................................. 37 FIBREB RIDGE/TRANSCEIVER ELEMENT FOR STATUS PAGE...................................................................... 37 ATTO FIBREB RIDGE GBIC CONNECTOR ELEMENT FOR STATUS PAGE (3100R AND 3200R ONLY ).............. 37 FIBRE CHAIN ELEMENT FOR STATUS PAGE (2100R ONLY ).........................................................
ATTO Technology, Inc. ATTO FibreBridge Software Manual ATTO Technology, Inc.
ATTO Technology, Inc. ATTO FibreBridge Software Manual Chapter 1:ATTO FibreBridge Services 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.
ATTO Technology, Inc. ATTO FibreBridge Software Manual ATTO Technology, Inc.
ATTO Technology, Inc. ATTO FibreBridge Software Manual Chapter 2:Operation 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”.
ATTO Technology, Inc. ATTO FibreBridge Software Manual ATTO Technology, Inc.
ATTO Technology, Inc. ATTO FibreBridge Software Manual 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.
ATTO Technology, Inc. ATTO FibreBridge Software Manual ATTO FibreBridge Configuration Service Commands FcAck0 (ATTO FibreBridge 2200R/D & 3200R) Syntax: set FcAck0 [enabled | disabled] get FcAck0 Returns: (terse) [enabled | disabled] (verbose) FcAck0 = [enabled | disabled] 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.
ATTO Technology, Inc. ATTO FibreBridge Software Manual Specifies the translation rules applied to fibre channel LUNs in the Virtual Device Address Method format. FcConnMode (ATTO FibreBridge 2200R/D and 3200R) Syntax: set FcConnMode [loop | ptp] get FcConnMode Returns: (terse) [loop | ptp] (verbose) FcConnMode = [loop | ptp] 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.
ATTO Technology, Inc. ATTO FibreBridge Software Manual 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.
ATTO Technology, Inc. ATTO FibreBridge Software Manual FibreBridgeName Syntax: set FibreBridgeName [name] get FibreBridgeName Returns: (terse) "name" (verbose) FibreBridgeName = "name" 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.
ATTO Technology, Inc. Returns: (terse) (verbose) ATTO FibreBridge Software Manual nn 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.
ATTO Technology, Inc. ATTO FibreBridge Software Manual ScsiPortSelTimeout Syntax: Returns: (terse) (verbose) set ScsiPortSelTimeout [PortNumber [256|128|64|32|16|8|4|2|1]] get ScsiPortSelTimeout [PortNumber] [enabled | disabled] Port n ScsiPortResetOnStartup = [enabled | disabled] Indicates the time, in milliseconds, the ATTO FibreBridge will wait for a response from a SCSI device on the selected port after a selection request.
ATTO Technology, Inc. ATTO FibreBridge Software Manual ScsiPortWideTransfer Syntax: Returns: (terse) (verbose) set ScsiPortWideTransfer [PortNumber [enabled | disabled]] get ScsiPortWideTransfer [PortNumber] [enabled | disabled] Port n ScsiPortWideTransfer = [enabled | disabled] Specifies whether WIDE SCSI transfers should be negotiated. The default setting is on, allowing wide transfer negotiation with devices supporting wide SCSI transfers.
ATTO Technology, Inc. ATTO FibreBridge Software Manual 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.
ATTO Technology, Inc. ATTO FibreBridge Software Manual ScsiPortReset (Immediate) Syntax: ScsiPortReset [PortNumber] Returns: Resetting Port Number n 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.
ATTO Technology, Inc. ATTO FibreBridge Software Manual ErrorLog for ATTO FibreBridge 3100R 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 896 A | Symbios 896 B | FibreChannel | Software] and Specific error text is one line of descriptive error text.
ATTO Technology, Inc. ATTO FibreBridge Software Manual the logical OR of the corresponding subsystem values. To display events from all subsystems enter the value 3Fh for the mask. The default value is 3Fh. [event_level] switch is a mask that controls what reporting level events are displayed.
ATTO Technology, Inc. ATTO FibreBridge Software Manual DisplayEvent (Immediate) Syntax: DisplayEvent Returns: The contents of the event log, as filtered by the current switch settings manipulated via DispEvent. The DisplayEvent command results in a dump of the current contents of the event log to the display. The log is filtered by the current switch settings as described in the DispEvent section.
ATTO Technology, Inc. ATTO FibreBridge Software Manual Set/Display the current subnet mask. If IPDHCP is enabled, then the get command reports the current IP gateway assigned by the nameserver. EthernetSpeed Syntax: set EthernetSpeed [10 | 100 | auto] get EthernetSpeed Returns (terse) [10 | 100 | auto ([10|100|UNKNOWN])] (verbose) EthernetSpeed = [10 | 100 | auto ([10|100|UNKNOWN])] Set/Display the ethernet speed. Auto will auto-negotiate speed (default).
ATTO Technology, Inc. ATTO FibreBridge Software Manual Menu (Immediate) Syntax: Menu <[enabled | disabled]> Returns: n/a The Menu command turns the menu interface on or off. Turning on the menu interface will cause the main menu to be displayed. In addition, other parameters will be enabled such as ECHO. 'Menu Disabled' will turn off the menu interface. Menu without any parameters will toggle the current menu state.
ATTO Technology, Inc. ATTO FibreBridge Software Manual VerboseMode Syntax: set VerboseMode [enabled | disabled] get VerboseMode Returns : (terse) [enabled | disabled] (verbose) VerboseMode = [enabled | disabled] Setting verbose mode will cause the command-line interface to display extended information about a parameter when the 'help' command is given. Only the parameter value is output when verbose mode is disabled. ATTO Technology, Inc.
ATTO Technology, Inc. ATTO FibreBridge Software Manual Chapter 4: Menu Interface for ATTO FibreBridge 2200 R/D, 3100R and 3200R Menu Interface This section describes the Menu Interface method of accessing ATTO FibreBridge services. The ATTO FibreBridge service options are accessible using a Command Line Interface (CLI). The CLI is designed for advanced programmers and integrators. To see a list of available commands type 'help' at the Ready prompt.
ATTO Technology, Inc.
ATTO Technology, Inc. ATTO FibreBridge Software Manual Fibre Channel Configuration Menu cont.
ATTO Technology, Inc. ATTO FibreBridge Software Manual Network Configuration Menu Network Configuration Menu A Ethernet Speed B IP Address C D IP Gateway IP Subnet Mask X Return to previous menu… Notes Display or set Ethernet port speed. Selections include Auto (autodetect), 10Base-T, and 100Base-T Display or set current IP address. The default address is 192.168.1.0 Display or set the current IP gateway address Display or set current IP subnet mask. The default subnet is 255.255.255.
ATTO Technology, Inc. ATTO FibreBridge Software Manual Chapter 5:ATTO FibreBridge SCSI Commands This chapter describes the SCSI commands that are processed by the ATTO FibreBridge. INQUIRY command The INQUIRY command requests that information regarding parameters of the target and a component logical unit is sent to the application client. If an INQUIRY command is received from an initiator with a pending unit attention condition (i.e.
ATTO Technology, Inc. ATTO FibreBridge Software Manual Field Definition Peripheral qualifier The peripheral qualifier is used with the peripheral device type field to identify the device currently connected to the logical unit. The peripheral qualifier field may take on the following values: 000b = The specified peripheral device type is currently connected to this logical unit. This peripheral qualifier does not mean that the device is ready for access by the initiator.
ATTO Technology, Inc. Field ATTO FibreBridge Software Manual Definition Vital Product Data The Peripheral Qualifier and the Peripheral Device Type in the inquiry vital product data pages are described in the standard Inquiry data format above. When EVPD (Enable Vital Product Data) is 1, PageCode indicates which page of vital product data is to be returned.
ATTO Technology, Inc. ATTO FibreBridge Software Manual Device Identification Page The Device Identification Page provides the ATTO FibreBridge WorldWideName in binary. description below shows the generic Device Information Page.
ATTO Technology, Inc. ATTO FibreBridge Software Manual READ 7BUFFER command The READ BUFFER command is used in conjunction with the WRITE BUFFER command as a maintenance function for reading and writing microcode and configuration information. The READ BUFFER command provides access to microcode and configuration parameter storage.
ATTO Technology, Inc. Bit Byte 0 1 2 3 4 5 6 7 8 9 10 11 7 ATTO FibreBridge Software Manual 6 5 4 3 2 1 0 Operation code (A0h) Reserved Reserved Reserved Reserved Reserved (MSB) Allocation length (LSB) Reserved Control The Allocation length shall be at least 16 bytes. If the Allocation length is less than 16 bytes, the ATTO FibreBridge will return a CHECK CONDITION status. The sense key will be set to ILLEGAL REQUEST and the additional sense data will be set to INVALID FIELD IN CDB.
ATTO Technology, Inc. ATTO FibreBridge Software Manual Request Sense Command Bit 7 6 5 4 3 2 1 Byte 0 Operation code (03h) 1 Logical Unit Number Reserved 2 Reserved 3 Reserved 4 Allocation Length 5 Control The Request Sense command requests that the target transfer sense data to the initiator. 0 The sense data returned for a FibreBridge command is a subset of the sense data described in the SCSI standard. TEST UNIT READY command The TEST UNIT READY command checks to see if the logical unit is ready.
ATTO Technology, Inc. ATTO FibreBridge Software Manual transferred. The ATTO FibreBridge will transfer the complete buffer or allocation length bytes, whichever is less. The Buffer Offset field contains the byte offset within the specified buffer from which data will be transferred. If the specified buffer offset is invalid, ATTO FibreBridge will return a CHECK CONDITION status with a sense key of ILLEGAL REQUEST and additional sense code of INVALID FIELD IN CDB.
ATTO Technology, Inc. ATTO FibreBridge Software Manual The ‘Configuration’ page (following) describes the format of the Enclosure status page. There is one entry in the configuration page for each Element Type described by the Enclosure status page. Configuration Page Byte (decimal) 0 4 8 12 16 20 24 28 32 36 40 44 48 – (11+m) 52 56 84 90 102 0 01 00 1 2 3 00 Pg.
ATTO Technology, Inc.
ATTO Technology, Inc.
ATTO Technology, Inc. ATTO FibreBridge Software Manual Element Definitions: Device Element for Status Page Bit Byte 0 1 2 3 7 0 0 6 5 0 Fault Sensed 0 Fault Reqstd 4 3 2 1 0 0 0 IDENT 0 1 0 2 1 0 0 0 0 0 0 DC Fail 2 1 0 OT Warning UT Failure UT Warning Common Status Slot Address 0 0 0 0 Slot Address: SCSI ID of this bridge (thumbwheel switch #1). Ident: Set to indicate the Identification control bit has been set. Fault Sensed : Set to indicate a fault detected by this bridge.
ATTO Technology, Inc. ATTO FibreBridge Software Manual Xmit Fail: Indicates that the port’s transmitter has failed. Language Element For Status Page Bit Byte 0 1 2 3 7 6 5 4 3 2 1 0 2 1 0 Common Status Reserved 0000 FibreBridge/transceiver Element for Status Page Bit Byte 0 1 2 3 7 6 5 4 3 Common Status Reserved Reserved Xmit fail Reserved Online Mode Online Mode: 00 : Normal –ATTO Fibre Bridge determines Online/Off Line status. 01 : Force Online – Fibre Channel is always Online.
ATTO Technology, Inc. ATTO FibreBridge Software Manual POST Code Element for Status Page Bit Byte 0 1 2 3 7 6 5 4 3 2 1 0 SDRAMerr SRAMerr P960err Common Status Reserved POST Code Type Error SWerr FCerr P876Berr P876Aerr P2100err POST Code: 1-byte value stored internally. May indicate an error which has been cleared. Is not cleared by power-on or soft reset. Type Error : 1-byte error type. May indicate an error which has been cleared. Is not cleared by poweron or soft reset.
ATTO Technology, Inc. ATTO FibreBridge Software Manual Enclosure Control Page for ATTO FibreBridge 2100R Byte 0 4 8 12 16 20 24 28 32 36 40 44 48 52 56 60 64 68 72 76 82 86 90 0 02 1 2 Cond.
ATTO Technology, Inc. ATTO FibreBridge Software Manual Enclosure Control Page for ATTO FibreBridge 3100R and 3200R Byte 0 0 4 8 12 16 20 24 28 32 36 40 44 48 52 56 60 64 68 72 76 80 1 2 3 Cond.
ATTO Technology, Inc. ATTO FibreBridge Software Manual Device Element for Control Page Bit 7 6 5 4 Byte 0 1 2 X X X 3 X X RQST FAULT 3 Common Control Reserved X X DEVICE OFF (RESET) X 2 1 0 X RQST IDENT X X X X Rqst Ident: Causes the device front panel to flash an identification signal. Rqst Fault: Causes the device front panel to flash a fault signal. Device Off: Causes the device to perform a software reset.
ATTO Technology, Inc. ATTO FibreBridge Software Manual Language e Element For Status Page Bit 7 6 5 4 3 2 1 0 Byte 0 Common Control 1 Reserved 2 Language Code 3 Language Code: Currently only one supported value, 0000, which stands for English with the US-ASCII character set. Fibre Channel/transceiver Element for Control Page Bit Byte 0 1 2 3 7 6 5 4 3 2 1 0 Common Control Reserved Reserved Online Mode Online Mode: 00 : Normal – Fibre Bridge determines Online/Off Line status.
ATTO Technology, Inc. ATTO FibreBridge Software Manual Command Table Templates Bit Byte 0 1 2 3 4 5 Bit Byte 0 1 2 3 4 5 6 7 8 9 Bit Byte 0 7 6 5 4 3 2 1 0 7 6 5 4 3 2 1 0 7 6 5 4 3 2 1 0 ATTO Technology, Inc.
ATTO Technology, Inc. ATTO FibreBridge Software Manual Tunnel CDB (ATTO FibreBridge 3100R and 3200R) The Tunnel CDB∗ command is a 16 byte Vendor Unique command which allows any 6 or 10 byte CDB to be tunneled through the FibreBridge LUN to a device residing at a different LUN address. This capability is useful for accessing SCSI devices when they are not known to the host.
ATTO Technology, Inc. ATTO FibreBridge Software Manual Chapter 6: NVRAM Configuration ATTO FibreBridge 2100R NVRAM Configuration Parameters Summary This section provides information on updating the ATTO FibreBridge 2100R flash or nvram parameters using updater.exe (MSDOS-based utility), SCSI Read Buffer or Write Buffer commands. The buffer ID identifies the respective field for either updater input or via the Read/Write Buffer commands.
ATTO Technology, Inc.
ATTO Technology, Inc. Buffer ID 1c: 1d: 1e: ATTO FibreBridge Software Manual nvram offset Buffer Description (default values*) 0x04-0x05 Reserved 0x3f Reserved for Internal Use. ATTO FibreBridge Soft Fibre LUN (default 0x07) Bits 7-4: Reserved Bits 3-0: SCSI Lun at which the FibreBridge will respond (0x00 – 0xFF). This parameter isonly enabled when LUN translations are performed AND Bridge soft FibreLUNs are enabled in the FBOptions buffer.
ATTO Technology, Inc. ATTO FibreBridge Software Manual ATTO FibreBridge 3100R NVRAM Configuration Parameters Summar y This section provides information regarding updating the ATTO FibreBridge 3100R flash or nvram parameters using updater.exe (MSDOS-based utility), SCSI Read Buffer or Write Buffer commands. The buffer ID identifies the respective field for either updater input or via the Read/Write Buffer commands. The nvram offset is provided to facilitate interpretation of nvram contents directly.
ATTO Technology, Inc.
ATTO Technology, Inc.
ATTO Technology, Inc. Buffer ID nvram offset 25: 0x51 26: 0x52 27: 0x53 28: 0x54 29 0x55 2a 0x56 2b 0x57 2c 0x58 ATTO FibreBridge Software Manual Buffer Description (default values*) Bit0: Auto Speed Detect 1=Speed Detection Enabled 0=SpeedDetection Disabled Temperature High Warning (default: 0x28) A user definable SBYTE parameter that indicates when certain alarm flags should be set within SCSI Enclosure Services with respect to excessive temperature.
ATTO Technology, Inc. ATTO FibreBridge Software Manual ATTO FibreBridge 2200R/D, 3200R NVRAM Configuration Parameters Summary This section provides information regarding updating the FibreBridge 3200R flash or nvram parameters using updater.exe (MSDOS-based utility) or SCSI Read Buffer or Write Buffer commands. The buffer ID identifies the respective field for either updater input or via the Read/Write Buffer commands. The nvram offset is provided to facilitate interpretation of nvram contents directly.
ATTO Technology, Inc. Buffer ID 8: nvram offset 0x44 ATTO FibreBridge Software Manual Buffer Description (default values*) Firmware Options (default 0x0000) Bits 15-10 Reserved Bit 9 ACK0 Enable 1= Use ACK0 w/ Class2 0 = Use ACK1 w/ Class2 Bit 8 Class 2 Support1 = Class 2 Enabled 0 = Class 2 Disabled Bit 7 Reserved Bits 6-4 Connection Mode Buffer Value Meaning 3 Point-toPoint Preferred, Otherwise Loop Only (unsupported) 2 Loop Preferred.
ATTO Technology, Inc. Buffer ID 17: ATTO FibreBridge Software Manual nvram offset Buffer Description (default values*) 0x08 - 0x0B ATTO FibreBridge Parameters (default 0x00 0x00 0x01 0x00) Byte 3: FC Port Type Byte 2-0: Reserved 18: 0x00 = Unknown 0x01 = DB9 0x02 = GBIC 0x38 – 0x3F ATTO FibreBridge Name (default space characters (0x20)) A user defined printable ASCII string intended to facilitate user identification of each FibreBridge.
ATTO Technology, Inc. Buffer ID 23: ATTO FibreBridge Software Manual nvram offset Buffer Description (default values*) 0x4E – 0x51 IP Subnet Mask (default 0xff 0xff 0xff 0x00) This four-byte field indicates the subnet mask for FibreBridge Ethernet services. The address is stored in dotted-decimal notation (e.g. 0xFF 0xFF 0xFF 0x00 represents the IP address 255.255.255.0).
ATTO Technology, Inc.
ATTO Technology, Inc. ATTO FibreBridge Software Manual Chapter 7: Error Codes The following is a list of Error Codes that may be present with the ATTO FibreBridge 2200R/D, 3100R and 3200R. Throughout the following description, references are made to the ATTO FibreBridge Services port, either RS232 or Ethernet/telnet. Models of the ATTO FibreBridge support varying levels of such support: 1. RS232 output at power-up; 2. ATTO FibreBridge Services commands/menus over RS232; 3.
ATTO Technology, Inc. ATTO FibreBridge Software Manual How to Contact ATTO Technology, Inc. For customer service and sales information, call Monday through Friday, Eastern Standard Time 8:00 AM to 7:00 PM or by fax and web site 24 hours a day. ATTO Technology Inc. 155 CrossPoint Parkway Amherst, NY 14068 (716) 691-1999 - voice (716) 691-9353 - fax http://www.attotech.com ATTO Technology can also be reached via e-mail at the following addresses: Sales Support: sls@attotech.
ATTO Technology, Inc.
ATTO Technology, Inc.
ATTO Technology, Inc. ATTO FibreBridge Software Manual ATTO Technology, Inc.