C H A P T E R  4

Channel Commands

This chapter provides the available host and drive channel commands with sample code.



Note - To prevent unauthorized access to administrative functions of the RAID controller, the CLI requires superuser or system administrator privileges for in-band 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 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

This command configures a host or drive channel and establishes channel IDs on the primary and secondary controller. After a SCSI 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 reset command, to stay in prompt mode, run the select command to reselect the device.



configure channel channel [{host|drive}] [primary-id target-list] [secondary-id target-list] [sync-clock rate] [-r | --reset]



Note - Unless the --reset option is specified, subsequent CLI commands might fail or might have unexpected results since the controller has not been reset.



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-7.

[host | drive]

Specify whether the channel is used to interface with a host or a disk drive. Each host channel can have multiple SCSI IDs. 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.

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.

sync-clock rate

Specifies the clock rate. rate is specified as Mhz, for example sync-clock 40Mhz. Accepted values include: 40Mhz, 80Mhz, 160Mhz, or Async. The default value is Async.

[-r | --reset]

Specifies that the controller reset immediately so that the specified changes take effect. By default, the specified changes do not take effect until an explicit reset controller command is issued.


The following example sets the SCSI channel mode as host and resets the controller immediately:

# sccli c2t0d0 configure channel 0 mode host --reset

The following example sets the SCSI 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 

The following example sets the SCSI channel 0 SCSI bus synchronous clock to 40Mhz:

# sccli c2t0d0 configure channel 0 sync-clock 40Mhz 

set drive-parameters

This command sets the specified RAID controller parameters that affect the operation of drive channels.

set drive-parameters parameter name value 

TABLE 4-2 Arguments for set drive-parameters

Argument

Description

scsi-io-timeout

Disk drive I/O timeout in milliseconds. The default value is 7000 (for example, 7 seconds).

spin-up {enabled | disabled}

Specifies whether the RAID controller automatically spins up.

reset-at-power-up {enabled | disabled}

Specifies whether the RAID controller automatically resets when it is powered on.

disk-access-delay

Specify in seconds or milliseconds the amount of time to wait before disk access is granted.

queue-depth

Maximum queue depth that the controller uses when queuing commands for each disk drive. auto or the value 0 can be specified to indicate that the queue depth value can be computed automatically. The default value is 32.

enclosure-polling-interval

Specifies 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.

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 polling is disabled.

smart {enabled | disabled}

Determines whether the disk drives are to perform predictive failure analysis.

auto-global-spare {enabled | disabled}

Specifies whether the RAID controller automatically allocates disk drives as global spares.


 

Note - The range of valid values for certain numeric parameters can vary depending on the array controller firmware. Refer to the firmware documentation, or the firmware menus, for the exact list of values supported in a given version of firmware. For example, the valid values for scsi-io-timeout in 3.27P firmware for the Sun StorEdge 3510 are 500ms, 1s, 2s, 4s, 6s, 8s, 10s, 15s, 20s, and 30s. A value of 29s will not be accepted.



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:

# sccli c2t0d0 set drive-parameters poll-interval 10s

set host-parameters

This command sets the specified host-channel related parameter.

set host-parameters [queue-depth | max-luns-per-id] value

TABLE 4-3 Arguments for set host-parameters

Argument

Description

max-luns-per-id

This parameter determines the maximum number of logical units that can be assigned to any one SCSI target address. The default value is 8. Valid values range from 1-32.

queue-depth

Controls the number of I/O operations that can be queued simultaneously for a given LUN. The default value is 32. Valid values range from 1-1024.


 

The following example sets the max I/O number in the controller queue to 16:

# sccli c2t0d0 set host-parameters queue-depth 16

The following example sets the max LUN number of each SCSI ID to 8:

# sccli c2t0d0 set host-parameters max-luns-per-id 8

set icl

This is a shortcut for the set inter-controller-link command. For details, see set inter-controller-link.

set inter-controller-link

Redundant Fibre Channel arrays only. This command connects or disconnects an individual FC port on the upper of lower RAID controller in a redundant controller configuration. The two controllers are effectively disconnected (on that channel) if either one of the two inter-controller links are disconnected. If the controllers are not connected, host applications might not experience transparent failover in the event of a controller failure.

set inter-controller-link {upper|lower} channel channel {connected|disconnected}

TABLE 4-4 Arguments for set inter-controller-link

Argument

Description

{upper | lower}

Specify the location of the inter-controller-link: upper or lower.

channel ch

Specify the channel to modify. Valid values include: 0, 1, 4, and 5.

{connected | disconnected}

Specify the desired state for the port bypass circuit.

Normally, all inter-controller-links on both the upper and lower controllers should be connected; disconnecting the upper or lower controllers' 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. This potentially doubles aggregate bandwidth because the controllers do not have to share bandwidth on each channel, but also prevents controller failover from working in a transparent fashion.


 

