Overview

C H A P T E R 1

Overview

This chapter provides an overview of the sscs administration command for Sun StorageTek and Sun Storage arrays. It contains the following sections:

Overview of the sscs Command

Understanding Command Syntax

Logging In to the sscs Environment

Exit Status Codes

Command Quick Reference

Overview of the `sscs` Command

The sscs command line interface (CLI) enables you to manage and monitor disk arrays. The CLI can be installed on a local data host or a remote management host.

Local CLI directory location:

Solaris: /opt/SUNWstkcam/bin/sscs

Linux: /opt/sun/cam/bin/sscs

Windows: Program Files > Sun > Common Array Manager > bin folder

Remote CLI directory location:

Solaris: /opt/SUNWsesscs/cli/bin/sscs

Linux: /opt/sun/cam/se6x20/cli/bin/sscs

Windows: Program Files > Sun > Common Array Manager > bin folder

Understanding Command Syntax

Type the sscs command with its options from a terminal command line. You can use only the indicated option or options for that subcommand. For a listing of commands and their options, refer to <<XREF to chapter 3 here>>

TABLE 1-1 describes the conventions that apply to the subcommands and variables:

TABLE 1-1 Syntax Conventions for sscs Commands
Convention	Description
Bold	Text in bold should be typed exactly as shown.
Italic	Text in italics is variable and should be replaced with the name or value used at your site. Multiple variables can be separated by a comma and, optionally, a space. Note: You cannot use a space alone. The following examples show the correct use of commas and spaces in lists: sscs list volume `TestVOL,fvm13311` sscs list volume `TestVol, fvm13311`
[ ] (square brackets)	Text in square brackets is optional.
\| (vertical bar)	Text separated by a vertical bar is exclusive. Specify only one of the options.
{ } (braces)	Text inside braces is a required argument
Short and long names	The `sscs` command accepts short or long names for each option. Short name options require a single hyphen (-). Long name options require a double hyphen (--).
Special characters in names	Do not use spaces, commas, colons (:), or any of the following special characters: ? * ! @ % &

Note - Any characters that you enclose within quotation marks are acceptable for names.

Getting Help with Commands and Their Syntax

Use the --help command to view all available commands, subcommands and their syntax.

TABLE 1-2 describes how to use the --help command:

TABLE 1-2
Task	Command Syntax
Get help with command syntax	sscs --help
Display a command list specific to a specific array type	sscs --help -a <array-type> Command example: sscs --help -a 2510 add create delete export fail ... revive service snapshoot unmap unregister
Display the subcommands available for a command for a specific array type	sscs <subcommand> --help -a <array-type> Command example: sscs list --help -a j4200 Sample Command Output: alarm array date ... site storage-system userrole
Display a detailed option list for a command/subcommand pair for a specific array type	sscs <subcommand> --help -a <array-type> <resource-type> Command example: sscs list --help -a j4200 alarm Sample Command Output: list [-s\|--severity <string>] [-f\|--faultdevtype <string>] [-a\|--advisor] [-S\|--Summary] alarm [string[,string...]]

Logging In to the `sscs` Environment

If you are using the local CLI, no login is required; however, you must have root access in Solaris and Linux or administrator privileges in Windows.

A login is required if using the remote CLI. To log into the remote CLI, follow these steps:

1. From a terminal window, log in to the management host where sscs resides.

2. Enter the following commands:

# cd CLI_directory (Refer to Overview of the sscs Command for directory information.
# ./sscs login -h localhost -u <user-name>

3. Enter the password for your sscs user account.

For a thorough description about logging into the sscs using the remote CLI, see the login command and all of its options, go to login

Exit Status Codes

Upon command completion, the sscs CLI reports the following exit status codes:

TABLE 1-3 Exit Status Codes
Exit Status Code	Description
0	Successful completion
15	Object not found error
25	Command parsing failure
30	Command validation error
50	Application error
75	System error
100	Nonspecific error

Command Quick Reference

There are two categories of CLI commands:

Monitoring and General Administration Commands

These commands are supported on all arrays supported by CAM, with only a few noted exceptions.

Array Configuration Commands

These commands are supported on only those arrays that have one or more RAID controllers.

For a complete listing of arrays supported by CAM, refer to the release notes.

Monitoring and General Administration Commands

The following table lists the commands used to monitor the array and perform general administration tasks. This table identifies the command name and provides basic syntax, a general command description, and identifies the page where you can find a detailed command description.

