EMC Solutions Enabler CLI Command Reference

Add to My manuals
882 Pages

advertisement

EMC Solutions Enabler CLI Command Reference | Manualzz

symdev

Performs operations on a specific Symmetrix device.

SYNOPSIS symdev -h symdev [-sid <SymmID>] [-offline] [-v] [-resv | -pgr]

[-wwn | -wwn_encapsulated [-detail] ] [-all] list [ -FA <#|ALL> [-p <#>] |

-SA <#|ALL> [-scsi] [-fibre] [-p <#>]]

[-devs <<SymDevStart>:<SymDevEnd> | <SymDevName>

[,<<SymDevStart>:<SymDevEnd> | <SymDevName>>...]>]

[-cap <#> [-captype <mb|gb|tb|cyl>]] [-N <#>]

[-vcm | -aclx] [-held] [-gige] [-[no]gcm]

[-ficon] [-escon] [-dldev] [-dd]

[-noport|-firstport|-multiport] [-[no]bcv|-drv]

[-meta] [-nomember]

[-spare] [-dynamic] [-vdev]

[-savedev [-nonpooled]] [-raids]

[-disk_group <DskGrpNum> | name:<DskGrpName>]

[-disk_director <#|ALL>]

[-ext_spid <SpindleID>]

[-rg][-sec_raid] [-unprotected] [-sec_unprotected]

[-raid1] [-sec_raid1] [-bcv_emulation]

[-raid5 [-protection <3+1 | 7+1>]]

[-raid6 [-protection <6+2 | 14+2>]]

[-sec_raid5 [-sec_protection <3+1 | 7+1>]]

[-sec_raid6 [-sec_protection <6+2 | 14+2>]]

[-emulation <fba|ckd|ckd3390|ckd3380|as400|celerra>]

[-star_mode] [-star_sync_target] [-star_async_target]

[-[no]reserved] [-cyl] [-geometry_set]

[-service_state [not]degraded | [not]failed |

[not]normal]

[-tdev [-bound | -unbound]] [-datadev [-nonpooled]]

[-migr_tgt] [-pinned] [-host_passive] [-identity_set]

Chapter 1: SYMCLI Commands

symdev 277

Chapter 1: SYMCLI Commands

[-identity [-detail]] [-sg <SgName>] [-rp]

[-host_cache] [-dif1] [-as400_gk] [-fast]

[-orm system | on | off] [-[no]vvol] [-[no]pedev]

[-technology <EFD | FC | SATA>]

[-internal | -external | -encapsulated [-limited]]

[-R1] [-R2] [-R21] [-notrdf] [-rdfg <RdfGrpNum>]

[-rdfa]] [-half_pair] [-dup_pair] [-rdf_metro]

[-insg | -notinsg]

[-ficon_split] list pd [ -FA <#|ALL> [-p <#>] |

-SA <#|ALL> [-scsi] [-fibre] [-p  <# >]]

[-devs <<SymDevStart>:<SymDevEnd> | <SymDevName>

[,<<SymDevStart>:<SymDevEnd> | <SymDevName>>...]>]

[-cap <#> [-captype <mb|gb|tb|cyl>]] [-N <#>]

[-vcm | -aclx] [-held] [-gige] [-[no]gcm]

[-ficon] [-escon]

[-noport|-firstport|-multiport] [-[no]bcv|-drv]

[-meta] [-nomember]

[-spare] [-dynamic] [-vdev]

[-savedev [-nonpooled]] [-raids]

[-disk_group <DskGrpNum> | name:<DskGrpName>]

[-disk_director <#|ALL>]

[-ext_spid <SpindleID>]

[-rg][-sec_raid] [-unprotected] [-sec_unprotected]

[-raid1] [-sec_raid1] [-bcv_emulation]

[-raid5 [-protection <3+1 | 7+1>]]

[-raid6 [-protection <6+2 | 14+2>]]

[-sec_raid5 [-sec_protection <3+1 | 7+1>]]

[-sec_raid6 [-sec_protection <6+2 | 14+2>]]

[-emulation <fba|ckd|ckd3390|ckd3380|as400|celerra>]

[-star_mode] [-star_sync_target] [-star_async_target]

[-[no]reserved] [-cyl] [-geometry_set]

[-service_state [not]degraded | [not]failed |

[not]normal]

[-tdev [-bound | -unbound]]

[-migr_tgt] [-pinned] [-host_passive] [-identity_set]

278 EMC Solutions Enabler CLICommand Reference

[-identity [-detail]] [-sg <SgName>] [-rp]

[-dif1] [-as400_gk]

[-technology <EFD | FC | SATA>]

[-host_cache]

[-orm system | on | off]

[-internal | -external | -encapsulated [-limited]]

[-R1] [-R2] [-R21] [-notrdf] [-rdfg <RdfGrpNum>]

[-rdfa] [-half_pair] [-dup_pair]

[-insg | -notinsg]

[-ficon_split] symdev [-sid <SymmID>] [-offline] list -space <-DA <#|ALL> | -DX <#|ALL>> [-cyl] [-spindle] list -inventory symdev [-sid <SymmID>] [-hyper <#|ALL>] [-spindle]

[-firstport] [-host_cache]

[-orm system | on | off] [-offline] list [-internal |

[-DA <#|ALL>] [-interface <#|ALL>] [-disk <#|ALL>]] list [-external |

[-DX <#|ALL>] [-encapsulated [-limited]]] symdev [-sid <SymmID>] [-v] list -lock

[-devs <<SymDevStart>:<SymDevEnd> | <SymDevName>

[,<<SymDevStart>:<SymDevEnd> | <SymDevName>>...]>] list -identifier <device_name|hp_id|vms_id>

[-devs <<SymDevStart>:<SymDevEnd> | <SymDevName>

[,<<SymDevStart>:<SymDevEnd> | <SymDevName>>...]>]

Chapter 1: SYMCLI Commands

symdev 279

Chapter 1: SYMCLI Commands symdev [-sid <SymmID>] [-offline] [-cyl] [-ficon_split] show <SymDevName> | -wwn <WWN> symdev -sid <SymmID> [-force] release [-lock <#>] [-noprompt]

[-devs <<SymDevStart>:<SymDevEnd> | <SymDevName>

[,<<SymDevStart>:<SymDevEnd> | <SymDevName>>...]>] symdev -sid <SymmID> [-noprompt] [-rp] [-star] [-celerra] rw_enable     <SymDevName>  [[-SA | -FA] <#|ALL>

[-p <#>]] write_disable <SymDevName>  [[-SA | -FA] <#|ALL>

[-p <#>]] ready         <SymDevName> [-rdf_metro] not_ready     <SymDevName> [-rdf_metro] hold          <SymDevName> unhold        <SymDevName>  [-symforce] set -geometry <SymDevName> -cyl <#> <-symm6 | -symm7 |

-symm9 | -sec_trk <#> -trk_cyl <#>>

[-host_capacity <NumBlocks>] set -geometry <SymDevName> -host_capacity <NumBlocks> set -geometry <SymDevName> -default symdev -sid <SymmID> [-noprompt] [-star] relabel           <SymDevName>

280 EMC Solutions Enabler CLICommand Reference

pin               <SymDevName> unpin             <SymDevName> host_active       <SymDevName> [-force] set -persistent   <SymDevName> unset -persistent <SymDevName> set -orm < system | on | off >  <SymDevName> set -gcm          <SymDevName> unset -gcm        <SymDevName> set -no_identity  <SymDevName> symdev -sid <SymmID> [-noprompt] [-v] create  -tdev -cap <#> [-captype <cyl|mb|gb|tb>][-N <#>]

[-bcv] [-emulation <ckd3380|as400|celerra>] create -tdev -emulation <ckd3390> [-N <#>] [-bcv]

<<-model <1|2|3|9|27|54>> |

<-cap <#> [-captype <cyl|mb|gb|tb>]>> create -tdev -emulation <fba> [-mobility] [-bcv]

-cap <#> [-captype <cyl|mb|gb|tb>] [-N <#>] create  <-as400_gk|-gk [-mobility]|-pedev> [-N <#>] delete  <SymDevName> modify  <SymDevName> -tdev -cap <#>

[-captype <cyl|mb|gb|tb>]

Chapter 1: SYMCLI Commands

symdev 281

Chapter 1: SYMCLI Commands symdev -sid <SymmID> -file <FileName>

[-noprompt] [-rp] [-star] [-celerra] rw_enable     [-SA <#|ALL> [-p <#>]] write_disable [-SA <#|ALL> [-p <#>]] ready [-rdf_metro] not_ready [-rdf_metro] hold unhold        [-symforce] set -geometry -cyl <#> <-symm6 | -symm7 | -symm9 |

-sec_trk <#> -trk_cyl <#>>

[-host_capacity <NumBlocks>] set -geometry -host_capacity <NumBlocks> set -geometry -default symdev -sid <SymmID> -file <FileName>

[-noprompt] [-star] relabel pin unpin host_active   [-force] compress [-stop] uncompress [-stop]

282 EMC Solutions Enabler CLICommand Reference

bind -pool <PoolName> unbind rebind -pool <PoolName> allocate [-persistent] allocate -stop free [-all] free [-all] -stop reclaim [-persistent] reclaim [-stop] set -persistent unset -persistent set -orm < system | on | off > set -gcm unset -gcm set -no_identity symdev -sid <SymmID> [-noprompt] [-rp] [-star] [-celerra]

-devs <<SymDevStart>:<SymDevEnd> | <SymDevName>

[,<<SymDevStart>:<SymDevEnd> | <SymDevName>>...]> rw_enable     [-SA <#|ALL> [-p <#>]]

Chapter 1: SYMCLI Commands

symdev 283

Chapter 1: SYMCLI Commands write_disable [-SA <#|ALL> [-p <#>]] ready [-rdf_metro] not_ready [-rdf_metro] hold unhold        [-symforce] set -geometry -cyl <#> <-symm6 | -symm7 | -symm9 |

-sec_trk <#> -trk_cyl <#>>

[-host_capacity <NumBlocks>] set -geometry -host_capacity <NumBlocks> set -geometry -default symdev -sid <SymmID> [-noprompt] [-star]

-devs <<SymDevStart>:<SymDevEnd> | <SymDevName>

[,<<SymDevStart>:<SymDevEnd> | <SymDevName>>...]> relabel pin unpin host_active   [-force] compress [-stop] uncompress [-stop] bind -pool <PoolName> unbind

284 EMC Solutions Enabler CLICommand Reference

rebind -pool <PoolName> allocate [-persistent] allocate -stop free [-all] free [-all] -stop reclaim [-persistent] reclaim [-stop] set -persistent unset -persistent set -orm < system | on | off > set -gcm unset -gcm set -no_identity symdev -sid <SymmID> [-noprompt] [-v]

-devs <<SymDevStart>:<SymDevEnd> | <SymDevName>

[,<<SymDevStart>:<SymDevEnd> | <SymDevName>>...]> delete modify -tdev -cap <#> [-captype <cyl|mb|gb|tb>] symdev -sid <SymmID> -file <DevPairFile>

[-noprompt]

Chapter 1: SYMCLI Commands

symdev 285

Chapter 1: SYMCLI Commands copy -geometry

DESCRIPTION

The symdev command displays information about all or selected Symmetrix devices regardless of whether they are visible to the local host. You can release a Device External Lock (DEL) on one or more specified

Symmetrix devices.

The symdev command also performs the following control actions on all or selected Symmetrix devices: write_disable, rw_enable, ready, not_ready, hold, unhold, pin, unpin, compress, uncompress, relabel, set, unset, bind, unbind, rebind, allocate, free, reclaim, create, delete or modify.

ARGUMENTS allocate       Allocates storage in the thin pool.

bind           Binds the thin device(s) to the pool.

create         Creates device(s).

compress       Starts data compression on thin device(s).

When combined with the -stop option, data compression is stopped.

copy           Copies the source device geometry to the target device geometry when the -geometry option is specified.

delete         Deletes device(s).

free           Frees storage in the thin pool.

286 EMC Solutions Enabler CLICommand Reference

hold           Sets the hold bit on a device. The hold bit is automatically placed on a target device during a TimeFinder/Snap operation.

host_active    Sets the host active mode on device(s).

The device(s) must be in a host passive mode for this operation to succeed.

list           Lists all nonprivate Symmetrix devices that are configured in one or more Symmetrix arrays connected to this host.

list pd        Lists all host visible Symmetrix devices that are configured in one or more

Symmetrix arrays connected to this host.

modify         Expands device(s) capacity.

not_ready      Sets the device(s) to be Not Ready. The device must be in a User Ready state for this operation to succeed.

pin            Sets the device(s) to the user pinned state.

User pinned device(s) will not be moved via FAST controller, but they can be moved via Optimizer or symmigrate.

ready          Sets the device(s) to be Ready. The device must be in a User Not Ready state for this operation to succeed.

rebind         Rebinds the device(s) to the thin pool.

reclaim        Reclaims storage from the thin pool.

relabel        Applies the defined label to the device.

Chapter 1: SYMCLI Commands

symdev 287

Chapter 1: SYMCLI Commands

The device must be in a User Not Ready state for this operation to be accepted.

Refer to the symlabel command to learn how to define a device label.

release        Releases the Device External Lock associated with one or more devices within a

Symmetrix array.

Caution: Use the release lock action only if it appears that a Symmetrix lock is currently hung and there are no other operations in progress on the Symmetrix array (local or remote). Also, make sure that your application is authorized to use the specified lock number.

rw_enable      Sets the device(s) to be Read and Write

Enabled to the local hosts on the specified front director port(s). If no ports are specified, then the device(s) will be Read and Write Enabled on all ports where the device is visible.

set            Sets the device geometry when combined with

-geometry option. Sets the persistent indicator for allocations on thin device(s) when combined with the -persistent option.

Sets the Optimized Read Miss mode when combined with the -orm option.  Sets GCM mode when combined with -gcm. Sets the device to its original identity when combined with

-no_identity option.

show           Shows detailed information about a specific

Symmetrix device, such as 000C.

288 EMC Solutions Enabler CLICommand Reference

unbind         Unbinds device(s) from the thin pool.

uncompress     Starts data decompression on thin device(s).

When combined with the -stop option, data decompression is stopped.

unhold         Resets the hold bit on a device. The hold bit is automatically removed from a target of a Snap device when the TimeFinder/Snap pair is stopped. However, the unhold argument can be used if there was a problem removing the hold bit.

unpin          Resets the device(s) from the user pinned state.

unset    Clears the persistent indicator for allocations on thin device(s) when combined with the -persistent option.  Clears GCM mode when combined with -gcm.

write_disable  Sets the device(s) to be Write Disabled to the local hosts on the specified front-end director port(s).

OPTIONS

-aclx          Lists all device masking devices in

Symmetrix arrays running Enginuity 5874 and higher.

-all           Lists all private devices (Vault devices,

SAVE devices, DRV devices, SFS devices, and

COVD devices) along with other Symmetrix devices.

When used with the free operation,

Chapter 1: SYMCLI Commands

symdev 289

Chapter 1: SYMCLI Commands specifies that all allocations associated with the indicated devices are to be freed, regardless of whether data has been written or not.

-as400_gk      Creates or lists the Symmetrix devices that have the as400_gk attribute set.

-bcv           Creates or lists the BCV device(s).

-bcv_emulation Lists clone emulated BCV devices.

-bound         Lists devices bound to a Thin pool.

-cap           Sets the device capacity to a specific value (in megabytes, gigabytes, terabytes or cylinders). See the '-captype' switch to set the units used.

-captype       Sets the capacity units to a specific value (either 'mb', 'gb', 'tb' or 'cyl').

-celerra       Allows controls on Celerra FBA devices.

-cyl           Lists the device capacity in cylinders, or specifies the device capacity when setting the device geometry. The default is megabytes (MB).

-orm           When combined with the set action, allows setting the Optimized Read Miss mode to system default, on, or off for the specified device(s). When used with the list action, lists devices with Optimized Read Miss mode set to system default, on, or off.

290 EMC Solutions Enabler CLICommand Reference

-DA            Lists the Symmetrix devices that are mapped to a certain DA director number. The interface, disk, and hyper IDs can also be used to limit the list further, but the default is ALL unless otherwise specified.

-datadev       Lists the data device(s).

-dd            Lists the Symmetix devices that are identified as Data Domain devices.

-default       Specifies the device's native geometry when setting the device geometry.

-detail        Lists the full WWN of the device when displaying the external identity information.  When used with the

-wwn_encapsulated option, lists vendor information for the device.

-devs          Specifies a set of Symmetrix device ranges and/or individual Symmetrix devices.

-dif1          Lists the Symmetrix devices that have the dif1 attribute set.

-disk          Lists the Symmetrix devices that are mapped to a certain disk Target ID. The DA, interface, and hyper IDs can also be used to limit the list further, but the default is ALL unless otherwise specified.

-disk_director Lists the Symmetrix devices with hypers residing on spindles configured to the specified back-end disk director and engine to which that director belongs.

Chapter 1: SYMCLI Commands

symdev 291

Chapter 1: SYMCLI Commands

-disk_group    Lists the Symmetrix devices whose hypers are contained on disks within the specified disk group.

-dldev         Lists the diskless devices.

-drv           Lists the DRV devices.

-dup_pair      Lists the SRDF devices in duplicate pair configurations.

-DX            Lists the Symmetrix devices that are mapped to a certain DX director number. The hyper

IDs can also be used to limit the list further, but dfaults to ALL unless specified.

-dynamic       Lists the dynamic SRDF devices capable of being formed into SRDF pairs. When used with -R1, lists RDF1-capable devices. When used with -R2, lists RDF2-capable devices.

When used with both -R1 and -R2, lists RDF1-capable or RDF2-capable devices.

When used without -R1 or -R2, lists

RDF1-capable, RDF2-capable, and

RDF1 or RDF2-capable devices.

-emulation     Lists devices that match the corresponding emulation type.

-encapsulated  Lists devices that are created on external spindles with encapsulation.

-escon         Lists devices mapped to front-end Escon directors.

-external      Lists the Symmetrix devices that are created on external spindles.

292 EMC Solutions Enabler CLICommand Reference

-ext_spid      Lists the Symmetrix devices with hypers residing on the specified external spindle.

-FA            Lists devices mapped to a specific fibre or gige front-end director number.

-fast          Lists the Symmetrix devices that are in 

FAST Managed Storage Groups.

-fibre         Lists devices mapped to front-end fibre directors.

-ficon         Lists devices mapped to front-end Ficon directors.

-ficon_split   Lists/Shows device(s) with Split and CU

Image mapping information.

-file          Specifies a file name with a list of devices to be acted upon. In copy geometry operations, the file must contain two 

SymDevNamed per line. Otherwise, the file must contain one SymDevName per line.

-firstport   Limits the display to just the first port of information for devices that are mapped to more than one port.

-force         Causes a device lock to be released independent of other options currently controlling the use of device locks.

Also applies to the host_active option.

-gcm           Allows setting or unsetting the device GCM attribute. Also lists devices with GCM attribute.

Chapter 1: SYMCLI Commands

symdev 293

Chapter 1: SYMCLI Commands

-geometry      Specifies the operation that will set or reset the device geometry.

-geometry_set  Lists all devices that have the device geometry set.

-gk         Creates the Symmetrix GK devices.

-gige          Lists devices mapped to front-end GigE directors.

-h             Provides brief, online help information.

-half_pair     Lists SRDF devices in a half-pair configuration.

-held          Lists Symmetrix devices in the device group that have device holds for a

TimeFinder/Snap session.

-host_cache    Lists Symmetrix devices which are registered for control by host cache cards.

-host_capacity Specifies the device host usable capacity in 512 bytes blocks.  Supported only on

Symmetrix arrays running Enginuity 5876 and above.

-host_passive  Lists devices set with host passive mode.

-hyper         Lists the Symmetrix devices that are mapped to a certain hyper ID. The DA, interface, and disk IDs or the DX can also be used to limit the list further, but the default is ALL unless otherwise specified.

-identifier    Lists the Symmetrix device identifiers

294 EMC Solutions Enabler CLICommand Reference

assigned to devices by the user or other applications. The user must choose one of the four identifier types currently supported to be displayed.

-identity      Lists the external identity information for each device. The external identity will be displayed if the device has external identity set. Otherwise, the device native identity will be displayed.

-identity_set  Lists devices whose external identity has been changed as part of a federated live migration operation.

-insg         Indicates that only devices contained within a Storage Group are listed.

-interface     Lists the Symmetrix devices that are mapped to a certain DA director interface path. The DA, disk, and hyper IDs can also be used to limit the list further, but the default is ALL unless otherwise specified.

-internal      Lists the Symmetrix devices that are created on internal spindles.

-inventory     Returns a table listing the number of configured Symmetrix devices for each supported emulation type.

-limited       Lists encapsulated devices that are geometry limited.

-lock          Lists devices that have a device external lock, or identifies a lock to release.

Chapter 1: SYMCLI Commands

symdev 295

Chapter 1: SYMCLI Commands

-meta          Lists meta-head devices.

-migr_tgt      Lists the Symmetrix devices that are usable as a migration target.

-mobility      Create FBA device with mobility safe ID.

-model         Indicates one of the CKD3390 models:

CKD3390-1, CKD3390-2, CKD3390-3, CKD3390-9,

CKD3390-27, CKD3390-54.

-multiport     Lists the Symmetrix devices that are mapped to multiple front-end director ports.

-N             Sets the number of devices to create or list.

When used for list operation the # specifies the maximum number of devices to return.

The actual number returned may be less than the specified number if fewer devices exist.

The default is to list all devices.

-nobcv         Lists standard devices only; excludes BCV devices.

-nogcm         Lists only devices that do not have GCM attribute.

-no_identity   Sets the device to its original identity.

-nomember      Lists only devices that are not meta members.  This includes non-meta devices as well as meta head devices.

-nonpooled     Lists devices that are ready to be assigned to a pool.

-nopedev       Lists all Symmetrix devices that are not

Protocol Endpoint (PE) devices.

296 EMC Solutions Enabler CLICommand Reference

-noport        Lists the Symmetrix devices that are not mapped to any front-end director ports.

-noprompt      Requests that no prompts are returned after the command is entered. The default is to prompt the user for confirmation.

-noreserved    Lists all Symmetrix devices that are not reserved as part of a device reservation

(see symconfigure).

-notrdf        Lists only devices that are not RDF devices.

-notinsg       Indicates that only devices not contained within a Storage Group are listed.

-novvol        Lists all Symmetrix devices that are not

VVol devices.

-offline       Displays the Symmetrix devices from the

Symmetrix configuration database without refreshing the data from the Symmetrix array.

-pedev         Creates or lists Protocol Endpoint (PE) device(s).

-persistent    Used with set or unset it specifies operation on the persistent indicator.  Used with allocate or reclaim it specifies the use of persistent storage.

-pgr           Lists the WWN and reservation key of

Symmetrix devices that have SCSI3 persistent group reservations.

Chapter 1: SYMCLI Commands

symdev 297

Chapter 1: SYMCLI Commands

-pinned        Lists the devices that were pinned.

-pool          Specifies a Thin Pool Name.

-protection    Applies to -raid5 or -raid6 only.

Further filters raid devices based on protection types (3+1, 7+1, 6+2 or 14+2).

-p             Lists devices mapped to a specific SCSI or front-end fibre director port. By default, all ports are selected.

-R1            Lists RDF1 (R1) devices. When used with

-dynamic, lists devices that are RDF1 capable (see -dynamic).

-R2            Lists RDF2 (R2) devices. When used with

-dynamic, lists devices that are RDF2 capable. Also, see -dynamic.

-R21           Lists RDF21 (R21) devices.

-raid1         Lists RAID-1 devices.

-raid5         Lists RAID-5 devices.

-raid6         Lists RAID-6 devices.

-raids         Lists RAID-S devices by RAID group number.

The -raid option is synonymous with -raids.

-rdf_metro     Lists devices that are in an RDF/Metro configuration.

When specified with ready and not_ready identifies the devices being controlled are part of an RDF/Metro configuration.

298 EMC Solutions Enabler CLICommand Reference

-rdfa          Lists devices that are RDFA-backed.

-rdfg          Lists devices that belong to the specified

RdfGroup.

-resv          Lists all Symmetrix devices that have SCSI reservations.

-reserved      Lists all Symmetrix devices that have device reservations (see symconfigure).

-rg            Lists primary and secondary RAID group information for each device.

-rp            Allows controls on devices that have been tagged for RecoverPoint use.

Lists the Symmetrix devices that are

RecoverPoint devices.

-SA            Lists devices mapped to a specific SCSI or fibre front-end director number.

-savedev       Lists devices that are Symmetrix SAVE devices.

-scsi          Lists devices mapped to SCSI front-end directors (SAs).

-sec_protection

Applies to -sec_raid5 or -sec_raid6 only. Further filters devices with secondary

RAID-5 or RAID-6 RAID groups based on protection types (3+1, 7+1, 6+2 or 14+2).

-sec_raid      Lists devices with a secondary RAID group.

Chapter 1: SYMCLI Commands

symdev 299

Chapter 1: SYMCLI Commands

-sec_raid1     Lists devices with a secondary RAID-1

RAID group.

-sec_raid5     Lists devices with a secondary RAID-5

RAID group.

-sec_raid6     Lists devices with a secondary RAID-6

RAID group.

-sec_trk       Specifies the number of sectors per track.

-sec_unprotected

Lists devices with a secondary Unprotected

RAID group.

-service_state Lists devices that match the corresponding service state.

-sg            Lists the Symmetrix devices that belong to a specified storage group.

-sid           Specifies a unique Symmetrix ID.

-space         Shows the available or unconfigured storage space for the specified list of disks.

Capacities refer to physical usage on-disk

(spindle). Disks containing device hypers of different emulation types are listed with a Format of "Mixed." Disks containing no hypers (such as empty or spare) are not included.

Note that the summary Total and Unconfigured values are repeated for each emulation type.

These values refer to cumulative capacities for the listed disk(s) and are not specific

300 EMC Solutions Enabler CLICommand Reference

to each emulation type.

-spare         Lists devices that have a spare disk invoked against them during dynamic sparing.

-spindle       Displays spindle information instead of the standard disk address information.

-star          Indicates that the action is targeted for devices in STAR mode.

-star_async_target

Lists devices in STAR ASYNC target mode.

-star_mode     Lists devices in STAR mode.

-star_sync_target

List devices in STAR SYNC target mode.

-stop Specifies that the compress, uncompress, allocate, free or reclaim operation will be stopped.

-symforce      Requests that the Symmetrix force the operation to be executed when normally it is rejected. Use extreme caution when using this option.

-symm6         Specifies the Symmetrix 6 device geometry.

It indicates 64 sectors per track and 15 tracks per cylinder.

-symm7         Specifies the Symmetrix 7 device geometry.

It indicates 128 sectors per track and 15 tracks per cylinder.

-symm9         Specifies the Symmetrix 9 device geometry.

Chapter 1: SYMCLI Commands

symdev 301

Chapter 1: SYMCLI Commands

It indicates 256 sectors per track and 15 tracks per cylinder.

-tdev          Creates or lists the thin device(s).

-technology    Specifies the drive technology type of the primary local back-end storage for the device.

-trk_cyl       Specifies the number of tracks per cylinder.

-unbound       Lists devices that are not bound to a Thin pool.

-unprotected   Lists unprotected devices.

-v             Provides a more detailed, verbose listing.

-vcm           Lists all of the device masking (or VCM) devices in the Symmetrix array.

This option is obsolete in Enginuity 5874 and higher, and is replaced by -aclx.

-vdev          Lists devices that are Symmetrix virtual devices.

-vnx           Specifies the VNX device geometry.

It indicates 16 sectors per track and 32 tracks per cylinder.

-vvol          Lists all VVol devices.

-wwn           Lists the full WWN of all devices, or select a device by its WWN.

-wwn_encapsulated

Lists the WWN of the backing external

302 EMC Solutions Enabler CLICommand Reference

spindle for the device, if the spindle is encapsulated.  Devices which are not backed by encapsulated external spindles will not be listed.

PARAMETERS

DevPairFile    The name of the file that contains pairs of source and target device. One pair per line with the format of source device first, a space and the target device.

For example:

10A 20A

10B 20B

DskGrpName     The disk group name.

DskGrpNum      The disk group number.

EFD            The Enterprise Flash disk drives.

FC             The Fibre Channel disk drives.

FileName       The name of the file that contains a list

(one SymDevName per line) of devices to be acted upon.

NumBlocks      The number of 512 bytes blocks.

RdfGroupNum    The RDF Group number.

SATA           The SATA disk drives.

SgName         The storage group name.

SymDevName   The Symmetrix device name, unique per

Symmetrix, such as 01C.

Chapter 1: SYMCLI Commands

symdev 303

Chapter 1: SYMCLI Commands

SymDevStart    The first Symmetrix device name in a sequence, such as 001C.

SymDevEnd      The last Symmetrix device name in a sequence, such as 00B6.

SymmID         12-digit ID of the Symmetrix array.

RETURN CODES

Code #    Code Symbol  

------ -----------

0         CLI_C_SUCCESS

1         CLI_C_FAIL

19        CLI_C_GK_IS_LOCKED

All GateKeepers to the Symmetrix array are currently locked.

EXAMPLES

To list all nonprivate Symmetrix devices that are configured in Symmetrix arrays connected to this host, enter: symdev list

To show detailed information about Symmetrix device 00C in a Symmetrix array with the specified ID, enter: symdev -sid 870 show 00C

To list the first 20 BCV devices starting at Symmetrix device 01F that are configured in a Symmetrix array enter:

304 EMC Solutions Enabler CLICommand Reference

symdev list -bcv -devs 01F -N 20

To list details about devices in the range from Symmetrix device (0000 to 000A) with device external lock of 9 locked, enter: symdev list -sid 870 -lock 9 -devs 0000:000A -v

To release all Symmetrix devices in Symmetrix 870 that have a device external lock of 9, enter: symdev -sid 3009 release -lock 9

Chapter 1: SYMCLI Commands

symdev 305

advertisement

Related manuals