Versions Compared

Key

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

...

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

Table of Contents

Table of Contents
excludeTable of Contents

...

Syntax for loading KZPBA storage adapter:

load KZPBA <name>

Example:

load KZPBA PKA


Note

In AlphaStation 400 configuration use the following syntax for KZPBA storage adapter loading:

load KZPBA

...

PKB irq_bus=isa


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

set PKA container[602]="/Mydisks/vms_distributive.vdisk"

...

Back to Table of Contents

Configuration parameters

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

scsi_id

Parameterscsi_id
TypeNumeric
Value

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

Parameterhost, port
TypeText String
Value

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"


Anchor
container
container
container

Parameter

container[N]

N is "XXYY" number, where:

  • XX - SCSI ID (0..15)
  • YY - LUN (00..07)
Type

Text String

Value

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

Physical disk"/dev/sd<L>" where "L" is letter, for example "/dev/sdb

of the following forms:

  • Physical disk
    • "/dev/sd<L>" where "L" is letter, for example "/dev/sdb"
    • "/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-

      id

      uuid/..." - addressing by the disk

      ID

      UUID, for example "/dev/disk/by-

      id/ata-ST1000DM003-9YN162_S1D01QJ4"

      uuid/0e808a2f-cdd3-4944-a245-f729ffd73882"
      (warning) Please note that existing data on such a disk may be destroyed, depending on how it is used in the emulator.

      Note

      "/dev

      /disk/by-label/..." - addressing by the disk label, for example

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

      label"/dev/disk/by-uuid/..." - addressing by the disk UUID, for example

      id/

      MyStorage"

      wwn-*" syntax instead to refer the disk by its WWID - especially in the enviroments utilizing FC and SAN storages.

       These disks must not be formatted by the host OS.

      Example:

      set PKA container[0]="/dev/disk/by-
      uuid
      id/
      0e808a2f
      ata-
      cdd3-4944-a245-f729ffd73882"
      (warning) Please note that existing data on such a disk may be destroyed, depending on how it is used in the emulator.
Note
ST1000DM003-9YN162_S1D01QJ4"

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>

sd<L><N>"

addressing is not persistent, so it is strongly recommended to use

where N is the number of partition to be used. 

Example:

set PKA container[0]="/dev/sdc1"

