C H A P T E R  5

Logical Drive, Partition, and Logical Volume Commands

This chapter provides the available Sun StorEdge CLI commands with sample code for logical drives, partitions, and logical volumes. Topics covered in this chapter include:



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 device is specified on the command line, and more than one array is connected to the host, a menu of devices is presented with one device file name for each array. If there is only one Sun StorEdge 3000 family array connected to the host, that device is selected automatically.




Note - Logical drive indexes can change whenever a logical drive is deleted, while a logical drive identifier never changes over the life of the logical drive.



Logical Drive Commands

The following commands are explained in this section:

abort create

Description

The abort create command stops the creation of a logical drive.

To create a logical drive, use the create logical-drive command. For details, see create logical-drive. To view logical drives, use the show logical-drive command. For details, see show logical-drive.

Syntax


abort create {ld-index | ld-id}

Arguments


TABLE 5-1 Arguments for abort create

Argument

Description

ld-index

Specify the logical drive index number. For example, ld3.

ld-id

Specify the logical drive ID. For example, 71038221.


Examples

The following example stops the creation of logical drive 8.


sccli> abort create ld8

abort expand

Description

The abort expand command stops the expansion of a logical drive.

To expand a logical drive, use the expand command. For details, see expand. To view the progress of an expansion, use the show logical-drives expanding command. For details, see show logical-drives expanding.

Syntax


abort expand {ld-index | ld-id}

Arguments


TABLE 5-2 Arguments for abort expand

Argument

Description

ld-index

Specify the logical drive index number. For example, ld3.

ld-id

Specify the logical drive ID. For example, 71038221.


Examples

The following example stops the expansion of logical drive 8.


sccli> abort expand ld8

abort media-check

Description

The abort media-check command stops a media check on specified disks or all member disks of the specified logical drive.

For more information on the check media command, see check media.



Note - The front-panel LEDs for the drives being checked will blink until the media check is finished or aborted. For more information about LEDs, refer to the Sun StorEdge 3000 Family Installation, Operation, and Service Manual for your array.


Syntax


abort media-check {disk-list | ld-index | ld-id}

Arguments


TABLE 5-3 Arguments for abort media-check

Argument

Description

disk-list

Shows specific disks. Use any of the following formats: ch.id, ch.idm-n.

ch is physical device channel and id is the SCSI ID of the device and m to n represents a contiguous range of IDs on the same channel. For example, 2.0, 2.3 or 2.2-5.

ld-index

Specify the logical drive index number. For example, ld3.

ld-id

Specify the logical drive ID. For example, 71038221.


Examples

The following example stops the media check for all member disks of logical drive 5.


sccli> abort media-check ld5 

abort parity-check

Description

The abort parity-check command stops the parity check on the specified logical drive.

To check parity, use the check-parity command. For details, see check parity. To view the progress of a parity check, use the show logical-drives parity-check command. For details, see show logical-drives parity-check.

Syntax


abort parity-check {ld-index | ld-id}

Arguments


TABLE 5-4 Arguments for abort parity-check

Argument

Description

ld-index

Specify the logical drive index number. For example, ld3.

ld-id

Specify the logical drive ID. For example, 71038221.


Examples

The following example stops the parity check on logical drive 0.


sccli> abort parity-check ld0

abort rebuild

Description

The abort rebuild command stops the rebuilding of a logical drive.

To rebuild a logical drive, use the rebuild command. For details, see rebuild. To view the progress of an expansion, use the show logical-drives rebuilding command. For details, see show logical-drives rebuilding.

Syntax


abort rebuild {ld-index | ld-id}

Arguments


TABLE 5-5 Arguments for abort rebuild

Argument

Description

ld-index

Specify the logical drive index number. For example, ld3.

ld-id

Specify the logical drive ID. For example, 71038221.


Examples

The following example stops rebuilding logical drive 4.


sccli> abort rebuild ld4

add disk

Description

The add disk command adds one disk or a list of disks to the specified logical drive. The disks must not be members of a logical drive. If you try to add a disk to an unsupported RAID level, an error returns.

Syntax


add disk {ld-index | ld-id} {disk-list}

Arguments


TABLE 5-6 Arguments for add disk

Argument

Description

disk-list

Adds specific disks. Use any of the following formats: ch.id, ch.idm-n.

ch is physical device channel, id is the SCSI ID of the device, and m to n represents a contiguous range of IDs on the same channel. For example, 2.0, 2.3 or 2.2-5.

ld-index

Specify the logical drive index number. For example, ld3.

ld-id

Specify the logical drive ID. For example, 71038221.


Examples

The following example adds two disks to logical drive 2.


sccli> add disk ld2 d0.0 d0.1

check media

Description

The check media command sequentially checks each physical drive in a specified logical drive, block by block, for bad blocks. If a bad block is encountered, the controller rebuilds the data from the bad block onto a good block if one is available on the physical drive. If no good blocks are available on the physical drive, the controller designates the physical drive Bad, generates an event message and, if a spare drive is available, begins rebuilding data from the bad physical drive onto the spare.

Use the show media-check command to review the progress of a media check. For details, see show media-check.

It is useful to run a media scan if a drive has failed, if drive errors are encountered, or when a rebuild is required after replacing a drive. You might want to run a nightly script to execute the check media command rather than running the command continuously.



Note - A firmware menu option called Media Scan at Power-Up specifies whether media scan runs automatically following a controller power-cycle, reset, or after logical drive initialization. This setting is disabled by default. For more information, refer to the Sun StorEdge 3000 Family RAID Firmware User's Guide.


You can use the abort media-check command to stop a media check.



Note - The front-panel LEDs for the drives being checked will blink until the media check is finished or aborted. For more information about LEDs, refer to the Sun StorEdge 3000 Family Installation, Operation, and Service Manual for your array.


Syntax


check media {ld-index | ld-id} [priority][continuous]

Arguments


TABLE 5-7 Arguments for check media

Argument

Description

ld-index

Specify the logical drive index number. For example, ld3.

ld-id

Specify the logical drive ID. For example, 71038221.

priority

Specify the priority of the disk check. Valid values: low, normal, improved, high. For example, specify low to have the media check occur after other firmware processes complete. The higher the priority selected, the greater amount of system resources required to perform the media check. Specify low to have the check occur using minimal system resources.

continuous

Specify continuous to run a media check at all times.


Examples

The following example checks all member disks of logical drive 5.


sccli> check media ld5 

check parity

Description

