Versions Compared

Old Version 1

changes.mady.by.user Copy Page Tree

Saved on

compared with

New Version 2

changes.mady.by.user Kirill Nikolaev (Unlicensed)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Initial update

...

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

set PKA container[602]="C:\My disks\/Mydisks/vms_distributive.vdisk"

The numbers in the square brackets represent SCSI ID and LUN of the devices on the virtual KZPBA SCSI bus.

...

Mapping to Floppy drive.

Example:

Parameter

Type

Value

scsi_idNumeric

Specifies SCSI ID of KZPBA PCI SCSI Adapter in a range 0..7

By default the "scsi_id" configuration parameter is set to 7.

Example:

set PKA scsi_id=0
host, portText String

These parameters are used in SCSI cluster configurations.

ParameterDescription
hostSpecifies remote end-point (remote host name and, optionally, TCP/IP port on remote host) of SCSI connection between this KZPBA PCI SCSI adapter and remote KZPBA PCI SCSI adapter on some host.
portSpecifies local end-point (TCP/IP port on local host) of SCSI connection between this KZPBA PCI SCSI adapter and remote KZPBA PCI SCSI adapter on some host.

By default the "host" and "port" configuration options are not specified.

Syntax:

port[connection-number]=<local port> host[connection-number]=”<host-name{:tcpip-port-no}>”

where: connection_number = remote_scsi_id * 100 + lun_id

Example:

set PKA port[600]=17060 host[600]=”localhost:16070"

container[N]

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

Text String

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

A SCSI ID of physical SCSI target device attached to host’s physical SCSI HBA

Example:

MappingDescription
"\\.\PhysicalDrive<X>", where X is 0, 1, …/dev/sd<N>"

Mapping to physical disk. (warning) Be careful not to destroy all the information from the disk dedicated to CHARON-AXP by mistak.

These disks must not be formatted by the host OS.

Example:

set PKA container[0]=”\\.\PhysicalDrive1"/dev/sd1"


"\\.\PhysicalDrive(DevID =XXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX)/dev/dm-<N>"
"/dev/mapper/mpath<N>"
"/dev/mapper/disk<N>"		Mapping to physical multipath disk by its WWID. (warning) Be  Be careful not to destroy all the information from the disk dedicated to CHARON-AXP 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:

"\\.\Scsi<N>:<X>:<Y>:<Z>"

Mapping to some SCSI device unknown to Windows for direct mapping
set PKA container[100]=”\\.\PhysicalDrive(DevID= 6008-05F3-0005-2950-BF8E-0B86-A0C7-0001)” 
"\\.\PhysicalDrive(iScsiTarget = <iSCSI target>, LUN = <LUN number>)"

Mapping to iSCSI disks.

iScsiTarget addresses the disk by its iSCSI target name.

LUN specifies LUN on connected iSCSI disk.

Example:

set PKA container[200]=”\\.\PhysicalDrive(iScsiTarget= iqn.2008-04:iscsi.charon-target-test1, LUN= 1)”
"\\.\Tape<X>", where X is 0, 1, …Mapping to a host tape device.
"/dev/mapper/disk0"


"/dev/sg<N>" 

Direct mapping to some SCSI device, for example, a SCSI disk or tape reader. 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
Y
ZA logical unit number inside physical SCSI target device attached to host’s physical SCSI HBA
set PKA container[202]=”\\.\Scsi1:0:1:0"
"\\.\A:" or "\\.\B:"
set PKA container[300]=”\\.\A:"
"\\.\CdRom<X>", where X is 0, 1, …
200]="/dev/sg0"


"/dev/sr<N>"
"/dev/cdrom"
"/dev/cdrom<N>

Mapping to CD-ROM device.

Example:

set PKA container[400]=”\\.\CdRom0"/dev/sr0"


[<drive>":\"<path-name>”\”]<file-name>[“.iso”]

Mapping to an ISO file for reading distribution CD-ROM image.

 Mapping may also include the full path (recommended), for example: "C:\My disks\/my_disks/vms_distributive.iso"

Example:

set PKA container[600]="C:\My disks\/my_disks/vms_distributive.iso"


[<drive>":\"<path-name>”\”]<file-name>[“.vdisk”]

Mapping to the file representing a physical disk of the HP Alpha system (disk image). 

These files can be created from scratch with "MkDiskmkdskcmd" utility. Data and OS disks disk 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_disks/my_boot_disk.vdisk" 

Example:

set PKA container[401]="my_dka401.vdisk"


[<drive>":\"<path-name>”\”]<file-name>“.vtape” 

Mapping to the file representing the tape (tape image). 

 These files are created automatically.

 Mapping may also include a full path (recommended), for example: "C:\My tapes\/my_tapes/backup.vtape"

Example:

Mapping to some other type of drive, for example magneto-optical drive.

Example:

set PKA container[500]="my_mka500.vtape"
"\\.\<N>:"
set PKA container[300]=”\\.\Z:"


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

media_type[N]

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

Text String

Instructs CHARON-AXP 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-AXP 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[N]

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

Boolean

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

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.

geometry [N]

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

Text String

This formatted string value specifies the explicit geometry of the disk storage element. This parameter is not applicable to tape storage elements.

The string format is <X>”/”<Y>[“/”<Z>] where:

ParameterDescription
XThe number of sectors per track
YThe number of tracks per cylinder
Z

The number of cylinders on the unit.

If omitted, Z is calculated based on X, Y and the total number of sectors on the unit that reflects the size of the disk storage element.

This is an optional parameter.

If this parameter is not set, CHARON-AXP will configure the geometry based on the most probable disk type.

Initially not set.

The syntax described above is applicable only to disk storage elements. If the container is a tape image, the following format is used instead:

Syntax:

"<image-size>[, <early-warning-zone-size>]"

where:

ParameterDescription
image-sizeThe tape size in MB
early-warning-zone-size

The size (in KB) of the space left on the tape when a warning to the OS is issued.

If omitted, 64K is assumed.

Example:

 

set PKA geometry[603] = ”255/255”

use_io_file_buffering[N]

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

Boolean

When set to "true", instructs CHARON-AXP to enable host operating system I/O cache on reading/writing operations.

When enabled, host operating system I/O cache may significantly improve I/O performance of the virtual system. At the same time maintaining I/O cache requires additional host resources (CPU and memory) which may negatively affect overall performance of the virtual system.

Initially is set to "false".

Example:

set PKA use_io_file_buffering[603]=true

...

Empty disk images are created with the "MkDiskmkdskcmd" utility utility. Tape images ("*.vtape") will be created automatically if they don't exist (no utility needed).

...

Info

The virtual KZPBA storage controller examines the file extension (vdisk or vtape) to distinguish between a disk image and a tape image.

Configured physical devices or tape/disk images that do not exist on the host system will, in general, cause OpenVMS/Alpha to report the unit offline. In some cases this will result in a VMS BUG CHECK. In this case, an error message will be written to the log file.

...

Back to Table of Contents