ADVERTISEMENT

symaccess commands

The symaccess command performs Auto-provisioning Group operations on storage, initiator, and port groups. It will also be used to create and manage masking views.

Below list contains some of the most useful symaccess command examples.

• symaccess -sid 1234 -f MyBackup.txt backup

  Creates a file MyBackup containing all the group and view information currently on the Symmetrix array 1234
  Copied

• symaccess -sid 1234 -f MyBackup.txt restore

  Restores all the group
  Copied

• symaccess -sid 1234 -f Total_views backup

  This command will backup all the Masking Views information for array 1234 to file Total_views.
  Copied

• symaccess -sid 1234 -f Total_views restore

  This command will restore all Masking view information for Vmax Array 1234 from file Total_views , which is earlier created by "backup" option.
  Copied

• symaccess -sid 1234 -file Views_Groups_1234.txt backup

  Backup all the view and group information currently on VMAX 1234 to the file Views_Groups_1234.txt.
  Copied

• symaccess -sid 1234 -file Views_Groups_1234.txt list

  List all the Group(storage,port,initiator) information from the backup file "Views_Groups_1234.txt".
  Copied

• symaccess -sid 1234 -file Views_Groups_1234.txt list view

  List all the views from the backup file "Views_Groups_1234.txt".
  Copied

• symaccess -sid 1234 -file Views_Groups_1234.txt restore

  Restores all the groups, views, and security informations from the previously(created using backup option) file.
  Copied

• symaccess -sid 1234 -name IG_Servers -type initiator -ig IG_Server_A remove

  Remove Initiator Group 'IG_Server_A' from parent Initiator Group 'IG_Servers'
  Copied

• symaccess -sid 1234 -name IG_Server_A -type initiator -wwn 1000000000000001 remove

  Remove HBA WWN 1000000000000001 from Initiator Group IG_Server_A
  Copied

• symaccess -sid 1234 -name PG_1_2_15_16_E0_Group -type port -dirport 1e:0,16e:0 remove

  Remove ports 1e:0 and 16e:0 from port group 'PG_1_2_15_16_E0_Group'.
  Copied

• symaccess -sid 1234 -name PG_1_2_15_16_E0_Group -type port -dirport 1e:0,16e:0 remove -unmap

  Remove ports 1e:0 and 16e:0 from port group 'PG_1_2_15_16_E0_Group'.The '-unmap' option also unmap(from 1e:0 and 16:e0) the devices on all related Storage Groups associated with port group 'PG_1_2_15_16_E0_Group'.
  Copied

• symaccess -sid 1234 -type initiator -name Host1 add -wwn 1000000000000002

  Add another HBA WWN to the existing Initiator group(IG) "Host1".
  Copied

• symaccess -sid 1234 -type initiator -name Host1 create -consistent_lun

  Create the Initiator Group Host1 and enable the LUN id consistency at the same time.
  Copied

• symaccess -sid 1234 -type initiator -name Host1 create -wwn 1000000000000001

  Creates and initiator group called Host1 by adding the specified wwn
  Copied

• symaccess -sid 1234 -type initiator -name Host1 rename -new_name Host2

  Rename the Initiator Gorup Host1 as Host2
  Copied

• symaccess -sid 1234 -type initiator -name Host1 set consistent_lun on

  Enable the LUN id consistency on an existing IG.
  Copied

• symaccess -sid 1234 -type initiator -name Host1_Host2_IG add -ig Host2_IG

  Add a child Initiator Group(Host2_IG) to the parent Initiator Group(Host1_Host2_IG).
  Copied

• symaccess -sid 1234 -type port -name 3E0_4E0_13E0_14E0 -dirport 3e:0,4e:0,13e:0,14e:0 create

  Create the portgroup E0_4E0_13E0_14E0 with specified ports
  Copied

• symaccess -sid 1234 -type port -name 3E0_4E0_13E0_14E0 rename -new_name 3E1_4E1_13E1_14E1

  Rename the Port Gorup 3E0_4E0_13E0_14E0 as 3E1_4E1_13E1_14E1
  Copied

• symaccess -sid 1234 -type port -name MyPorts add -dirport 6e:0

  Add an aditional port 6e:0 to the existing port group(PG) "MyPorts".
  Copied

• symaccess -sid 1234 -type storage -name Host1 add devs AAA:AAB

  Add the devices AAA:AAB to storage group Host1.
  Copied

• symaccess -sid 1234 -type storage -name Host1 add devs AAA:AAB -celerra

  Add the Celerra devices AAA:AAB to storage group Host1.
  Copied

