41
ATTO Technology FibreBridge 4500 Installation and Operation Manual
4.4 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 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
set FibreBridgeName FB4500
3
The ServicesLUN will execute the command
line and create feedback in the form of ASCII
characters into a buffer. This buffer is 8 KB
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.
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.
Initiator (Host)
FibreBridge
Reserve ServicesLUN
return: “ok”
Write Buffer
ServicesLUN
bid 0
“get Temperature”
executes the CLI command,
stores output in buffer
Read Buffer
ServicesLUN
bid 0
return:
”Temperature=28C\r\n\Ready.\r\n
\0”
Release ServicesLUN
return: “ok”
Содержание FibreBridge 4500C
Страница 2: ......
Страница 7: ......
Страница 57: ...iv Appendix A...
Страница 61: ...viii Appendix B...