Table of Contents
Advertisement
7.2 In-band CLI using SCSI over Fibre Channel port
In-band Command Line Interface (CLI) configures and manages the ATTO FibreBridge
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
29 ATTO Technology FibreBridge 1190E Installation and Operation Manual
accompanied by an ASCII buffer
representing the CLI command string such
as
set FibreBridgeName FB1190
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 7.2-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)
TM
using SCSI-
Advertisement
Table of Contents
