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.
Note: For Provisioning Storage First the Host needs to be zoned with Storage.
Terms to be Known:
SID: Symmetrix ID
Device: In Vmax device are LUN
Emulation: There are two kind of Emulation Available in VMAX FBA and CKD.
FBA: Fixed block Architecture used for open systems.
CKD: Count key data used for Mainframes and it is a IBM Technology.
Cylinders: Unit to measure capacity in Storage.
1 CYL= 0.9375 MB
Size in GB= Number of Cylinders x 15 x 128 x 512 / 1024 / 1024 / 1024
Number of Cylinders= Size in GB / 15 / 128 / 512 x 1024 x 1024 x 1024
Size of one Sector: 512 Bytes
Number of Sectors per Track: 128
Number of Heads: 15
Size of One Track: ( 512 x 128 )
Bytes Size of One Cylinder: ( 512 x 128 x 15 ) Bytes
Auto Provisioning contains 3 Groups.
1. Initiator Group
2. Port Group
3. Storage Group
Initiator Group contains the world wide name or iSCSI name of a host initiator, also referred to as
an HBA or host bus adapter. An initiator group may contain a combination of up to thirty-two,
Fibre Channel initiators or eight, iSCSI names or a combination of both. Port flags are set on an
initiator group basis, with one set of port flags applying to all initiators in the group. An individual
initiator can only belong to one Initiator Group. The group can be a member in another initiator
group. It can be grouped within a group. This feature is called cascaded initiator groups, and is
only allowed to a cascaded level of one.
Port Group may contain any number of valid front end ports, FAs. Front end ports may belong to
more than one port group. Before a port can be added to a port group the ACLX flag must
enabled on the port.
Storage Group may contain up to (4,096) Symmetrix logical volumes. A logical volume may
belong to more than one storage group. There is a limit of (8,192) storage groups.
Masking view is a container of a storage group, a port group, and an initiator group. When you
create a masking view, the devices in the storage group become visible to the host. The devices
are masked and mapped automatically.
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
000A
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
----- ----- ----------------------- ---- ---- ----------------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
----- ----- ----------------------- ---- ---- ----------------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
----- ----- ----------------------- ---- ---- ----------------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
View Name
------------
View Name
------------
View Name
------------