.

  • Multipath disk
    • "/by-iddev/wwndm-*" syntax instead to refer the disk by its WWID - especially in the enviroments utilizing FC and SAN storages.

       These disks must not be formatted by the host OS.

      Example:

      set PKA container[0]=<N>" 
    • "/dev/mapper/mpath<N>" 
    • "/dev/disk/by-id/ata-ST1000DM003-9YN162_S1D01QJ4"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. mapper/disk<N>" 
      (warning) 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.

      Example:

      set PKA container[0100]="/dev/sdc1dm-0"

      .

    Multipath disk"/dev/dm-<N>" 
  • Loop (virtual block) devices
    • "/dev/

      mapper/mpath<N>" 

      loop<N>"
      Example:

      set PKA container[200]="/dev/
      mapper/disk<N>
      loop0"
       
      (warning) 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.



  • Direct mapping to some SCSI device, for example, a SCSI disk, tape reader or tape changer
    • "/dev/sg<N>"
      Example:

      set PKA container[100300]="/dev/dm-0sg0"

      .

  • Loop (virtual block) devicesCD-ROM device
    • "/dev/loop<N>"
      Example:
      set PKA container[200]=sr<N>"
    • "/dev/loop0"
    Direct mapping to some SCSI device, for example, a SCSI disk or tape reader
    • cdrom" 
    • "/dev/sg<N>cdrom<N>"
      Example:

      set PKA container[300400]="/dev/sg0sr0"

      .

  • ISO file for reading distribution CD-ROM device
  • "/dev/sr<N>"
  • "/dev/cdrom" 
  • "/dev/cdrom<N>image
    • [<drive>":\"<path-name>"\"]<file-name>[".iso"]
       Mapping may also include the full path (recommended), for example: "/my_disks/vms_distributive.iso"

      Example:

      set PKA container[400600]="/dev/sr0my_disks/vms_distributive.iso"

      .

    ISO file for reading distribution CD-ROM image
  • File representing a physical disk of the HP Alpha system (disk image)
    • [<drive>":\"<path-name>"\"]<file-name>[".isovdisk"]
      These files can be created from scratch with "mkdskcmd" utility. Data and OS 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: "/my_disks/

      vms

      my_boot_

      distributive

      disk.

      iso

      vdisk"

      Example:

      set PKA container[600401]="/my_disks/vms_distributive.isodka401.vdisk"

      .

    • File representing
    a physical disk of the HP Alpha system (disk
    • the tape (tape image)
      • [<drive>":\"<path-name>"\
    "]<file-name>[".vdisk"]
    These files can be created from scratch with "mkdskcmd" utility. Data and OS disk backups are transferred from the original system via tapes or network and restored into these container files.   
      • "]<file-name>".vtape"

        These files are created automatically. 

        Mapping may also include

    the
      • a full path (recommended), for example: "

    /my_disks
      • /

    my_boot_disk.vdisk"

    Example:

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

    .

    • File representing the tape (tape image)
      • [<drive>":\"<path-name>"\"]<file-name>".vtape"

        These files are created automatically.

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

        Warning

        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:

        set PKA container[500]=".vtape"

        Example:

        set PKA container[500]="my_mka500.vtape"

        How the Emulator Maps Guest-OS Operations to the Virtual Tape Drive

        Guest-OS operationsEmulator Action
        Open device for readingCreate a container file if none exists. open for reading and lock container file
        Open device for writingCreate a container file if necessary; open for writing and lock the container file
        Unload (eject) tape from driveClose a container file if open and unlock it - this allows copy/move/delete operations on CHARON host


        Info

        The container file associated with a virtual tape drive can be compared to the tape cartridge used in a physical tape drive. Both store the data written to the tape device by the guest OS.

        The size of virtual tape container files is limited only by space available in the emulator host file system.

        (warning) Prerequisite to the examples below: a virtual tape device has been configured in the CHARON configuration file and it is not in use by the guest OS.

        To perform backup:

        1. The tape device may be issued the "unload" command and the container-file moved/deleted to insure proper status 
        2. Initialize the tape device using standard guest OS procedure.
        3. Perform backup.
        4. Issue "unload" command to the tape device in the guest OS.
        5. On the emulator host, move the *.vtape container file containing backup data for storage or further backup.

        To restore from a backup:

        1. The tape device may be issued the "unload" command to insure proper status.
        2. On the emulator host, move or copy a *.vtape container file containing backup data onto the filename specified in the CHARON configuration file.
        3. Perform restore.
        4. Issue the "unload" command to the tape device in the guest OS.
        5. Delete or move the container file in preparation for the next vtape operation.

        Warning

        CHARON does not support muti-volume backup for tape images. If some mutli-volume set (in form of tape images) has to be restored it is recommended to configure several tape drives in CHARON configuration file, assign each tape image to each tape drive and use them in the following way (OpenVMS example):

        $ BACKUP MKA100:BACKUP.BCK,MKA200,MKA300,MKA4000/SAVE_SET DKA0:...



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


  • media_type

    Parameter

    media_type[N]

    N is "XXYY" number, where:

    • XX - SCSI ID (0..15)
    • YY - LUN (00..07)
    Type

    Text String

    Value

    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

    Parameter

    removable[N]

    N is "XXYY" number, where:

    • XX - SCSI ID (0..15)
    • YY - LUN (00..07)
    TypeBoolean
    Value

    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

    Parameter

    geometry[N]

    N is "XXYY" number, where:

    • XX - SCSI ID (0..15)
    • YY - LUN (00..07)
    Type

    Text String

    Value

    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>] or <X>”,”<Y>[“,”<Z>][“,”<B>] 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.

    B

    The total size of the disk (in blocks) reported to the guest OS.

    If omitted it is calculated automatically.

    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.

    Info

    It is possiblle to specify each parameter independently of another one. The following syntax is used for that:

    set PKA geometry[300]="*,*,*,16777210"


    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

    Parameter

    use_io_file_buffering[N]

    N is "XXYY" number, where:

    • XX - SCSI ID (0..15)
    • YY - LUN (00..07)
    TypeBoolean
    Value

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

    (info) Note that this caching has a significant effect only in case of mapping to disk and tape containers, not physcial drives. 

    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



    ...