Discovering and assigning VDisks with OpenVMS

To recognize VDisks, OpenVMS issues a UDID value.

Each OpenVMS fibre-attached volume requires a user-defined identifier or unit device identifier (UDID). A UDID is a nonnegative integer that is used when an OpenVMS device name is created. All fibre-attached volumes have an allocation class of $1$, followed by the letters DGA, followed by the UDID value. All storage unit LUNs that you assign to an OpenVMS system require a UDID so that the operating system can detect and name the device. LUN 0 must be created and present, so OpenVMS system can detect the rest of assigned VDisks. See the Hewlett-Packard document, Guidelines for OpenVMS Cluster Configurations, at http://h71000.www7.hp.com/doc/732FINAL/6318/6318pro_contents.html for more information about fibre-attached storage devices.

An OpenVMS UDID value must be a decimal number 0 to 32767. However, because the CLI utility does not enforce UDID value rules, you must ensure that your input is valid. For example, the CLI accepts values such as AaBbCcDd that are not valid for OpenVMS. It is also possible to assign the same UDID value to multiple storage unit volumes. However, each volume that you assign to an OpenVMS system must have a value that is unique within the OpenVMS cluster. For more information on UDID rules, see the HP OpenVMS documentation at http://h71000.www7.hp.com.

Note: Volumes with UDID values greater than 9999 cannot be MSCP-served in an OpenVMS cluster to other systems.

UDID values must be entered during VDisk creation, after MDisk and related group and host information is set up. UDID values can be changed or added using the chvdisk command. See Figure 1.

Figure 1. Example output for assigning VDisks

svctask mkvdisk -mdiskgrp 0 -size 2 -unit gb -iogrp io_grp0 -mdisk mdisk0 -udid 10 -name ovms_10

svctask mkvdiskhostmap -host gs160a ovms_10

When you use the procedure outlined in Figure 1, you can then use the same procedure for the remaining new disks. See Figure 2.

Figure 2. Example output

IBM_2145:svc_190:admin svcinfo lsvdisk -delim :
id:name:IO_group_id:IO_group_name:status:mdisk_grp_id:mdisk_grp_name:capacity:type:FC_id:FC_name:RC_id:RC_name:vdisk_UID
0:ovms_0:0:io_grp_0:online:0:ds6000:2.0GB:striped:::::60050768019381005000000000000000
1:ovms_1:0:io_grp_0:online:0:ds6000:2.0GB:striped:::::60050768019381005000000000000001
2:ovms_2:0:io_grp_0:online:0:ds6000:2.0GB:striped:::::60050768019381005000000000000002
3:ovms_3:0:io_grp_0:online:0:ds6000:2.0GB:striped:::::60050768019381005000000000000003
4:ovms_4:0:io_grp_0:online:0:ds6000:3.0GB:striped:::::60050768019381005000000000000004
5:ovms_5:0:io_grp_0:online:0:ds6000:3.0GB:striped:::::60050768019381005000000000000005
6:ovms_6:0:io_grp_0:online:0:ds6000:2.0GB:striped:::::60050768019381005000000000000006
7:ovms_7:0:io_grp_0:online:0:ds6000:2.0GB:striped:::::60050768019381005000000000000007

If the system is already running, locate the WWPN using the SHOW DEVICE command or the ANALYZE/SYSTEM utility. To run the SHOW DEVICE command, enter:

show device fg/full

To run the ANALYZE/SYSTEM utility, you must have OpenVMS CMKRNL privilege. To use this utility, perform the following steps:

Enter:
```
ANALYZE/SYSTEM
```
At the SDA> prompt, enter:
```
fc show dev fgadapter0
```

where adapter is the letter that identifies the adapter. For example:

fc show dev fga0

Use the SYSMAN utility to discover new disks on the OpenVMS host. See Figure 3.

Figure 3. Example output

SYSMAN> IO SCSI_PATH_VERIFY
SYSMAN> IO AUTOCONFIGURE
SYSMAN> exit
$ sho dev d

Device                  Device           Error    Volume         Free  Trans Mnt
 Name                   Status           Count     Label        Blocks Count Cnt
GS160A$DKA0:            Online               0
$1$DGA10:     (GS160A)  Online               0
$1$DGA11:     (GS160A)  Online               1
$1$DGA12:     (GS160A)  Online               1
$1$DGA13:     (GS160A)  Online               1
$1$DGA14:     (GS160A)  Online               0
$1$DGA15:     (GS160A)  Online               0
$1$DGA16:     (GS160A)  Online               0
$1$DGA17:     (GS160A)  Online               0
$1$DGA10001:  (GS160A)  Online               0
$1$DKD100:    (GS160A)  Online               0
$1$DKD300:    (GS160A)  Mounted              0  GS160A_SYS    25643715   341   1
$1$DKD500:    (GS160A)  Online               0
$1$DQA0:      (GS160A)  Online               0
$1$DQA1:      (GS160A)  Offline              1
$ init $1$dga16: dga16
$ init $1$dga17: dga17
$ mou $1$dga16 dga16
%MOUNT-I-MOUNTED, DGA16 mounted on _$1$DGA16: (GS160A)
$ mou $1$dga17 dga17
%MOUNT-I-MOUNTED, DGA17 mounted on _$1$DGA17: (GS160A)
$ init $1$dga10: dga10
$ init $1$dga11: dga11
$ mou $1$dga11 dga11
%MOUNT-I-MOUNTED, DGA11 mounted on _$1$DGA11: (GS160A)
$ sho dev d

Device                  Device           Error    Volume         Free  Trans Mnt
 Name                   Status           Count     Label        Blocks Count Cnt
GS160A$DKA0:            Online               0
$1$DGA10:     (GS160A)  Online               0
$1$DGA11:     (GS160A)  Mounted alloc       12  DGA11          4193950     1   1
$1$DGA12:     (GS160A)  Online              57
$1$DGA13:     (GS160A)  Online              57
$1$DGA14:     (GS160A)  Online              56
$1$DGA15:     (GS160A)  Online              57
$1$DGA16:     (GS160A)  Mounted alloc       12  DGA16          4193950     1   1
$1$DGA17:     (GS160A)  Mounted alloc       20  DGA17          4193950     1   1
$1$DGA10001:  (GS160A)  Online               0
$1$DKD100:    (GS160A)  Online               0
$1$DKD300:    (GS160A)  Mounted              0  GS160A_SYS    25642572   341   1
$1$DKD500:    (GS160A)  Online               0
$1$DQA0:      (GS160A)  Online               0
$1$DQA1:      (GS160A)  Offline              1