C H A P T E R  4

Channel Commands

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 icon 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 icon 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 icon 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:

Media (mode) values include:

Speed values include:



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:

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


show drive-parameters

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


show host-parameters

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