The check parity command checks the integrity of redundant data on fault-tolerant logical drives. A qualified logical drive must be configured as a RAID1, RAID3, or RAID5 array. For RAID 3 and 5 configurations, the parity checking procedure on a logical drive recalculates the parity of data stripes in each of the logical drive’s RAID stripe sets and compares it with the stored parity. If a discrepancy is found, an error is reported and the new correct parity is substituted for the stored parity. For RAID 1 configurations, if an inconsistency is encountered, data is copied from the master disk to the slave disk. If a bad block is encountered when the parity is regenerated, the data is copied from the other disk, master or slave, to the reporting disk drive reallocating the bad block.



Note - You cannot check parity on multiple logical drives simultaneously. If you try to run multiple parity checks at the same time, an error is displayed.


To view the progress of a parity check, use the show logical-drives parity-check command. For details, see show logical-drives parity-check. To cancel the parity check, use the abort parity-check command. For details, see abort parity-check.

Syntax


check parity {ld-index | ld-id} [check-only] [verbose]

Arguments


TABLE 5-8 Arguments for check parity

Argument

Description

ld-index

Specify the logical drive index number. For example, ld3.

ld-id

Specify the logical drive ID. For example, 71038221.

check-only

Specify check-only to indicate that if an inconsistency is found, parity regeneration is not performed.

verbose

Specify verbose to generate events when an inconsistency is encountered.


Examples

To check parity and view the parity status for logical drive 0, type:


sccli> check parity ld0
sccli> show ld parity-check
LD      LD-ID     Status
------------------------
ld0     627D800A  2% complete

configure local-spare

Description

The configure local-spare command specifies a local spare disk as a dedicated spare disk for the specified logical drive. The disk drive status is set to standby. Local spares can only be assigned to logical drives in RAID1, RAID3, and RAID5 arrays.



Note - You cannot create a logical drive composed of Sun StorEdge 3510 FC drives and Sun StorEdge 3511 SATA drives. If you try to mix drive types in a logical drive, by configuring a local spare with a different drive type, an error is displayed. For more information, refer to the Sun StorEdge 3000 Family RAID Firmware User’s Guide.


Syntax


configure local-spare disk [ld-index | ld-id]

Arguments


TABLE 5-9 Arguments for configure local-spare

Argument

Description

disk

Specify the disk to configure. For example, specify the disk with target ID 1 on channel 2 as 2.1.

ld-index

Specify the logical drive index number. For example, ld3.

ld-id

Specify the logical drive ID. For example, 71038221.


Examples

The following example configures disk drive ID 5 on channel 2 as a local spare for the logical drive with index number 2.


# sccli c2t0d0 configure local-spare 2.5 ld2

The following example configures disk drive ID 5 on channel 2 as a local spare for the logical drive with ID 2C33AAEA.


# sccli c2t0d0 configure local-spare 2.5 2C33AAEA

create logical-drive

Description

The create logical-drive command creates a logical drive with the specified RAID level and disk drives, assigns the logical drive to the primary or secondary RAID controller, assigns the global spare drives, sets the stripe size, sets the maximum disk capacity per drive, sets the cache write policy, and sets the logical drive initialization mode.



caution icon Caution - Any time logical drives are created or deleted, the numbering of logical drive indexes might change. After creating or deleting logical drives, issue a show logical-drivecommand to view an updated list of logical drive indexes. Or, use logical drive IDs, which do not change over the lifetime of the logical drive, rather than logical drive indexes. For more information, see Logical Drive Syntax.




Note - You cannot create a logical drive composed of Sun StorEdge 3510 FC drives and Sun StorEdge 3511 SATA drives. If you try to mix drive types in a logical drive, an error is displayed. For more information, refer to the Sun StorEdge 3000 Family RAID Firmware User’s Guide.




Note - All device capacity is displayed in powers of 1024. For details, see Device Capacity.


Stripe Size

Depending on the optimization mode and RAID level selected, newly created logical drives are configured with the default stripe sizes shown in the following table.


TABLE 5-10 Default Stripe Size Per Optimization Mode (Kbyte)

RAID Level

Sequential I/O

Random I/O

0, 1, 5

128

32

3

16

4




Note - Default stripe sizes optimize performance for most applications.


When you create a logical drive, you can replace the default stripe size with one that better suits your application.

To view the optimization mode, type show cache-parameters. For more information about optimization modes, see set cache-parameters.



Note - Once data is written to logical drives, the only way to change the stripe size is to back up all data to another location, delete all logical configurations of drives, reconfigure the logical drive with the stripe size, and reboot the array.


Syntax


create logical-drive raid-level disk-list [assignment] [global-spare {disk-list}] [stripe-size {size}] [max-disk-capacity{size}] [write-policy] [mode]

Arguments


TABLE 5-11 Arguments for create logical-drive

Argument

Description

raid-level

Specify the RAID level to assign to the logical drive. Valid values: raid0, raid1, raid3, raid5, raid1+, raid3+, raid5+. The plus (+) sign includes a local spare. The local spare is randomly chosen from the disk-list.

disk-list

Specify a comma-separated list of IDs to use for the RAID set and the local spare, if specified. Use the show disks free command to determine which disks are available.

assignment

Specify the controller assignment for the logical drive. If no value is specified, the logical drive is assigned to the primary controller by default. Valid values: primary, secondary.

global-spare {disk-list}

Specify a list of drives to use as global spares, for example, d0:1,d0:2-3. When you assign a global spare, the system automatically assigns global spare status 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.

stripe-size

Specify the stripe block size in a multiple of 4. Valid values: 4k, 8k, 16k, 32k, 64k, 128k, 256k. Depending on the RAID level and cache optimization setting, some of the values may not be available for your configuration. To view the valid values for a specific RAID level, use the show stripe-size-list command. For details, see show stripe-size-list. If no stripe size is specified, the default value is used.

max-disk-capacity nMB

Allocates only nMB of each drive, instead of the entire drive; the remaining space on the drives can be used to expand the logical drive later. Include a MB or GB suffix with the specified parameter. The default value is the maximum capacity of the logical drive.

size nMB

An alternative to the max-disk-capacity keyword that specifies the total usable size of the resulting logical drive. The logical drive can be expanded later until it fills the capacity of all the member drives.

write-policy

Specify the logical drive cache policy. Valid values: write-back, write-through. If you do not specify a write policy, the logical drive uses the write policy specified for the controller. If the write policy changes for the controller, the write policy automatically changes for the logical drive as well. To set the controller write policy, use the set cache-parameters command. For details, see set cache-parameters.

mode

Specify the initialization mode. The default value is online. Because logical drive initialization can take up to several hours, you can choose to initialize a logical drive online to immediately begin configuring and using the logical drive before initialization is complete. However, because the controller is building the logical drive while performing I/O operations, initializing a logical drive online requires more time than offline initialization.

