Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Back to Table of Contents

Configuration parameters

The KZPBA PCI SCSI adapter emulation has the following configuration parameters:

container

Parameter

container[N]

N (is 0...63) is I/O Bypass controller device number.32766 (no more than 64 units)

TypeText string
ValueParameter

media_type[N]

N is "XXYY" number, where XX = SCSI ID (0

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

  • Physical disk
    •  "\\.\PhysicalDrive<X>", where X is 0, 1, … 
      (warning) 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 PKA DIA container[0]="\\.\PhysicalDrive1"

      .

  • Physical disk by its WWID 

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

      (warning) 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:

      Div
      classsmall

      set PKA 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:

      Div
      classsmall

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

      .

  • dddSCSI device disk unknown to Windows for direct mapping, for example, a SCSI disk or tape reader

    • "\\.\Scsi<N>:<X>:<Y>:<Z>" 
      The values of N, X, Y and Z can be collected using special utility "Host Device Check" included in the CHARON distributive - or manually by investigation of the devices connected to CHARON host in the "Device Manager" applet.

      ParameterDescription
      NA logical number assigned by host operating system (Microsoft Windows) to logical or host’s physical storage resource such as physical SCSI HBA
      XAn internal SCSI bus number (usually 0) on host’s physical SCSI HBA
      YA SCSI ID of physical SCSI target device attached to host’s physical SCSI HBA
      ZA logical unit number inside physical SCSI target device attached to host’s physical SCSI HBA

      Example: 

      set PKA DIA container[202]="\\.\Scsi1:0:1:0"

      .

  • ISO file for reading distribution CD-ROM image
    • [<drive>":\"<path-name>"\"]<file-name>[".iso”]  
      Mapping may also include the full path (recommended), for example: "C:\My disks\vms_distribution.iso"  

      Example:

      set PKA DIA container[600]="C:\My disks\vms_distribution.iso"

      .

  • File representing a physical disk of the HP Alpha system (disk image)
    • [<drive>":\"<path-name>"\"]<file-name>[".vdisk"] 
      These files can be created from scratch with "MkDisk" utility. Data and OS disks backups are transferred from the original system via tapes or network and restored into these container files.   
      Mapping may also include the full path (recommended), for example: "C:\My disks\my_boot_disk.vdisk"   
      Example: 

      set PKA DIA container[401]="tru64-v51-system.vdisk"

      .

  • Other type of drive, for example magneto-optical drive
    • "\\.\<N>:" 
      Example:

      set PKA DIA container[300]="\\.\Z:"

      .

(info) This parameter is initially not set, thus creating NO storage elements on the controller..

media_type

.

.15) and YY = LUN (00..07)
TypeText string
Value

Instructs CHARON VM to use the supplied value as the PRODUCT field in the SCSI INQUIRY data returned to a software running on virtual HP Alpha system in response to SCSI INQUIRY command.

If not specified, CHARON VM attempts to guess the SCSI INQUIRY data based on virtual SCSI device type and underlying container (which is specified in the corresponding container configuration parameter).

Initially is not specified.

Example:

set PKA media_type[0]="HSZ70"

removable

Parameter

removable[N]

N is "XXYY" number, where XX = SCSI ID (0..15) and YY - LUN (00..07)

TypeBoolean
Value

When set to "true", the removable configuration parameter instructs CHARON VM to report the corresponding virtual SCSI device as removable.

Note to set this parameter to "true" if this disk storage element is:

  • Mapped to a host removable device
  • Mapped to a disk/tape image located on a host removable device
  • Mapped to a disk/tape image that has to be renamed/moved/deleted right after dismounting it in the guest OS

By default the removable configuration parameter is set to "false".

Example:

set PKA removable[400]=true

(info) Note that virtual SCSI tapes and CD-ROM devices are always reported as removable regardless of the "removable" configuration parameter.


...