Symmetrix CLI cheat sheet

symmaskdb commands

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

create and initialises a device masking database. On completion, the database written to by the operating system. Note: This command only needs to be run once otherwise all SAN configu 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

lists all devices accessible to an HBA on a specified symmetrix system and al each device List the HBA assignments to devices Lists the capacity of devices assigned to a particlur host list available devices detailed information of a device display meta device information list available devices

list -v list show <symdevname> -noport list

sympd commands

list list -vcm

symcfg commands

lists the symmetrix devices that are accessed through fibre channel and shows director, TID, LUN, device number and serial number. Also shows which dev masking database (VCM). lists all the physical devices in the device masking database lists whether the symmetrix director has device masking turned on 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 deletes all access rights for a WWN in the database

list -v list -address -fa -available all list -sa all list -sa 15D -v -application list -connections list
symmask commands

lists all fibre directors in a symmetrix system and which devices they can acce

add devs remove devs delete

remove a device from the list of devices that a WWN can access in the databa

replace set lockdown set visibility set lunoffset set heterogeneous rename refresh discover hba list logins list hba
symconfigure commands

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

causes the symmetrix system to refresh its WWN related memory tables with database If you update the VCMDB you must run this command to see your chang discovers the HBA on the host and assigns AWWN to the login history table e WWNs that are not set

Lists foreach fibre director which hosts and HBAs are logged into the symme login history table contents) lists WWNs of the fibre HBAs on this host. verify that we have access to the symmetrix and we can make changes

-sid <sid> -f <filename> verify

-sid <sid> -f <filename> preview confirm that the syntax is correct (since we use a mapping files) -sid <sid> -f <filename> commit 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

common commands

default symapi database file lists the network services available from that host

the options file contains behavior parameters that can be set to critically ch 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

VCMDB initialize the VCMDB backup the VCMDB restore the VCMDB refresh the database

# symmaskdb -sid 084 init -f newinit.db Note: This command only needs to be run once otherwi 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 b otherwise you will not see your changes.

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

# symmaskdb -sid 084 list database # symmaskdb -sid 084 -dev 0029 list assignment -v

# symcfg -sa <##|all> [-p <#>] list -v # symcfg -sid 084 -FA 15C -address list # symdev list # inq # symmaskdb -sid 084 -dev 0029 list assignment -v

add access to the symmetrix devices

remove access from the symmetrix devices list devices available assigned to a specific host display meta devices HBA register the HBA with the VCMDB List HBAs in local host List HBAs to FA port logins Build file contents

# symmask -sid 084 -wwn 10000000c9370c0a -dir 15c -p 0 dir = director port p = port number on the director port Note: the devices are symmetrix devices ID's not LUN I masking. # symmask -sid 084 -wwn 10000000c9370c0a remove dev # symdev show <symdevname> # symmask discover hba # symmask list hba -v # symmask -sid 084 list logins

# symmaskdb -sid 084 -host 10000000c9370c0a list capaci

Meta devices files

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

Mapping devices file (map devices to ports)

Modifying FA Port settings (used for HP systems only)

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