EMC Symcli Commands
EMC Symcli Commands
Once SYMCLI is installed the below table lists all common commands that can be used using the symcli command interface.
symmaskdb commands
create and initialises a device masking database. On completion, the database device cannot be written
to by the operating system.
init
Note: This command only needs to be run once otherwise all SAN configuration is lost
backup backups up the database to a specified file
restore restore a database file
remove removes the meta member devices
lists for each symmetrix fibre director which devices in a symmetrix system a WWN can access
list database
symmaskdb -sid 516 list database -output XML
lists all devices accessible to an HBA on a specified symmetrix system and all directors that access each
list devs (-wwn)
device
list assignment (-dev) List the HBA assignments to devices
list capacity (-host) Lists the capacity of devices assigned to a particlur host
symdev commands
list available devices
list
symdev list -inventory
Useful and common EMC Symm CLI Command list Page 4 of 27
sympd commands
lists the symmetrix devices that are accessed through fibre channel and shows their controlling director,
list TID, LUN, device number and serial number. Also shows which device holds the device masking
database (VCM).
list -vcm lists all the physical devices in the device masking database
symcfg commands
list -v lists whether the symmetrix director has device masking turned on
lists all fibre directors in a symmetrix system and which devices they can access
list -address -fa -available all
symcfg -sid xxx list -address -fa 4c -p 1 -available
list -sa all lists all fibre directors (FA) in a symmetrix system
lists detailed information on a FA port
list -sa 15D -v
symcfg list -RA all -sid 516 -switched
symcfg -dir all list –sid 516
list applications using the symmetrix
-application list
symcfg list -applications -sid xxx
list host connections to the array
symmask commands
add devs add a device to the list of devices that a WWN can access in the database
remove devs remove a device from the list of devices that a WWN can access in the database
Useful and common EMC Symm CLI Command list Page 5 of 27
symconfigure commands
-sid <sid> -f <filename> verify verify that we have access to the symmetrix and we can make changes
-sid <sid> -f <filename> preview confirm that the syntax is correct
-sid <sid> -f <filename> prepare
-sid <sid> -f <filename> commit commit the changes to the database
the options file contains behavior parameters that can be set to critically change default
/symapi/config/options
behavior of SYMCLI operations, SYMAPI calls and their control actions
/symapi/config/symavoid identifies devices to skip over when looking for devices
/symapi/config/gkavoid identifies devices not chosen as gatekeepers
/symapi/config/inqfile lists devices to be added to the symapi database
/symapi/log/symapi-<date>.log logfile for symcli.symapi functions, calls, activities
Common commands
VCMDB
# symmaskdb -sid xxx init -f newinit.db
initialize the VCMDB Note: This command only needs to be run once otherwise all SAN
configuration is lost, also make sure the database is backed up
regularly.
backup the VCMDB # symmaskdb -sid xxx -file <filename> backup
restore the VCMDB # symmaskdb -sid xxx -file <filename> restore
# symmask -sid xxx refresh
refresh the database
Note: Remember any changes to the VCMDB have to be uploaded to the
symmetrix memory, otherwise you will not see your changes.
list the database # symmaskdb -sid xxx list database
list a specific device # symmaskdb -sid xxx -dev 0029 list assignment -v
FA Ports
List currently configured FA port settings (this is used
# symcfg -sa <##|all> [-p <#>] list -v
primary for HP systems)
List currently visable devices on a FA port # symcfg -sid xxx -FA 15C -address list
Useful and common EMC Symm CLI Command list Page 7 of 27
Disk Devices
# symdev list
list all devices within the array
# inq
list a specific device within the array # symmaskdb -sid xxx -dev 0029 list assignment -v
# symmask -sid xxx -wwn 5000020001f2 -dir 15c -p 0 add devs 087,088,089
Note: the devices are symmetrix devices ID's not LUN ID's. Also this is
know as LUN masking.
remove access from the symmetrix devices # symmask -sid xxx -wwn 5000020001f2 remove devs 0029,002A
list devices available assigned to a specific host # symmaskdb -sid xxx -host 5000020001f2 list capacity
display meta devices # symdev show <symdevname>
HBA
register the HBA with the VCMDB # symmask discover hba
List HBAs in local host # symmask list hba -v
List HBAs to FA port logins # symmask -sid xxx list logins
Backup vcmdb
# Backup binary vcmdb
sudo symmaskdb -noprompt -sid 90096 backup -file 90096_backup.bin
# Backup text vcmdb
sudo symmaskdb -sid 90096 database list > 90096_backup.txt
symcfg -sid [sym id] -FA [FA] -p [port] -address -available list
# ./symcfg -sid 20322 -dir 9b -p 1 -address -available list |egrep "038D|038E|038F|0390|04EC|
04ED|04EE|04EF|04F7|04F8|04F9|04FA|04FB|04FC|04FD|04FE"
038D /dev/rdsk/c5t13d61s2 0 0 03D
038E /dev/rdsk/c5t13d62s2 0 0 03E
038F /dev/rdsk/c5t13d63s2 0 0 03F
0390 /dev/rdsk/c5t13d64s2 0 0 040
04EC /dev/rdsk/c5t13d65s2 0 0 041
04ED /dev/rdsk/c5t13d66s2 0 0 042
04EE /dev/rdsk/c5t13d67s2 0 0 043
04EF /dev/rdsk/c5t13d68s2 0 0 044
04F7 /dev/rdsk/c5t13d69s2 0 0 045
04F8 /dev/rdsk/c5t13d70s2 0 0 046
04F9 /dev/rdsk/c5t13d71s2 0 0 047
04FA /dev/rdsk/c5t13d72s2 0 0 048
04FB /dev/rdsk/c5t13d73s2 0 0 049
04FC /dev/rdsk/c5t13d74s2 0 0 04A
04FD /dev/rdsk/c5t13d75s2 0 0 04B
04FE /dev/rdsk/c5t13d76s2 0 0 04C
# ./symcfg -sid 20322 -dir 8b -p 1 -address -available list |egrep "038D|038E|038F|0390|04EC|
04ED|04EE|04EF|04F7|04F8|04F9|04FA|04FB|04FC|04FD|04FE"
038D /dev/rdsk/c5t12d61s2 0 0 03D
038E /dev/rdsk/c5t12d62s2 0 0 03E
038F /dev/rdsk/c5t12d63s2 0 0 03F
0390 /dev/rdsk/c5t12d64s2 0 0 040
04EC /dev/rdsk/c5t12d65s2 0 0 041
04ED /dev/rdsk/c5t12d66s2 0 0 042
04EE /dev/rdsk/c5t12d67s2 0 0 043
04EF /dev/rdsk/c5t12d68s2 0 0 044
04F7 /dev/rdsk/c5t12d69s2 0 0 045
04F8 /dev/rdsk/c5t12d70s2 0 0 046
04F9 /dev/rdsk/c5t12d71s2 0 0 047
04FA /dev/rdsk/c5t12d72s2 0 0 048
04FB /dev/rdsk/c5t12d73s2 0 0 049
04FC /dev/rdsk/c5t12d74s2 0 0 04A
04FD /dev/rdsk/c5t12d75s2 0 0 04B
04FE /dev/rdsk/c5t12d76s2 0 0 04C
Useful and common EMC Symm CLI Command list Page 13 of 27
Get info about symmetrix device group (symdg) including devices in the group.
# symdg show archivep
Group Name: archivep
Group Type : RDF2
Valid : Yes
Symmetrix ID : 000187790096
Group Creation Time : Mon Aug 29 11:02:54 2005
Vendor ID : EMC Corp
Application ID : SYMCLI
Number of STD Devices in Group : 8
Number of Associated GK's : 0
Number of Locally-associated BCV's : 0
Number of Locally-associated VDEV's : 0
Number of Remotely-associated BCV's (STD RDF): 0
Number of Remotely-associated BCV's (BCV RDF): 0
Number of Remotely-assoc'd RBCV's (RBCV RDF) : 0
Standard (STD) Devices (8):
{
--------------------------------------------------------------------
Sym Cap
LdevName PdevName Dev Att. Sts (MB)
--------------------------------------------------------------------
DEV001 /dev/vx/rdmp/c3t4d101s2 0120 (M) RW 30469
DEV002 /dev/vx/rdmp/c3t4d102s2 0122 (M) RW 30469
DEV003 /dev/vx/rdmp/c3t4d103s2 0124 (M) RW 30469
DEV004 /dev/vx/rdmp/c3t4d104s2 0126 (M) RW 30469
DEV005 /dev/vx/rdmp/c3t4d105s2 0128 (M) RW 30469
DEV006 /dev/vx/rdmp/c3t4d106s2 012A (M) RW 30469
DEV007 /dev/vx/rdmp/c3t4d107s2 012C (M) RW 30469
DEV008 /dev/rdsk/c3t4d108s2 012E (M) RW 30469
}
Device Group RDF Information
{
RDF Type : R2
RDF (RA) Group Number : 11 (0A)
Remote Symmetrix ID : 000187721328
Useful and common EMC Symm CLI Command list Page 15 of 27
PowerPath
Control Center
Symmetrix Manager
Clariion Manager
SAN Manager
Performance Manager
- dynamicaly moves disk strips
ISL: Inter Switch Links
- full mesh
Terminology:
Zoning: setting up a path (similar to vlans)
Port
- zones are mapped from port in to port out.
- hard zoning
WWN (world wide name)
- MAC addresses are used
- soft zoning
- secure zoning
Storage Area Network (SAN)
LUN Masking
- Used to restrict host's A LUNs from host B's LUNs
LUN - represents a what the OS see's as a physical disk
HYPER - section carved from symmetrix volume.
META - LUN comprised of multiple Hypers
META Head - the first sym device in the META that is presented to represent the LUN
Useful and common EMC Symm CLI Command list Page 21 of 27
sd_max_throttle – The sd_max_throttle variable sets the maximum number of commands that the SCSI sd driver will attempt to queue to a single
HBA driver. The default value is 256. This variable must be set to a value less than or equal to the maximum queue depth of each LUN connected
to each instance of the sd driver. If this is not done, then commands may be rejected because of a full queue condition and the sd driver instance
that receives the queue full message will throttle down sd_max_throttle to 1. This obviously will result in degraded performance. The variable is
set in the /etc/system file as follows:
set sd:sd_max_throttle=20
sd_io_time – The sd_io_time variable is command time out value. Setting this time out value to 120 seconds will prevent the host from issuing
warning messages while non-disruptive operations are performed on the disk array. For example, in a EMC Symmettrix power path environment
this variable can be set to 0x3C (60 seconds). As with the sd_max_throttle value, this is set in the /etc/system file. Using the EMC value in an
example:
scsi_options – The value scsi_options is a setting for SCSI options included as outlined in the bit meaning table above. Solaris 7 default SCSI
settings are for the maximum Ultra Wide Speed. Since the /etc/system file can also affect other disks in the system, consider the effects of
implementing the scsi_options=0x7F8 mask on the other disks. You might consider the bus level or device level setpoints as we discussed above
rather than a system wide setting. An example entry in the /etc/system file would be:
set scsi_options=0x7F8
List Disk info for all visible disks regardless of imported/deported disk group status
# vxdisk -o alldgs list
Useful and common EMC Symm CLI Command list Page 23 of 27
Create vxdg
# vxdg init {new vxdg} {dm name}=cXtYdZ
vxdg init archivep archivep01=c3t4d101s2 archivep02=c3t4d102s2 archivep03=c3t4d103s2 archivep04=c3t4d104s2
archivep05=c3t4d105s2 archivep06=c3t4d106s2 archivep07=c3t4d107s2
Useful and common EMC Symm CLI Command list Page 24 of 27
Remove Diskgroup
Remove sentnlp from VCS.
The above disks have been entered back into the global free pool.
Create volume
# vxassist -g {vxdg} make {volume name} {length} [attributes]
# vxassist -g archivep make archivepu21 213261m layout=stripe
DynamicMultipathing
Get all pathed HBAs(controllers)
# vxdmpadm listctlr all
img2s001n1 # vxdmpadm listctlr all
CTLR-NAME ENCLR-TYPE STATE ENCLR-NAME
=====================================================
c0 Disk ENABLED Disk
c1 OTHER_DISKS ENABLED OTHER_DISKS
c2 EMC ENABLED EMC1
c3 EMC ENABLED EMC1
c2 EMC ENABLED EMC2
c3 EMC ENABLED EMC2