Versions Compared

Old Version 1

changes.mady.by.user Copy Page Tree

Saved on

compared with

New Version Current

changes.mady.by.user Kirill Nikolaev

Saved on

Key

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

...

Load a mapping device with the "load" command.  Specify the name of the device instance, the emulated SCSI bus to connect the device to and the SCSI identifier of the CHARON-VAX device.

...

scsi_bus

Parameter

...

Type

...

scsi_bus

TypeIdentifier
Value

Name of the emulated SCSI disk controller: "pka" or "pkb"

scsi_id

Parameter

scsi_id

TypeNumeric
Value

A value between 0 and 7. This is the ID number of the emulated SCSI device. The SCSI adapter is preloaded with address 7. If required, set it to another value in the range of 0-7 from the VAX console.

.

 

Info

There is no direct correspondence between the host hardware SCSI ID and these CHARON-VAX SCSI addresses. Set the correspondence between the physical SCSI addresses on the host system and the CHARON-VAX SCSI bus ID in the configuration file.

 

...

load <instance type>/<module name> <instance name> scsi_bus=<bus name> scsi_id=<number>

Example:

load virtual_scsi_disk/chscsi pka_0 scsi_bus=pka scsi_id=0

...

The "virtual_scsi_disk" mapping has the following parameters:

container

ValueDescriptionname>””“vdisk”

for disk images

for local . here for multipath disks, for floppy drives,
Parameter
Type

container[N]

N=0…7

Type

Text String

Value

A string containing the device name to map to the emulator.

Mapping to host system resources
  • Disk images
    • [<path-
    • name>"/
    • "]<file-name>[
    • ".
    • vdisk"]

    • Format: A string containing the full path to a disk container.

      If only the name of the disk container is specified, CHARON-VAX will look for the container in the folder CHARON is running from.

"/dev/sd<L>"

    • .

  • Local fixed disks (IDE, SCSI, SATA)
    • "/dev/sd<L>" where "L" is letter
    • "/dev/disk/by-id/..." - addressing by the disk ID, for example "/dev/disk/by-id/ata-ST1000DM003-9YN162_S1D01QJ4"
    • "/dev/disk/by-label/..." - addressing by the disk label, for example "/dev/disk/by-label/MyStorage"

    • "/dev/disk/by-uuid/..." - addressing by the disk UUID, for example "/dev/disk/by-uuid/0e808a2f-cdd3-4944-a245-f729ffd73882"

      Note

      Since "/dev/sd<L>" addressing is not persistent, so it is strongly recommended to use "/dev/disk/by-id/wwn-*" syntax instead to refer the disk by its WWID - especially in the enviroments utilizing FC and SAN storages.

      (info) It is also possible to use not a whole disk, but previously created partitions on it. In this case the syntax is the following: "/dev/sd<L><N>" where N is the number of partition to be used.
      .

  • Multipath disks
    • "/dev/dm-<X>",
    • "/dev/mapper/mpath<X>",
    • "/dev/mapper/disk<X>"
    • where X is 0,1,2...
      .
  • Floppy drives
    • "/dev/fd<X>"
    • where X is 0,1,2...

 

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

media_type

Parameter

media_type[N]

N=0…7

Type

Text String

Value

Overrides the PRODUCT ID in the default SCSI INQUIRY data.

Valid values may contain uppercase letters, integers and spaces. The length of the string cannot exceed 16 characters.

If not specified, synthetic SCSI INQUIRY data is returned containing a PRODUCT ID selected based on the disk size.

Initially left unspecified.

geometry

Parameter

geometry[N]

N=0…7

Type

Text String

Value

This formatted string value specifies the explicit geometry of the disk storage element

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

  • "X" is the number of sectors per track;
  • "Y" is the number of tracks per cylinder;
  • "Z" (optional) is 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;

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

use_io_file_buffering

Parameter

use_io_file_buffering[N]

N=0…7

TypeBoolean
Value

Enables use of the host OS I/O buffering.

Initially set to “false” (buffering disabled).

removable

Parameter

removable[N]

N=0…7

TypeBoolean
ValueEnables the logical unit to appear as a removable SCSI disk drive.

Initially set to “false” (fixed, non-removable).

 

(warning) In the table above N stands for logical unit number. The first unit must be 0 with no gaps in subsequent numbering.

Example:

load virtual_scsi_disk/chscsi pka_0 scsi_bus=pka scsi_id=0

set pka_0 container[0] = "/charon/disks/disk1.vdisk"
set pka_0 container[1] = "/dev/sdc"

...

Warning

Unlike MSCP controlled disk images, a disk image connected to a SCSI controller as a virtual SCSI disk CANNOT be replaced by another disk image unless "removable" parameter is set for this particular disk image.

Example:

set pka_0 container = "/charon/disks/my_removable_disk.vdisk"
set pka_0 removable = true

...

"virtual_scsi_tape" has the following parameters:

container

Value
Parameter
Type

container[N]

N=0…7

Type

Text String

Value

A string containing the full path to a tape container. If the specified tape image does not exist, CHARON-VAX creates it.

If only the name of the tape container is specified, CHARON-VAX will look for the container in the folder CHARON is running from.

media_type

Parameter

media_type[N]

N=0…7

Type

Text String

Value

Overrides PRODUCT ID in the default SCSI INQUIRY data.

Valid values may contain uppercase letters, integers and spaces. Length of this string cannot exceed 16 characters.

By default the PRODUCT ID returned is “TLZ04”"TLZ04"

geometry

Parameter

geometry[N]

N=0…7

Type

Text String

Value

Specifies the size of the tape image and (optionally) the size of the "early-warning" area at the end of the tape image.

Syntax:

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

where:

  • <image-size> is the tape size in MB

  • <early-warning-zone-size> is the size (in KB) of the space remaining on the tape when a warning to the OS is issued. If omitted, 64K is assumed.

Example:

load virtual_scsi_tape/chscsi pka_0
set pka_0 geometry[0] = 90

 

(warning) In the table above N stands for logical unit number. The first unit must be 0 with no gaps in subsequent numbering.

Example:

load virtual_scsi_tape/chscsi pka_0 scsi_bus=pka scsi_id=0

set pka_0 container[0] = "/charon/tapes/tape1.vtape"
set pka_0 container[1] = "/charon/tapes/tape2.vtape"

...

"virtual_scsi_cdrom" has the following parameters:

container

ValueDescriptionname>””“iso”]for *.iso images, for CD-ROM, DVD drives;
Parameter
Type

