advertisement
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
advertisement
Table of contents
- 12 symaccess
- 36 symacl
- 54 symapierr
- 56 symaudit
- 68 symauth
- 84 symbcv
- 96 symcfg
- 135 symcg
- 162 symchg
- 173 symchksum
- 183 symcli
- 185 symclient
- 188 symclone
- 207 symconfigure
- 270 symconnect
- 277 symdev
- 306 symdg
- 337 symdisk
- 346 symdrv
- 349 symevent
- 368 symfast
- 384 symhost
- 388 syminq
- 393 symioctl
- 402 symipsec
- 418 symlabel
- 423 symlmf
- 429 symlv
- 438 symmask
- 451 symmaskdb
- 457 symmigrate
- 468 symmir
- 490 symntctl
- 499 symoptmz
- 512 sympart
- 517 sympd
- 523 symqos
- 540 symrcopy
- 554 symrdb
- 576 symrdf
- 637 symrecover
- 659 symreplicate
- 688 symreturn
- 690 symrslv
- 697 symsan
- 700 symsg
- 723 symsnap
- 742 symsnapvx
- 765 symstar
- 784 symstat
- 800 symtier
- 808 symtw
- 814 symvg
- 826 Daemon Options File
- 827 Common Parameters
- 829 storsrvd [SYMAPI server daemon] parameters
- 833 storapid [Base Daemon] parameters
- 836 storgnsd [Group Name Service (GNS) Daemon] parameters
- 838 storevntd [Event Daemon] parameters
- 842 storstpd [Statistics Collection (STP) Daemon] parameters
- 846 Options File
- 846 Options File
- 864 Return code handling for Windows and UNIX
- 875 Return code handling for OpenVMS