| Sun StorageTek Common Array Manager CLI Guide |    
|
| C H A P T E R 3 |
|
Monitoring and Administration Commands for All Arrays |
This chapter describes the sscs commands and their options for monitoring and administrating all Sun arrays, including Sun Storage J4200, J4400, and J4500 arrays, Sun Storage F5100 Flash Array, Sun StorEdge 6130 array, Sun StorageTek 6140 and 6540 arrays, Sun Storage 6180 array, Sun Storage 6580 and 6780 arrays, Sun StorageTek 2500 Series arrays, FlexLine 240, 280, and 380 Systems, and Sun Blade 6000 disk module.
For configuration and other commands that apply only to arrays with RAID controllers, see Chapter 4.
Sets up email or SNMP trap notification.
add -e <email-address,...> [ -c <array_type> ] [ -r pager | email ] [ -m down | critical | major | minor ] [ -f ] [ -k ] [ -d ] [ -g ] notification local_email
Add an SNMP trap notification:
add -i <IP-address,...> [ -o <port_id>] [-t 1 | 2 | 3 | 4 | 5 ] [-l warning | error | down ] [-m <down | critical | major | minor>] [-c <community-string> ] [-g ] notification trap
add -n <event-id> -s info | none notification email-filter
Turn on the SNMP trap notifier:
add notification trap
Sets up email and SNMP trap notification. You can add one or more email addresses for notifications.
-e,--email <email-address,...>
Specifies that all notifications are sent to the given email addresses.
-i,--ip <IP-address,...>
Specifies the IP address of the host that will receive the SNMP trap data.
-l,--traplevel warning | error | down
Specifies the trap level associated with this notification.
-o,--port <port-id>
Specifies the port ID used to transfer notifications.
-c,--community-string <community-string>
Specifies an SNMP community. An SNMP community is a group that devices and management stations running SNMP belong to. The default value is public.
-c,--components <array_type>
Specifies the array model number. For example, j4200 or j4400.
-r,--format pager | email
Specifies the format of the message: email or pager. If no value is specified, the command defaults to email.
-m,--alarm-level down | critical | major | minor
Specifies the minimum priority level of alerts to be sent out. By default, all alerts will be sent out.
-f,--filter true | false
Enables or disables email filters. The default is false.
-k,--skip-aggregated true | false
Skips components of aggregated events if set to true.
-d,--advisor true | false
Adds Service Advisor information to the email if set to true. The default is false.
-g,--config-change true | false
Sends configuration event emails as well as alert e-mails. The default is false.
-n,--event-number <event_id>
Specifies the event code to filter.
-s,--severity info | none
Specifies the severity of events to report.
-t,--trapnumber 1 | 2 | 3 | 4 | 5
Specifies the trap number associated with this notification.
notification local_email | email-filter | trap
Specifies that all notifications of the specified type are sent to the given addresses.
local-email - Specifies that you want to receive the notification at your local email address.
email-filter - Specifies that you want to filter the notification.
trap - Specifies that you want to receive notification using the SNMP trap notification.
sscs add -i 10.10.10.1 -o 162 notification trap
Discovers an array or all arrays on the same subnet as the management host and registers them.
add -d registeredarray add -i [ -q ] registeredarray
Discovers arrays and registers them.
-i,--ipaddress
Specifies the IP address of the device.
-d,--discover
Automatically discovers all arrays on the same subnet as the management host and registers them. If discover is specified, all other options are ignored and arrays are automatically discovered.
-q,--query-for-password
Queries for the current password for remote proxy for the registered array.
sscs add -i 10.10.10.1 registeredarray
Adds a user name to the user access list and defines the user privileges.
add -u <user-name> userrole storage | guest
Adds a user name to the user access list and defines the user role as having storage or guest privileges.
-u,--username <user-name>
Specifies a user name. The <user-name> must already be defined on the computer in the operating system.
userrole storage | guest
Specifies the new user’s role.
storage - Provides full storage configuration and monitoring access.
guest - Allows user to view but not change storage configurations.
Provides detailed information on a specified alarm or summary information on all alarms.
list [-s <0|1|2|3>] [-f <2510|2530|2540|j4200|j4400|j4500|F5100|6120|6130|6140|6540|6580|6780|FLX240|FLX280|FLX380|B6000|NEM>] [-a <sevice-advisor-ID>] [-S] alarm [Alarm Id[,Alarm Id...]]
Provides detailed information on a specified alarms. When alarm IDs are not specified, it provides summary information on all alarms.
-a,--advisor service-advisor-ID
Specifies the Service Advisor ID.
-s,--severity <0..3>
Specifies a severity level at which to filter alarms so that only the alarms of that severity or higher are listed.
-f,--faultdevtype <2510|2530|2540|j4200|j4400|j4500|F5100|6120|6130|6140|6540|6580|6780|FLX240|FLX280|FLX380|B6000|NEM>
Specifies the type of device to list.
-S, --Summary
Specifies that the system return a summary of alarm information.
alarm [ <alarm-ID,...> ]
Specifies the alarm or alarms to display. If no alarm is specified, summary information on all alarms is displayed.
sscs list -f j4200 alarm sscs list -s 2 alarm
(when no advisor option is specified)
Alarm ID: ID Severity: severity Type: type Topic: topic Event Code: event-code Date: date Device: device-id Descrip.: Description
(when the advisor option is specified) Alarm ID: ID Severity: severity Type: type Topic: topic SERVICE ADVISOR EventCode: event-code EventType: event-type Severity: severity-level Sample Description: event-Description Information: event-information Probable Cause: probable-cause Recommended Action: recommended-action Date: date Device: device-ID Descrip.: Description
Lists detailed information about specified arrays or all array names.
list array [array-name[,array-name...]]
Lists detailed information about one or more arrays. If you do not specify an array name, then all array names are listed.
Summary of arrays when no array-name value is specified:
sscs list array
Details of array when the array-name value is specified:
sscs list array array00
Firmware Version: firmware-version
Hot-Spare Pool Disks: number-of-hot-spare-drives (FC, SATA, and SAS)
Default Cache Block Size: 4K | 16K
Default Cache Start %: <0..100>
Default Cache Stop %: <0..100>
Disk Scrubbing: Disabled | Enabled
Failover Alert Delay: 1..300 minutes
Health: OK | Lost Contact |...
Lists the current date and time for the array in hours, minutes, and seconds.
list -a <array-name> date
Lists the current date and time for the array in hours, minutes, and seconds. The time zone of the management system is assumed to be the time zone of the array. NOTE: This command is not supported by any JBOD array.
-a,--array <array-name>
Specifies the array for which you want to see the date.
sscs list -a array00 date
Date: weekday month day HH:MM:SS YYYY
Provides detailed information on a specified device or summary information on all devices.
list [ -n <array-name> ] [ -i <IP-address>] device [ <device-ID [,device-ID...]>]
List the details of a device or the devices being monitored.
-n,--name <array-name>
Specifies the array name for which you want to see the details. If no array is specified, summary information for all arrays is displayed. NOTE: Other commands may use -a,--array or -d,--device in place of -n,--name.
-i,--ip <IP-address>
Specifies the IP address of the connected host when using remote proxy.
Specifies one or more device IDs.
sscs list device Device Name : F5100g Type : f5100 IP Address : camtest17 Monitored On : camtest17 Key : SUN.f5100.508002000048f100 Active : Y WWN : 508002000048f100 Alternate IP : camtest17 Alt IP Number : 10.9.178.48 Management Level : D Said : 508002000048f100 Time Added : 2008-10-28 13:35:28 sscs list -n fms-6780-1 device Device Name : den-6780-1 Type : 6780 IP Address : 192.168.128.101 Monitored On : camtest29 Key : SUN.24643-01.SF74700358 Active : Y Unique Identifier : 200400a0b829ec26 Alternate IP : fms-6780-1b Alt IP Number : 10.9.176.231 Management Level : D Said : 600A0B800029EC260000000048931900 Time Added : 2009-02-20 15:15:42 Port WWNs : 201400a0b829ec26,202400a0b829ec26,203400a0b829ec26,204400a0b 829ec26,205400a0b829ec26,206400a0b829ec26,207400a0b829ec26,208400a0b829ec26,2015 00a0b829ec26,202500a0b829ec26,203500a0b829ec26,204500a0b829ec26,205500a0b829ec26 ,206500a0b829ec26,207500a0b829ec26,208500a0b829ec26 sscs list -i 192.168.128.101 device Device Name : den-6780-1 Type : 6780 IP Address : 192.168.128.101 Monitored On : camtest29 Key : SUN.24643-01.SF74700358 Active : Y Unique Identifier : 200400a0b829ec26 Alternate IP : fms-6780-1b Alt IP Number : 10.9.176.231 Management Level : D Said : 600A0B800029EC260000000048931900 Time Added : 2009-02-20 15:15:42 Port WWNs : 201400a0b829ec26,202400a0b829ec26,203400a0b829ec26,204400a0b 829ec26,205400a0b829ec26,206400a0b829ec26,207400a0b829ec26,208400a0b829ec26,2015 00a0b829ec26,202500a0b829ec26,203500a0b829ec26,204500a0b829ec26,205500a0b829ec26 ,206500a0b829ec26,207500a0b829ec26,208500a0b829ec26
Provides summary information on all devices.
list devices
List a summary of the devices being monitored.
list devices
Monitored On: Interface Device: Array/system being monitored Type: Array/system model IP Address: IP-address WWN: World Wide Name Active: Is the device active? Y | N ASR: Is Auto Service Request on? Y | N
List the disk information on an array.
list -a <array-name> disk [ <disk-name,...> ] list -a <array-name> [ -t <tray-name> ] disk [ <disk-name,...> ]
NOTE: Second synopsis is not valid for JBOD arrays.
-a,--array <array-name>
Specifies the name of the array where the disk resides.
-t,--tray <tray-name>
Specifies to display disk information only within a specified tray in a specified array.
disk <disk-name,...>
This option provides detailed information on the specified disks. When disks are not specified, this option provides detailed information on all the disks in the tray.
sscs list -a array00 -t 0 disk
Tray: tray-ID Disk: disk-name Capacity: disk-capacity Type: SAS | SATA | Fibre Channel Speed (RPM): speed-in-revolutions-per-minute Status: Optimal | In-use | Available | Failed State: Enabled | Disabled Role: Data Firmware: firmware-version-number Serial number: serial-number WWN: WWN-number
Lists the command error return code.
list erc
Lists the error return code of the immediately preceding sscs command.
The following examples demonstrate the execution of an sscs command, followed by the list erc command to check the error code.
sscs list storage-system Array: JBODTest Array: Test10x86 Array: Demo-w2k3 Array: Demo2_JBOD Array: ColoSata Array: Denver Array: Ruby Array: NMS-OZ-12 Array: JBOD3Test Array: JBOD4Top sscs list erc 0 sscs list storage-system NMS-OZ-12 Name: NMS-OZ-12 ID: NMS-OZ-12 Type: 6130 Version: 06.19.25.13 Vendor: SUN Microsystems Model: Sun StorEdge 6130 System Capacity: 2.483 TB Available Capacity: 2.077 TB sscs list erc 0 sscs list storage-system NMS-OZ-21 NMS-OZ-21: The object was not found. sscs list erc 100
Lists the Fault Management Service (FMS) event log information.
list [ -s <0..3> ] [ -d <array-name> ] [ -t <type> ] [ -a ] [ -f <keyword> ] [ -l <limit> ] event [ <event_id,...> ]
Lists the FMS event log information. You can filter by device type and severity level.
-s,--severity <0..3>
Specifies a severity level at which to filter events so that only the events of that severity or higher are listed.
-d,--device <array-name>
List only events for the given device. NOTE: Other commands may use -a,--array or -n,--name in place of -d,--device.
-t,--type <type>
List only events of the given event type. Valid types can be obtained by first listing event details.
-a,--aggregated
Specifies that all events are listed and aggregated so that related events are grouped together.
-f, --filter <keyword>
Filter output on the event Description by using the given keyword parameter.
-l,--last <limit>
Limit the number of events printed by the given number.
event <event_id,...>
sscs list event 12 Severity: Minor Date: Wed Jan 21 10:56:57 MST 2009 Device: ralphie (StorageTek 6140) Component: - Type: Discovery Information: Discovered a device of type 6140 named ralphie Event Code: 57.14.16 Aggregated: No Description: Discovered a device of type 6140 named ralphie Probable Cause: A discovery operation has found a monitorable device. Recommended Action: No action required.
Lists the firmware versions of the field-replaceable units (FRUs) in this device.
list [ -a <array-name[,array-name...]> ] [ -t ctrl | iom | disk | system | sim | expander ] [ -x ctrl | iom | disk | system | sim | expander ] firmware
Lists the firmware versions of the field-replaceable units in this device. You can define the FRUs to include or exclude.
-a,--array <array-name[,array-name...]>
Shows the firmware revision level of the field-replaceable units for the specified arrays only.
-t,--type ctrl | iom | disk | system | sim | expander
Shows the firmware revision level for the specified component types. Valid types are ctrl (array controller), iom, disk (disk drive or FMOD), system (NVSRAM), sim, or expander. The -t option can be used multiple times in the same command (see examples). NOTE: ctrl, system, and iom do not apply to JBOD arrays.
-x, --exclude ctrl | iom | disk | system | sim | expander
Excludes the specified component types from the list of firmware revision levels. Valid types are ctrl (array controller), iom, disk (disk drive or FMOD), system (NVSRAM), sim, or expander. The -x option can be used multiple times in the same command (see examples). NOTE: ctrl, system, and iom do not apply to JBOD arrays.
List the component firmware revisions for all arrays:
sscs list firmware
List the component firmware revisions for a specified array:
sscs list -a jbod1 firmware
List the component firmware revisions for specified component types in a specified array:
sscs list -a jbod1 -t disk -t sim firmware
List the component firmware revisions for a specified array, excluding specified component types:
sscs list -a jbod1 -x system -x expander firmware
Lists the field-replaceable units (FRUs) in this device.
list -d <array-name> [ -t <type-name> ] [ -s ] fru [<fru-name[,fru-name...]>]
Lists the field-replaceable units in this array. You can filter by component type.
-d, --device <array-name>
Specifies the array for which to list installed FRUs. NOTE: Other commands may use -a,--array or -n,--name in place of -d,--device.
-t,--type <type-name>
Specifies the type of field-replaceable units installed in this device to list. Use the -s option to see which FRU types would be valid for the chosen device.
| Note - The all option for type name is no longer valid for use. |
-s,--summary
Lists a summary of this field-replaceable unit.
fru [<fru-name>[,fru-name...]>]
If no FRU names are specified, lists the FRUs on the specified device. If FRU names are specified, lists the details of those FRUs.
sscs list -d j4400_test fru Name FRU Alarm State Status Revision Unique Id ----------- ------ ------- ------ -------- ------ ---------- Disk.00 Disk - Enabled OK 0B92 0751S371QV 3 LN371QV Disk.01 Disk - Enabled OK 0B92 0751S3B1DC 3 LN3B1DC Disk.02 Disk - Enabled OK 0B92 0749S374JE 3 LN374JE sscs list -d j4400_test -s fru Disk.00 Availability : Running/Full Power Capacity : 146GB Caption : disk Enabled State : Enabled Firmware : 0B92 Host Path : camtest99:/dev/rdsk/c3t97d0p0 Id : disk00. 0751S371QV 3LN371QV IdentifyingNumber : 0751S371QV 3LN371QV Model : ST314655SSUN146G Name : disk00. 0751S371QV 3LN371QV Physical ID : disk00. 0751S371QV 3LN371QV Product Firmware Version : 0B92 Product Name : SEAGATE ST314655SSUN146G Revision Level : 0B92 SAS Address : 50:00:C5:00:07:BB:59:65 Serial Number : 0751S371QV 3LN371QV Speed : 3G Status : OK Type : SAS Valid SUN Disk : TRUE Vendor : SEAGATE sun-mgmt-data-host : 10.9.178.47 sun-mgmt-data-host-name : camtest99
Lists job IDs and status associated with the specified array and optionally specified job ID. NOTE: This command does not apply to JBOD arrays.
list -a <array-name> jobs [<job-id[,job-id...]>]
Lists job IDs and status associated with the specified array and optionally specified job ID.
-a,--array <array-name>
Specifies the name of the array.
jobs [<job-id[,job-id...]>]
Specifies the job’s identifier. If one or more job IDs are given, this option lists detailed information on the jobs. If no job ID is given, this option lists summary information on all jobs.
sscs list -a array01 jobs
Job ID: job-ID Status: job-status
Job ID: job-ID Type: job-type Status: Pending | In Progress % Complete: complete Time to Completion: time-to-complete or Unknown Priority: priority Volume: volume-name
Lists the user-initiated actions performed for all registered arrays.
NOTE: This command is not valid for any JBOD array.
list [ -s { [ mmdd ] HHMM | mmddHHMM [ cc ] yy } [ .SS ] ] [ -f { [ mmdd ] HHMM | mmddHHMM [ cc ] yy } [.SS ] ] [ -t <number-of-messages> ] log
Lists the user-initiated actions performed for all registered arrays. You can filter the listings by date and time or most recent entries. If you do not specify any options, all log messages are displayed.
-s,--start { [ mmdd ] HHMM | mmddHHMM [ cc ] yy } [ .SS ]
Lists all log messages starting at the date specified by the date options. Use with the -f,--finish subcommand to specify a date range.
-f,--finish { [ mmdd ] HHMM | mmddHHMM [ cc ] yy } [ .SS ]
Lists all log messages ending at the date specified by the date options. Use with the -s,--start subcommand to specify a date range.
mmdd
Specifies the month and day. For example, 0331 for March 31.
HHMM
Specifies the hour and minute. The hour is based on a 24-hour clock. For example, 1:30 p.m. is 1330.
cc
Specifies the century part of the year.
yy
.SS
Specifies the seconds of the hour.
-t,--tail <number>
Lists the most recent log messages as specified by number.
sscs list -t 100 log
Timestamp:message
list mgmt-sw
Lists the management software application that you are logged into.
sscs list mgmt-sw
Application Name: “Sun StorageTek(TM) Common Array Manager” User: storage Current Logins: 2 Server: 10.8.88.173 Server OS: SunOS Server OS Version: 5.10 Product Version: 4.2.0.0 Build Date: 2005/12/03 Install Info: 4.2.0.0 Build 61 Critical Alarms: 13 Down Alarms: 0 Major Alarms: 24 Minor Alarms: 0
list notification
Lists the remote notification provider and its status.
sscs list notification
Email Configuration SMTP Server for Email : server SMTP Server User Name : user-name SMTP Server Password : password Use Secure SMTP Connection : true | false Email Address of Sender : email-address Maximum Email Size MB : size-in-megabytes Email Entries Entry Email/Events Type Device Priority Events entry-no email-address notification-type device-type priority events Active active-flag SNMP Trap Configuration Notifier State : Enabled | Disabled SNMP Trap Entries ID IP Name/Address Port Minimum Alert Level trap-id ip-address port trap-level
Lists registered array information.
list [ -a <array-name[,array-name...]> ] registeredarray
Lists registered array information or the names of all arrays.
-a,--array <array-name[,array-name...]>
Specifies the registered array or arrays to list. If no arrays are specified, a list of all array names is provided.
sscs list registeredarray Array: array01 Array: array02 Array: j4400_test Array: j4500_test2 sscs list -a array01 registeredarray Array: array01 IP Address: 10.80.194.32 IP Address: 10.80.194.33
list site
Lists pertinent information for the installation site.
sscs list site *Company Name : Sun Microsystems *Site Name : Interop Lab Address : Address 2 : Mail Stop : *City : Broomfield State : Zip Code : *Country : USA *Contact First Name : Fred *Contact Last Name : Jones Telephone Number : Extension : *Contact Email : Fred.Jones@sun.com
Lists detailed information about one or more arrays.
list storage-system [<array-name[,array-name...]>]
Lists detailed information about one or more arrays. If you do not specify an array name, then all array names are listed.
storage-system [<array-name[,array-name...]>]
If no array names are specified, all array names are listed. If array names are specified, details for those arrays will be listed.
sscs list storage-system
Summary of arrays when no <array-name> value is specified
Array: array-name ... Array: array-name
Detail of array when the <array-name> value is specified
./sscs list storage-system j4400_test Name: j4400_test ID: j4400_test Type: J4400 Version: 3R21 Vendor: SUN Microsystems Model: Sun Storage J4400 Capacity: 3.074 TB
Lists the user name and role defining the user’s array privileges.
list userrole [ <storage | guest> ]
Lists the user name and role defining the array privileges.
userrole storage | guest
List the users with the specified role. The storage role allows write access so that the user can configure the array. The guest role can only monitor the array.
sscs list userrole storage
User Name: user-name User Role: user-role ... User Name: user-name User Role: user-role
Log in to the sscs command-line interface (CLI).
login -h <host-name> [ -s CAM | Legacy ] [ -t ] [ -f ] [ -u <user-name> ]
Log in to the sscs command-line interface (CLI) on the management system specified by the -h <host-name>. This command starts a CLI session on the management host.
There are two versions of the CLI:
The local CLI requires a user to run the command as administrator from a shell on the management host. Because of this limitation, the login and logout commands are not supported.
Both CLI versions can manage any array that has been registered and added to the Common Array Manager inventory. The array type and array management path (in-band, out-of-band, proxy agents) has no limitations with local or remote CLI usage. Both CLIs manage the same arrays with the same command set.
The following explains how to log in to and out of the management host using the CLI. The options for accessing the CLI are presented in the next section.
There are different CLI directories for the remote and local CLIs.
1. Telnet or ssh to the CAM workstation.
ssh root@cam_workstation1
2. Change to the CLI directory (varies by operating system).
a. Access the remote CLI directory:
3. Log into the remote CLI by typing the following command:
% sscs login -h <host-name> -u <user-name>
| Note - The Local CLI on a data host does not require the login command. You will need the terminal window login to the host. |
b. Access the local CLI directory:
NOTE: sscs has an inactivity timer. The session terminates if you do not enter any sscs commands for 30 minutes. You must log in again before you can enter a command after the timeout.
-h,--hostname <host-name>
Required. Specifies the management host name.
-s,--system-type CAM | Legacy
This option specifies whether you are logging into any of the current arrays supported by the Common Array Manager or the now legacy 6920 array. In some cases, using the -s CAM option may log you in faster as it skips a step of listening for a response from the legacy array.
You no longer have to specify the system type to login.
-t,--http
Enables you to use the HTTP protocol to connect to the CAM server, instead of HTTPS. An HTTP connector is configured in Tomcat, the servlet container in Java, for the Java Web Console at port 6789. If SSL is not functioning between the client and the server, this might be required.
-f,--force
Exists for backward compatibility with legacy management applications that only allow one login per user. This option forces a login to the management host. If another user with the same user name is already logged on, the duplicate user is then logged off.
-u,--username <user-name>
Specifies the user name to log in.
./sscs login -h localhost -u root
logout
Logs out of the remote sscs command-line interface session. This command is not supported with the local version of the CLI.
./sscs logout
Modify the fault management agent parameters.
modify [ -a ] [ -d ] [ -r ] [ -i <integer> ] agent [<agent-id>[,agent-id...]]
Modify the fault management agent parameters. Fault Management Service (FMS) periodically scans devices for new messages and updated health status. This command allows changing the scan interval as well as enabling or disabling the scan. If no options are given the current agent settings are printed out.
-a,--activate
Specifies that the system activate the monitoring agent.
-d,--deactivate
Specifies that the system deactivate or turn off the monitoring agent.
-r,--run
Specifies that the system schedule the agent to run either immediately or as soon as the currently scheduled run has finished.
-i,--interval <integer>
Specifies the interval, in minutes, before the agent scan runs.
agent [<agent-id>[,agent-id...]]
Specifies the agent that you want to modify. The name of the agent monitoring the device can be retrieved using the list device command
sscs modify -i 5 agent
modify -N <new-array-name> array <array-name>
Modifies the name assigned to the array.
| Note - Refer to the modify array command in Chapter 4 for the extensive configuration options that apply to arrays with RAID controllers. |
-N,--new-name <new-array-name>
Specifies the new name of the array.
array <array-name>
Specifies the name of the array to be modified.
sscs modify -N array2 array jbod1
Modifies the firmware versions of the specified field-replaceable units (FRUs) of the specified array, and installs the CAM baseline firmware or user-provided firmware image to the FRUs in the device.
modify -a <array-name> [ -f ] [ -o ][ -t ctrl | iom | disk | system | sim | expander ] [ -x ctrl | iom | disk | system | sim | expander ] [ -p <path> ] [ -c <field-name> ] [ -w ] firmware
Modifies the firmware versions of the specified field-replaceable units (FRUs) of the specified array, and installs the CAM baseline firmware or user-provided firmware image to the FRUs in the device.
-a,--array <array-name>
Modifies the firmware revision level of the specified field-replaceable units for the specified array only.
-c,--component <field-name>
Modifies the firmware for the selected components. To get the valid values, execute the sscs list -a <array-name> firmware command. Values for either the Name or Model fields can be used in place of <field-name>. If a Name value is used, only the given component will be modified. If a Model value is used, all components with the given model name will be modified.
| Note - NVSRAM does not have a component name or model name. Use
-c system to install or modify NVSRAM firmware. This note is not applicable to JBOD arrays. |
-f,--force
Modifies the firmware revision level of the all field-replaceable units even if the firmware revision level is already at the baseline level.
-o,--offline
Specifies to allow installation of firmware to FRU components excluded from installation by default. Certain FRU component types (such as disk drives, SIMs, and expanders) require I/O operations to stop before a firmware installation. As a precaution, these components are excluded from the firmware installation by default. To install firmware on these component types, stop all I/O operations on these components and use this option.
-p,--path <path>
Specifies the path of the firmware image file. Loads firmware from a file directly onto the array. Caution should be exercised when using this command because unsupported firmware can be loaded onto a field-replaceable unit. If -p option is provided, the -c option is required. The file path of the firmware image file must be specified when using the -p option.
| Note - If the -p option is not specified, this command will default to the CAM baseline firmware image. |
-t,--type ctrl | iom | disk | system | sim | expander
Modifies the firmware revision level of the field-replaceable units of the specified type only. The -t option can be used multiple times in the same command. NOTE: ctrl, system, and iom do not apply to JBOD arrays.
-w,--no-warn
Modifies the firmware without displaying the standard warning.
-x,--exclude ctrl | iom | disk | system | sim | expander
Excludes the specified component type from the firmware install. The -x option can be used multiple times in the same command. NOTE: ctrl, system, and iom do not apply to JBOD arrays.
modify -a MyArray -f firmware
modify -X <array-name> mgmt-sw
Stores the specified storage system name for the session. This command is useful for repeated operations with an array. After this command is executed, the -a option for subsequent sscs commands is not necessary.
-X,--storage-system <array-name>
Specifies the name of the storage system.
modify -X MyArray mgmt-sw
Change the locally stored password for a registered array.
modify -a <array-name> -q registeredarray
Modifies the locally stored password for a registered array or queries for the current password.
-a,--array <array-name>
Specifies the name of the array to be modified.
-q,--query-for-password
Queries for the current password for the registered array.
sscs modify -a array00 -q registeredarray New Password: myregisteredarray Re-enter New Password: myregisteredarray
Modifies the site properties for this instance of CAM.
modify [-r <site-info[,site-info...]>] site [<site-info=-value[,site-info=value...]>]
Modifies the site properties for this instance of CAM. The site properties contain information needed for notification providers. Upon command execution, updated site information is displayed.
-r,--remove <site-info[,site-info...]
Removes the specified site information. Possible values for site-info are: customer, contract, name, address, address2, mailStop, city, state, zip, country, contact, phone, extension, and email.
site [<site-info=value[,site-info=value...]]
Modifies existing site settings or adds new site information. Possible values for site-info are: customer, contract, name, address, address2, mailStop, city, state, zip, country, contact, phone, extension, and email. Possible values for value consist of an alphanumeric string. If the string includes spaces, enclose the values in quotes.
sscs modify site name=”Development Lab” *Company Name : Sun *Site Name : Development Lab Address : Address 2 : Mail Stop : *City : Broomfield State : Zip Code : *Country : USA *Contact First Name : Bob *Contact Last Name : Tester Telephone Number : Extension : *Contact Email : bob.tester@sun.com sscs modify -r name site *Company Name : Sun *Site Name : Address : Address 2 : Mail Stop : *City : Broomfield State : Zip Code : *Country : USA *Contact First Name : Bob *Contact Last Name : Tester Telephone Number : Extension : *Contact Email : bob.tester@sun.com
Modifies the array information.
modify [ -N <new-array-name> ] [ -d <description-text> ] [ -u <user-name> ] [ -q ] [ -U <user-name> ] [ -Q ] storage-system <array-name>
Modifies array information such as array name, description, and user name.
-d,--description <description-text>
Provides a textual description of the array.
-N,--new-name <new-array-name>
-Q,--query-for-device-specific-password
Queries for device-specific password.
-q,--query-for-password
-U,--device-specific-user <user-name>
Specifies to use a device-specific user-name.
-u,--user-name <user-name>
Changes a username on the array.
storage-system <array-name>
Specifies the array where the changes will take effect.
sscs modify -q storage-system MyArray Enter the array password: Confirm password:
Change the user role or the IP address from which the user can log in.
modify -u <user-name> -p <true|false> -i <ANY|IP-address[,IP-address...]> userrole <storage|guest>
Modifies a user role or the IP address from which the user can log in. The storage role can perform configuration changes while the guest role can just monitor an array.
-u,--username <user-name>
Specifies the user name that has an assigned role (storage or guest).
-p,--password-required true | false
Specifies whether to require user login with a password.
-i,--ip-address ANY | <ip-address[,ip-address...]>
Specifies the IP addresses from which the user can log in. You can let the user log in from anywhere or restrict access to specified IP addresses.
userrole storage | guest
Specifies the role assigned to the user.
sscs modify -u bsmith -p true -i ANY userrole guest
register -i <ip-address> [ -s <array-name> ] [ -p <port-id> ] [ -u <user-name> ] [ -q ] [ -U <user-name> ] [ -Q ] storage-system register -d storage-system
Registers a storage system with the host.
-d,--discover
Specifies that the host will discover a registered array.
-i,--ipaddress <ip-address>
Specifies the IP address of the storage system that you want to register.
-p,--port <port-id>
Specifies the port ID of the storage system that you want to register.
-s,--set-name <array-name>
-u,--user storage | root | guest
Specifies the user name that has an assigned role.
-q,--query-for-password
Specifies whether to query for a password for this registered storage system.
-U,--device-specific-user <user-name>
Specifies a specific name for this device.
-Q,--query-for-device-specific-password
Specifies whether to query for a specific password for this registered device.
Registers CAM software and all monitored arrays with Auto Service Request.
register [ -u <sun-online-account-username> ] [ -H <proxy-host-name> ] [ -P <proxy-port-number> ] [ -U <proxy-username> ] [ -t ] sun-connection
Registers CAM software and all monitored arrays with Auto Service Request. Auto Service Request monitors the array system health and performance and automatically notifies the Sun Technical Support Center when critical events occur. Critical alarms generate an Auto Service Request case. The notifications enable Sun Service to respond faster and more accurately to critical on-site issues. All newly discovered arrays will also be registered with the saved registration options.
-H,--proxyHost <proxy-host-name>
Specifies the proxy host name.
-P,--proxyPort <proxy-port-number>
Specifies the proxy port number.
-t,--testMessage
Specifies to send a test message using the current settings.
-U, --proxyUser <proxy-username>
A proxy host authenticated user name.
-u,--user <sun-online-account-username>
Specifies a valid Sun online account user name. To get one, go to: https://portal.sun.com/portal/dt/
sscs register -H Proxy1 -P 8080 -u MySunAcctId sun-connection
remove [-s <0|1|2|3>] [-f <device-type>] [-A] alarm [<alarm-ID[,alarm-ID...]>]
-f,--faultdevtype <device-type>
Removes alarms by the device type using a device key filter.
-s,--severity 0 | 1 | 2 | 3
Specifies the severity level for which you want to remove alarms.
-A,--All
alarm [<Alarm-ID[,Alarm-ID...]>]
Specifies the alarm ID or alarm IDs you want to remove.
sscs remove -f 6140 alarm sscs remove -s 2 alarm sscs remove -A alarm
Removes a local or remote notification.
remove [-e <email-address[,email-address...]>] notification local_email | email-filter | trap remove [-i <IP-address>] [-o <port-id>] [-t 1 | 2 | 3 | 4 | 5 ] notification local_email | email-filter | trap remove -d <array-name[,array-name...]> notification local_email | email-filter | trap
Removes a local or remote notification.
-d, --id <array-name[,array-name...]>
Removes the specified device ID notification.
-e,--email <email-address[,email-address...]>
Stops notifications to the specified recipient.
-i, --ip <IP-address>
Stops sending SNMP trap data to the IP address of the specified host.
-t,--trapnumber 1 | 2 | 3 | 4 | 5
Stop notifications for the specified trap number.
-o,--port <port-id>
Specifies the port ID used to transfer notifications.
local-email
Removes the notification from your local email address.
email-filter
Removes the email filter from the notification.
trap
Removes the SNMP trap notification.
sscs remove -e john.doe@address.com notification local_email sscs remove -t 2 notification trap
Removes one or more arrays from the list of registered arrays.
remove -a <array-name[,array-name...]> registeredarray
Removes one or more arrays from the list of registered arrays.
-a,--array <array-name[,array-name...]>
Specifies the registered arrays to remove.
sscs remove -a array00 registeredarray
Removes a user role assigned to a user name.
remove -u <user-name[,user-name...]> userrole <storage|guest>
Removes the privileges (storage or guest role) assigned to a user name.
-u,--username <user-name[,user-name...]>
userrole storage | guest
Specifies the user’s role to remove.
sscs remove -u jf39992 userrole guest
Tests connectivity to a specified array (inband communication test).
service -a <array-name> contact
Tests connectivity to a specified array (inband communication test).
-a,--array <array-name>
Specifies the array to which connectivity is tested.
sscs service -a j4400_test contact Executing the contact command on j4400_test Completion Status: Success
Disables a target drive in a specified array.
service -a <array-name> -t <fru-name> disable
Disables a target drive in a specified array.
-a,--array <array-name>
Specifies the array containing the target drive to disable.
-t,--target <fru-name>
Specifies the name of the field-replaceable unit to disable. This parameter needs to be set to either the FRU name or the FRU ID, both of which can be obtained using variations of the list fru command. See list fru for further details.
sscs service -a j4400_test -t Disk.00 disable
Enables a target drive in a specified array.
service -a <array-name> -t <target-fru-name> enable
Enables a target drive in a specified array.
-a,--array <array-name>
Specifies the array containing the target drive to enable.
-t,--target <target-fru-name>
Specifies the name of the field-replaceable unit to enable. This parameter needs to be set to either the FRU name or the FRU ID, both of which can be obtained using variations of the list fru command. See list fru for further details.
service -a j4400_test -t Disk.00 enable
Turns on the locator LED for an array, drive, or tray.
service -a <array-name> [ -t <target-fru-name> ] [ -o ] locate
Identifies the array, drive, or tray whose locator LED will be turned on.
-a,--array <array-name>
Specifies the array whose locator LED will be turned on, or the array containing a specified target FRU.
-t,--target <target-fru-name>
Specifies the name of the field-replaceable unit whose locator LED will be turned on. This parameter needs to be set to either the FRU name or the FRU ID, both of which can be obtained using variations of the list fru command. See list fru for further details.
-o,--off
Specifies to turn off the locate LED.
Turn on the locate LED for a specified array:
service -a j4500_rocky locate
Turn on the locate LED for a target disk in a specified array:
service -a j4500_rocky -t Disk.00 locate
Turn off the locate LED for a target disk in a specified array:
service -a j4500_rocky -t Disk.00 -o locate
Prints physical information available for a specified array.
service -a <array-name> -t arrayprofile print
Prints the contents of the array profile for a specified array.
-a,--array <array-name>
Specifies the array for which information is printed.
-t,--target arrayprofile
Specifies a target file to print.
Print the specified array’s profile:
service -a j4500_rocky -t arrayprofile print
Changes the name of a specified array.
service -a <array-name> set name=<new-array-name>
Changes the name of a specified array.
-a,--array <array-name>
Specifies the array for which you want to change the name.
Change array name from array_bob to array_steve:
sscs service -a array_bob set name=array_steve
Unregisters an array from the list of registered storage systems.
unregister storage-system <array-name[,array-name...]>
Unregisters an array from the list of registered storage systems.
storage-system <array-name[,array-name...]>
Specifies the storage system or systems that you want to unregister from the list of registered storage systems.
sscs unregister storage-system array19
Stops notifications of system health and performance to Sun using the Auto Service Request (ASR) feature.
unregister sun-connection
Unregisters CAM software and all monitored arrays from Auto Service Request (ASR) which monitors the array system health and performance and automatically notifies the Sun Technical Support Center when critical events occur. Newly discovered arrays will not be registered with the saved registration options.
sscs unregister sun-connection
Shows the version of the CAM software that you are running on the management host, the version of the SSCS client, or the version of the pclient.
-V,--version
If running the remote CLI, shows the version of the CAM software that you are running on the management host and the version of the SSCS client. If running the local CLI, only the version of the current CAM installation will be shown.
-v
If running the remote CLI, shows the version of the pclient. Not valid with the local CLI.
Shows the version of the CAM software that you are running on the management host, the version of the SSCS client, or the version of the pclient.
sscs -V Sun StorageTek(TM) Common Array Manager v6.3.0.12 sscs client v2.1.4 sscs -v $Id: pclient.c,v 1.1 2007/03/24 18:55:51 wf142404 Exp $
| Sun StorageTek Common Array Manager CLI Guide | 821-0132-10 |
|
Copyright © 2009 Sun Microsystems, Inc. All rights reserved.