Specify offline to manually bring the drive online. If you do not select online initialization, you can configure and use the drive only after initialization is complete. Because the controller is building the logical drive without having to also perform I/O operations, offline initialization requires less time than online initialization.

Valid values: online, offline.


Examples

The following example creates a logical drive as RAID 1 with disks 1 through 4 on channel 2 on the primary controller. Channel 2 ID 0 is assigned as the global spare.


# sccli c2t0d0 create logical-drive raid1 2.1-4 primary global-spare 2.0

The following example creates a 10-Gbyte RAID 5 volume using six disk drives (disks with IDs 0 to 5 on channel 2), one of which is reserved as a global spare for this logical drive.


# sccli c2t0d0 create logical-drive raid5 size 10gb global-spare 2.0-5

The following example creates a logical drive as RAID 1 with disks 1, 3, and 4 on channel 2 on the primary controller. Channel 2 ID 0 is assigned as the global spare, and each disk drive uses 1000-Mbyte capacity to build the RAID.


# sccli c2t0d0 create logical-drive 1 2.1,2.3,2.4 primary global-spare 2.0 max-disk-capacity 1000MB

delete logical-drive

Description

The delete logical-drive command deletes the specified logical drives and disassociates all disks that are assigned to the logical drive.



caution icon Caution - Any time logical drives are created or deleted, the numbering of logical drive indexes might change. After creating or deleting logical drives, issue a show logical-drivecommand to view an updated list of logical drive indexes. Or, use logical drive IDs, which do not change over the lifetime of the logical drive, rather than logical drive indexes. For more information, see Logical Drive Syntax.




Note - Before you can delete a logical drive, you must unmap all assigned LUNs. To review LUN maps, see show lun-maps.


Syntax


delete logical-drive {ld-index | ld-id}

Arguments


TABLE 5-12 Arguments for delete logical-drive

Argument

Description

ld-index

Specify the logical drive index number. For example, ld3.

ld-id

Specify the logical drive ID. For example, 71038221.


Examples

The following example deletes the logical drive with the logical drive index number 2.


# sccli c2t0d0 delete logical-drive ld2

The following example deletes the logical drive with the logical drive ID number 3C24554F.


# sccli c2t0d0 delete logical-drive 3C24554F

expand

Description

The expand command expands a logical drive or logical volume by the specified size. The size you specify is added for each available physical drive in the logical drive, and is limited to the maximum available free disk space on the smallest physical drive. The total capacity added is calculated automatically, based on the RAID level. RAID levels 0, 1, 3, and 5 support expansion. For more information on how the expansion size is calculated, refer to the Sun StorEdge 3000 Family RAID Firmware User’s Guide.



Note - To expand a logical volume, you must first expand the logical drives that make up the logical volume.




Note - To expand a logical drive with a local spare assigned, you must remove the local spare, and then expand the logical drive. Since local spares are dedicated to a specific logical drive, if you expand the logical drive size, the spare drive can no longer accommodate the size of the expanded logical drive.




Note - All device capacity is displayed in powers of 1024. For details, see Device Capacity.


Syntax


expand {ld-index | lv-index | ld-id | lv-id} size [online|offline]

Arguments


TABLE 5-13 Arguments for expand

Argument

Description

lv-index

Specify a comma-separated list of logical volume indexes, for example, lv0,lv1,lv2.

ld-index

Specify the logical drive index number. For example, ld3.

lv-id

Specify a logical volumes using an eight-digit hexadecimal logical volume ID, for example, 3C24554F.

ld-id

Specify the logical drive ID. For example, 71038221.

size nMB

Specify the total usable size per physical drive to be added to the logical drive. The capacity you specify is allocated from each available physical drive and cannot exceed the space available on the smallest drive. Include an MB or GB suffix with the specified parameter.

online|offline

Specify the expansion mode. The default value is online. Because logical drive expansion can take up to several hours, you can choose to expand a logical drive online to immediately begin configuring and using the logical drive before expansion is complete. However, because the controller is expanding the logical drive while performing I/O operations, expanding a logical drive online requires more time than offline expansion.

Specify offline to configure and use the drive only after expansion is complete. Because the controller is expanding the logical drive without having to also perform I/O operations, offline expansion requires less time than online expansion.

Valid values: online, offline.


Examples

The following example expands each physical drive in logical drive 5 by 36 Gbyte and brings the logical drive online.


sccli> expand ld5 36GB online

rebuild

Description

The rebuild command rebuilds the specified logical drive. RAID levels 1, 3, and 5 are supported. If you attempt to perform the rebuild command on an unsupported RAID level or if no spare drives are available, an error is returned.

In most cases, you do not need to use this command because replaced drives are automatically rebuilt. If a spare is not present when the failure occurs, or for some reason the drive does not rebuild, you can use this command to manually start the rebuild process. Also, if the rebuild process is interrupted by a reset, use this command to restart the rebuilding process.

The time required to rebuild a logical drive is determined by the size of the logical drive, the I/O that is being processed by the controller and the array’s rebuild priority setting. To review the rebuild priority, run the show disk-array command. For details, see show disk-array.

Syntax


rebuild [ld-index | ld-id] 

Arguments


TABLE 5-14 Arguments for rebuild

Argument

Description

ld-index

Rebuild a specific logical drive. The index number is generated from the Sun StorEdge CLI. Use the show logical-drive command to find the number.

ld-id

Rebuild a specific logical drive. The ID is generated from the Sun StorEdge CLI. Use the show logical-drive command to find the number.


Examples

The following example rebuilds logical drive 0.


# sccli c2t0d0 rebuild ld0

set logical-drive

Description

The set logical-drive command sets the write policy and controller assignment for the specified logical drive. Before using this command, you must create a logical drive. For details, see create logical-drive.

You can also use this command to reset the status of a previously failed drive. After a logical drive experiences a fatal failure, it will show as Dead when you view drive status using the show logical-drive command.

When this occurs for non-redundant RAID sets, reset the controller and then reset the drive status to good.

When this occurs for redundant RAID sets, reset the controller, reset the drive status to degraded, and then rebuild the logical drive.



Note - Before resetting drive status to either good or degraded, you must reset the controller. After resetting the controller, the drive status will still show as Dead. For more information on resetting the controller, refer to reset controller.




Note - For information on resetting drive status using the firmware application, refer to the Sun StorEdge 3000 Family RAID Firmware User’s Guide.


Syntax


set logical-drive {ld-index | ld-id} [write-policy] [assignment] status {good | degraded}

Arguments


TABLE 5-15 Arguments for set logical-drive

Argument

Description

ld-index

