Settings for Xen

When HDLM is installed in an environment that uses Xen, the SCSI devices corresponding to HDLM devices are accessible from a domainU environment. Therefore, you must specify the certain settings so that the SCSI devices cannot be accessed from the domainU environment directly.

The following procedure shows how to migrate SCSI device /dev/sda, which is connected in the domainU environment in a single-path configuration, to HDLM device /dev/sddlmaa, which is connected in a multi-path configuration.

1. Check the correspondence between the HDLM and SCSI devices.

   Execute the HDLM configuration definition utility (dlmcfgmgr) with the -v parameter.

   # /sbin/dlmcfgmgr -v
   HDevName      Management  Device  Host  Channel Target  Lun
   /dev/sddlmaa configured  /dev/sda   2        0       0    0
   /dev/sddlmab configured  /dev/sdb   2        0       0    1
         :
         :
   KAPL10302-I /sbin/dlmcfgmgr completed normally.
   #

   HDLM devices are listed in the HDevName column, and SCSI devices are listed in the Device column.

2. Check whether the SCSI devices can be migrated to the HDLM devices.

   Execute the command shown below.

   In the following example, the domU configuration information is retrieved from the management domain:

   # /usr/sbin/xm list -l domU
         :
         :
        (device
            (vbd
               (uuid 6b393aaa-89e7-44dc-7a57-24d477dee43d)
               (bootable 0)
               (driver paravirtualised)
               (dev sdx)
               (uname phy:/dev/sda)
               (mode w)
           )
       )
         :
         :

   If the SCSI device displayed on the uname phy line is the SCSI device that appeared in step 1, continue to step 3. (Only a SCSI device that appears in step 1 can be migrated to an HDLM device.)

3. If domainU is running, stop it.

   If domainU has been set to automatically start when domain0 starts, temporarily change the setting so that domainU will not start automatically.

4. Specify the settings so that SCSI devices are not used in domainU.

   Disable the block device settings from domainU. For details, see the Linux documentation.

5. Specify the settings so that HDLM devices are used in domainU.

   Set (export) the block devices to domainU. For details, see the Linux documentation.

   Make sure that you specify the settings based on the correspondence between the HDLM and SCSI devices displayed in step 1.

6. Change the single-path configuration to a multi-path configuration.

7. Start domainU.

   If you temporarily changed the settings in step 3 so that domainU would not automatically start, restore the previous settings.