C H A P T E R  5

Software Management Tools

This chapter describes the software management tools used for monitoring and managing the Sun StorEdge 3120 SCSI array. Topics include the following:



Note - For other supported software, see the Release Notes for your array.




5.1 Overview of Provided Software

This section describes the software management tools available for monitoring and managing the Sun StorEdge 3120 SCSI array with in-band connections.

The following software management tools are provided on the Sun StorEdge 3000 Family Software and Documentation CD for your array.

For details on how to install Sun StorEdge Configuration Service, Sun StorEdge Diagnostic Reporter, or the Sun StorEdge CLI software, refer to the Sun StorEdge 3000 Family Software Installation Manual.


5.2 Monitoring with Sun StorEdge Configuration Service

Sun StorEdge Configuration Service supports standalone JBOD arrays. However, because the Sun StorEdge 3120 SCSI array does not have a RAID controller or RAID controller firmware to manage the disks, this software support is limited to enabling JBOD support and viewing component and alarm characteristics.

See Section 5.2.2, Viewing Component and Alarm Characteristics.

5.2.1 Enabling JBOD Support

Use JBOD support only when you have a SCSI array connected directly to a host. This enables you to monitor peripheral device condition and events.



Note - Enabling JBOD support may impact I/O performance.



To monitor peripheral device condition and events for a JBOD device from the Sun StorEdge Configuration Service Console, you first must enable JBOD support.



Note - Whenever you choose a command to perform administration or configuration activities in Sun StorEdge Configuration Service, if you are not logged in as ssadmin or ssconfig, you are prompted with a Log In dialog box to change your level of security.



1. Choose View right arrow Agent Options Management.

The Agent Options Management window is displayed.

2. Select the Enable JBOD Support check box.

3. To immediately display the JBOD in the main window, you must probe for new inventory. Choose View right arrow View Server and click Probe.

4. Click OK.

The JBOD is displayed in the main window.

In a single-bus configuration, both ports of the JBOD array are connected to one HBA on the server, as shown in the following example.

  FIGURE 5-1 Single-Bus Configuration

Screen capture showing a single-bus JBOD configuration.

In a split-bus configuration, each port is connected to its own HBA, as shown in the following example. A SCSI Accessed Fault-Tolerant Enclosure (SAF-TE) limitation prevents the main window from showing the drives connected to port A and port B. The program can only monitor the JBOD from the server connected to port B as shown in the following example.

  FIGURE 5-2 Split-Bus Configuration

Screen capture showing a split-bus, dual-server, dual-HBA configuration.


Note - In a split-bus configuration, if each port is connected to a different server, the program can only monitor the JBOD from the server connected to port B. SAF-TE information is not displayed for port A.



5.2.2 Viewing Component and Alarm Characteristics

In Sun StorEdge Configuration Service, to view environmental component and alarm characteristics, use the View Enclosure window or, for some components, the main window.

You can also view environmental and drive components using the Sun StorEdge CLI show enclosure-status command. For details, see Section 5.4, Monitoring with the Sun StorEdge CLI.

Main Window

In the main window, device states are color-coded and symbol-coded so that it is easy to identify when a device is in a state that requires attention. The status is propagated along the device tree, enabling you to trace a failure down to the device level. See TABLE 5-1 for device status details.

TABLE 5-1 Device Status State

Color

Symbol

State

Purple

None

The group, server, or device is online.

White

None

The user has not logged into this server.

Yellow

 

 Degraded icon

One or more components of this group or server are not working properly, but the array is still functional.

Red

 

 Critical icon

One or more components of this group or server are not working. For instance, a disk drive failure or an enclosure with a failed fan would warrant a critical state icon.

Gray

 

 Unresponsive icon

The group, server, or device is unresponsive.


To view the cause of a critical or degraded device status, review the event log. For details on the event log, refer to the Sun StorEdge 3000 Family Configuration Service User's Guide.

View Enclosure Window

The View Enclosure window displays the component and alarm characteristics for a JBOD device. The window displays the status for environmental components including the fan, power supply, and temperature sensor.

To view the environmental component and alarm characteristics of a SCSI array from the Sun StorEdge Configuration Service Console, perform the following steps.

1. Select the event monitoring unit (EMU) iconEMU icon.

