Commands to create and query initiator group, port group, storage groups and masking

Product:

 

Symmetrix: VMAX

Enginuity: 5874

EMC SW: Solutions Enabler 7.1.0.0 or above


Description:

 

Commands to create and query initiator group, port group, storage groups and masking views using symaccess for VMAX.

 

 

Resolution:

 

Below are the procedures required to create and query initiator group, port group, storage groups and masking views using

symaccess for VMAX.

 

Create Initiator Group: This group contains the host HBA (initiator) WWN details.

 

1. Create Initiator Group:
     > symaccess -sid xxx -name <init_group_name> -type initiator create

 

2. Add the Initiator HBA WWNs:

     > symaccess -sid xxx -name <init_group_name> -type initiator -wwn <HBA_wwn1> add

     > symaccess -sid xxx -name <init_group_name> -type initiator -wwn <HBA_wwn2> add

     > symaccess -sid xxx -name <init_group_name> -type initiator -wwn <HBA_wwn3> add

etc.

 

or

 

3. It is also possible to create the group and add in one command as follows:

     > symaccess -sid xxx create -name <init_group_name> -type initiator -f <filename> <-- where the file <filename> contains WWN entries,

    for example, 2000000000000001, 2000000000000002, 2000000000000003.

 

Query Initiator Group:

     > symaccess -sid xxx -type initiator -detail show <init_group_name>

 

     Example:
     ------------------------------------------------------------
     Symmetrix ID : 000xxxxxxxxxxxx
     Last updated at : 02:00:00 AM on Fri Feb 13, 2009
     Initiator Group Name : Dev_C_IG
     Originator Port wwn : 10000e08b04daac
     User-generated Name : W2k3-25/HBA_1
     FCID Lockdown : No
     Heterogeneous Host : No

 

     Port Flag Overrides : No
     Type : Fibre
     Originator Port wwn : 210000e08b1ed7f1
     User-generated Name : W2k3-25/HBA_2
     FCID Lockdown : No
     Heterogeneous Host : No
     Port Flag Overrides : No
     Type : Fibre
     ------------------------------------------------------------

 

Create Port Group: This group contains valid front end adapter ports of a Symmetrix VMAX array.

 

1. Create the Port Group:
     > symaccess -sid xxx -name <port_group_name> -type port create


2. Add FA ports:
     > symaccess -sid xxx -name <port_group_name> -type port -dirport 7E:0, 7H:1 add


or


3. It is also possible to create and add in one command as follows:
     > symaccess -sid xxx create -name <port_group_name> -type port -dirport 7E:0, 7H:1


4. Enable ACLX flag using symconfigure:
     > set port 07E:0 ACLX=enable


     NOTE: Refer to EMC Knowledgebase solution emc101448 for more information on changing FA port flag settings using Symconfigure.

 

Query Port Group:

 

     > symaccess -sid xxx -type port show <port_group_name>


     ----------------------------------------------------
     Symmetrix ID :000xxxxxxxxxxx
     Last updated at :02:00:00 AM on Fri Feb 13, 2009
     Port Group Name : DEV_C_PG
     Director Identification {7E:0,8B:1,7B:0, 8A:1}
     Masking View Names { None}
     ----------------------------------------------------

 


Create Storage Group: This group contains the Symmetrix VMAX logical volumes.


1. Create the Storage Group:
     > symaccess -sid xxx -name <storage_group_name> -type storage create


2. Add Symmetrix devices:
     > symaccess -sid xxx -name <storage_group_name> -type storage add devs 0050, 0055

or


3. It is also possible to create and add in one command as follows:
     > symaccess -sid xxx -name <storage_group_name> -type storage create devs 0050, 0055

 

 

Query Storage Group:


     > symaccess -sid xxx -type storage show <storage_group_name>


     Example:
     ----------------------------------------------------
     Symmetrix ID : 000xxxxxxxxxxxx
     Last updated at : 02:00:00 AM on Fri Feb 13, 2009
     Storage Group Name : Dev_C_SG
     Devices : 0050:0055
     Masking View Names : {None}
     ----------------------------------------------------

 

 

