Specifications

31
ATTO Technology FibreBridge 1180E/D Installation and Operation Manual
8.4 In-band CLI using SCSI over Fibre Channel port
In-band Command Line Interface (CLI) configures and manages the ATTO FibreBridge using SCSI-
based CLI commands over a fibre port connection.
In-band CLI allows a programmer to configure
the FibreBridge while it is moving data. Using a
programmer’s interface, ATTO FibreBridge
Services CLI commands, as described previously
in this manual, may be implemented. The only
command not available is
menu.
In-band CLI is implemented as a device separate
from the FibreBridge itself. It uses a different
LUN than the FibreBridge, and reports as a
Storage Enclosure Services (SES) device (device
type 0x0D). This LUN is referred to as the
ServicesLUN.
The ServicesLUN is visible on all fibre ports but
is actually a single unit. The default fibre LUN for
each fibre port’s ServicesLUN is 0x08.
The ServicesLUN must be reserved for each
Write Buffer/Read Buffer pair, using the SCSI
Reserve command to insure integrity of the in-
band CLI session.
1 An initiator (host) sends a SCSI Reserve
command to the ServicesLUN.
➔
If the ServicesLUN is not reserved by
another initiator, the ServicesLUN is now
reserved and ready to begin a new CLI
session.
➔
If the FibreBridge configuration is
reserved by a different CLI session (i.e.
serial or Telnet), the in-band session will
not be allowed to modify the FibreBridge
configuration. If you try, the results buffer
of the ServicesLUN will return:
Process X has the configuration reserved.
ID of this session = Y
Ready.
2 The initiator issues a SCSI
WriteBuffer
(buffer ID = 0) command to the ServicesLUN.
A
WriteBuffer
command must be
accompanied by an ASCII buffer
representing the CLI command string such
as
set FibreBridgeName FB1180
3 The ServicesLUN will execute the command
line and created feedback in the form of
ASCII characters into a buffer. This buffer is
8KB and circular. Retrieve the results by
issuing a
ReadBuffer
command before
issuing another
WriteBuffer
command.
4 A subsequent
WriteBuffer
command will
execute the new command line and
overwrite the previous results in the buffer
with new results.
5 The ServicesLUN can be released by
issuing a
SCSI Release
command to the
Services LUN after each Write/Read Buffer
pair, or multiple Write/Read Buffer pairs.
(See Exhibit 8.4-1 for an example)
I/O details
The buffer sent to the Services LUN during the
data out phase of a Write Buffer command must
be:
➔
ASCII data
➔
maximum 80 bytes length
➔
terminated with either a carriage return
character (0x0D), line feed character
(0x0A) or NULL character (0x00)
➔
Characters following the first carriage
return character, line feed character or
NULL character are ignored.
The buffer retrieved from the Services LUN
during the data-in phase of a Read Buffer
command will be:
➔
ASCII data
➔
maximum 8 KBytes (8192 bytes) in length
➔
terminated with a NULL character (0x00)