C H A P T E R 2 |
Sun StorEdge Configuration Service Command-Line Interface (CLI) |
The Configuration Service software provides a secure command-line interface for all Configuration Service, Sun StorEdge T3, T3+, or 6120 array, alarm, and log management functionality. There are two options for logging in to this interface, the Secure Shell, and telnet.
This section contains the following topics:
In locations where security is not an issue, you can use the telnet interface.
1. Telnet to the host with the specified CLI port.
$ telnet hostname.domain port-number TelnetD library (embeddable telnet daemon) |
The login name can be root or any user name registered with the Sun StorEdge Configuration Service by way of the esmconfig script. For more information about the esmconfig script, see the Sun StorEdge Enterprise Storage Manager 1.2 Installation Guide.
2. To run device specific commands, navigate to /devices/array/sun.
SeSh [1] cd devices/array/sun |
One way to access the command-line interface is by way of the Secure Shell client (ssh) available on Solaris 8 and 9. Depending upon how your SSH environment is configured, you may need to see the ssh.1m man page for additional information on starting a session.
1. To initiate a Secure Shell client session on a host, enter the following:
# ssh -c 3des hostname |
This logs you into the Configuration Service command line interface (CLI).
2. To run device specific commands, navigate to /devices/array/sun.
SeSh [1] cd devices/array/sun |
Listed below are some useful CLI procedures.
SeSh [1} help |
Navigate to the devices/array/sun directory and display discovered arrays.
SeSh [2] cd devices/array/sun SeSh [3] ls |
From the devices/array/sun directory, type one of the following:
|
1. Navigate to the devices/array/sun directory.
SeSh [3] cd devices/array/sun |
2. To add Sun StorEdge T3, T3+, or 6120 arrays, enter the discovery add command:
SeSh [4] discovery add array-name array-name array-name... |
3. Use the config credential command to set the password the Sun StorEdge Configuration Service software will use with the device for configuration.
SeSh [5] config credential array-name1 array-name2 array-name3 |
4. Set passwords with the config password command.
5. Verify passwords have been set with the inventory info command.
If the Password column has `admin', you have set the root password. You may need to allow some time for the output of `inventory info' to be updated since it uses cached values.
1. Use the config credential command to set the password the Sun StorEdge Configuration Service software will use with the device for configuration.
SeSh [8] config credential array-name1 array-name2 array-name3 |
2. When prompted, enter the password.
3. When prompted, enter the confirm password by entering it again.
1. Use the config password command to set the password for the Sun StorEdge T3, T3+, or 6120 arrays.
SeSh [8] config password array-name1 array-name2 array-name3 |
2. When prompted, enter the SSCS (Sun StorEdge Configuration Service) root password.
3. When prompted, enter the password.
4. When prompted, enter the confirm password by entering it again.
Run config status command to view the volume information on a device.
SeSh [10] config status array-name |
SeSh [11] config volcreate -f -p -u unit-id -r raid-level array-name |
Using the -p option will allocate for a hot spare and the hot spare will not appear as available space.
When you create a volume, you must specify the volume size with the -i option, which indicates the corresponding size by index, or with the -s option, whereby you specify volume size in Gbytes. Use the -a option in `config volcreate' command to automatically bring the volume online after the initialization.
a. Use the -i option to choose the size from the list when creating a volume.
SeSh [12] config volcreate -a -u unit-id -r raid-level -i index -p array-name |
b. Use the -s option to specify the size on your own.
SeSh [12] config volcreate -a -u unit-id -r raid-level -s size -p array-name |
When using the -s option, you will be prompted with a list of available sizes.
The Sun StorEdge T3, T3+, or 6120 arrays only allow 2 volumes per device, so if you don't use the rest of the space for the second volume, you will be wasting some space. You will get the warning, but the operation will continue.
WARNING: Inefficient Use of Available Space Creating the second volume with less than the maximum capacity available leaves a segment of space that can not be used. |
3. Check volume initialization for completion.
SeSh [13] config info -v vol-name array-name |
Once the operation is done, you can mount the volume.
Execute the following command:
SeSh [13] asset info array-name |
Execute the following command:
SeSh [13] asset info -u * array-name |
Pass `*' to the unit-id to get all the unit information.
Execute the following command:
SeSh [13] asset info -m * array-name |
Pass `*' to the fru-id to get all the unit information.
Note - This is only available on Sun StorEdge T3+ with firmware version 2.1 or greater. |
1. View if slicing feature is enabled.
SeSh [24] config status array-name |
SeSh [25] config set -p "volslicing=enable" array-name |
SeSh [26] config luncreate-n lun-name -v vol-name -s size -p array-name |
4. Verify the LUN information.
SeSh [27] config status -l * array-name |
1. Navigate to the /services directory.
SeSh [16] cd /services |
SeSh [17] alarm list |
1. Navigate to the /services directory.
SeSh [16] cd /services |
SeSh [17] log list |
See the man pages listed in TABLE 2-1 for additional information on the StorEdge Shell. See the man pages listed in TABLE 2-2 for additional information on Sun StorEdge Configuration Service CLI man pages for the Sun StorEdge T3, T3+, or 6120 array.
See the man pages listed in TABLE 2-1 for additional information on the StorEdge Shell.
Add, list or remove alarms from the log in the StorEdge Shell |
|
Display exit status for functions executed in the StorEdge Shell |
|
See the man pages listed in TABLE 2-2 for additional information on the StorEdge Shell.
Copyright © 2003, Sun Microsystems, Inc. All rights reserved.