Specify the logical drive index number. For example, ld3.

ld-id

Specify the logical drive ID. For example, 71038221.

write-policy

Set the write policy for the logical drive. Valid values: write-back, write-through, default. If you do not specify a write-policy, or if you specify default, the logical drive uses the write-policy specified for the controller. If the write policy changes for the controller, the write policy automatically changes for the logical drive as well. To set the controller write policy, use the set cache-parameters command. For details, see set cache-parameters.

assignment

Specify the controller assignment for the logical drive. If no value is specified, the logical drive is assigned to the primary controller by default. Valid values include: primary and secondary.

status

Specify to reset the logical drive status. Valid values include: degraded (for failed redundant RAID sets) and good (for failed non-redundant RAID sets).




caution icon Caution - In a single-controller configuration, if you set the cache policy to write-back, data corruption might occur in the event of a controller failure. To avoid the possibility of data corruption, set the write policy for single-controller configurations to write-through.


Examples

The following example sets the write policy for logical drive 0 to write-back.


sccli> set logical-drive ld0 write-back

The following example resets the drive status to good for a failed non-redundant RAID set.


sccli> set logical-drive status good

show disks logical-drive

Description

The show disks command displays information about the disk drives in the specified logical drive. Returned values include: channel number, SCSI ID, size (MB), speed, logical drive index, logical drive ID that the disk is assigned to, status, vendor, and revision.



caution icon Caution - Any time logical drives are created or deleted, the numbering of logical drive indexes might change. After creating or deleting logical drives, issue a show logical-drivecommand to view an updated list of logical drive indexes. Or, use logical drive IDs, which do not change over the lifetime of the logical drive, rather than logical drive indexes. For more information, see Logical Drive Syntax.


Syntax


show disks [logical-drive {ld-index | ld-id}] 



Note - ld can be substituted for the keyword logical-drive.


Arguments


TABLE 5-16 Arguments for show disks logical-drive

Argument

Description

ld-index

Show a specific logical drive. The index number is generated from the Sun StorEdge CLI. Values range from 0 to 31. Use the show logical-drive command to find the number.

ld-id

Show a specific logical drive. The ID is generated from the Sun StorEdge CLI. Use the show logical-drive command to find the number.


Examples

The following example returns all logical drive disks with the logical drive ID of 13843684.


sccli> show disks logical-drive 13843684
Ch  Id    Size     Speed  LD    LD-ID    Status   IDs                     Rev
------------------------------------------------------------------------------
 0   0   33.92GB   160MB  ld0   13843684 ONLINE   SEAGATE ST336607LSUN36G 0307
                                                      S/N 3JA1BJ2P00007338
 0   1   33.92GB   160MB  ld0   13843684 ONLINE   SEAGATE ST336607LSUN36G 0307
                                                      S/N 3JA1C2E600007339
 0   2   33.92GB   160MB  ld0   13843684 ONLINE   SEAGATE ST336607LSUN36G 0307
                                                      S/N 3JA22Z0A00007351
 0   3   33.92GB   160MB  ld0   13843684 ONLINE   SEAGATE ST336607LSUN36G 0307
                                                      S/N 3JA230NL00007351

The following example returns all logical drive disks with a logical drive index of 0.


sccli> show disks ld ld0
Ch  Id    Size     Speed  LD     LD-ID    Status   IDs                     Rev
------------------------------------------------------------------------------
 2   6   33.92GB   200MB  ld0    161637C1 ONLINE   SEAGATE ST336753FSUN36G 0349
                                                       S/N 3HX0YEJT00007349
 2   7   33.92GB   200MB  ld0    161637C1 ONLINE   SEAGATE ST336753FSUN36G 0349
                                                       S/N 3HX0Y6J300007349
 2   8   33.92GB   200MB  ld0    161637C1 ONLINE   SEAGATE ST336753FSUN36G 0349
                                                       S/N 3HX0YC1Y00007349
 2   9   33.92GB   200MB  ld0    161637C1 ONLINE   SEAGATE ST336753FSUN36G 0349
                                                       S/N 3HX0Y7W100007349

Returned Values

The returned values for the show disks command are described in the following section.

Speed values include:

Status values include:

show logical-drive

Description

The show logical-drive command displays information about specified logical drives. For details on creating logical drives, see create logical-drive.



caution icon Caution - Any time logical drives are created or deleted, the numbering of logical drive indexes might change. After creating or deleting logical drives, issue a show logical-drivecommand to view an updated list of logical drive indexes. Or, use logical drive IDs, which do not change over the lifetime of the logical drive, rather than logical drive indexes. For more information, see Logical Drive Syntax.




Note - If no write policy is specified for the logical drive, the write policy is set to the global controller setting and “Default” displays in the Write-Policy field. To view the controller write policy, run the show cache-parameters command. For more information about the cache policy, see set cache-parameters.


Syntax


show logical-drive [ld-list]



Note - The abbreviation ld can be substituted for the keyword logical-drive.


Arguments


TABLE 5-17 Arguments for show logical-drive

Argument

Description

ld-list

Specify a list of logical drives.


If no options are specified, all logical drives are displayed.

Examples

The following example returns all logical drive information.


sccli> show ld
LD    LD-ID        Size  Assigned  Type   Disks Spare  Failed Status
------------------------------------------------------------------------
ld0   161637C1 101.00GB  Primary   RAID5  4     1      0      Good
                         Write-Policy Default          StripeSize 128KB

The following example returns all logical drives with logical drive index numbers 0 and 1.


sccli> show logical-drive ld0,ld1
LD    LD-ID        Size  Assigned  Type   Disks Spare  Failed Status
------------------------------------------------------------------------
ld0   250FF1DC     30MB  Primary   RAID5  4     2      0      Good
                         Write-Policy Default          StripeSize 128KB
ld1   363F38D9  67.34GB  Primary   RAID3  3     2      0      Good
                         Write-Policy Default          StripeSize  16KB

Returned Values

Returned values include LD index, LD ID, size (MB or GB), controller assignment, RAID level, number of disks, number of spares, number of failed disks, status, write policy type, block size (KB), and block status.

Status values include:

show logical-drives add-disk

Description

The show logical-drives add-disk command displays the status of disks that are being added to a logical drive. Returned values include LD index, LD ID, and progress. For details on the add disk command, see add disk.

Syntax


show logical-drives add-disk 



Note - The abbreviation ld can be substituted for the keyword logical-drive.


Examples

The following example returns the completion percentage for the disks that are being added.


# sccli c2t0d0 show logical-drives add-disk

show logical-drives expanding

Description

The show logical-drives expanding command displays the progress of the logical drive expansion. Returned values include LD index, LD ID, and progress. For details on expanding logical drives, see expand.

