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:


Using telnet

In locations where security is not an issue, you can use the telnet interface.

1. Telnet to the host with the specified CLI port.

The default port is 8023.

$ telnet hostname.domain port-number

Trying 127.0.0.1...

Connected to localhost.

Escape character is `^]'.

 

TelnetD library (embeddable telnet daemon)

Copyright (c) 2000, Dieter Wimberger

All rights reserved.

 

login: root

Password:

 

Welcome to the StorEdge Shell V1.2.0


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


Using the Secure Shell

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


Using the Command-Line Interface

Listed below are some useful CLI procedures.


procedure icon  To List Built-In CLI Commands

SeSh [1} help


procedure icon  To View Sun StorEdge T3, T3+, or 6120 Arrays Being Managed

single-step bulletNavigate to the devices/array/sun directory and display discovered arrays.

SeSh [2] cd devices/array/sun
SeSh [3] ls


procedure icon  To Display Command Sub-command Usage

single-step bulletFrom the devices/array/sun directory, type one of the following:

  • asset
  • config
  • control
  • discovery
  • inventory
  • /services/alarm
  • /services/log

procedure icon  To Add Sun StorEdge T3, T3+, or 6120 Arrays and Set the Password

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.

SeSh [6] config password array-name1 array-name2 array-name3

Please enter T3 password:

Please confirm T3 password:

config: INFO: credential: successfully set credential for array-name1

config: INFO: credential: successfully set credential for array-name2

config: INFO: credential: successfully set credential for array-name3


5. Verify passwords have been set with the inventory info command.

SeSh [7] inventory info


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.


procedure icon  To Set the Array Credential

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.


procedure icon  To Set the Array Password

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.


procedure icon  To View Volume Configuration

single-step bullet Run config status command to view the volume information on a device.

SeSh [10] config status array-name


procedure icon  To Create and Bring a Volume Online

1. Determine available sizes.

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.

2. Create volume.

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.


procedure icon  To Display System Information

single-step bulletExecute the following command:

SeSh [13] asset info array-name


procedure icon  To Display Unit Information

single-step bulletExecute the following command:

SeSh [13] asset info -u * array-name

Pass `*' to the unit-id to get all the unit information.


procedure icon  To Display FRU Information

single-step bulletExecute the following command:

SeSh [13] asset info -m * array-name

Pass `*' to the fru-id to get all the unit information.


procedure icon  To Create a LUN with Volume Slicing Enabled



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

2. Enable volume slicing.

SeSh [25] config set -p "volslicing=enable" array-name

3. Create the LUN.

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


procedure icon  To View Alarm Entries

1. Navigate to the /services directory.

SeSh [16] cd /services

2. Display alarms.

SeSh [17] alarm list


procedure icon  To View Log Entries

1. Navigate to the /services directory.

SeSh [16] cd /services

2. Display log entries.

SeSh [17] log list

 


Command-Line Interface (CLI) and StorEdge Shell Man Pages

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.

StorEdge Shell Man Pages

See the man pages listed in TABLE 2-1 for additional information on the StorEdge Shell.

TABLE 2-1 CLI Command Information

CLI command

Description

intro

Introduction to StorEdge Shell UNIX commands

alarm

Add, list or remove alarms from the log in the StorEdge Shell

attributes

Command characteristics unique to the StorEdge Shell

cd

Change the working directory in the StorEdge Shell

echo

Echoing arguments in the StorEdge Shell

environ

User environment variables for the StorEdge Shell

exit

Display exit status for functions executed in the StorEdge Shell

help

Lists available commands in the StorEdge Shell

log

Add or list alarms from the StorEdge Shell

ls

Lists storage resources in the StorEdge Shell

man

Man page command for the StorEdge Shell

pwd

Print working directory in the StorEdge Shell

sesh

StorEdge shell command interpreter

set

Setting environment variables in the StorEdge Shell

unset

Unsetting environment variables in the StorEdge Shell


Sun StorEdge Configuration Service CLI Man Pages for the Sun StorEdge T3, T3+, or 6120 Arrays

See the man pages listed in TABLE 2-2 for additional information on the StorEdge Shell.

TABLE 2-2 Sun StorEdge Configuration Service CLI Man Pages for the Sun StorEdge T3, T3+, or 6120 array

CLI command

Description

asset

Display component information for a Sun StorEdge T3, T3+, or 6120 array

config

Perform configuration actions on Sun StorEdge T3, T3+, or 6120 arrays

control

Enable, disable, and reset operations for Sun StorEdge T3, T3+, or 6120 arrays

discovery

Add an array to, or remove an array from the list of discovered disk arrays

intro

Introduction to Sun StorEdge T3, T3+, or 6120 array commands

inventory

Display inventory overview for Sun StorEdge T3, T3+, or 6120 arrays