| Sun StorEdge 3000 Family CLI 1.5 User's Guide |    
|
| Sun StorEdge 3000 Family CLI 1.5 User's Guide |
|
| C H A P T E R 2 |
|
System Function Commands |
This chapter provides the available system function commands with sample code. Topics covered in this chapter include:
The following commands are explained in this section:
The about command displays version and copyright information.
The following example shows the about text for the CLI:
sccli> about Sun StorEdge 3000 Family CLI Copyright 2002 Dot Hill Systems Corporation. All rights reserved. Use is subject to license terms. sccli version 1.5.0 built 2004.01.26.23.49 |
This command exits the interactive mode.
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 inquiry command displays SCSI INQUIRY data returned by the array controller. The output of this command varies from one product to another, and from one channel to another.(Shortcut for show inquiry-data).
The following example shows an out-of-band Sun StorEdge 3510 inquiry:
The following example shows an in-band Sun StorEdge 3510 inquiry:
The quit command exits the interactive mode.
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.
sccli> select c15t0d0 sccli: selected /dev/rdsk/c0t5d0s2 [SUN StorEdge 3310 SN#00028E] sccli> select 199.249.246.28 sccli: selecting se3000://199.249.246.28:58632[SUN StorEdge 3510 SN#000187] |
The version command displays the version number of the CLI.
# sccli version sccli: selected se3000://199.249.246.28:58632[SUN StorEdge 3510 SN#000187] sccli version 1.5.0 |
The following commands are explained in this section:
This command configures the LAN interface, enabling the Telnet, FTP, SNMP, and out-of-band management functions.
For dynamic addressing, use the following syntax:
For static addressing, use the following syntax:
The following dynamic options are accepted:
|
Note - The bootp, rarp, and dhcp options can be combined to specify that multiple protocols be tried in the specified order. |
|
Note - All LAN parameters must be specified on the same command line. |
Alternately, if none of the dynamic options are specified on the same command line, a static IP address can be specified along with optional netmask and default gateway parameters.
|
The netmask, in dotted-decimal format, for example, 255.255.255.0 |
|
The following example configures the controller IP address as 192.168.0.10, netmask as 255.255.255.0, gateway as 192.168.0:
# sccli c2t0d0 configure network-interface lan0 ip 192.168.0.10 netmask 255.255.255.0 gateway 192.168.0.1 |
The following example specifies the DHCP protocol is used to establish an IP address:
Fibre Channel devices only. This command creates a list of Host ID/WWN name entries to associate a symbolic name with a host WWPN. This enables the user to use the symbolic name instead of the numeric WWPN when creating host LUN filters.
The following example creates the alias sun-hba-1 for the HBA WWPN value 210000e08b095562:
Fibre Channel devices only. This command deletes a Host/WWN name entry.
Fibre Channel devices only. This command displays all registered HBA WWNs in the controller for host channels.
The following example shows all host WWN names for the specified device.
# sccli c2t0d0 show host-wwn-names Host-ID/WWN Name -------------------------------------- 210000e08b095562 sun-hba-1 210100e08b295562 sun-hba-2 |
If no host WWN names are defined, a message is displayed, but it is not considered an error.
If a Qlogic HBA is connected to a host channel, the Qlogic HBA WWN is automatically detected by the controller and registered into the table.
If the HBA is another brand, the user must register this HBA WWN to the controller using the RS232 application. Use the serial port of the array to access the firmware. For information about the firmware menus and commands, refer to the RAID firmware user's guide for your product.
This command displays the IP address of the array controller.
|
Note - Before running this command, make sure the network parameters on the controller are set. |
The following example shows the IP address for device c2t0d0:
This command displays the IP address, netmask, and default router address of the network management port.
The following example shows the network parameters for the network management port.
sccli> show network-parameters ip-address: 206.235.238.223 netmask: 255.255.255.0 gateway: 0.0.0.0 mode: static |
Fibre Channel devices only. This command displays FC host channel port WWNs.
The following example shows the port WWNs for the FC host channels.
This command displays the RS232 connection configuration. Returned values include the port number and current band-rate. In a redundant controller configuration, the COM port rate is always the same for both ports. Valid rates include: 2400, 4800, 9600, 19200, 38400, 115200.
The following example shows the band-rate is set to 38400 bps for COM1 and COM2.
The following commands are explained in this section:
LVD SCSI devices only. The show enclosure-status command shows the status for all chassis components including SAF-TE information, fan, power supply, temperature sensor, and drive slot status.
|
Note - In dual-bus configurations, half the drives display a status of Absent. The drives are present, but because of a SAF-TE design limitation, the information does not display. |
The following example shows the enclosure status for a Sun StorEdge 3310 SCSI device.
Disk slots refer to the backplane FRU to which disks are connected.
If the selected device is a RAID subsystem consisting of more than one chassis, the output in the example is repeated for each chassis in the subsystem.
Enclosure status values include:
This command displays field-replaceable units (FRU) ID information for the RAID and any related JBODs, including dynamic FRU status information. All FRU information is retrieved from the SAF-TE device (SCSI unit) or SES (FC unit).
The following example returns all FRU information in the RAID and JBOD unit:
The following example returns all FRU information in the JBOD unit:
The following example shows a partial list of the FRUs in a Sun StorEdge 3310 SCSI device:
|
One or more of the FRU components is exhibiting a fault condition. |
The following commands are explained in this section:
This command restores controller configuration information previously saved in file using the upload controller-configuration file command. A logical drive or logical volume create operation might be required to completely restore the saved configuration. However, creating a logical drive might take a long time, and block other operations. The command provides an option for the user to specify whether to build the logical drive.
|
Note - Optimally, rebuild any logical drives before running this command. |
This command clears the NVRAM configuration memory and restores factory defaults. After issuing this command, reset the controller and reconfigure the controller to restore any non-default configuration options.
|
Caution - Logical devices are not deleted, but it is possible for them to become inaccessible after this command is run. This might result in data loss. |
reset nvram |
|
Note - This command should only be used by Sun support personnel during troubleshooting procedures. |
Fibre Channel devices only. The show bypass device command displays the bypass status of all devices on a specified loop.
If a device is bypassed, the Attributes column displays a code, S, H, or F, that details the bypass. An S means the device was bypassed due to a CLI command. An H means the device was bypassed due to a hardware problem (no signal was present). And, an F means a drive fault caused the bypass.
The following example is sent on channel 2 and shows the bypass information for Loop A.
The following example is sent on channel 3 and shows the bypass information for Loop B.
|
Note - This command should only be used by Sun support personnel during troubleshooting procedures. |
Fibre Channel devices only. The show bypass RAID command displays the hardware bypass status of the RAID controllers on Loop A and Loop B. In a redundant RAID controller system, there is a RAID controller in the top slot of the chassis and a RAID controller in the bottom slot of the chassis. Each RAID controller has a connection to Loop A and Loop B. In a normal redundant RAID controller system, the top and bottom RAID controllers indicate unbypassed status on both loops. If a RAID controller has failed due to natural causes, or has failed as a result of the fail primary or fail secondary command, the show bypass RAID command indicates that the RAID controller is bypassed.
The following example shows the bypass status of the RAID controllers.
sccli> show bypass raid SLOT LOOP BYP-STATUS ---- ---- ---------- TOP LOOP-A Bypassed TOP LOOP-B Bypassed BOTTOM LOOP-A Unbypassed BOTTOM LOOP-B Unbypassed |
|
Note - This command should only be used by Sun support personnel during troubleshooting procedures. |
Fibre Channel devices only. The show bypass SFP command displays the bypass status of all SFPs on a specified loop.
If a device is bypassed, the Attributes column displays a code, S or H, that details the bypass. An S means the device was bypassed due to a CLI command. An H means the device was bypassed due to a hardware problem (no signal was present).
The following example is sent on channel 2 and shows the bypass information for Loop A.
The following example is sent on channel 2 and shows the bypass information for Loop B.
This command displays the array configuration including inquiry information, FRU information, and the enclosure status which includes the status for the SES or SAF-TE device and all chassis components--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 can be obtained by specifying the --xml option. To see a sample XML report, see Show Configuration Command Output.
|
Note - In dual-bus configurations, half the drives display a status of Absent. The drives are present, but because of a SAF-TE design limitation, the information does not display. |
|
Note - FC enclosures can contain two SES processors, and there can be more than one enclosure in a RAID subsystem. |
|
If the -x or --xml options are specified, XML output is generated. |
|
|
Specify the filename for the configuration file that you want to show. |
Configuration values in the report include: inquiry data, network parameters, drive parameters, redundancy mode, cache policy, RS232 configuration, channels, disks, logical drives, logical volumes, partitions, LUN maps, host WWNs (FC only), port WWNs (FC only), intercontroller link (FC only), battery status (FC only), FRUs, SES (FC only), and SAF-TE (SSCI only).
The following example shows a portion of a RAID configuration.
The following example writes the RAID configuration information to the myconfig.xml file.
|
Note - This command should only be used by Sun support personnel during troubleshooting procedures. |
Fibre Channel devices only. The show loop-map command shows the FC loop positional map for a given channel. This information shows the user how the FC devices are connected in the loop. The positional map displays the Arbitrated Loop Physical Address (ALPA) and the SCSI Select ID that corresponds to that ALPA. Use the positional loop map during the diagnostic process to determine which devices to selectively bypass in order to isolate faulty devices.
There can be two RAID controllers on each drive loop. The first device displayed in the loop map is the RAID controller that executes the diagnostics and performs the port bypass operations. Both ALPAs and SCSI Select IDs are displayed. Additional information is also displayed including device type, chassis enclosure ID, and slot number that the device resides in.
|
Specify the drive channel number of the FC port from which the loop map information is to be obtained. Valid values: 0-5. |
|
Note - The channel must be configured as a drive channel and there must be an SES device present on the channel. |
The following example displays the loop map on channel 2.
|
Note - The first line of output in the loop map identifies the primary RAID controller that requested the loop map and that issues any subsequent FC diagnostic commands. |
This command saves a description of the configuration of the array to a user-specified file. The file can be used to restore the same configuration to the array at a later date, or to copy the configuration to another array. The file includes: channel settings, host and drive side parameters, array parameters, network port setup, controller general parameters, logical drive, logical volume, and SCSI drive information, partition information, and mappings on host channels.
|
Note - The file contains binary data and cannot be viewed with a text editor. |
The following example saves the RAID configuration into the binary file, raidcfg.bin:
For details on downloading the controller configuration file, see download controller-configuration file.
The upload nvram command saves the NVRAM configuration to a host file. The binary NVRAM file contains information specific to the host device, such as channel settings, RAID controller parameters, IP address, RAID controller password and name, and unique IDs, and so on. This works for both SCSI and FC arrays.
The following commands are explained in this section:
This command clears the RAID controller event log.
The following example clears the event log for controller c0t5d0s2.
This command displays the contents of the specified RAID controller.
If no option is specified, the command shows all events.
To show the last 10 events for a controller, type:
| Sun StorEdge 3000 Family CLI 1.5 User's Guide | 817-4951-10 |
|
Copyright © 2004, Sun Microsystems, Inc. All rights reserved.