TABLE 1-4 Monitoring and General Administration Commands
Command	Description
add notification	Set up email or SNMP trap notification.
add registeredarray	Discovers an array or all arrays on the same subnet as the management host and registers them.
add userrole	Adds a user name to the user access list and defines the user privileges.
list alarm	Provides detailed information on a specified alarm or summary information on all alarms
list array	Lists detailed information about specified arrays or all array names.
list date	Lists the current date and time for the array in hours, minutes, and seconds. (Not supported by j450 and B6000 JBODs.)
list device	List the details of a device or the devices being monitored.
list devices	List an overview of a device or the devices being monitored.
list disk	List the disk information on an array.
list event	Lists the Fault Management Service (FMS) event log information.
list firmware	Lists the firmware versions of the field-replaceable units (FRU) in this device
list fru	Lists the field-replaceable units (FRUs) in this device.
list jobs	Lists job IDs and status associated with the specified array and optionally specified job ID
list log	Lists the user-initiated actions performed for all registered arrays.
list mgmt-sw	Lists the management software application that you are logged into.
list notification	Lists the remote notification provider and its status.
list registeredarray	Lists registered array information
list storage-system	Lists detailed information about one or more arrays.
list site	Lists pertinent information on the site.
list userrole	Lists the user name and role defining the user’s array privileges.
login	Log in to the sscs command-line interface (CLI).
logout	Logs out of the remote sscs command-line interface session.
modify agent	Modify the fault management agent parameters.
modify array	Modifies the name assigned to the array.
modify firmware	Modifies the firmware versions of the specified field-replaceable units (FRUs) of the specified array
modify mgmt-sw	Stores the specified storage system name for the session. This command is useful for repeated operations with an array.
modify registeredarray	Change the locally stored password for a registered array.
modify site	Modifies the site properties for this instance of CAM.
modify storage-system	Modifies the array information
modify userrole	Change the user role or the IP address from which the user can log in.
register storage-system	Registers a storage system with the host
register sun-connect	Registers CAM software and all monitored arrays with Auto Service Request (ASR).
remove alarm	Removes the current alarms.
remove notification	Removes a local or remote notification.
remove registeredarray	Removes one or more arrays from the list of registered arrays.
remove userrole	Removes a user role assigned to a user name.
service	Perform service-related commands.

Array Configuration Commands

This section identifies the commands used to configure an array. This table identifies the command name and provides basic syntax, a general command description, and identifies the page where you can find a detailed command description.