Syntax


show logical-drives expanding



Note - The abbreviation ld can be substituted for the keyword logical-drive.


Examples

The following example returns the completion percentage for the logical drive expansion.


sccli> show logical-drives expanding
LD      LD-ID     Status
------------------------
ld0     250FF1DC  60% complete (offline)

show logical-drives initializing

Description

The show logical-drives initializing command displays the progress of the RAID controller initialization. Returned values include LD index, LD ID, and progress.

Syntax


show logical-drives initializing



Note - The abbreviation ld can be substituted for the keyword logical-drive.


Examples

The following example returns the completion percentage of the RAID controller for all logical drives.


sccli> show ld initializing
LD      LD-ID     Status
------------------------
ld1     59839F65  10% complete (online)

show logical-drives logical volume

Description

The show logical-drives logical-volume command displays information for all logical drives in a specified logical volume.



caution icon Caution - Any time logical volumes are created or deleted, the numbering of logical volume indexes might change. After creating or deleting logical volumes, issue a show logical-volumescommand to view an updated list of logical volume indexes. Or, use logical volume IDs, which do not change over the lifetime of the logical volume, rather than logical volume indexes. For more information, see Logical Volume Syntax.




Note - If no write policy is specified for the logical drive, the write policy is set to the global controller setting and “Default” displays in the Write-Policy field. To view the controller write policy, run the show cache-parameters command. For more information about the cache policy, see set cache-parameters.


Syntax


show logical-drives logical-volume {lv-index | lv-id}



Note - The abbreviation ld can be substituted for the keyword logical-drive. The abbreviation lv can be substituted for the keyword logical-volume.


Arguments


TABLE 5-18 Arguments for show logical-drives logical volume

Argument

Description

lv-index

Show specific drives in a logical volume. The index number is generated from the Sun StorEdge CLI. Use the show logical-volumes command to find the number.

lv-id

Show specific drives in a logical volume. The ID number is generated from the Sun StorEdge CLI. Use the show logical-volumes command to find the number


Examples

The following example returns all logical drives with the logical volume ID of 12345678.


# sccli c2t0d0 show logical-drives logical-volume 12345678

The following example shows all logical drives in the logical volume with the ID of 0.


sccli> show ld lv lv0
LD    LD-ID        Size  Assigned  Type   Disks Spare  Failed Status
------------------------------------------------------------------------
ld1   363F38D9  67.34GB  Primary   RAID3  3     2      0      Good
                         Write-Policy Default          StripeSize  16KB

Returned Values

Returned values include LD index, LD ID, RAID level, size (GB), status, number of disks, number of spares, and number of failed disks.

Status values include:

show logical-drives parity-check

Description

The show logical-drives check-parity command displays the status of a parity check being performed on a logical drive. Returned values include LD index, LD ID, and progress. To cancel the parity check, use the abort parity-check command. For details, see abort parity-check.

Syntax


show logical-drives parity-check 



Note - The abbreviation ld can be substituted for the keyword logical-drive.


Examples

The following example returns the percent complete for the parity check for logical drive 0.


sccli> check parity ld0
sccli> show ld parity-check
LD      LD-ID     Status
------------------------
ld0     627D800A  2% complete

For details on the check parity command, see check parity.

show logical-drives rebuilding

Description

The show logical-drives rebuilding command displays the status for all logical drives being rebuilt. Returned values include LD index, LD ID, and progress. To cancel the rebuild, use the abort rebuild command. For details, see abort rebuild.

Syntax


show logical-drives rebuilding 



Note - The abbreviation ld can be substituted for the keyword logical-drive.


Examples

The following example returns the rebuilding process percent complete for the logical drive.


# sccli c2t0d0 show logical-drives rebuilding

show media-check

Description

The show media-check command displays the progress of a media check. To cancel the media check, use the abort media-check command. For details, see abort media-check.



Note - The front-panel LEDs for the drives being checked will blink until the media check is finished or aborted. For more information about LEDs, refer to the Sun StorEdge 3000 Family Installation, Operation, and Service Manual for your array.


Syntax


show media-check

Examples

The following example shows the progress of the media check.


sccli> show media-check
 Ch  ID  Iteration  Status
------------------------------
 2   6   0          2% complete
 2   7   0          2% complete
 2   8   0          2% complete
 2   9   0          2% complete

show stripe-size-list

Description

The show stripe-size list command displays the valid stripe block size list for the specified RAID level. To set the stripe size for an individual logical drive, use the create logical-drive command. For details, see create logical-drive.



Note - Once data is written to logical drives, the only way to change the stripe size is to back up all data to another location, delete all logical configurations of drives, reconfigure the logical drive with the stripe size, and reboot the array.


Syntax


show stripe-size-list raid-level

Arguments


TABLE 5-19 Arguments for show stripe-size-list

Argument

Description

raid-level

Specify the RAID level to display the corresponding stripe block size. Valid values: raid0, raid1, raid3, raid5.


Examples

The following example shows the stripe block list for RAID5.


sccli> show stripe-size-list raid5
 raid5-stripe-sizes: 16KB 32KB 64KB 128KB 256KB
 raid5-stripe-size-default: 128KB

shutdown logical-drive

Description

The shutdown logical-drive command guarantees that all the data is written to the disk drives, so the disk drives can be safely removed from the chassis. Other logical drives in the array are still accessible if only one logical drive is shut down.



caution icon Caution - This command is not reversible. To access the logical drive again, the array must be rebooted.




caution icon Caution - Any time logical drives are created or deleted, the numbering of logical drive indexes might change. After creating or deleting logical drives, issue a show logical-drivecommand to view an updated list of logical drive indexes. Or, use logical drive IDs, which do not change over the lifetime of the logical drive, rather than logical drive indexes. For more information, see Logical Drive Syntax.




Note - A logical drive that belongs to a logical volume cannot be shut down.


Syntax


shutdown logical-drive ld-index | ld-id



Note - The abbreviation ld can be substituted for the keyword logical-drive.


Arguments


TABLE 5-20 Arguments for shutdown logical-drive

Argument

Description

ld-index

Specify the logical drive index number. For example, ld3.

ld-id

Specify the logical drive ID. For example, 71038221.


Examples

The following example shuts down the logical drive and then shows the status of that drive.