Create Masking View: The creation of the Masking View is what triggers the mapping and masking operation. If the Symmetrix logical volumes in the storage group are unmapped, they will be mapped to the ports contained in the port group.


     > symaccess -sid xxx create view -name <masking_view_name> -sg <storage_group_name> -pg <port_group_name> -ig <initiator_group_name>

 


Query Masking View:

 

     > symaccess -sid xxx show view <masking_view_name>


     Example:


     Symmetrix ID : 000xxxxxxx
     Last updated at : 02:00:00 AM on Fri Feb 13, 2009
     Masking View Name : Dev_C_View
     Initiator Group Name : Dev_C_IG
     Host Initiators {210000e08b04daac 210000e08b1ed7f1 210000e08b04dabb 210000e08b04dabc}
     Port Group Name : Dev_C_PG
     Director Identification {7E:0,8B:1,7B:0, 8A:1 }
     Storage Group Name : Dev_C_SG
     Sym Dev      Dir:P      Physical Device Name     Lun      Cap(MB)
     -------------------------------------------------------------------------------
     0050         7E:0       \\.\PHYSICALDRIVE5       0
00A     2048
                  7G:1       \\.\PHYSICALDRIVE6
       000A     2048
                  7B:0       \\.\PHYSICALDRIVE7
       000A     2048
     0051         8A:1      
\\.\PHYSICALDRIVE8       000B     2048

 

 

To list all devices, what Initiator WWNs they are masked on and what masking views they belong to you can run the following
(the below is for all devices and IGs but can specify a particular IG also):


     > symaccess -sid xxx list devinfo [-ig <InitiatorGroupName>]

 

E.g output:


     Symmetrix ID : 000xxxxxxxxx
     Initiator Group Name : IG1
     Last updated at : 07:21:23 AM on Thu Aug 06,2009
     Host Initiators
     {
     WWN :210000aaaaaaaaaa
     }
     Sym Host Cap
     Dev Dir:P Physical Device Name Lun Attr (MB) Masking View Name
     ----- ----- ----------------------- ---- ---- ------ ------------------------
     0050 07F:1 Not Visible 0 (M) 61802 MV_1
     10F:1 Not Visible 0 (M) MV_1
     0053 07F:1 Not Visible 1 (M) 41201 MV_2
     10F:1 Not Visible 1 (M) MV_2

     ------
     Total Capacity 103021
     Initiator Group Name : IG2
     Last updated at : 07:21:23 AM on Thu Aug
     Host Initiators
     {
     WWN :210000bbbbbbbbbbb
     }
     Sym Host Cap
     Dev Dir:P Physical Device Name Lun Attr (MB) Masking View Name
     ----- ----- ----------------------- ---- ---- ------ ------------------------
     0050 07F:1 Not Visible 0 (M) 61802 MV_1

     10F:1 Not Visible 0 (M) MV_1
     0053 07F:1 Not Visible 1 (M) 41201 MV_2
     10F:1 Not Visible 1 (M) MV_2
     ------
     Total Capacity 103021
     Initiator Group Name : IG_PR-UFS-MGMT
     Last updated at : 07:21:23 AM on Thu Aug 06,2009
     Host Initiators
     {
     IG :IG1
     IG :IG2
     }
     Sym Host Cap
     Dev Dir:P Physical Device Name Lun Attr (MB) Masking View Name
     ----- ----- ----------------------- ---- ---- ------ ------------------------
     0050 07F:1 Not Visible 0 (M) 61802 MV_3
     10F:1 Not Visible 0 (M) MV_3
     0053 07F:1 Not Visible 1 (M) 41201 MV_3
     10F:1 Not Visible 1 (M) MV_3
     ------
     Total Capacity 103003