container[N]

N=0…7

Type

Text String

Value

A string containing the device name to map to the emulator.

Mapping to host system resources
  • ISO images
    • [<path-
    • name>"/
    • "]<file-name>[
    • ".
    • iso"]

      Format: A string containing the full path to an *.iso image.

      If only the name of the *.iso image is specified, CHARON-VAX will look for it in the folder CHARON is running from.
      .

  • CD-ROM or DVD drives
    • "/dev/cdrom<X>"
    • or
    • "/dev/sr<X>"
    • where X is 0,1,2...

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

media_type

Parameter

media_type[N]

N=0…7

Type

Text String

Value

Overrides the PRODUCT ID in the default SCSI INQUIRY data.

Valid values may contain uppercase letters, integers and spaces. The length of the string cannot exceed 16 characters.

If not specified, synthetic SCSI INQUIRY data is returned containing a PRODUCT ID selected based on the disk size.

Initially left unspecified.

geometry

Parameter

geometry[N]

N=0…7

Type

Text String

Value

This formatted string value specifies the explicit geometry of the disk storage element

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

  • "X" is the number of sectors per track;
  • "Y" is the number of tracks per cylinder;
  • "Z" (optional) is 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;

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

use_io_file_buffering

Parameter

use_io_file_buffering[N]

N=0…7

Typeboolean
Value

Enables use of the host OS I/O buffering.

Initially set to “false” (buffering disabled).

 

(warning) In the table above N stands for logical unit number. The first unit must be 0 with no gaps in subsequent numbering. If only one LUN is configured, the LUN number can be omitted

Example:

load virtual_scsi_cdrom/chscsi pka_0 scsi_bus=pka scsi_id=0
set pka_0 container="/dev/sr0"

...

"physical_scsi_device" has the following parameters:

container

ValueDescriptionThis parameter is initially not set, thus creating NO storage elements on the controller
Parameter
Type

container[N]

N=0…7

Type

Text String

Value

A string containing the device name to map to the emulator.

Mapping to host system resources
  • Physical tape drives and other SCSI devices connected to CHARON host
    • "/dev/sg<X>", where X is 0, 1, …
for physical tape drives and other SCSI devices connected to CHARON host

media_type

Parameter

media_type[N]

N=0…7

Type

Text String

Value

Overrides the PRODUCT ID in the default SCSI INQUIRY data.

Valid values may contain uppercase letters, integers and spaces. The length of the string cannot exceed 16 characters.

If not specified, synthetic SCSI INQUIRY data is returned containing a PRODUCT ID selected based on the disk size.

Initially left unspecified.

geometry

Parameter

geometry[N]

N=0…7

Type

Text String

Value

This formatted string value specifies the explicit geometry of the disk storage element

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

  • "X" is the number of sectors per track;
  • "Y" is the number of tracks per cylinder;
  • "Z" (optional) is 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;

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

use_io_file_buffering

Parameter

use_io_file_buffering[N]

N=0…7

Type

boolean

Value

Enables use of the host OS I/O buffering.

Initially set to “false” (buffering disabled).

removable

Parameter

removable[N]

N=0…7

Typeboolean
ValueEnables the logical unit to appear as a removable SCSI disk drive.

Initially set to “false” (fixed, non-removable).

disconnect_timeout

Parameter

disconnect_timeout[N]

N=0…7

TypeNumeric
Value

Sets logical unit disconnect timeout. This parameter helps if a connected SCSI device performs a given SCSI command for a very long time.

The default value depends on the type of the SCSI device attached. For example for a disk it is 10 seconds, for a tape - an hour. If the type of the device is not known the timeout is 1 hour.

Example (the timeout is with 48 days )timeout:

set

pka_0

disconnect_timeout[1]

=

0x400000

 

(warning) In the table above N stands for logical unit number. The first unit must be 0 with no gaps in subsequent numbering. If only one LUN is configured, the LUN number can be omitted.

Example:

load physical_scsi_device/chscsi pka_0 scsi_bus=pka scsi_id=0
set pka_0 container="/dev/sg3"

...