Syntax Overview
www.3ware.com
24
whether it is directly connected to the controller, or cascaded through one or
more expanders. The VPort, in essence, is a handle in the software to uniquely
identify a drive. The VPort ID or port ID allows a drive to be consistently
identified, used in a RAID unit, and managed. For dual-ported drives,
although there are two connections to a drive the drive is still identified with
one VPort handle.
For additional information about 3ware controller concepts and terminology,
see the user guide that came with your 3ware RAID controller or the user
guide portions of the 3ware HTML Bookshelf.
Syntax Overview
The command syntax uses the general form:
Object Command Attributes
Objects
are shell commands, controllers, units, ports (drives), BBUs (battery
backup units), and enclosures.
Commands
can either select (show, get, present, read) attributes or alter (add,
change, set, write) attributes.
Attributes
are either Boolean Attributes or Name-Value Attributes.
•
The value of a boolean attribute is deduced by presence or lack of—that
is, the attribute is either specified, or not. For example, the command
show alarms
by default lists alarms with the most recent alarm first. If
you include the attribute
reverse,
as in the command
show alarms
reverse
, alarms are listed in reverse order.
•
The value of name-value attributes are expressed in the format
attribute=value
.
Example:
When adding (creating) a unit to the controller with the following
command string,
/c1 add type=raid1 disk=0-1
c1
is the object,
add
is the command,
type
(for type of array) is an attribute
with
raid1
as the value of the attribute, and
disk
is another attribute with
0-1
as the value (ports 0 through 1).
Information about commands is organized by the object on which the
commands act:
Note:
For practical purposes, port and VPort are used interchangeably in this
document in reference to a drive (or disk). Therefore, unless otherwise specified,
the mention of port implies VPort as well. For example, when “port” is used to
indicate a drive, it is implied that for the applicable controller series, the reference
also applies to VPort.