sccli> shutdown logical-drive ld3
WARNING: This is a potentially dangerous operation.
The logical drive will be placed permanently offline.
A controller reset will be required to bring it back online.
Are you sure? yes
sccli: ld3: offlined logical drive
sccli> show logical-drive
LD    LD-ID         Size  Assigned    Type     Disks Spare  Failed Status
-------------------------------------------------------------------------
ld0   0043BF50  101.01GB  Primary     RAID0      3     0      0    Good
ld1   025E42E1   33.67GB  Primary     RAID1      2     3      0    Good
ld2   05CC1F19   67.34GB  Primary     NRAID      2     0      0    Good
ld3   52AD5DEB   33.67GB  Primary     NRAID      1     0      0    ShutDown

unconfigure local-spare

Description

The unconfigure local-spare command removes a local spare disk as a dedicated spare disk for the specified logical drive.



caution icon Caution - Any time logical drives are created or deleted, the numbering of logical drive indexes might change. After creating or deleting logical drives, issue a show logical-drivecommand to view an updated list of logical drive indexes. Or, use logical drive IDs, which do not change over the lifetime of the logical drive, rather than logical drive indexes. For more information, see Logical Drive Syntax.


Syntax


unconfigure local-spare disk [ld-index | ld-id]

Arguments


TABLE 5-21 Arguments for unconfigure local-spare

Argument

Description

disk

Specify the disk to unconfigure. For example, specify the disk with target ID 1 on channel 2 as 2.1.

ld-index

Specify the logical drive index number. For example, ld3.

ld-id

Specify the logical drive ID. For example, 71038221.


Examples

The following example unconfigures disk drive ID 5 on channel 2 as a local spare for the logical drive with index number 2.


# sccli c2t0d0 unconfigure local-spare 2.5 ld2

The following example unconfigures disk drive ID 5 on channel 2 as a local spare for the logical drive with ID 2C33AAEA.


# sccli c2t0d0 unconfigure local-spare 2.5 2C33AAEA


Partition Commands

The following commands are explained in this section:

configure partition

Description

The configure partition command specifies how much disk space to assign to the partition or deletes a specified partition. When a logical drive or logical volume is created, it is automatically assigned to partition 0.

Syntax


configure partition partition [size | delete]

Arguments


TABLE 5-22 Arguments for configure partition

Argument

Description

partition ID

Specify a combination of LD-ID/LV-ID and partition-number in XXXXXXXX-PP format where XXXXXXXX represents the Logical Drive/Volume ID, or a combination of LD/LV Index and partition number in ld{X}/lv{X}-PP format where LD/LV Index is the Logical Drive/Volume Index number. PP is a two-digital hexidecimal number that represents the partition number.

size

Specify the partition size in MB, such as 4000MB. To delete a partition, specify a size of 0. Or, use the delete keyword.

delete

To delete a partition, specify the delete keyword. All partitions in the logical drive or logical volume must be unmapped for this argument to take effect.




Note - All device capacity is displayed in powers of 1024. For details, see Device Capacity.




Note - Changes to a partition cause the next-higher-numbered partition to shrink or grow. Any change in the size of one partition causes the dimensions of the partition next to it to change as well, invalidating whatever data might be stored on both partitions. Before implementing a new partition layout, the layout is displayed and the user is warned that data in the old partitions will be lost. The user is prompted to continue.


Examples

The following example creates a partition for a logical drive with a logical drive index number of 2, partition number of 2, and partition size of 4000 Mbyte, and leaves the remaining capacity for the next partition.


# sccli c2t0d0 configure partition ld2-02 4000MB

The following example creates a partition for a logical drive with a logical drive ID of 1D2F34AA, partition number of 2, and partition size of 4000 Mbyte, and leaves the remaining capacity for the next partition.


# sccli c2t0d0 configure partition 1D2F34AA-02 4000MB

This example deletes a partition from logical drive 0.


# sccli c2t0d0 configure partition ld0-0 delete

map partition

Description

The map partition command maps a partition to the specified host channel, target, and LUN on the specified controller. To review host channel assignments, run the show channels command. For more information, see show channels. To review LUN maps, see show lun-maps.



Note - In redundant-controller configurations, the specified channel and target must be valid on the controller to which the specified logical drive or volume is assigned. For example, to map a partition to the primary controller in a FC array, the logical drive or logical volume must be assigned to a primary channel ID.




Note - A maximum of 32 partitions per logical drive can be created. And, a maximum of 64 host WWN entries can be created.


Syntax

To map a partition, use the following syntax:


map partition-id channel channel-number target SCSI-id lun lun-number [wwpn | host-id][read-only | read-write] [include | exclude] [mask] [name]

Or, to map a partition, use the following syntax:


map partition-id channel.target.lun [wwpn | host-id][read-only | read-write] [include | exclude] [mask] [name]

Arguments


TABLE 5-23 Arguments for map partition

Argument

Description

partition ID

Specify a combination of LD-ID/LV-ID and partition-number in XXXXXXXX-PP format where XXXXXXXX represents the Logical Drive/Volume ID, or a combination of LD/LV Index and partition number in ld{X}/lv{X}-PP format where LD/LV Index is the Logical Drive/Volume Index number. PP is a two-digital hexidecimal number that represents the partition number. Valid partition-IDs for a logical drive, for example, are 3C2B1111-01 or ld2-03. Valid partition-IDs for a logical volume, for example, are 205FB9AC-01 or lv2-03.

channel ch

Specify a host channel number between 0 and 7.

target target

Specify a host channel target number between 0 and 126.

lun lun

Specify a host channel LUN number.

channel.target.lun

Specify the channel, target, and LUN to map. For example, 4.1.2 represents physical channel 4, target ID 1, logical unit number 2.

wwpn

Sun StorEdge 3000 family FC and SATA devices only. Specify a worldwide port name (WWPN) to map to the host bus adapter with the specified WWPN. To review the available WWPN values, run the show port-wwn command. For details, see show port-wwn.

host-id

Specify the host-ID of the corresponding WWPN to map to the host bus adapter. To review the available WWPN values, run the show port-wwn command. For details, see show port-wwn.

[read-only | read-write]

Sun StorEdge 3000 family FC and SATA devices only. To specify the access mode, which assigns Read-Only or Read/Write privileges, type read-only or read-write.

[include | exclude]

Sun StorEdge 3000 family FC and SATA devices only. Specify include to grant LUN access to the host identified by the WWN and WWN Mask. Type exclude to deny the identified host LUN access. If no host has been granted access to the selected LUN (by specifying include), all hosts can access that LUN. Once any host is granted access to a LUN, only hosts with explicit access (with include specified) can access that LUN.

mask

Sun StorEdge 3000 family FC and SATA devices only. Specify the WWN Mask. LUN access is granted based on the host identified by WWN and mask.

name

Sun StorEdge 3000 family FC and SATA devices only. To set a name for the filter, type the name you want to use


Examples