2. Choose View right arrow View Enclosure.

To display FRU ID information, click View FRU.

  FIGURE 5-3 View Enclosure Dialog Box

Screen capture showing the View Enclosure dialog box.


5.3 Event Messages from the Sun StorEdge Diagnostic Reporter

Sun StorEdge Diagnostic Reporter supports standalone JBOD arrays. However, triggered event notification is limited to environmental and hard drive failures. Refer to the Sun StorEdge 3000 Family Diagnostic Reporter User's Guide for more information.


5.4 Monitoring with the Sun StorEdge CLI

The Sun StorEdge CLI supports JBOD arrays. However, because JBOD arrays do not have a RAID controller or RAID controller firmware to manage the disks, this CLI support is limited to the following commands:

about

Description

The about command displays version and copyright information.

Syntax

about

Examples

The following example shows the about text for the CLI.

sccli> about
Sun StorEdge 3000 Family CLI
Copyright 2002-2005 Dot Hill Systems Corporation.
All rights reserved. Use is subject to license terms.
sccli version 2.1.0
built 2005.07.07.15.56
build 17 for solaris-sparc

exit

Description

The exit command exits the interactive mode. You can also use the quit command to exit the CLI.

Syntax

exit

help

Description

The help command displays a short synopsis of the available commands.

Syntax

help [command]

If no command is specified, basic usage information is displayed.

Examples

The following example shows the help text for the show channels command.

sccli> help show channels
  show channels
        display channel configuration

quit

Description

The quit command exits the interactive mode.You can also use the exit command to exit the CLI.

Syntax

quit

select

Description

The select command selects a new device to which subsequent commands are issued. If no device is specified, and more than one choice exists, a menu of choices is displayed. This command should not be used on the command line because a select command is implicitly done if no device name is specified.

Syntax

select device

Examples

The following command selects an in-band SCSI JBOD device.

