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:
- L - loop mode (FC only)
- P - point-to-point (FC only)
- SCSI
- FC
- LAN - network channel
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.
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).
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
|
Sun StorEdge 3000 Family CLI 1.5 User's Guide
|
817-4951-10
|
|
Copyright © 2004, Sun Microsystems, Inc. All rights reserved.