...
Back to Table of ContentsConfiguration parameters
The KZPBA PCI SCSI adapter emulation has the following configuration parameters:
scsi_id
Parameter | scsi_id |
---|
Type | Numeric |
---|
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: |
---|
host, port
Parameter | host, port |
---|
Type | Text String |
---|
Value | These parameters are used in SCSI cluster configurations. Parameter | Description |
---|
host | Specifies 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. | port | Specifies 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
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.
- "/dev/disks/by-id/..." - addressing by the disk ID, for example "/dev/disk/by-id/ata-ST1000DM003-9YN162_S1D01QJ4"
- "/dev/disks/by-label/..." - addressing by the disk label, for example "/dev/disk/by-label/MyStorage"
- "/dev/disks/by-uuidluuid/..." - addressing by the disk UUID, for example "/dev/disk/by-uuid/0e808a2f-cdd3-4944-a245-f729ffd73882"
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]="/dev/sdb" |
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. Example: set PKA container[0]="/dev/sdc1" |
.
- Multipath disk
- Direct mapping to some SCSI device, for example, a SCSI disk or tape reader
"/dev/sg<N>" Example: set PKA container[200]="/dev/sg0" |
.
- CD-ROM device
- "/dev/sr<N>"
- "/dev/cdrom"
"/dev/cdrom<N>" Example:
set PKA container[400]="/dev/sr0" |
.
- ISO file for reading distribution CD-ROM 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[600]="/my_disks/vms_distributive.iso" |
.
- File representing a physical disk of the HP Alpha system (disk image)
- 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/backup.vtape" Example: set PKA container[500]="my_mka500.vtape" |
.
This parameter is initially not set, thus creating NO storage elements on the controller.
|
---|
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)
|
---|
Type | Boolean |
---|
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 |
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: Parameter | Description |
---|
X | The number of sectors per track | Y | The 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: Parameter | Description |
---|
image-size | The 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)
|
---|
Type | Boolean |
---|
Value | When set to "true", instructs CHARON-AXP to enable host operating system I/O cache on reading/writing operations. 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 |
|
---|
...