• symaccess -sid 1234 -type storage -name Host1 create devs AAA:AAB

  Create the storage group Host1 with specified range of devices
  Copied

• symaccess -sid 1234 -type storage -name Host1 remove devs AAA:AAB

  Remove the device AAA to AAB from storage group Host1
  Copied

• symaccess -sid 1234 -type storage -name Host1 remove devs AAA:AAB -unmap

  Remove the device AAA to AAB from storage group Host1 and also unmap from the FAs. Do not use -unmap option if we want to keep the devices mapped to the front end ports. These devices need be unmapped manually later using symconfigure command.
  Copied

• symaccess -sid 1234 -type storage -name Host1 remove devs AAA:AAB -unmap -celerra

  Remove the celerra device AAA to AAB from storage group Host1 and also unmap from the FAs
  Copied

• symaccess -sid 1234 -type storage -name Host1 rename -new_name Host2

  Rename the Storage Gorup Host1 as Host2
  Copied

• symaccess -sid 1234 -type storage -name ParentSG add sg ChildSG1,ChildSG2

  Add the existing child storage groups ChildSG1 and ChildSG2 to the parent Storage Group ParentSG
  Copied

• symaccess -sid 1234 -type storage -name ParentSG create sg ChildSG1,ChildSG2

  Create a new parent Storage Group called ParentSG and add the existing child storage groups ChildSG1 and ChildSG2 to it.
  Copied

• symaccess -sid 1234 -type storage -name ParentSG remove sg ChildSG1,ChildSG2

  Remove the child storage groups ChildSG1 and ChildSG2 from the parent Storage Group ParentSG
  Copied

• symaccess -sid 1234 -wwn 1000000000000001 rename -alias Host1/HBA01

  Create/Rename Node Name(Host1) and Portname(HBA01) in Access-logix database for given WWN.
  Copied

• symaccess -sid 1234 -wwn 1000000000000001 replace -new_wwn 1000000000000002

  Replace all occurance of wwn 1000000000000001 with 1000000000000002 in array 1234
  Copied

• symaccess -sid 1234 create view -name Host1_Allocation -sg Host1 -pg 3E0_4E0_13E0_14E0 -ig Host1

  Create a masking view combined with specified groups
  Copied

• symaccess -sid 1234 delete -name MyInitiator -type init

  Delete/Remove an empty initiator group.The "-force" must be used if the initiator group(IG) is not empty.We can't delete IG if it is part of a Masking View.
  Copied

• symaccess -sid 1234 delete -name MyPortGroup -type port

  Delete/Remove an empty port group.The "-force" must be used if the port group(PG) is not empty.We can't delete PG if it is part of any Masking View.
  Copied

• symaccess -sid 1234 delete -name MyStorageGroup -type storage

  Delete/Remove an empty storage group.The "-force" must be used if the storage group(SG) is not empty.We can't delete SG if it is part of a Masking View.
  Copied

• symaccess -sid 1234 delete view -name Host1_Allocation

  Delete view Host1_Allocation.
  Copied

• symaccess -sid 1234 delete view -name Host1_Allocation -unmap

  Delete view Host1_Allocation and also unmap all the device in associated storage group.
  Copied

• symaccess -sid 1234 list

  List all Initiator, Port and Storage Groups Created for Array 1234
  Copied

• symaccess -sid 1234 list -name MyGroup

  List all groups named MyGroup
  Copied

• symaccess -sid 1234 list -name MyGroup -v

  List all groups named MyGroup and also shows the related Masking Views
  Copied

• symaccess -sid 1234 list -type init -name MyIG

  Find the number of child initiators in IG MyIG and number of associated Masking Views.
  Copied

• symaccess -sid 1234 list -type init -name MyIG -v

  Find the number of child Initiator Groups in IG MyIG and also shows the associated Masking View.
  Copied

• symaccess -sid 1234 list -type initiator

  List all Initiator Groups Created for Array 1234
  Copied

• symaccess -sid 1234 list -type initiator -wwn 1000000000000001

  Check whether the HBA WWN 1000000000000001 is a member of any Initiator Group.
  Copied

• symaccess -sid 1234 list -type port

  List all Port Groups Created for Array 1234
  Copied

• symaccess -sid 1234 list -type port -dirport 1d:04

  List all the port groups in which FA port 1d:04 is a member.
  Copied

• symaccess -sid 1234 list -type port -dirport 1d:04 -detail

  List all the port groups in which FA port 1d:04 is a member. It will also shows the port counts in each port group and the number of masking views for each port group.
  Copied

• symaccess -sid 1234 list -type port -dirport 1d:04 -v

  List all the port groups and masking views in which FA port 1d:04 is a member. It will also shows the port counts in each port group and the number of masking views for each port group.
  Copied