The following example maps partition 0 of the logical drive with index number 2 to LUN 0 of channel 1 on ID 112 and 113.


# sccli c2t0d0 map ld2-00 channel 1 target 112 lun 0 

The following example maps partition 0 of the logical drive with ID 2D1A2222 to LUN 0 of channel 1 on ID 112.


# sccli c2t0d0 map 2D1A2222-00 channel 1 target 112 lun 0 

The following example maps partition 0 of the logical volume with index number 2 to LUN 0 of channel 1 on ID 112. It sets access permission to read/write, includes the filter so all hosts can access the LUN, and names it “sabre-2.”


# sccli c2t0d0 map lv2-00 1.112.0 read-write include sabre-2

show lun-maps

Description

The show lun-maps command shows all partitions mapped to a specified host channel. Returned values include host channel, target ID, LUN ID, logical volume or logical drive index, partition ID, controller assignment, and worldwide name (WWN) filters for the LUNs.

Sun StorEdge 3000 family FC and SATA arrays only. This command additionally shows mask information, access (RW for read/write or RO for ready only permission), type (I for include or E for exclude), and name.

Syntax


show lun-maps [channel host-channel-list]

Arguments


TABLE 5-24 Arguments for show lun-maps

Argument

Description

host-channel-list

Specify the LUN format. Use the format {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 configuration.


Examples

The following example shows all partitions mapped to host channel 1 and 3.


sccli> show lun-maps channel 1-3
Ch Tgt LUN   ld/lv  ID-Partition  Assigned  Filter Map
--------------------------------------------------------------
 1   0   0   ld0    64D138EC-00   Primary
 3   1   0   ld1    3C67B2FD-00   Secondary

The following example shows all partitions mapped to the host channels in a Sun StorEdge 3510 FC array.


sccli> show lun-maps
Ch Tgt LUN   ld/lv   ID-Partition  Assigned  Filter Map
                                Access Type Mask             Name
--------------------------------------------------------------------
0  40   0   ld2     3F1561F1-00   Primary   210000E08B101256 {sabre-2}
                                  RW I      FFFFFFFFFFFFFFFF
0  40   0   ld0     20CEAE10-00   Primary   210100E08B301256 {sabre-1}
                                  RW I      FFFFFFFFFFFFFFFF
1  42   0   ld1     15F4EEA7-00   Secondary
1  42   1   ld3     029B14A2-00   Secondary

show partitions

Description

The show partitions command displays information about all disk partitions, or just those partitions allocated from the specified logical volumes or logical drives. Returned values include logical volume or logical drive index, logical volume or logical drive ID, partition number, offset (GB), and size (GB).

Syntax


show partitions [{lv-index | lv-id} | {ld-index | ld-id}]

Arguments


TABLE 5-25 Arguments for show partitions

Argument

Description

lv-index

Specify a comma-separated list of logical volume indexes, for example, lv0,lv1,lv2.

ld-index

Specify the logical drive index number. For example, ld3.

lv-id

Specify a logical volumes using an eight-digit hexadecimal logical volume ID, for example, 3C24554F.

ld-id

Specify the logical drive ID. For example, 71038221.


Examples

The following example shows the logical drive partition table for the logical drive with the ID 161637C1.


sccli> show partitions logical-drive 161637c1
LD/LV    ID-Partition        Size
-------------------------------------
ld0-00   161637C1-00     101.00GB

The following example shows the logical volume partition table for the logical volume with index number 0.


sccli> show part lv0
LD/LV    ID-Partition      Size
-------------------------------
lv0-00   02CE9894-00     4.00GB

unmap partition

Description

The unmap partition command unmaps a partition. Use the appropriate syntax depending on the target you want to unmap. To view the current partitions, use the show partitions or show lun-maps command. For details, see show partitions or show lun-maps.

You can unmap a partition currently mapped to the specified channel.target.lun address. If a host worldwide port name (WWPN) or alias (previously defined using create host-wwn-name) is specified, the specified host LUN mapping is removed without affecting other host LUN maps on the same host LUN.

Syntax

To unmap a partition using a channel, target, LUN address, use the following syntax.


unmap partition channel.target.lun [wwpn | host-wwn-name] 

You can unmap a specified partition from any LUNs to which its mapped, or if channel is specified, from LUNs on the specified channel.

To unmap a partition from a specified partition or channel, use the following syntax.


unmap partition partition-id [channel]

Arguments


TABLE 5-26 Arguments for unmap partition

Argument

Description

partition-id

Specify a combination of LD-ID/LV-ID and partition-number in XXXXXXXX-PP format where XXXXXXXX represents the Logical Drive/Volume ID, or a combination of LD/LV Index and partition number in ld{X}/lv{X}-PP format where LD/LV Index is the Logical Drive/Volume Index number. PP is a two-digital hexidecimal number that represents the partition number. Valid partition IDs for a logical drive, for example, are 3C2B1111-01 or ld2-03. Valid partition IDs for a logical volume, for example, are 205FB9AC-01 or lv2-03.

channel

Specify a host channel number between 0 and 7 when unmapping a specific partition from only one channel.

channel.target.lun

Specify the channel, target, and LUN to unmap. This must be on the same controller as the logical volume or the logical drive that you are unmapping. Specify a host channel number between 0 and 7 when unmapping a specific partition from only one channel. Specify a host channel SCSI target number between 0 and 126. Since a host channel can have multiple SCSI IDs, the user can map the partition to multiple SCSI IDs of a host channel. Use the SCSI-ID-list format: {p}[,...{q}[,...{n}]]. Specify a host channel LUN number. For example, 4.1.2 represents physical channel 4, target ID 1, logical unit number 2.

wwpn

Sun StorEdge 3000 family FC and SATA devices only. Specify a worldwide port name (WWPN) to unmap from the host bus adapter with the specified WWPN. To review the available WWPN values, run the show port-wwn command. For details, see show port-wwn.

host-wwn-name

Sun StorEdge 3000 family FC and SATA devices only. Specify a host name to unmap from the host bus adapter with the specified worldwide name (WWN).


Examples

The following example unmaps the partition assigned to host channel, target ID 0, LUN 3.


sccli> show lun-maps
Ch Tgt LUN   ld/lv  ID-Partition  Assigned  Filter Map
--------------------------------------------------------------
 1   0   0   ld0    13843684-00   Primary
 1   0   1   ld1    295AB786-00   Primary
 1   0   2   ld2    0A7F8942-00   Primary
 1   0   3   ld2    0A7F8942-00   Primary
sccli> unmap partition 1.0.3
sccli> show lun-maps
Ch Tgt LUN   ld/lv  ID-Partition  Assigned  Filter Map
--------------------------------------------------------------
 1   0   0   ld0    13843684-00   Primary
 1   0   1   ld1    295AB786-00   Primary
 1   0   2   ld2    0A7F8942-00   Primary

The following example unmaps the partition from partition ID 0A7F8942-00.


sccli> unmap partition 0A7F8942-00 1

 


Logical Volume Commands

The following commands are explained in this section:

create logical-volume

Description



Note - Logical volumes are unsuited to some modern configurations such as Sun Cluster environments, and do not work in those configurations. Use logical drives instead. For more information about logical drives, see create logical-drive.


The create logical-volume command creates a logical volume from the specified logical drives on the specified controller. The logical drives used to create the logical volume must not already be mapped to any host channels. Be sure to specify the secondary keyword if the underlying logical drives are mapped to the secondary controller.



caution icon Caution - Any time logical volumes are created or deleted, the numbering of logical volume indexes might change. After creating or deleting logical volumes, issue a show logical-volumes command to view an updated list of logical volume indexes. Or, use logical volume IDs, which do not change over the lifetime of the logical volume, rather than logical volume indexes. For more information, Logical Volume Syntax.


Syntax


create logical-volume ld-list [assignment] [write-policy]

Arguments


TABLE 5-27 Arguments for create logical-volume

Argument

Description

ld-list

A comma separated list of logical drive indexes, for example, ld0,ld1,ld2, or a list of logical drive identifiers, such as, 71038221.

assignment

Specify the controller assignment for the logical volume. If no value is specified, the logical volume is assigned to the primary controller by default. Valid values: primary, secondary.

write-policy

Set the write policy for the logical volume. Valid values: write-back, write-through. If you do not specify a write policy, the logical volume uses the write policy specified for the controller. If the write policy changes for the controller, the write policy automatically changes for the logical volume as well. To set the controller write policy, use the set cache-parameters command. For details, see set cache-parameters.


Examples

The following example creates a logical volume using ld0 and ld2 and assigns it to the primary controller.


# sccli c2t0d0 create logical-volume ld0,ld2 primary

The following example creates a logical volume using IDs 2378FDED, 7887DDAB and assigns it to the secondary controller.


# sccli c2t0d0 create logical-volume 2378FDED,7887DDAB secondary

delete logical-volume

Description

The delete logical-volume command deletes the specified logical volumes.



caution icon Caution - Any time logical volumes are created or deleted, the numbering of logical volume indexes might change. After creating or deleting logical volumes, issue a show logical-volumes command to view an updated list of logical volume indexes. Alternatively, use logical volume IDs, which do not change over the lifetime of the logical volume, rather than logical volume indexes. For more information, see Logical Volume Syntax.




Note - Before you can delete a logical volume, you must unmap all assigned LUNs. To review LUN maps, see show lun-maps.


Syntax


delete logical-volume {lv-index | lv-id}

Arguments


TABLE 5-28 Arguments for delete logical-volume

Argument

Description

lv-index

Specify a comma-separated list of logical volume indexes, for example, lv0,lv1,lv2.

lv-id

Specify a logical volumes using an eight-digit hexadecimal logical volume ID; for example, 3C24554F.


Examples

The following example deletes the logical volume with the logical volume index number 2.


# sccli c2t0d0 delete logical-volume lv2

The following example deletes the logical volume with the logical volume ID number 3C24554F.


# sccli c2t0d0 delete logical-volume 3C24554F

set logical-volume

Description

The set logical-volume command sets the write policy and controller assignment for the specified logical volume. Before using this command, you must create a logical volume. For more details, see create logical-volume.



Note - Logical volumes are unsuited to some modern configurations such as Sun Cluster environments, and do not work in those configurations. Use logical drives instead. For more information about logical drives, see create logical-drive.


Syntax


set logical-volume {lv-index | lv-id} [assignment] [write-policy] 

Arguments


TABLE 5-29 Arguments for set logical-volume

Argument

Description

lv-index

Set specific drives in a logical volume. The index number is generated from the Sun StorEdge CLI. Use the show logical-volumes command to find the number.

lv-id

Set specific drives in a logical volume. The ID number is generated from the Sun StorEdge CLI. Use the show logical-volumes command to find the number.

write-policy

Set the write policy for the logical volume. Valid values: write-back, write-through, default. If you do not specify a write-policy, or if you specify default, the logical volume uses the write-policy specified for the controller. If the write policy changes for the controller, the write policy automatically changes for the logical volume as well. To set the controller write policy, use the set cache-parameters command. For details, see set cache-parameters.

assignment

Specify the controller assignment for the logical volume. If no value is specified, the logical volume is assigned to the primary controller by default. Valid values: primary, secondary.


Examples

The following example sets write policy for logical volume 4 to write-back.


set logical-volume lv4 write-back

show logical-volumes

Description

The show logical-volumes command displays information about all, or a specified list, of logical volumes. Returned values include LV index, LV ID, logical volume count, LD ID list, size (Mbyte or Gbyte), write policy, and assignment information. For details on creating logical volumes, see create logical-volume.



caution icon Caution - Any time logical volumes are created or deleted, the numbering of logical volume indexes might change. After creating or deleting logical volumes, issue a show logical-volumes command to view an updated list of logical volume indexes. Or, use logical volume IDs, which do not change over the lifetime of the logical volume, rather than logical volume indexes. For more information, Logical Volume Syntax.




Note - If no write policy is specified for the logical volume, the write policy is set to the global controller setting and “Default” displays in the Write-Policy field. To view the controller write policy, run the show cache-parameters command. For more information about the cache policy, see set cache-parameters.




Note - All device capacity is displayed in powers of 1024. For details, see Device Capacity.


Syntax


show logical-volumes lv-list

Arguments


TABLE 5-30 Arguments for show logical-volumes

Argument

Description

lv-list

Specify a list of logical volumes.


If no arguments are specified, all logical volumes are displayed.

Examples

The following example returns all logical volume information.


# sccli 206.111.111.111 show logical-volumes
sccli: selected se3000://206.111.111.111:58632 [SUN StorEdge 3510 SN#000002]
LV    LV-ID         Size  Assigned    Write-Policy   LDs
----------------------------------------------------------------
lv0   43DBA866   13.67GB  Primary     Default         2   ld1,ld2

The following example returns all logical volumes with logical volume index numbers 0 and 2.


# sccli c2t0d0 show logical-volumes lv0,lv2
LV    LV-ID         Size  Assigned    LDs
-----------------------------------------
lv0 02CE9894    4.00GB  Primary     2   ld0,ld1
lv2 02CE9894    4.00GB  Primary     2   ld0,ld1