EMC Symmetrix cheat sheet

symmaskdb | symdev | sympd | symcfg | symmask | symconfigure | file locations | common commands First the Solution enabler software has to be installed which can be obtained from powerlink.emc.com. The should be unzip/untarred and the emc_install program should be run. You need to license the product and then run the following command to discover the connected symmetrix: # /usr/symcli/bin/symcfg discover # /usr/symcli/bin/symcfg list Once 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 backups up the database to a specified file restore a database file removes the meta member devices lists for each symmetrix fibre director which devices in a symmetrix system a WWN can access lists all devices accessible to an HBA on a specified symmetrix system and all directors that access each device List the HBA assignments to devices Lists the capacity of devices assigned to a particlur host

backup restore remove list database list devs (-wwn) list assignment (-dev) list capacity (-host) symdev commands list -v list show <symdevname> -noport list sympd commands

list available devices detailed information of a device display meta device information list available devices

list list -vcm

lists the symmetrix devices that are accessed through fibre channel and shows their controlling director, TID, LUN, device number and serial number. Also shows which device holds the device masking database (VCM). lists all the physical devices in the device masking database

symcfg commands list -v list -address -fa -available all list -sa all list -sa 15D -v -application list -connections list symmask commands add devs remove devs delete replace set lockdown set visibility set lunoffset set heterogeneous rename lists whether the symmetrix director has device masking turned on lists all fibre directors in a symmetrix system and which devices they can access lists all fibre directors (FA) in a symmetrix system lists detailed information on a FA port list applications using the symmetrix list host connections to the array

add a device to the list of devices that a WWN can access in the database remove a device from the list of devices that a WWN can access in the database deletes all access rights for a WWN in the database allows one HBA to replace another sets or clears the fibre channel ID lockdown sets or clears visibility for noncontiguous LUNS sets or clears a LUN base/offset skip for noncontiguous LUNS. sets or clears heterogeneous host inform with distinctive attributes changes the AWWN for the specified WWN in the database and login history table causes the symmetrix system to refresh its WWN related memory tables with the contents of the database

refresh

If you update the VCMDB you must run this command to see your changes discovers the HBA on the host and assigns AWWN to the login history table entries for thoses WWNs that are not set Lists foreach fibre director which hosts and HBAs are logged into the symmetrix. (displays the login history table contents)

discover hba list logins

list hba lists WWNs of the fibre HBAs on this host. symconfigure commands -sid <sid> -f <filename> verify that we have access to the symmetrix and we can make changes verify -sid <sid> -f <filename> confirm that the syntax is correct (since we use a mapping files) preview -sid <sid> -f <filename> commit the changes to the database commit control and log files locations

/ var/symapi/db/symapi_ default symapi database file db.bin / var/symapi/config/netc lists the network services available from that host nfg / the options file contains behavior parameters that can be set to var/symapi/config/optio critically change default behavior of SYMCLI operations, SYMAPI calls ns and their control actions / var/symapi/config/sym identifies devices to skip over when looking for devices avoid / var/symapi/config/gkav identifies devices not chosen as gatekeepers oid / var/symapi/config/inqfi lists devices to be added to the symapi database le / var/symapi/log/symapi- logfile for symcli.symapi functions, calls, activities <date>.log common commands VCMDB # symmaskdb -sid 084 init -f newinit.db initialize the VCMDB

Note: This command only needs to be run once otherwis SAN configuration is lost, also make sure the database is up regularly. # symmaskdb -sid 084 -file <filename> backup # symmaskdb -sid 084 -file <filename> restore # symmask -sid 084 refresh

backup the VCMDB restore the VCMDB

refresh the database

Note: Remember any changes to the VCMDB have to be uploaded to the symmetrix memory, otherwise you will your changes. # symmaskdb -sid 084 list database # symmaskdb -sid 084 -dev 0029 list assignment -v FA Ports

list the database list a specific device List currently configured FA port settings (this is used primary for HP systems) List currently visable devices on a FA port

# symcfg -sa <##|all> [-p <#>] list -v # symcfg -sid 084 -FA 15C -address list

Disk Devices list all devices within the array list a specific device within the array # symdev list # inq # symmaskdb -sid 084 -dev 0029 list assignment -v # symmask -sid 084 -wwn 10000000c9370c0a -dir 15c -p 0 add 0029,002A,002B add access to the symmetrix devices dir = director port p = port number on the director port

Note: the devices are symmetrix devices ID's not LUN ID this is know as LUN masking.

remove access from the symmetrix # symmask -sid 084 -wwn 10000000c9370c0a remove devs 002 devices list devices available assigned to a specific host display meta devices # symmaskdb -sid 084 -host 10000000c9370c0a list capacity # symdev show <symdevname> HBA register the HBA with the VCMDB # symmask discover hba List HBAs in local host List HBAs to FA port logins # symmask list hba -v # symmask -sid 084 list logins Build file contents Form meta from dev 0004, config-striped stripe_size=1920; add dev 0005 to meta 0004; add dev 0006 to meta 0004; add dev 0007 to meta 0004; add dev 0008 to meta 0004; Meta devices files The run the following: # symconfigure -sid 084 -f meta.txt verify # symconfigure -sid 084 -f meta.txt preview # symconfigure -sid 084 -f meta.txt commit map dev 002e to dir 15C:0 target=0, lun=006; map dev 002e to dir 16C:0 target=0, lun=006; map dev 0042 to dir 15C:0 target=0, lun=007; map dev 0042 to dir 16C:0 target=0, lun=007; Mapping devices file (map devices The run the following: to ports) # symconfigure -sid 084 -f mappings.txt verify # symconfigure -sid 084 -f mappings.txt preview # symconfigure -sid 084 -f mappings.txt commit

set port1C:1 volume_set_addressing=enabled; set port15C:1 volume_set_addressing=enabled; set port16C:1 volume_set_addressing=enabled; set port2C:1 volume_set_addressing=enabled; Modifying FA Port settings (used for HP systems only) The run the following: # symconfigure -sid 084 -f port.txt verify # symconfigure -sid 084 -f port.txt preview # symconfigure -sid 084 -f port.txt commit