• symaccess -sid 1234 list -type port -name MyPG

  Find the number of ports in Port Group MyPG and numbers of associated Masking views.
  Copied

• symaccess -sid 1234 list -type port -name MyPG -v

  Find the number of ports in Port Group MyPG and also shows the associated Masking Views.
  Copied

• symaccess -sid 1234 list -type storage

  List all Storage Groups Created for Array 1234
  Copied

• symaccess -sid 1234 list -type storage -dev AAA

  Check whether the device AAA is part of of any Storage Groups.
  Copied

• symaccess -sid 1234 list -type storage -name MySg

  Find the number of devices in storage Group MySg and number of associated Masking Views.
  Copied

• symaccess -sid 1234 list -type storage -name MySg -v

  Find the number of devices in storage group MySg and also shows the associated Masking View
  Copied

• symaccess -sid 1234 list -v

  List all Initiator,Port and Storage Groups Created for Array 1234 along with related Masking Views
  Copied

• symaccess -sid 1234 list assignment -dev 9A0:9AF

  Shows the masking details of devices from 9A0 to 9AF
  Copied

• symaccess -sid 1234 list devinfo -ig MyInitiator

  List the details of devices assigned to the initiatorgroup MyInitiator
  Copied

• symaccess -sid 1234 list logins -dirport 12f:1

  List WWPNs logged in to FA port 12f:1
  Copied

• symaccess -sid 1234 list logins -wwn 1000000000000001

  Check whether wwn 1000000000000001 logged in to any of the FAs on array 1234.
  Copied

• symaccess -sid 1234 list logins -wwn 1000000000000001 -v

  Check whether wwn 1000000000000001 logged in to any of the FAs on array 1234."-v" options also provides the time of login change. This is helpful if the wwpn not logged in now on the FAs , but want to know when its got disconnected.
  Copied

• symaccess -sid 1234 list no_assignments -dirport 12f:1

  Shows the devices are mapped to 12f:1 but not part of any masking view.
  Copied

• symaccess -sid 1234 list view

  List masking views Created for Array 1234 with related groups details
  Copied

• symaccess -sid 1234 list view -name Host1_Allocation -detail

  Provides detailed infomation about the masking view .This output is same as 'symmaccess show view'.
  Copied

• symaccess -sid 1234 list view -name Host1_Allocation -v

  This command shows more readable information about the associated Storage Group,Initiator Groups and Port Groups.
  Copied

• symaccess -sid 1234 remove -login -wwn 1000000000000001

  Completely remove the wwn 1000000000000001 from the login history table of vmax 1234
  Copied

• symaccess -sid 1234 remove -login -wwn 1000000000000001 -dirport 12g:1

  Delete the wwn 1000000000000001 on port 6g:1 from the login history table of vmax 1234
  Copied

• symaccess -sid 1234 show MyInitiatorGroup -type initiator

  Shows the contents of initiator group MyInitiatorGroup Created on Array 1234
  Copied

• symaccess -sid 1234 show MyInitiatorGroup -type initiator -detail

  By including '-detail' option will shows the Flag settings like 'FCID Lockdown' ,'Consistent Lun'.. for each WWN number in the initiator group.
  Copied

• symaccess -sid 1234 show MyPortGroup -type port

  Shows the contents of port group MyPortGroup Createdon Array 1234
  Copied

• symaccess -sid 1234 show MyStorageGroup -type storage

  Shows the contents of storage group MyStorageGroup Created on Array 1234
  Copied

• symaccess -sid 1234 show view MyView

  Shows the contents of view MyView Created on Array 1234
  Copied

• symaccess -sid 1234 show view MyView -detail

  This command is the best option to see both parent and child initiator groups( cascaded initiator group) and associated devices for a masking view.
  Copied

• symaccess -sid 1234 show view Server_A_B_View -ig Server_B_IG

  Displays the content of view 'Server_A_B_View' with the WWN details of child-Initiator group 'Server_B_IG'.
  Copied

• symaccess -sid 1234 verify

  Verify the ACLX database in VMax 1234 is consistent.
  Copied

• symaccess -sid 1234 view -name Host1_Allocation rename -new_name Host2_Allocation

  Rename name of view Host1_Allocation as Host2_Allocation
  Copied

• symaccess -sid 1234 view -name Host1_Allocation rename -new_name Host2_Allocation

  Rename name of view Host1_Allocation as Host2_Allocation
  Copied

• symaccess list hba

  Shows the wwn of the local HBA and the devices assigned to those.
  Copied