sccli> select /dev/es/ses0
sccli: selected device /dev/es/ses2 [SUN StorEdge 3120 D SN#00029F]

set led

Description

The set led command changes the drive LED for the specified disk (or slot) from green to amber. For Sun StorEdge 3120 SCSI JBODs, specify a disk device using a Solaris device name such as sd31 or c1t0d0s2, or specify a slot number. Use the show led-status command to show the status of the identified disk drive.



Note - Selecting a slot by disk name is not supported in split-bus enclosure configurations because the enclosure services processor resides on only one of the internal buses and the CLI might not be able to determine the slot location of a particular device. In such configurations, use the show enclosure-status command and the disk documentation provided with your enclosure to determine the correct slot number instead.



Syntax

To change a specific drive LED from green to amber, use the following syntax.

set led {slot n | disk sdn | disk cXtYdZ} {on | off}

Arguments

TABLE 5-2 Arguments for set led

Argument

Description

slot n

Changes the drive LED from green to amber for the specified disk drive slot.

disk sdn

Changes the drive LED from green to amber for the specified Solaris disk drive slot.

disk cXtYdZ

Changes the drive LED from green to amber for the specified Solaris disk drive slot.

{on | off}

Specify whether to change the LED from green to amber.


Examples

In the following example, the LED adjacent to the drive with SCSI address 3 in the enclosure changes from green to amber:

sccli> set led slot 3 on
 (enclosure sn 006498) led-slot-3: on

show access-mode

Description

The show access-mode command displays whether the communication mode being used to manage the device is FC/SCSI channels (inband) or an Ethernet connection (out-of-band). Returned values include inband and out-of-band.



Note - If inband management access has been disabled by Sun StorEdge CLI or Sun StorEdge Configuration Service (SSCS), and a user attempts to use inband management, the message "RAID controller not responding" displays when a command is run.



Syntax

show access-mode

Examples

The following example shows the CLI communication mode is inband.

sccli> show access-mode
 access-mode: inband

show configuration

Description

The show configuration command displays the array configuration including inquiry information, FRU information, SCSI Accessed Fault-Tolerant Enclosure (SAF-TE) device information, access mode, and enclosure status which includes the status for the fan, power supply, temperature sensor, and drive slots. The configuration can be displayed onscreen, or written to the specified file. The output is plain text by default, but XML output may be obtained by specifying the --xml option.

Syntax

show configuration [--xml | -x] [filename]

Arguments

TABLE 5-3 Arguments for show configuration

Argument

Description

{--xml | -x}

If the -x or --xml options are specified, XML output is generated.

filename

Specify the filename for the configuration file that you want to show.


Examples

The following example writes the configuration information to the myconfig.xml file.

# sccli c2t0d0 show configuration --xml myconfig.xml

The following example shows a portion of the JBOD configuration.

sccli> show configuration
 
* inquiry-data
 
 Vendor: SUN
 Product: StorEdge 3120  D
 Revision: 1170
 Peripheral Device Type: 0x3
 Serial Number: 0064CA
 Page 80 Serial Number: 0064CA
 Device Type: Enclosure
 
* safte-devices
 
 Id  Chassis  Vendor  Product ID        Rev   Package
------------------------------------------------------
  5  0064CA   SUN     StorEdge 3120  D  1170  1170
 
* enclosure-status
 
 Id  Chassis  Vendor  Product ID        Rev   Package   Status
--------------------------------------------------------------
  5  0064CA   SUN     StorEdge 3120  D  1170  1170      OK
 
Enclosure Component Status:
     Type Unit Status   FRU P/N   FRU S/N   Add'l Data
--------------------------------------------------------------
      Fan 0    OK       370-6193  901763     --
      Fan 1    OK       370-6193  901757     --
       PS 0    OK       370-6193  901763     --
       PS 1    OK       370-6193  901757     --
     Temp 0    OK       370-6195  0064CA     temp=30
     Temp 1    OK       370-6195  0064CA     temp=30
     Temp 2    OK       370-6193  901763     temp=28
     Temp 3    OK       370-6195  0064CA     temp=30
     Temp 4    OK       370-6195  0064CA     temp=30
     Temp 5    OK       370-6195  0064CA     temp=30
     Temp 6    OK       370-6193  901757     temp=30
 DiskSlot 0    OK       370-6195  0064CA     addr=8,led=off
 DiskSlot 1    OK       370-6195  0064CA     addr=9,led=off
 DiskSlot 2    OK       370-6195  0064CA     addr=10,led=off
 DiskSlot 3    OK       370-6195  0064CA     addr=11,led=off
 
Enclosure SCSI Channel Type: single-bus
...

Returned Values

Enclosure status values include:

Status

Description

OK

This component has a status of OK.

Absent

This component is absent.

Fault

The component is exhibiting a fault condition.

Unknown

This component status is not available.


show enclosure-status

Description

The show enclosure-status command shows the status for all chassis components including SCSI Accessed Fault-Tolerant Enclosure (SAF-TE) revision number and status information, fan, power supply, temperature sensor, and drive slot status.



Note - In split-bus configurations on SCSI devices, half the drives display a status of Unknown. The drives are present, but because of a SAF-TE design limitation, the information does not display.



Syntax

show enclosure-status

Examples

The following example shows the enclosure status for a Sun StorEdge 3120 SCSI device.

sccli> show enclosure-status
 Id  Chassis  Vendor  Product ID        Rev   Package   Status
--------------------------------------------------------------
  5  0064CA   SUN     StorEdge 3120  D  1170  1170      OK
 
Enclosure Component Status:
     Type Unit Status   FRU P/N   FRU S/N   Add'l Data
----------------------------------------------------------------
      Fan 0    OK       370-6193  901763     --
      Fan 1    OK       370-6193  901757     --
       PS 0    OK       370-6193  901763     --
       PS 1    OK       370-6193  901757     --
     Temp 0    OK       370-6195  0064CA     temp=30
     Temp 1    OK       370-6195  0064CA     temp=30
     Temp 2    OK       370-6193  901763     temp=28
     Temp 3    OK       370-6195  0064CA     temp=30
     Temp 4    OK       370-6195  0064CA     temp=30
     Temp 5    OK       370-6195  0064CA     temp=30
     Temp 6    OK       370-6193  901757     temp=30
 DiskSlot 0    OK       370-6195  0064CA     addr=8,led=off
 DiskSlot 1    OK       370-6195  0064CA     addr=9,led=off
 DiskSlot 2    OK       370-6195  0064CA     addr=10,led=off
 DiskSlot 3    OK       370-6195  0064CA     addr=11,led=off
 
Enclosure SCSI Channel Type: single-bus

Returned Values

The following table describes the location of the enclosure devices from the back of the array orientation as shown in the following figure.

  FIGURE 5-4 Enclosure Device Orientation

Figure showing the location of fans and power supplies.

The returned values for the Sun StorEdge 3120 SCSI array are described in the following table.

TABLE 5-4 Output for the show enclosure-status command

Enclosure Types

Description

fan 0

Left side power supply fan

fan 1

Right side power supply fan

PS 0

Left side power supply

PS 1

Right side power supply

Temp 0

Left drive temperature sensor

Temp 1

Center drive temperature sensor

Temp 2

Temperature sensor on left side power supply module (Power supply 0 in FIGURE 5-4)

Temp 3

Temperature sensor on left side I/O module

Temp 4

Temperature sensor on right side I/O module

Temp 5

Right drive temperature sensor

Temp 6

Temperature sensor on right side power supply module (Power supply 1 in FIGURE 5-4)

Disk Slot 0-3

Disk slot identifier refers to the backplane FRU to which disks are connected


Enclosure status values include:

Status

Description

OK

This component has a status of OK.

Absent

This component is absent.

Fault

The component is exhibiting a fault condition.

Unknown

This component status is not available.




Note - The Enclosure SCSI Channel Type values include single-bus and split-bus. Throughout the documentation and the CLI, the term "split-bus" is interchangeable with the term "dual-bus." For details on configuring an array, see Section 4.6, Connecting Sun StorEdge 3120 SCSI Arrays to Hosts.



show frus

Description

The show frus command displays field-replaceable units (FRU) ID information for JBODs, including dynamic FRU status information. All FRU information is retrieved from the SCSI Accessed Fault-Tolerant Enclosure (SAF-TE) device.

Syntax

show frus

Examples

The following example returns all FRU information in a JBOD unit:

# sccli /dev/es/ses2 show frus

The following example shows a partial list of the FRUs in a Sun StorEdge 3120 SCSI device:

sccli> show frus
3 FRUs found in chassis SN#006498
 Name: JBOD_CHASSIS_BKPLN
 Description: SE3120 JBOD Chassis
 Part Number: 370-6195
 Serial Number: 006498
 Revision: 01
 Manufacturing Date: Thu Jan 15 07:33:19 2004
 Manufacturing Location: Milpitas California, USA
 Manufacturer JEDEC ID: 0x0301
 FRU Location: 1U SCSI JBOD MIDPLANE SLOT
 Chassis Serial Number: 006498
 FRU Status: OK
 
 Name: AC_POWER_SUPPLY
 Description: SE3120 AC PWR SUPPLY/FAN MOD
 Part Number: 370-5638
 Serial Number: 000236
 Revision: 01
 Manufacturing Date: Tue Jul  8 22:14:33 2003
 Manufacturing Location: Irvine California, USA
 Manufacturer JEDEC ID: 0x048F
 FRU Location: 1U AC PSU SLOT #0 (LEFT)
 Chassis Serial Number: 006498
 FRU Status: OK
 
 Name: AC_POWER_SUPPLY
 Description: SE3120 AC PWR SUPPLY/FAN MOD
 Part Number: 370-5638
 Serial Number: 000287
 . . . 

Returned Values

The returned status values for the show frus command are described in the following table.

TABLE 5-5 FRU Status Values

Status

Description

OK

All subcomponents of this FRU have a status of OK.

Fault

One or more of the FRU components is exhibiting a fault condition.

Absent

No FRU is located in the device.

N/A

Not applicable.


show inquiry-data

Description

The show inquiry-data command displays the SCSI inquiry data. The output of this command varies from one product to another, and from one channel to another.

Syntax

show inquiry-data



Note - The abbreviation inquiry can be substituted for the keywords show inquiry-data.



Examples

The following example shows an in-band Sun StorEdge 3120 SCSI array inquiry.

sccli> show inquiry-data
 Vendor: SUN
 Product: StorEdge 3120  D
 Revision: 1170
 Peripheral Device Type: 0x3
 Serial Number: 0064CA
 Page 80 Serial Number: 0064CA
 Device Type: Enclosure

show led-status

Description

The show led-status command displays the status of the LED adjacent to the specified disk drive slot in the array enclosure or expansion chassis. Returned values include on and off. If the value is on, the LED of the specified drive is amber. If the value is off, the LED of the specified drive is green if it is working properly.

Syntax

To show the status of LVD JBOD enclosures, use the following parameters:

show led-status {slot n | disk sdn | disk cXtYdZ}

Arguments

TABLE 5-6 Arguments for show led-status

Argument

Description

slot n

Shows the status for the LED adjacent to the specified disk drive slot.

disk sdn

Shows the status for the LED adjacent to the specified Solaris disk drive slot. This argument is not accepted for split-bus chassis.

disk cXtYdZ

Shows the status for the LED adjacent to the specified Solaris disk drive slot. This argument is not accepted for split-bus chassis.


Examples

The following example shows the status of the LED adjacent to the disk assigned to drive slot 3 for an expansion chassis:

sccli> show led-status slot 3
 (enclosure sn 006498) led-slot-3: on

show safte-device

Description

The show safte-device command displays information returned by the SCSI Accessed Fault-Tolerant Enclosure (SAF-TE) device embedded in SCSI LVD RAID enclosures or JBODs.

The output includes the serial number of the chassis in which it is installed, the vendor and product IDs and SAF-TE firmware revision, and the "SAF-TE firmware package" revision, which refers to firmware for other microprocesses in the chassis that are managed by the SAF-TE processor.

Syntax

show safte-device

Examples

The following example shows the SAF-TE device information for a Sun StorEdge 3120 SCSI array.

sccli> show safte-device
 Id  Chassis  Vendor  Product ID        Rev   Package
------------------------------------------------------
  5  0064CA   SUN     StorEdge 3120  D  1170  1170

version

Description

The version command displays the version number of the CLI.

Syntax

version

Examples

In the following example, version 2.1 is displayed.

# sccli version
sccli: selected se3000://199.249.246.28:58632[SUN StorEdge 3120 SN#000187]
sccli version 2.1.0


5.5 Managing Disks in the Sun StorEdge 3120 SCSI Array

Use your standard host system disk management utilities for all disk management in a JBOD array, such as partitioning and formatting. Refer to your host system documentation for more information about disk management.

For maintenance and troubleshooting information, see Chapter 7.


5.6 Enabling VERITAS DMP in a Single-Bus Configuration

The Sun StorEdge 3120 SCSI array supports Veritas Dynamic Multipathing (DMP) software.



Note - For other supported software, see the Release Notes for your array.



To enable VERITAS Dynamic Multipathing (DMP) support on VERITAS Volume Manager Version 3.2, ensure the HBA device SCSI initiator IDs are unique and then start the system. Perform the following steps.

1. Create a single-bus, multi-initiator configuration that links two cables to two different HBAs.

For details about creating a single-bus multi-initiator configuration, see Section 4.6.5, A Single-Bus, Multi-Initiator JBOD Configuration.

2. Stop the server and at the OpenBoottrademark PROM (OBP) Monitor ok prompt, type:

ok setenv auto-boot? false
ok reset-all
ok probe-scsi-all

3. Issue the remaining commands on only one of the paths.

4. Edit or create the nvramrc to set the SCSI-initiator-id to a non-conflicting ID for these devices. The information returned from the probe-scsi-all command identifies the IDs that are currently used and unavailable for assignment.

For more information about ID assignment, see Section 4.6.2, Fixed Drive IDs.

5. From the OBP type:

ok nvedit
0: probe-all install-console banner
1: cd /pci@6,4000/scsi@3 *** your path information here ***
2: 4 " scsi-initiator-id" integer-property
3: device-end
4: banner (Ctrl-c)

6. Store the nvramrc by typing:

ok nvstore

7. Set the system to use the nvramrc and reset auto-boot by typing:

ok setenv use-nvramrc? true
ok setenv auto-boot? true

8. Reset the configuration by typing:

ok reset-all

9. Reboot the hosts. A system reboot is required to implement these changes.



Note - SCSI arrays require a license from VERITAS in order to enable any of its advanced features. Refer to VERITAS Volume Manager Release Notes or contact VERITAS Software Corporation for licensing terms and information.