Symmetrix CLI cheat sheet

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
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
list database
WWN can access
lists all devices accessible to an HBA on a specified symmetrix system and all
list devs (-wwn)
directors that access each 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 list available devices

-v list detailed information of a device
show <symdevname> display meta device information
-noport list list available devices

sympd commands

lists the symmetrix devices that are accessed through fibre channel and shows
list their controlling director, 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
list -address -fa -available all
access
list -sa all lists all fibre directors (FA) in a symmetrix system
list -sa 15D -v lists detailed information on a FA port
-application list list applications using the symmetrix
-connections list 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
delete deletes all access rights for a WWN in the database
replace allows one HBA to replace another
set lockdown sets or clears the fibre channel ID lockdown
set visibility sets or clears visibility for noncontiguous LUNS
set lunoffset sets or clears a LUN base/offset skip for noncontiguous LUNS.
set heterogeneous sets or clears heterogeneous host inform with distinctive attributes
changes the AWWN for the specified WWN in the database and login history
rename
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
discover hba
entries for thoses WWNs that are not set
Lists foreach fibre director which hosts and HBAs are logged into the
list logins
symmetrix. (displays the login history table contents)
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_db.bin default symapi database file

/var/symapi/config/netcnfg lists the network services available from that host
/var/symapi/config/options the options file contains behavior parameters that can be set to critically
change default behavior of SYMCLI operations, SYMAPI calls and their
 control actions
/var/symapi/config/symavoid identifies devices to skip over when looking for devices
/var/symapi/config/gkavoid identifies devices not chosen as gatekeepers
/var/symapi/config/inqfile lists devices to be added to the symapi database
/var/symapi/log/symapi-
logfile for symcli.symapi functions, calls, activities
<date>.log

common commands

initialize the VCMDB
backup the VCMDB
restore the VCMDB
refresh the database
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
list all devices within the array
list a specific device within the array
VCMDB
# symmaskdb -sid 084 init -f newinit.db
Note: This command only needs to be run once otherwise all SAN
configuration is lost, also make sure the database is backed up regularly.
# symmaskdb -sid 084 -file <filename> backup
# symmaskdb -sid 084 -file <filename> restore
# symmask -sid 084 refresh
Note: Remember any changes to the VCMDB have to be uploaded to the
symmetrix memory, otherwise you will not see your changes.
# symmaskdb -sid 084 list database
# symmaskdb -sid 084 -dev 0029 list assignment -v
FA Ports
# symcfg -sa <##|all> [-p <#>] list -v
# symcfg -sid 084 -FA 15C -address list
Disk Devices
# symdev list
# inq
# symmaskdb -sid 084 -dev 0029 list assignment -v
# symmask -sid 084 -wwn 10000000c9370c0a -dir 15c -p 0 add devs
0029,002A,002B

dir = director port

add access to the symmetrix devices
p = port number on the director port

Note: the devices are symmetrix devices ID's not LUN ID's. Also this is kn
as LUN masking.
remove access from the symmetrix
# symmask -sid 084 -wwn 10000000c9370c0a remove devs 0029,002A
devices
list devices available assigned to a
# symmaskdb -sid 084 -host 10000000c9370c0a list capacity
specific host
display meta devices # symdev show <symdevname>

register the HBA with the VCMDB
List HBAs in local host
List HBAs to FA port logins
Meta devices files
Mapping devices file (map devices to
ports)
Modifying FA Port settings (used for HP
systems only)
HBA
# symmask discover hba
# 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;
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;
The run the following:
# 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;
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