TABLE 1-5 Array Configuration Commands
Command	Description
add hostgroup	Adds hosts to a host group.
add license	Adds a license to the specified array.
create host	Creates a storage host.
create hostgroup	Creates a storage host group.
create initiator	Creates an initiator.
create iscsi initiator	Creates an iSCSI initiator on a host.
create pool	Creates an empty storage pool on the array
create profile	Creates a storage profile on the array.
create repset	Creates a storage replication set using a peer World Wide Name or remote array name (not applicable to 2500 Series).
create snapshot	Creates a snapshot for the specified volume.
create vdisk	Creates a virtual disk.
create volume	Creates a volume within a specified pool.
create volume-copy	Creates a copy of the volume (not applicable to 2500 Series).
delete host	Deletes one or more hosts.
delete hostgroup	Deletes one or more host groups.
delete initiator	Deletes one or more initiators.
delete iscsi-session	Deletes an iscsi-session
delete pool	Deletes one or more pools.
delete profile	Deletes one or more profiles.
delete repset	Deletes one or more replication sets (not applicable to 2500 Series).
delete snapshot	Deletes one or more snapshots.
delete vdisk	Deletes one or more named virtual disks.
delete volume	Deletes one or more named volumes.
delete volume-copy	Deletes a volume-copy (not applicable to 2500 Series).
disable snapshot	Disables one or more snapshots.
export array	Renders an extensible markup language (XML) representation of the array
export profile	Exports one or more profiles into an XML representation.
fail disk	Sets a disk to the failed state.
import array	Applies an array configuration file to the specified array.
import profile	Imports one or more profiles from a specified XML file.
initialize disk	Initializes a disk.
list controller	Lists configuration information for the specified controller
list fcport	Lists Fibre Channel port information for the controller of the specified array.
list host	Lists the host names and details for an individual host.
list hostgroup	Lists host group name and hosts for an individual host group.
list initiator	Lists the initiators and provides a description of each.
list iperformance	Displays iSCSI performance statistics for the 2510 array and enables you to define the type of iSCSI performance statistics to monitor.
list iscsi-port	Lists iSCSI ports.
list iscsi-session	Lists iSCSI sessions
list iscsi-target	Lists iSCSI target name configured for the specified array.
list license	Shows all licenses that are associated with the array, along with related licensing details (serial number, controller serial number, and further details)
list mapping	Lists mappings for the array. You can filter the output by specifying the name of a storage domain, a host, or a host group.
list os-type	Shows all of the operating systems that are supported by the array. The values returned can be used in subsequent requests to create or modify initiators, or to modify the default host type of the array.
list performance	Shows detailed performance statistics. You can use the following options only if a single array is specified.
list pool	Lists storage pool information.
list profile	Lists the named storage profiles
list repset	Lists replication set information (not applicable to 2500 Series).
list sasport	Lists SAS port information.
list snapshot	Lists the specified snapshot or snapshots associated with this array.
list tray	Lists information about one or more storage trays in the array.
list vdisk	Lists virtual disk (vdisk) or virtual disks information associated with this array.
list volume	Lists volume information.
list volume-copy	Lists volume copy information. If neither the source volume nor the target volume is specified, a summary of all volume copies is listed. If the source volume or the target volume is specified, a detailed listing of each is generated.
map host	Maps one or more volumes and snapshots to a host. Any previous mappings for the given volumes and snapshots are removed.
map hostgroup	Maps one or more volumes and snapshots to a host group. Any previous mappings for the given volumes or snapshots are removed.
map initiator	Maps an initiator to a volume or snapshot. Any previous mappings for the given volumes or snapshots are removed.
map snapshot	Maps one or more snapshots to a host or host group. If no host or host group is specified, the snapshot or snapshots are mapped into the Default partition.
map volume	Maps one or more volumes to a host or host group. Any previous mappings for the given volume or volumes are removed.
modify array	Modifies the configuration of the specified array
modify controller	Modifies the controller settings.
modify date	Modifies the date on the array, allowing you to set the time on the array, or to synchronize the time with the management host (that is, setting the array's time to the management host's time.)
modify disk	Specifies the disk role.
modify fcport	Modifies the Fibre Channel port settings on the specified array.
modify host	Modifies the host name.
modify hostgroup	Modifies the host group name.
modify initiator	Modifies an initiator.
modify iperformance	Modifies the settings for iSCSI performance data.
modify iscsi-port	Modifies an iSCSI port.
modify iscsi-target	Modifies an iSCSI target.
modify jobs	Cancels or prioritizes a running or outstanding job.
modify license	Activates replication set licenses (applicable to 2500 Series only when running firmware version 07.35.nn.nn or higher).
modify notification	Modifies notification options.
modify performance	Modifies settings for performance monitoring
modify pool	Modifies the name or description of the storage pool or the profile with which this pool is associated.
modify profile	Modifies a storage profile on the array.
modify repset	Modifies the mode, consistency group, or replication priority of the specified replication set (not applicable to 2500 Series).
modify snapshot	Modifies the specified snapshot
modify tray	Modifies information about one or more storage trays in the array.
modify vdisk	Specifies modifications to a virtual disk.
modify volume	Modifies any of a volume’s attributes
modify volume-copy	Modifies a volume copy (not applicable to 2500 Series).
offline vdisk	Sets a virtual disk offline.
online vdisk	Sets a virtual disk online.
reconstruct disk	Initiates a disk reconstruction.
remove hostgroup	Removes one or more hosts from a host group.
remove license	Removes the replication set feature license from the specified array (not applicable to 2500 Series).
remove notification	Removes a local or remote notification provider.
reset array	Resets the specified array.
rreset controller	Resets the specified controller.
resnap snapshot	Resnaps one or more existing snapshots.
revive disk	Attempts to bring a disk to the optimal state.
revive vdisk	Revives a virtual disk
service fail	Places a field-replaceable unit of an array into a failed state.
service locate	Turns on the drive, tray, or array locator LED.
service redistribute	Redistributes volumes back to their preferred owners.
service revive	Attempts to place the array controller or disk drive into the optimal state. This can create complications. Do not initiate this command without first consulting Sun Customer Service personnel.
snapshoot volume	Creates and manages snapshots.
unmap host	Unmaps one or more snapshots or volumes from a host.
unmap hostgroup	Unmaps one or more snapshots or volumes from a host group.
runmap initiator	Removes the mapping from one or more initiators to a volume or snapshot.
unmap snapshot	Removes the mapping from one or more snapshots to a host or hostgroup.
unmap volume	Unmaps one or more volumes from a host or host group.
unregister storage-system	Unregisters an array.
unregister sun-connection	Unregisters CAM software and all monitored arrays from Auto Service Request (ASR).
version	Shows the versions of software that you are running on this array and the client.

Overview of the sscs Command