ACS Overview
================================================
The Command Line Interpreter (CLI) commands are used to interact with the
storage controller by way of:
A local terminal connected to the maintenance port of the
controller
A remote connection by way of the host system terminal
The StorageWorks Command Console (SWCC)
CLI Overview
============
The CLI is one of the user interfaces through which you control a Compaq
StorageWorks array controller in the storage subsystem (the CLI being the
most direct).
The CLI commands allow you to manage the subsystem by viewing
and modifying the configuration of the controller and the devices
attached to them.
You can also use the CLI to start controller diagnostic and
utility programs.
Using the CLI
=============
You can access the CLI through the following methods:
A local terminal/PC to the maintenance port on the front of the
controller.
The DUP utility from the system terminal can be used to enable a
remote connection to the controller.
After configuring the controller, and making it visible to
the host, you can perform other configuration tasks through this
remote connection.
Overview of Commands
====================
CLI commands are divided into categories based on what options or structures
they control. The following is a list of the command categories:
*Controller Commands* - Configure the maintenance terminal
characteristics, CLI prompt, and so forth. Controller commands are also
used to shut down and restart the controller
*Device Commands* - Create and configure containers made from
physical devices attached to the controller.
*Storageset Commands* - Create and configure complex containers
made from groups of device containers.
There are four basic types of storagesets:
stripesets
RAIDsets
striped-mirrorsets
mirrorsets
Storageset commands group device containers together and
allow them to be handled as single units.
*Partition Commands* - Create and multiple logical disk units
from the same container.
*Logical Unit Commands* - Create and optimize access to logical
units made from any container type.
*Diagnostic and Utility Commands* - Perform general controller
support functions.
Entering CLI Commands
=====================
Use the following tips and techniques for the entering of CLI commands:
Commands are not case-sensitive.
For most commands, you only need to enter enough of the command
to make the command unique. For example, SHO is the same as entering
SHOW.
The controller processes each command in sequence. You can
continue entering subsequent commands while the controller is processing
prior commands. A controller experiencing heavy data I/O may respond
slowly to CLI commands.
Specific keys or a combination of keys allow you to recall and
edit the last four commands. This feature can save time and help prevent
mistakes when you need to enter similar commands during the
configuration process.
Command Syntax
==============
Each CLI command is described using the following structure:
COMMAND SWITCHES
*COMMAND* - A word or phrase expressed as a verb that is used to
instruct the controller what to do.
*PARAMETER_NAME* - The name of a parameter, followed by an equal
sign and the parameter variable. If a specific command specifies
parameter names, they must be entered in the command string.
*parameter* - When required in the command, parameters are used
as one or more words or phrases that supply necessary information to
support the action of the COMMAND.
Not all CLI commands require parameters.
*SWITCHES* - An optional word or phrase that modifies the
command/parameter string. Not all CLI commands require switches.
Switches are represented in this manual as capitalized, italicized text.
Recall and Edit Command Keys
============================
Key Function
Up Arrow or Steps forwards or backward through the four most recent CLI
Ctrl/B, commands
Down Arrow or
Ctrl/N
Left arrow or Moves the cursor left or right in a command line
Ctrl/D,
Right arrow
or Ctrl/F
Ctrl/E Moves the cursor to the end of the line
Ctrl/H or Moves the cursor to the beginning of the line
Backspace
Ctrl/J or Deletes the word to the left of the cursor
Linefeed
Ctrl/U Deletes all characters on the same line as the cursor
Ctrl/A or F14 Toggles between insert and overstrike mode:
The default setting is insert mode allowing you to insert
characters at the cursor location (moving the existing
characters to the right).
Overstrike mode replaces existing characters.
The CLI prompt returns to insert mode at the beginning of
each line.
Ctrl/R Recalls the contents of the command line. This is especially
helpful if the system issues a message that interrupts your
typing.
----------------------------------------------------------------------------
| |
