Table of Contents
Advertisement
8.2 In-band CLI uses SCSI over Fibre port
In-band Command Line Interface (CLI) configures and manages the ATTO FibreBridge using SCSI-
based CLI commands over a Fibre Channel 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 value 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 Write Buffer
command to the ServicesLUN. A Write
Buffer command must be accompanied by
an ASCII buffer representing the CLI
command string such as
33
ATTO Technology FibreBridge 2300E/R/D Installation and Operation Manual
set FibreBridgeName FB2300
3
The ServicesLUN will execute the command
line and create feedback in the form of ASCII
characters into a buffer. This buffer is 8KB
and circular. Retrieve the results by issuing
a Read Buffer command before issuing
another Write Buffer command.
4
A subsequent Write Buffer 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.
Initiator (Host)
Reserve ServicesLUN
Write Buffer
ServicesLUN
bid 0
"get Temperature"
Read Buffer
ServicesLUN
bid 0
Release ServicesLUN
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.
FibreBridge
return: "ok"
executes the CLI command,
stores output in buffer
return:
"Temperature=28C\r\n\Ready.\r\n
\0"
return: "ok"
Advertisement
Table of Contents
