Table of Contents

General description

CHARON-AXP supports PCI I/O bypass controller for accessing to disk images and host physical disks. PCI I/O bypass controller requires a specific driver to be installed.

Prerequisites

This release supports VMS version V6.2-1H3 and higher. Bypass disks can not be used as a boot device in V6.2-1H3, higher versions do not have this restriction.

Make sure that the latest Bypass controller kit has been installed, especially for VMS versions before V7.3-2.

Installation

1. Open your VM configuration and attach the virtual disk "ovms_tool.vdisk"  located by default in the "C:\Program Files\CHARON\Virtual Disk Images\OpenVMS tools package" directory:

2. Run VM, boot guest OpenVMS operating system.

3. Mount the disk, its label is "TOOLS" (Example: $ MOUNT DKA400: TOOLS)

4. Use the POLYCENTER Software Installation (PCSI) utility to install the Bypass Driver.  The following example demonstrates the "PCSI PRODUCT INSTALL" command to execute and the expected output (the example assumes the utilities virtual disk image is attached as DKA400:):

Loading PCI I/O bypass controller

Syntax for loading PCI I/O bypass storage adapter:

The <name> can be DI<x>, DR<x> or DU<x>

where x is selected according to VMS naming scheme, i.e. A stands for the first controller of given type, B - for the second, etc.

Example:

The adapter instance name ("DIA" in the example above) is used then for parametrization, for example:

The numbers in the square brackets represent a number of device on PCI I/O Bypass controller.

The maximum number of I/O Bypass controller devices is 64.

By default I/O Bypass controller uses PCI slot corresponded to the <x> parameter (see above). If instead some particular slot is needed, refer to this section for details of specific placement of PCI peripherals on CHARON Virtual Machine (VM) PCI bus (note that "irq_bus" and "irq" parameters are ignored for I/O Bypass controller). In this case the <x> will be changed automatically according to custom position of I/O Bypass controller on PCI bus.

 I/O Bypass controller is implemented for OpenVMS only.

Configuration parameters

The I/O Bypass controller has the following configuration parameters:

container

Possible values of the parameter are strings in one of the following forms:

• Physical disk

  • "\\.\PhysicalDrive<X>", where X is 0, 1, …
    Be careful not to destroy all the information from the disk dedicated to CHARON VM by mistake.
    These disks must not be formatted by the host OS.
    Example:
    set DIA container[0]="\\.\PhysicalDrive1"

    .

• Physical disk by its WWID

  • "\\.\PhysicalDrive(DevID=XXX-...-XXXX)"

    Be careful not to destroy all the information from the disk dedicated to CHARON VM by mistake.

    These disks must not be formatted by the host OS.

    DevID addresses the target physical disk by its WWID (hexadecimal 128-bit identifier assigned to the disk drive by its manufacturer/originator).

    Example:

    set DIA container[100]="\\.\PhysicalDrive(DevID=6008-05F3-0005-2950-BF8E-0B86-A0C7-0001)"

    .

• iSCSI disks

  • "\\.\PhysicalDrive(iScsiTarget = <iSCSI target>, LUN = <LUN number>)"

    iScsiTarget addresses the disk by its iSCSI target name.

    LUN specifies LUN on connected iSCSI disk.

    Example:

    set DIA container[200]="\\.\PhysicalDrive(iScsiTarget=iqn.2008-04:iscsi.charon-target-test1, LUN= 1)"

    .