SYMCLI Cheet Sheet Leave a comment

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

init
backup
restore
remove
list database
list devs (-wwn)
list assignment (-dev)
list capacity (-host)

create and initialises a device masking database. On completion, the database

device cannot be written to by the operating system.
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

symdev commands

list
-v list
show <symdevname>
-noport list

list available devices

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

sympd commands

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

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

symmask commands

add devs
remove devs
delete
replace
set lockdown
set visibility
set lunoffset
set heterogeneous
rename
refresh
discover hba
list logins
list hba

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
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)
lists WWNs of the fibre HBAs on this host.

symconfigure commands

-sid <sid> -f <filename>

verify
-sid <sid> -f <filename>
preview
-sid <sid> -f <filename>
commit

verify that we have access to the symmetrix and we can make changes
confirm that the syntax is correct (since we use a mapping files)
commit the changes to the database

control and log files locations

/var/symapi/db/symapi_db.bin
/var/symapi/config/netcnfg
/var/symapi/config/options
/var/symapi/config/symavoid
/var/symapi/config/gkavoid
/var/symapi/config/inqfile
/var/symapi/log/symapi<date>.log

default symapi database file

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

common commands

VCMDB
initialize the VCMDB
backup the VCMDB

# symmaskdb -sid 084 init -f newinit.db

Note: This command only needs to be run once otherwise all SAN con
is lost, also make sure the database is backed up regularly.
# symmaskdb -sid 084 -file <filename> backup

restore the VCMDB

refresh the database

# symmaskdb -sid 084 -file <filename> restore

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

list the database

list a specific device
FA Ports
List currently configured FA port
settings (this is used primary for HP # symcfg -sa <##|all> [-p <#>] list -v
systems)
List currently visable devices on a FA
# symcfg -sid 084 -FA 15C -address list
port
Disk Devices
# symdev list
list all devices within the array
# inq
list a specific device within the array # 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 IDs not LUN IDs. Also this i
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>
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 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
Mapping devices file (map devices to map dev 002e to dir 15C:0 target=0, lun=006;
ports)
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;
Modifying FA Port settings (used for set port2C:1 volume_set_addressing=enabled;
The run the following:
HP systems only)
# symconfigure -sid 084 -f port.txt verify
# symconfigure -sid 084 -f port.txt preview
# symconfigure -sid 084 -f port.txt commit

symcfg
symcfg list : A brief description of the all connected Symmetrix boxes.
symcfg -sid 1234 list -lockn all : Lists all the external locks held in Symmetrix array 1234.
symcfg -sid 1234 -lockn 15 release -force : Release the lock 15 held on array 1234 .
symcfg -sid 1234 list -v : Displays detailed information about the Symmetrix Array 1234.
symcfg -sid 1234 -dir 4a -p 0 list -addr -avail : Lists the LUN information / availability of lun ids
on port 4a:0 in array 1234 .
symcfg -sid 1234 list -rdfg all : List details about all the rdf groups in array.
symcfg -sid 1234 list -rdfg 3 : List details about rdf group 3 .
symcfg -sid 1234 list -rdfg all -dynamic : List details about all the dynamic rdf groups in array .
symcfg -sid 1234 list -rdfg all -static : List details about all the static rdf groups in array .
symcfg -sid 1234 list -ra all : List all RA ports with details like rdfg number , remote array sid and
online status.
symcfg discover : Scans all the devices in hosts looking for new symmetrix devices and rebuilds the
symmetrix configuration database .
symdev
symdev -sid 1234 list : Lists all devices in symmetrix 1234.
symdev -sid 1234 list -noport : Lists the devices which are not mapped to any ports.
symdev -sid 1234 list -noport -meta : Lists all unmapped meta devices .
symdev -sid 1234 list -dynamic : Lists all devices whose dyn_rdf attribute set .
symdev -sid 1234 list -hotspare : Checks whether hotspare invoked in the array .
symdev -sid 1234 show ABC : show the detailed information about the devioce ABC.
symdev -sid 1234 write_disable ABC -SA all : Write disable the device ABC from through all
directors.
symdev -sid 1234 not_ready ABC -SA all : Not ready the device ABC from through all directors.
symmaskdb
symmaskdb -sid 1234 -dev ABC list assign : List the masking details of the dev ABC .
symmaskdb -sid 1234 -wwn xxxxxxx list devs : List the devices masked to the given wwn
number .
symmask

symmask list hba : List the HBA details of the host.

symmask -sid 1234 -dir 4a -p 0 list logins : List out wwn s logged through port 4a:0 .
symmask -sid 1234 refresh : Refresh the VCM Data Base after a masking and unmasking operation.
symmask -sid 1234 -wwn xxxx -dir 4a -p 0 add devs ABC,ABD : Mask the devices ABC and ABD
to the given wwn in 1234 arrray .
symmask -sid 1234 -wwn xxxx -dir 4a -p 0 remove devs ABC,ABD : Unmask the devices ABC
and ABD from the given wwn in 1234 arrray .
symdg
symdg -sid 1234 list : List the device groups which include the devices from array 1234.
symdg create mydg -type rdf1 : Create device group mydg of rdf1 type .
symdg show mydg : Shows the members/details of mydg.
symdg rename mydg yourdg : Renames the mydg to yourdg.
symdg delete mydg -force : Delete device group mydg.
symld
symld -g mydg -sid 1234 add dev ABC DEV006 : Add the RDF device ABC to device group mydg
as DEV006
symld -g mydg remove DEV006 : Remove DEV006 form device group mydg.
symrdf
symrdf -sid 1234 -rdfg 3 -type rdf1 -file rdf.txt -g mydg createpair -establish : Establish the
SRDF relation between the devices given in the file rdf.txt from array 1234(R1) and remote box
according to the rdf group . This command start sync between R1 and R2, and also add these devices
after creating the device group mydg.
symrdf -sid 1234 -rdfg 3 -file rdf.txt query : Query the Devices by using the device pair file.
symrdf -g mydg set mode acp_disk : Set syncing mode to Adaptive Copy.
symrdf -g mydg query : Query the device group.
symrdf -g mydg split : Split the dynamic srdf pair.
symrdf -sid 1234 -rdfg 3 -file rdf.txt deletepair.txt -force : Delete the srdf pairing between
R1/R2 and return them to normal.
symdisk
symdisk -sid 1234 list -hotspare : Lists the Hotpsraes configured in the array.
symdisk -sid 1234 list -by_diskgroup : Dispalys all the disks in the array by grouping by disk
groups.
symdisk -sid 1234 list -diskg_roup 1 : Dispalys all the disks in disk group 1