|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:
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.
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.
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.
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 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 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.
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.
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.
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.
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.
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.
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) icon.
2. Choose View View Enclosure.
To display FRU ID information, click View FRU.
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.
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:
The about command displays version and copyright information.
The following example shows the about text for the CLI.
The exit command exits the interactive mode. You can also use the quit command to exit the CLI.
The help command displays a short synopsis of the available commands.
If no command is specified, basic usage information is displayed.
The following example shows the help text for the show channels command.
The quit command exits the interactive mode.You can also use the exit command to exit the CLI.
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.
The following command selects an in-band SCSI JBOD device.
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.
To change a specific drive LED from green to amber, use the following syntax.
In the following example, the LED adjacent to the drive with SCSI address 3 in the enclosure changes from green to amber:
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.
The following example shows the CLI communication mode is inband.
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.
The following example writes the configuration information to the myconfig.xml file.
The following example shows a portion of the JBOD configuration.
Enclosure status values include:
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.
The following example shows the enclosure status for a Sun StorEdge 3120 SCSI device.
The following table describes the location of the enclosure devices from the back of the array orientation as shown in the following figure.
The returned values for the Sun StorEdge 3120 SCSI array are described in the following table.
Temperature sensor on left side power supply module (Power supply 0 in FIGURE 5-4)
Temperature sensor on right side power supply module (Power supply 1 in FIGURE 5-4)
Enclosure status values include:
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.
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.
The following example returns all FRU information in a JBOD unit:
The following example shows a partial list of the FRUs in a Sun StorEdge 3120 SCSI device:
The returned status values for the show frus command are described in the following table.
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.
The following example shows an in-band Sun StorEdge 3120 SCSI array inquiry.
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.
To show the status of LVD JBOD enclosures, use the following parameters:
The following example shows the status of the LED adjacent to the disk assigned to drive slot 3 for an expansion chassis:
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.
The following example shows the SAF-TE device information for a Sun StorEdge 3120 SCSI array.
The version command displays the version number of the CLI.
In the following example, version 2.1 is displayed.
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.
The Sun StorEdge 3120 SCSI array supports Veritas Dynamic Multipathing (DMP) software.
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 OpenBoot PROM (OBP) Monitor ok prompt, type:
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:
6. Store the nvramrc by typing:
7. Set the system to use the nvramrc and reset auto-boot by typing:
8. Reset the configuration by typing:
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.