8/2/2019 Symmetrix CLI Cheat Sheet

1/4

Symmetrix CLI cheat sheet

symmaskdb commands

initcreate and initialises a device masking database. On completion, the dwritten to by the operating system.

Note: This command only needs to be run once otherwise all SAN

backup backups up the database to a specified file

restore restore a database file

remove removes the meta member devices

list database lists for each symmetrix fibre director which devices in a symmetrix s

list devs (-wwn)lists all devices accessible to an HBA on a specified symmetrix systemeach device

list assignment (-dev) List the HBA assignments to deviceslist 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 display meta device information

-noport list list available devices

sympd commands

list

lists the symmetrix devices that are accessed through fibre channel an

director, TID, LUN, device number and serial number. Also shows wmasking 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

list -address -fa -available all lists all fibre directors in a symmetrix system and which devices they

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 commandsadd devs add a device to the list of devices that a WWN can access in the datab

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

delete deletes all access rights for a WWN in the database

8/2/2019 Symmetrix CLI Cheat Sheet

2/4

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

rename changes the AWWN for the specified WWN in the database and login

refresh

causes the symmetrix system to refresh its WWN related memory tab

database

If you update the VCMDB you must run this command to see you

discover hbadiscovers the HBA on the host and assigns AWWN to the login histor

WWNs that are not set

list loginsLists foreach fibre director which hosts and HBAs are logged into the

login history table contents)

list hba lists WWNs of the fibre HBAs on this host.symconfigure commands

-sid -f verify verify that we have access to the symmetrix and we can make change

-sid -f preview confirm that the syntax is correct (since we use a mapping files)

-sid -f commit commit the changes to the database

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 criti

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-.log logfile for symcli.symapi functions, calls, activities

common commands

VCMDB

initialize the VCMDB

# symmaskdb -sid 084 init -f newinit.db

Note: This command only needs to be run once

make sure the database is backed up regularly.

backup the VCMDB # symmaskdb -sid 084 -file backup

restore the VCMDB # symmaskdb -sid 084 -file restore

refresh the database# symmask -sid 084 refresh

Note: Remember any changes to the VCMDB h

otherwise you will not see your changes.

8/2/2019 Symmetrix CLI Cheat Sheet

3/4

list the database # symmaskdb -sid 084 list database

list a specific device # symmaskdb -sid 084 -dev 0029 list assignment -

FA Ports

List currently configured FA port settings (this is

used primary for HP systems)# symcfg -sa [-p ] list -v

List currently visable devices on a FA port # symcfg -sid 084 -FA 15C -address list

Disk Devices

list all devices within the array# symdev list

# inq

list a specific device within the array # symmaskdb -sid 084 -dev 0029 list assignment -

add access to the symmetrix devices

# symmask -sid 084 -wwn 10000000c9370c0a -dirdir = director port

p = port number on the director port

Note: the devices are symmetrix devices ID's no

masking.

remove access from the symmetrix devices # symmask -sid 084 -wwn 10000000c9370c0a rem

list devices available assigned to a specific host # symmaskdb -sid 084 -host 10000000c9370c0a li

display meta devices # symdev show

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

Meta devices files

Form meta from dev 0004, config-striped stripe_siadd 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

Mapping devices file (map devices to ports)

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

8/2/2019 Symmetrix CLI Cheat Sheet

4/4

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