Introduction
This chapter introduces the major components in Mayastor storage management. The components include both the hardware components and the logical components of the storage system.
The storage management commands are issued from the Mayastor Command Line Interface (CLI) program mayacli by running on the Mayastor storage server system.
...
mayacli –h mayaserv1
The mayacli program makes use of Linux tcpwrapper library interface to prevent unauthorized access. Please consult the Linux Administrator guide for more information on tcpwrapper.
The mayacli program when invoked without any command statement will enter into interactive mode waiting for commands to be entered. Otherwise it will execute the command statement passed in the command line argument and exit immediately intended for scripting.
Command Description and Syntax
Each CLI command is made up of string of keywords separated by spaces. Each keyword could be a command, system object, parameter, etc. The keywords are case insensitive and so writeCacheEnabled is equivalent to writecacheenabled. Sometimes it can be recognized by partial keywords as long as it is not ambiguous. For example writeCacheEnabled can be recognized simply by writecache. Also some keywords can have aliases, which are easier to type. For example the keyword logicalUnitNumber can also be referred by keyword lun. The special character "*" refers to all the objects. The label name cannot use these reserved names:
command object cmd-statement
The following table gives the notational conventions for the command set.
Table 3-1Command notational conventions
a | b | alternatives (“a or b”) |
italicized-word | non-terminals |
[ … ] (square braces) | zero or one occurrence |
{ … } (curly braces) | zero or more occurrences |
( a | b | c ) | “choose exactly one of the alternatives” |
...
Object | Mayastor Configuration section |
controller | Represents the fibre channel HBA operating in target mode. For iSCSI operations this refers to all the Ethernet interfaces in the system. |
iscsi | Represents the iSCSI targets, sessions and connections for management. |
disk | Available physical disks in the system. |
host | The application server that will make use of the Mayastor volumes |
mapping | Binding a volume to controller and lun for a particular host or for all the hosts. |
mayastor | The overall storage server. |
perf | Performance object for volumes or controllers. |
stats | Statistics object for volumes or controllers. |
volume | Mayastor basic unit of storage that is presented as disks to hosts. |
CLI Commands
controller
Displays information about the controllers used for Mayastor storage services. For iSCSI operation it will show the familiar ifconfig output for Ethernet interfaces. For Fibre Channel version of Mayastor it will provide information about the Qlogic controller operating in target mode.
mayacli> show controller
bind
Bind causes volume mappings to go into effect and actually makes it available online for access from SAN clients.
mayacli> bind mapping
disk
Display information about the physical SCSI disks in the system.