The following example disconnects the port on lower channel 1:

# sccli c2t0d0 set inter-controller-link lower channel 1 disconnected

show channels

The show channels command displays information about the host and drive channels.

show channels [channel-list] 

TABLE 4-5 Arguments for show channels

Argument

Description

channel-list

Specify the SCSI channel. The format for channel-list is {n}[,...{m}] or a range format "{n}-{m}" or {n}[,...{p}-{m}]. A valid channel number is 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.


 

The following example returns information for channels 0 and 2:

# sccli c2t0d0 show channels 0,2

The following example returns all SCSI channel information:

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  Drive   FC(L)   2G      Serial  14 / 15
 3  Drive   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 include: Channel Number, Channel Type, Media (Mode), Speed, Width, Primary ID (PID), and Secondary ID (SID).

CH Type values include:

Media (Mode) values include:

When multiple IDs exist for the primary ID or secondary ID, an asterisk (*) displays in the PID or SID field.

show drive-parameters

The show drive-parameters command displays the specified RAID controller parameters that affect the operation of drive channels.

show drive-parameters

The following example shows all drive parameters of the array controller at IP address 192.168.1.42:

# sccli 192.168.1.42 show drive-parameters 
sccli: selected se3000://199.249.246.28:58632 [SUN StorEdge 3510 SN#000187]
 spin-up: disabled
 reset-at-power-up: enabled
 disk-access-delay: 15s
 scsi-io-timeout: 10s
 queue-depth: 32
 polling-interval: 0ms
 enclosure-polling-interval: 30s
 auto-detect-swap-interval: 0ms
 smart: disabled
 auto-global-spare: disabled

show host-parameters

The show host-parameters command displays the maximum I/O queue depth per LUN and the number of LUNs that can be configured per target ID. Returned values include: max-luns-per-id, queue-depth, and fc-connection-mode (point-to-point or loop for FC only).

show host-parameters

The following example shows the maximum I/O number for the controller and LUN number of each SCSI ID for a FC array:

sccli> show host-parameters
 max-luns-per-id: 32
 queue-depth: 1024
 fibre connection mode: loop

show icl

This command is a shortcut for the show inter-controller-link command. For details, see show inter-controller-link.

show inter-controller-link

Redundant Fibre Channel arrays only. This 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, as described below. If no arguments are specified, the upper and lower slots of channels 0, 1, 4, and 5 are displayed.

show inter-controller-link [upper | lower] channel ch

TABLE 4-6 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.


 

The following example shows the inter-controller-links for channels 0, 1, 4, and 5:

# sccli 206.6.182.71 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

show luns

This command shows all partitions mapped to specified host channels. Returned values include: Partition Number, Logical Volume or Logical Drive Index, Logical Volume or Logical Drive ID, Host Channel Number, On-Controller, and SCSI ID.

show luns [channel host-channel-list]

TABLE 4-7 Arguments for show luns

Argument

Description

host-channel-list

Specify the lun format. Use the format {n}[,...{m}] or a range format "{n}-{m}" or {n}[,...{p}-{m}].

A valid channel number is from 0-7 or 0-5 depending upon the hardware configuration.


 

The following example returns all partitions mapped to host channel 6 and 7:

# sccli c2t0d0 show luns channel 6-7

The following example shows all partitions mapped to the host channels:

sccli> show luns
Ch Tgt LUN   ld/lv  ID-Partition  Assigned  Filter Map
--------------------------------------------------------------
 0  40   0   ld0    48CE0175-00   Primary
 0  40   1   ld0    48CE0175-01   Primary
 0  40   2   ld0    48CE0175-02   Primary
 0  41   0   ld1    172613B6-00   Secondary
 0  41   1   ld1    172613B6-01   Secondary
 0  41   2   ld1    172613B6-02   Secondary
 1  42   0   ld1    172613B6-00   Secondary
 1  42   1   ld1    172613B6-01   Secondary
 1  42   2   ld1    172613B6-02   Secondary
 1  43   0   ld0    48CE0175-00   Primary
 1  43   1   ld0    48CE0175-01   Primary
 1  43   2   ld0    48CE0175-02   Primary
 4  44   0   ld0    48CE0175-00   Primary
 4  44   1   ld0    48CE0175-01   Primary
 4  44   2   ld0    48CE0175-02   Primary
 4  45   0   ld1    172613B6-00   Secondary
 4  45   1   ld1    172613B6-01   Secondary
 4  45   2   ld1    172613B6-02   Secondary
 5  46   0   ld1    172613B6-00   Secondary
 5  46   1   ld1    172613B6-01   Secondary
 5  46   2   ld1    172613B6-02   Secondary
 5  47   0   ld0    48CE0175-00   Primary
 5  47   1   ld0    48CE0175-01   Primary
 5  47   2   ld0    48CE0175-02   Primary