This chapter provides the available host, drive, and redundant controller communication (RCCOM) channel commands with sample code.
Note - To prevent unauthorized access to administrative functions of the RAID controller, the Sun StorEdge CLI requires superuser or system administrator privileges for inband access, and uses the controller password to authorize users of the out-of-band interface.
|
Note - If no command is entered on the command line, the Sun StorEdge CLI enters an interactive mode, prompting you to enter commands until the quit command is entered. All commands operate on the currently selected device.
|
Channel Commands
The following commands are explained in this section:
configure channel
Description
The configure channel command configures host, drive, or RCCOM channels and establishes channel IDs on the primary and secondary controller. The most common reason to change a channel setting is to change a host channel to a drive channel to attach expansion units to a RAID array. After a channel configuration change, the RAID controller must be reset.
|
Caution - All reset commands cause the array to stop responding to I/O requests from the host for a period of time. This might result in data loss unless all I/O activity is suspended by halting all applications that are accessing the array, and unmounting any file systems that are mounted from the array. In redundant-controller configurations, these commands affect all LUNs on both controllers. After running a resetcommand, to stay in prompt mode, run the selectcommand to reselect the device.
|
Note - If a primary ID is not mapped to a channel, and a secondary ID is mapped, “Async” displays in the Speed field when the show channels command is run. For details, see show channels.
|
Syntax
configure channel channel [{host|drive|RCCOM}] [primary-id target-list] [secondary-id target-list] [-r | --reset]
|
Arguments
TABLE 4-1 Arguments for configure channel
Argument
|
Description
|
channel channel
|
Specify the physical drive channel. Use the following format: {p}[,..{q}[,....{n}]]. Valid values include 0-5 or 0-7.
|
[host | drive|
RCCOM]
|
Specify whether the channel is used to interface with a host or disk drive, or assigned to RCCOM. If the channel is configured as a host channel, multiple IDs can be applied. However, if the channel is configured as a drive channel, only one ID can be applied.
|
primary-id target-list
|
Specify one or more comma-separated target IDs for the primary controller on the specified channel. Specify None if you do not want to configure a primary ID. primary-id can be abbreviated pid. Valid values: None (no ID configured), 0-15 for SCSI devices, and 0-125 for FC and SATA devices.
|
secondary-id target-list
|
Specify one or more comma-separated target IDs for the secondary controller. Specify None if you do not want to configure a secondary ID. secondary-id can be shortened to sid. Valid values: None (no ID configured), 0-15 for SCSI devices, and 0-125 for FC and SATA devices.
|
[-r | --reset]
|
Specify that the controller reset immediately so that the specified changes take effect. By default, the specified changes do not take effect until a reset controller command is issued.
|
Examples
The following example sets the channel mode as host and resets the controller immediately.
# sccli c2t0d0 configure channel 0 mode host --reset
|
The following example sets the channel primary ID as 112 and the secondary ID as 114 and 115.
# sccli c2t0d0 configure channel 0 primary-id 112 secondary-id 114,115
|
set drive-parameters
Description
The set drive-parameters command sets the specified RAID controller parameters that affect the operation of drive channels. For details about configuring a drive channel, see configure channel.
|
Caution - Do not change the scsi-io-timeoutargument. Setting the timeout to a lower value causes the controller to judge a drive as failed while a drive is still retrying or while a drive is unable to arbitrate the SCSI bus. Setting the timeout to a greater value causes the controller to keep waiting for a drive, and it might cause a host timeout.
|
Syntax
set drive-parameters parameter-name value
|
Arguments
TABLE 4-2 Arguments for set drive-parameters
Argument
|
Description
|
scsi-io-timeout
|
Specify the time interval for the controller to wait for a disk drive to respond. If the controller attempts to read data from or write data to a drive but the drive does not respond within the SCSI I/O timeout value, the drive is considered a failed drive. Valid values: 500ms, 1s, 2s, 4s, 6s, 7s, 8s, 10s, 15s, 20s, 30s (default).
|
spin-up {enabled | disabled}
|
This parameter is reserved and should be used only by qualified technicians.
Specify whether the disk drives are powered up sequentially when the array powers up. When the power supply is unable to provide sufficient current for all physical drives and controllers that are powered on at the same time, spinning-up the physical drives serially requires less current. Valid values: enabled, disabled.
|
disk-access-delay
|
Specify the amount of time that the controller waits before it tries to access the physical drives after power-on. The default value is 15 seconds. Valid values: 0s, 5s, 10s, 15s (default), ...75s (increments of 5 between 0-75).
|
queue-depth
|
Specify the maximum queue depth (tag count) that the controller uses when queuing commands for each disk drive. To indicate that the queue depth value can be computed automatically, specify the value 0. The default value is 32. Valid values: 0 (disable), 1, 2, 4, 8, 16, 32, 64, 128.
|
polling-interval
|
Specify the interval at which the array controller polls the disk drives. The default value is 0 (disabled), which means if there is no activity on the bus, the controller does not know if a drive has failed or has been removed. Setting an interval enables the program to detect a drive failure when there is no array activity; however, performance is degraded. Valid values: 0 (disable), 500ms, 1s, 2s, 5s, 10s, 30s.
|
enclosure-polling-interval
|
Specify the interval at which the array controller polls the SAF-TE or SES environmental services processor in the enclosure. The default value of 0 specifies that polling is disabled. Valid values: 0 (disabled), 50ms, 100ms, 200ms, 500ms, 1s, 2s, 5s, 10s, 20s, 30s, 60s.
|
auto-detect-swap-interval
|
Specify the interval between checks to determine if a failed drive has been physically replaced. The default value of 0 specifies that auto-detecting is disabled. Valid values: 0, 5s, 10s, 15s, 30s, 60s.
|
smart
|
Specify whether the disk drives perform predictive failure (SMART) analysis. Valid values: disabled, detect-only, detect-perpetual-clone, detect-clone-replace.
- Detect-only predicts symptoms of drive failure, but only writes an error message to the controller event log.
- Detect-perpetual-clone detects future problems and clones a spare drive so that it is ready when failure does occur. The spare drive stays mirrored to the source drive (the drive whose failure has been predicted) but does not replace it until the source drive fails.
- Detect-clone-replace detects future problems, clones a spare drive, and immediately uses the cloned drive to replace the source drive whose failure is predicted.
|
auto-global-spare {enabled | disabled}
|
Specify whether the RAID controller automatically allocates disk drives as global spares. When you enable this option, the system automatically assigns a global spare to the unassigned drive with the lowest drive ID. This enables the array to use the global spare to rebuild a logical drive automatically without user intervention when a failing drive needs to be replaced. Valid values: enabled, disabled.
|
Examples
The following example sets the SCSI I/O timeout to 30 seconds.
# sccli c2t0d0 set drive-parameters scsi-io-timeout 30s
|
The following example sets the queue depth to 32 (the default value).
# sccli c2t0d0 set drive-parameters queue-depth 32
|
The following example sets the interval of drive polling to 10 seconds and disables SMART monitoring.
# sccli c2t0d0 set drive-parameters poll-interval 10s smart disabled
|
set host-parameters
Description
The set host-parameters command sets the specified host-channel related parameters including the maximum number of LUNs per target address, queue depth, inband management access, and the FC connection mode (FC and SATA devices only). For details about configuring a host channel, see configure channel.
Note - If inband management is disabled by the Sun StorEdge CLI, the RAID firmware application, or Sun StorEdge Configuration Service, and a user attempts to use inband management, the message “RAID controller not responding” displays when a Sun StorEdge CLI command is run. If this occurs, use out-of-band management to access the RAID controller with the Sun StorEdge CLI. For details, see Device Names for Out-of-Band Communication.
|
Syntax
set host-parameters [queue-depth value] [max-luns-per-id value] [fibre-connection-mode] [inband-management value]
|
Arguments
TABLE 4-3 Arguments for set host-parameters
Argument
|
Description
|
max-luns-per-id
|
Specify the maximum number of LUNs that can be assigned to any one host ID (target address). Each time a host channel ID is added, it uses the number of LUNs allocated in this setting. The default setting is 32 LUNs. Valid values: 1, 2, 4, 8, 16, 32.
|
queue-depth
|
Specify the maximum number of I/O operations that can be queued simultaneously for a given logical drive. The default value is 1024. Valid values: 0 (auto), 1, 2, 4, 8, 16, 32, 64, 128, 256, 512, 1024.
|
fibre-connection-mode
|
FC and SATA devices only. Specify the connection mode.
- Loop configures an arbitrated loop, which can be used with Direct Attached Storage (DAS) or Storage Area Network (SAN) configurations. Fibre Channel-Arbitrated Loop (FC-AL) supports only half-duplex communication, but allows up to eight IDs per channel.
- Point-to-point can be used only with a switched fabric network, also called a Storage Area Network (SAN) configuration. Point-to-Point protocol supports full duplex communication, but only allows one ID per channel.
Valid values: loop, point-to-point.
|
inband-management {enabled | disabled}
|
Specify whether users can access Sun StorEdge CLI and Sun StorEdge Configuration Service using inband communication over a FC or SCSI channel. If this argument is disabled, out-of-band access must be used. For more information about out-of-band access, see Device Names for Out-of-Band Communication. Valid values: enabled, disabled.
|
Examples
The following example sets the maximum I/O number in the controller queue to 16.
# sccli c2t0d0 set host-parameters queue-depth 16
|
The following example sets the maximum LUN number of each SCSI ID to 8.
# sccli c2t0d0 set host-parameters max-luns-per-id 8
|
set inter-controller-link
Description
Redundant Sun StorEdge 3000 family FC and SATA arrays only. The set inter-controller-link command connects or disconnects an individual port on the upper of lower RAID controller in a redundant-controller configuration. For the Sun StorEdge 3510 FC array, the two controllers are effectively disconnected (on that channel) if either one of the two inter-controller links are disconnected because host channels on both Sun StorEdge 3510 FC controllers are controlled by the same port. For the Sun StorEdge 3511 SATA array, the command must be run for each individual channel and slot location because host channels on the primary and secondary controller are controlled by different ports.
|
Caution - If the controllers are not connected, host applications might not experience transparent failover in the event of a controller failure.
|
Syntax
set inter-controller-link {upper|lower} channel channel {connected|disconnected}
|
Note - icl can be substituted for the keywords inter-controller-link.
|
Arguments
TABLE 4-4 Arguments for set inter-controller-link
Argument
|
Description
|
{upper | lower}
|
Specify the location of the array controller slot, upper or lower.
|
channel ch
|
Specify the channel to modify. Valid values: 0, 1, 4, 5.
|
{connected | disconnected}
|
Specify the desired state for the port bypass circuit.
Usually, all inter-controller links on both the upper and lower controllers are connected.
For the Sun StorEdge 3510 FC array, disconnecting the upper or lower controller’s inter-controller link on any given host channel breaks the internal connection between the two controllers, and between the upper controller and the external connector on the lower controller and vice versa.
For the Sun StorEdge 3511 SATA array, you must disconnect the upper and lower host channel to disconnect the inter-controller link.
Disconnecting the inter-controller link potentially doubles aggregate bandwidth because the controllers do not have to share bandwidth on each channel; and, it also prevents controller failover from working.
|
Examples
The following example disconnects the port on lower channel 1.
# sccli c2t0d0 set inter-controller-link lower channel 1 disconnected
|
The following example sets the port bypass circuit for channel 5 on the upper controller slot to enabled.
# sccli c2t0d0 set icl upper channel 5 connected
|
show channels
Description
The show channels command displays information about host, drive, and RCCOM channels including the channel number, channel mode, primary and secondary ID, speed, and connection mode.
Syntax
show channels [channel-list]
|
Arguments
TABLE 4-5 Arguments for show channels
Argument
|
Description
|
channel-list
|
Specify the channel. The format for channel-list is {n}[,...{m}] or a range format “{n}-{m}” or {n}[,...{p}-{m}]. Valid channel numbers include: 0-7 or 0-5 depending on the hardware. If {m} is greater than the largest channel number, information for all the channels is displayed.
|
Examples
The following example returns information for channels 0 and 2.
# sccli c2t0d0 show channels 0,2
|
The following example returns all channel information for a Sun StorEdge 3510 FC array.
sccli> show channels
Ch Type Media Speed Width PID / SID
--------------------------------------------
0 Host FC(L) 2G Serial 40 / 41
1 Host FC(L) 2G Serial 43 / 42
2 DRV+RCC FC(L) 2G Serial 14 / 15
3 DRV+RCC FC(L) 2G Serial 14 / 15
4 Host FC(L) 2G Serial 44 / 45
5 Host FC(L) 2G Serial 47 / 46
6 Host LAN N/A Serial NA / NA
|
Returned Values
Returned values include channel number, channel type, media (node), speed, width, primary ID (PID), and secondary ID (SID).
Channel type values include:
- Host
- DRV (Drive)
- RCC (RCCOM)
Media (mode) values include:
- L - loop mode (FC and SATA only)
- P - point-to-point (FC and SATA only)
- SCSI
- FC
- LAN - network channel
Speed values include:
- Async -
- For SCSI, SCSI Asynchronous
- For FC or SATA, no link or link down
- SYNC - SCSI Synchronous
- Ultra - SCSI Ultra
- Ultra2 - SCSI Ultra2
- U160 - SCSI U160
- U320 - SCSI U320
- 1G - FC 1 GB/s
- 2G - FC 2 GB/s
Note - Speed values are displayed for the primary controller only. Therefore, if a user maps one LUN to the primary controller, and another LUN to a secondary controller, only the established connection to the primary controller is displayed. As a result, if a primary ID is not mapped to a channel, and a secondary ID is mapped, “Async” displays in the Speed field.
|
PID (primary ID) / SID (secondary ID) values include:
- SCSI 0-15
- FC and SATA 0-125
- When multiple IDs exist for the primary ID or secondary ID, an asterisk (*) displays in the PID or SID field.
show drive-parameters
Description
The show drive-parameters command displays the specified RAID controller parameters pertinent to the operation of disk drives and enclosure services connected to drive channels.
Syntax
Examples
The following example shows all drive parameters of the Sun StorEdge 3510 FC array.
sccli> show drive-parameters
spin-up: disabled
disk-access-delay: 15s
scsi-io-timeout: 30s
queue-depth: 32
polling-interval: disabled
enclosure-polling-interval: 30s
auto-detect-swap-interval: disabled
smart: disabled
auto-global-spare: disabled
|
Returned Values
The returned values for the show drive-parameters command are described in the following table.
TABLE 4-6 Output for show drive-parameters
Field
|
Description
|
spin-up {enabled | disabled}
|
Specifies whether the disk drive automatically spins up on power up. Valid values: enabled, disabled.
|
disk-access-delay
|
The delay in seconds or milliseconds before disk access is granted.
|
scsi-io-timeout
|
Delay in seconds before disk drive I/O timeout. Valid values: 500ms, 1s, 2s, 4s, 6s, 7s, 8s, 10s, 15s, 20s, 30s (default).
|
queue-depth
|
Maximum queue depth that the controller uses when queuing commands for each disk drive. The default value is 32. Valid values: 0 (disabled), 1, 2, 4, 8, 16, 32, 64, 128.
|
polling-interval
|
Specifies the interval at which the array controller polls the disk drives. Valid values: 0 (disable), 500ms, 1s, 2s, 5s, 10s, 30s.
|
enclosure-polling-interval
|
Specifies the interval at which the array controller polls the SAF-TE or SES environmental services processor in the enclosure. Valid values: 0 (disabled), 50ms, 100ms, 200ms, 500ms, 1s, 2s, 5s, 10s, 20s, 30s, 60s.
|
auto-detect-swap-interval
|
Interval (in milliseconds) between checks to determine if a failed drive has been physically replaced. The default value of 0 specifies that auto-detecting is disabled. Valid values: 0, 5s, 10s, 15s, 30s, 60s.
|
smart
|
Determines whether the disk drives perform predictive failure analysis. Valid values: disabled, detect-only, detect-perpetual-clone, detect-clone-replace.
|
auto-global-spare {enabled | disabled}
|
Specifies whether the RAID controller automatically allocates disk drives as global spares. Valid values: enabled, disabled.
|
show host-parameters
Description
The show host-parameters command displays the maximum I/O queue depth per LUN, the number of LUNs that can be configured per target ID, the fibre connection mode (point-to-point or loop for FC and SATA only), and inband management access. To view the partitions mapped to specific host channels, use the show lun-maps command. For details, see show lun-maps.
Syntax
Examples
The following example shows the host parameters for a Sun StorEdge 3510 FC array.
sccli> show host-parameters
max-luns-per-id: 32
queue-depth: 1024
fibre-connection-mode:loop
inband-management: enabled
|
The following example shows the host parameters for a Sun StorEdge 3310 SCSI array.
sccli> show host-parameters
max-luns-per-id: 32
queue-depth: 1024
inband-management: enabled
|
show inter-controller-link
Description
Redundant Sun StorEdge 3000 family FC and SATA arrays only. The show inter-controller-link command displays the status of the port bypass circuit for the specified channel on the array controller in the upper or lower slot. If specified, the arguments must specify an array controller slot location and a channel specifier. If no arguments are specified, the upper and lower slots of channels 0, 1, 4, and 5 are displayed.
Syntax
show inter-controller-link {upper | lower} channel ch
|
Note - icl can be substituted for the keywords inter-controller-link.
|
Arguments
TABLE 4-7 Arguments for show inter-controller-link
Argument
|
Description
|
{upper | lower}
|
Specify the upper or lower controller slot in the chassis to which the command is directed.
|
channel ch
|
Specify the channel number of the inter-controller link.
|
Examples
The following example shows the inter-controller links for channels 0, 1, 4, and 5.
# sccli 111.1.111.11 show inter-controller-link
inter-controller-link upper channel 0: connected
inter-controller-link lower channel 0: connected
inter-controller-link upper channel 1: connected
inter-controller-link lower channel 1: connected
inter-controller-link upper channel 4: connected
inter-controller-link lower channel 4: connected
inter-controller-link upper channel 5: connected
inter-controller-link lower channel 5: connected
|
Sun StorEdge 3000 Family CLI 2.5 User’s Guide
|
817-4951-18
|
|
Copyright © 2009 Sun Microsystems, Inc. All rights reserved.