Using symaccess on VMAX storage arrays

written by billy December 4, 2013

vmax01

symaccess – Performs Auto-provisioning Group operations on storage, initiator, and port groups. Allows you to create and manage masking views.

You can search for a command or click on the name to show the symaccess command.

Expand allClose all

List all IG’s

symaccess -sid 000123456789 list -type initiator

List all umapped sym devices

symdev -sid 000123456789 list -noport

Show unmapped metas

symdev -sid 000123456789 list -noport -meta

Show IG details

symaccess -sid 000123456789 show INITIATORGROUP_IG -type initiator

Create a new IG

symaccess -sid 000123456789 -type initiator -name HOST create -wwn 500112345678abcd

Add WWN to existing IG

symaccess -sid 000123456789 add -type initiator -name HOST -wwn 5001abcd12345678

Rename IG

symaccess -sid 000123456789 -type initiator -name HOST rename -new_name NEWHOST

Show symdevs assigned to an IG

symaccess -sid 000123456789 list devinfo -ig INITIATORGROUP_IG

List all PG’s

symaccess -sid 000123456789 list -type port

Show PG details

symaccess -sid 000123456789 show PORTGROUP_PG -type port

Create new PG

symaccess -sid 000123456789 -type port -name MYPORTGROUP_PG -dirport 7F:0,8F:0,9F:0,10F:0 create

Rename a PG

symaccess -sid 000123456789 -type port -name MYPORTGROUP_PG rename -new_name MYPORTGROUPNEW_PG

Verify what PG’s an initiator is part of

symaccess -sid 000123456789 list -type initiator -wwn 500112345678abcd

List all SG’s

symaccess -sid 000123456789 list -type storage

Create SG and add symdevs

symaccess -sid 000123456789 -type storage -name MYSERVERNAME_SG create dev “list of devs here”

NOTE: You can specify a range of devices with the colon or individual devices separated with a commas

Create parent SG with existing SG

This will create a parent child relationship (nested SG)
symaccess -sid 000123456789 -type storage -name MYPARENTNAME_SG_p create sg MYSERVERNAME_SG

Verify what SG’s a symdev is in

symaccess -sid 000123456789 list -type storage -dev 10BC

Give summary of a SG

symaccess -sid 000123456789 list -name STORAGEGROUP_SG

Show all details for SG to include MV

symaccess -sid 000123456789 list -name STORAGEGROUP_SG -v

Display symdevs and MV for a given SG

symaccess -sid 000123456789 show STORAGEGROUP_SG -type storage

Show MV details

symaccess -sid 000123456789 show view MASKINGVIEW_MV

List all IG’s, SG’s, and PG’s

symaccess -sid 000123456789 list

List MV’s with IG, PG, and SG names

symaccess -sid 000123456789 list view

List all IG’s, PG’s and SG’s created with MV’s

symaccess -sid 000123456789 list -v

Create backup of masking data

symaccess -sid 000123456789 -f MaskingDataBackup.bak backup

You will be prompted to confirm backup file before backup is taken

Restore masking data from backup

symaccess -sid 000123456789 -f MaskingDataBackup.bak restore

Show masking info for symdevs

The symdev used in any variation of this command should be a meta head

Single symdev
        symaccess -sid 000123456789 list assignment -dev 10BC

Concurrent symdevs
        symaccess -sid 000123456789 list assignment -dev 10BC:10BE

Check if WWN is logged into any FA’s

symaccess -sid 000123456789 list logins -wwn 500112345678abcd

Replace any instances of a world wide name

symaccess -sid 000123456789 -wwn 500112345678abcd replace new_wwn 5001abcd12345678

List all devs on array

symdev -sid 000123456789 list -all

Leave a Comment