Versions Compared

Old Version 3

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

Saved on

compared with

New Version Current

changes.mady.by.user W.Erber

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: prepare for PDF export

AnchorTopSCSIPageTopSCSIPage

Anchor
TOC
TOC
Include Page
KBCOMMON:KB-CSSstyle
KBCOMMON:KB-CSSstyle

Table of Contents

Table of Contents
excludeTable of Contents

Introduction

CHARON-VAX provides two SCSI controllers for the SCSI and SCSI/QBUS models of VAX.

...

Use the following emulated device types to map real peripherals to the emulated SCSI devices:

Type of mappingDescription
virtual_scsi_disk

36802882952417

For disk image containers and physical disks
virtual_scsi_tape

36802882952417

For tape image containers
virtual_scsi_cdrom

36802882952417

For host CD-ROM and *.iso images
physical_scsi_device 

36802882952417


For physical tapes and other SCSI devices connected to a host

...

The boot ROM of CHARON-VAX detects SCSI devices with multiple LUNs and builds proper device names for them.

(info) To To display a list of devices on the VAX console (SRM), enter ">>> show device" .

This list is passed to VAX/VMS at boot time.

(warning) VAXVAX/VMS creates devices only for logical unit 0 for each device detected in the boot ROM. To add additional logical units, use the following SYSGEN command:

...

CHARON-VAX is able to boot from disk images of any VAX/VMS version, starting with 4.5 or higher for MicroVAX II or VAX 3600 and VMS 5.5-2 or higher for the VAX4000.

...

Include Page
KBCOMMON:DOC-GoToToc
KBCOMMON:DOC-GoToToc

Mapping to host resources

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

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.

.

...

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.


Syntax:

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

...

"kzdda.icfg" loads the second SCSI adapter.

(info) OpenVMS OpenVMS version 5.5-2H4, or above, is required to use the "pkb" controller.

...

Include Page
KBCOMMON:DOC-GoToToc
KBCOMMON:DOC-GoToToc

virtual_scsi_disk

Use the "virtual_scsi_disk" mapping for disk containers and physical disks. This is the most convenient way of connecting disks to SCSI adapters in CHARON-VAX

The "virtual_scsi_disk" mapping has the following parameters:

Div
classpagebreak


container

Since "/dev/sd<L>" addressing is not persistent, so it is strongly recommended to use

, for example "/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: uuid/0e808a2f-cdd3-4944-a245-f729ffd73882"

  • Do not use device names of the form "/dev/sd<L><N>" where N is the number of partition to be usedsd<L>" – they are not persistent. Use one of the above device names instead.

    Instead of an entire disk, a partition can be mapped by using the device name with the partition-letter at the end.
    .

  • 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

    Parameter

    container[N]

    N=0…7

    Type

    Text String

    Value

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

    • 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.
        .

    • 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


    Div
    classpagebreak


    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 In the table above N stands for logical unit number. The first unit must be 0 with no gaps in subsequent numbering.numbering.

    Div
    classpagebreak


    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/disk/by-id/wwn-0x5000039c28ca8391"

    If only one LUN is configured, the LUN number can be omitted:

    ...

    When a virtual SCSI disk image is dismounted in VMS, it is no longer open by CHARON and may be copied. This capability can be useful when designing back-up and restore procedures. If copying CHARON-VAX disk images while CHARON-VAX is running, take care to minimize the risk of overloading the host system.

    ...

    Please note:

    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

    ...

    Include Page
    KBCOMMON:DOC-GoToToc
    KBCOMMON:DOC-GoToToc

    virtual_scsi_tape

    Use "virtual_scsi_tape" for tape containers. This is the most convenient way of connecting tapes to SCSI adapters in CHARON-VAX.

    "virtual_scsi_tape" has the following parameters:

    container

    Parameter

    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.

    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.

    Please note

    If the "CHARON Guest Utilities for OpenVMS" (CHARONCP) package is used there is a possibility not to specify the exact tape container on CHARON start since it can be specified later using the package.

    In this case the syntax is:

    load virtual_scsi_tape/chscsi pka_0 scsi_bus=pka scsi_id=0
    set pka_0 container[0] =".vtape"


    Div
    classpagebreak


    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"

    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 In the table above N stands for logical unit number. The first unit must be 0 with no gaps in subsequent numbering.

    ...

    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"

    ...

    set pka_0 container = "/charon/tapes/tape1.vtape"
    set pka_0 media_type = "TLZ08"

    ...

    Include Page
    KBCOMMON:DOC-GoToToc
    KBCOMMON:DOC-GoToToc

    Div
    classpagebreak


    virtual_scsi_cdrom

    Use "virtual_scsi_cdrom" to connect IDE or SATA host CD-ROM or *.iso file to CHARON-VAX.

    "virtual_scsi_cdrom" has the following parameters:

    container

    Parameter

    container[N]

    N=0…7

    Type

    Text String

    Value

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

    • 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.


    Div
    classpagebreak


    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 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

    ...

    This example associates an unallocated CD-ROM drive "/dev/sr0" with virtual_scsi_cdrom "pka_0".

    ...

    .

    Include Page
    KBCOMMON:DOC-GoToToc
    KBCOMMON:DOC-GoToToc

    physical_scsi_device

    Use "physical_scsi_device" to connect any host "raw" SCSI device to CHARON-VAX. This mapping type is suitable only for tape drives and other specific SCSI devices connected to CHARON host.

    "physical_scsi_device" has the following parameters:

    container

    Parameter

    container[N]

    N=0…7

    Type

    Text String

    Value

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

    • Physical tape drives and other SCSI devices connected to CHARON host including the tape changers
      • "/dev/sg<X>", where X is 0, 1, … (do not use /dev/st<N> devices, only /dev/sg<N> for tape drives)

    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.


    Div
    classpagebreak


    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).


    Div
    classpagebreak


    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 with 48 days timeout:

    set pka_0 disconnect_timeout[1] = 0x400000

    (warning) In 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.

    ...

    This example associates a host tape device "/dev/sg3" with physical_scsi_device "pka_0".

    ...

    Include Page
    KBCOMMON:DOC-GoToToc
    KBCOMMON:DOC-GoToToc