Anchor | TopConfigurationPage | TopConfigurationPage|||
---|---|---|---|---|
Anchor | ||||
|
Include Page | ||||
---|---|---|---|---|
|
...
To change the configuration file, open the CHARON Virtual Machines Manager from its shortcut on Desktop / Start menu or from the tray menu item, select the target CHARON VM and press the "Edit Configuration" button:
Div | ||
---|---|---|
| ||
Notepad will be used to edit the configuration file:
...
Include Page | ||||
---|---|---|---|---|
|
VAX/PDP11 model specification
...
If you create the CHARON VM configuration file from scratch, it must be the very first uncommented line in the configuration file.
...
Include Page | ||||
---|---|---|---|---|
|
Configuration name
The next configuration statement is the "Configuration name" option:
...
#set session configuration_name = MicroVAX_3600
You can optionally uncomment this line to differentiate this CHARON VM instance from all others in a multi-instance environment. The configuration name can be any label that is meaningful.
It is possible to specify a configuration name containing spaces, in this case use quotation marks:
. If the virtual machine has been created using an existing template, the configuration name is defined in the configuration_name.icfg file otherwise it is defined directly in the configuration file using the "set session configuration_name =
...
The configuration name is <...>" syntax:
include configuration_name.icfg |
Notes:
- The configuration name is reported in the log file and is used to set the log file name for rotating
...
- log (see explanations further
...
- ).
...
class | pagebreak |
---|
Log file parameters
The execution of a CHARON VM creates one log file or a set of log files reflecting the progress of its start-up and ongoing operation: start and end time of execution, system information, license and configuration details, warnings, reports on problems that may occur, etc. In case of problems with either the running CHARON VM or the emulated system configuration (such as the absence or malfunction of certain devices), the log file is the primary source to be analyzed for troubleshooting.
If it becomes necessary to contact Stromasys for support, the configuration and log files will be requested to begin the problem resolution.
Here is an example of a CHARON VM log file:
...
- Changing the configuration name in the "configuration_name.icfg" file does not change the name of the virtual machine at Virtual Machines Manager level.
- The "configuration_name.icfg" file can be found in the home directiory of the VM. Select the target VM, open "VM Configuration" tab and press "Explore" button.
The configuration name can be any label that is meaningful.
Example:
set session configuration_name = My_VAX |
It is possible to specify a configuration name containing spaces, in this case use quotation marks:
set session configuration_name = "My VAX" |
Include Page | ||||
---|---|---|---|---|
|
Log file parameters
The execution of a CHARON VM creates one log file or a set of log files reflecting the progress of its start-up and ongoing operation: start and end time of execution, system information, license and configuration details, warnings, reports on problems that may occur, etc. In case of problems with either the running CHARON VM or the emulated system configuration (such as the absence or malfunction of certain devices), the log file is the primary source to be analyzed for troubleshooting.
If it becomes necessary to contact Stromasys for support, the configuration and log files will be requested to begin the problem resolution.
Here is an example of a CHARON VM log file:
20161120:142250
20161120:142250:INFO :0:000003DC:ll_sentine( 825): ... found license key 1422726238. 20161120:142250:INFO :0:0000024D
20161120:142250:INFO :0:00000408
20161120:142250:INFO :0:00000336
20161120:142250:INFO :0:0000009D:ethane.cxx(2859): License info: CHARON product code: "CHVAX-480xx-WI-LI". Licensed to: "MSC". License KEY driver is installed as hasplms and is running. Executable "C:\Windows\system32\hasplms.exe", version 18.0.1.55505. 20161120:142250:INFO :0:00000097:ethane.cxx(2868): OS Environment: Microsoft Windows 7 Professional, 64-bit, Service Pack 1 (Build 7601). 20161120:142250:INFO :0:00000098:ethane.cxx(2873): Host CPU: Intel(R) Xeon(R) CPU E31275 @ 3.40GHz x8. 20161120:142250:INFO :0:00000099:ethane.cxx(2878): Host Memory: 24320Mb 20161120:142251:INFO :0:00000001: tpool.cxx(1370): cpu: The ACE option is omitted; enable ACE as license default. 20161120:142251:INFO :0:00000401:ethdev.cxx( 384): eza: RX FIFO is disabled. 20161120:142251:INFO :0:00000133: tpool.cxx(1602): Advanced CPU Emulation (ACE) enabled. 20161120:142251:INFO :0:0000032C:ethane.cxx(2617): "My_MV3100_96" started
|
Div | ||
---|---|---|
| ||
The next group of parameters defines the name of the CHARON VM log file and how the CHARON VM will use it:
...
|
...
Include Page | ||||
---|---|---|---|---|
|
TOY, ROM and EEPROM containers
...
|
...
Include Page | ||||
---|---|---|---|---|
|
KW11 timer
PDP11/93 and PDP11/94 emulators require the KW11 system timer to be configured:
...
Uncomment the line corresponding to the frequency used in the RSX11/RT11 systems to be migrated if needed.
...
Include Page | ||||
---|---|---|---|---|
|
ACE mode
The next setting indicates whether the CHARON VM will use the Advanced CPU Emulation (ACE) mode:
...
The "ace_mode" mode is license dependent, the "Charon-xx/Plus" products have ACE mode enabled by default.
...
Include Page | ||||
---|---|---|---|---|
|
Emulated memory (RAM) size
...
Note that in some particular orders your license may restrict the maximum RAM amount of each VAX/PDP11 model.
...
Include Page | ||||
---|---|---|---|---|
|
Div | ||
---|---|---|
| ||
Console
Mapping to system resources
...
This line allows the CHARON VM to be stopped by pressing the "F6" key.
...
Include Page | ||||
---|---|---|---|---|
|
Disk subsystem
The disk subsystem and the mapping to the system resources can be done using the samples given in the template configuration files.
...
#load RQDX3 DUA #set DUA container[0]="<file-name>.vdisk" #load RQDX3 DUB address=... |
The first line ("load RQDX3 DUA") loads disk controller RQDX3 with name DUA, followed by 6 lines showing different ways of mapping to the host resources:
...
5]="<file-name>. |
...
Mapping may also include the full path (recommended), for example: "C:\My disks\my_boot_disk.vdisk"
Example:
set DUA container[0]="my_bootable_disk.vdisk" |
.
Warning |
---|
Using compressed folders to store virtual disks and tapes is not supported |
.
...
.
...
DevID addresses the target physical disk by its WWID (hexadecimal 128-bit identifier assigned to the disk drive by its manufacturer/originator).
Example:
Div | ||
---|---|---|
| ||
|
.
Mapping to iSCSI disks.
"\\.\PhysicalDrive(iScsiTarget = <iSCSI target>, LUN = <LUN number>)"
iScsiTarget addresses the disk by its iSCSI target name. LUN specifies LUN on connected iSCSI disk.
Example:
Div | ||
---|---|---|
| ||
|
Mapping to CD-ROM device.
"\\.\CdRom<N>"
Example:
...
.
...
"<file-name>.iso"
Mapping may also include the full path (recommended), for example: "C:\My disks\vms_distributive.iso"
Example:
...
.
...
"\\.\A:"
Example:
...
.
...
"\\.\<N>:"
Example:
...
.
The numbers in the square brackets represent the unit numbers associated with each container of the MSCP controller. For example, the 3rd "set DUA" line of the configuration sample above creates disk "DUA2". The maximum unit number allowed is 9999, significantly more than the original hardware provided.
It is possible to load several RQDX3 controllers DUB, DUC, etc. (see lines 6-7, above) by configuring specific addresses for them on the Qbus. Use the "CONFIGURE" utility available on the VAX console to determine the addresses. Please refer to specific HP documentation for further information.
Please also refer to the HP documentation for information on placement of additional KDM70 controllers on an XMI bus (VAX 6000 models) and additional KDB50 controllers on a BI bus (VAX 6310).
Note that the KDM70 controller is capable of mapping to files representing tapes (tape images) and physical tape devices:
...
Follow this link for details of (T)MSCP controllers configuration.
Back to Table of Contents
...
class | pagebreak |
---|
SCSI controller NCR53C94
The VAX 4000 and MicroVAX 3100 models have an NCR53C94 SCSI controller on board for the support of different types of SCSI devices including disks and tapes. Optionally a second controller can be added.
Below is a typical configuration template for a preloaded "PKA" NCR53C94 SCSI controller:
load physical_scsi_device pka_5 iso" #load RQDX3 DUB address=... |
The first line ("load RQDX3 DUA") loads disk controller RQDX3 with name DUA, followed by 6 lines showing different ways of mapping to the host resources:
- Mapping to the file representing a physical disk of the VAX/PDP11 system (disk image).
"<file-name>.vdisk"
These files can be created from scratch with "MkDisk" utility. Data and OS disks 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_boot_disk.vdisk"
Example:
set DUA container[0]="my_bootable_disk.vdisk"
.
Warning Using compressed folders to store virtual disks and tapes is not supported
.
- Mapping to physical disk.
"\\.\PhysicalDrive<N>"
Be careful not to destroy all the information from the disk dedicated to CHARON VM by mistake. These disks must not be formatted by the host OS.
Example:set DUA container[1]="\\.\PhysicalDrive1"
.
- Mapping to physical disk by its WWID.
- "\\.\PhysicalDrive(DevID = <XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX>)"
Be careful not to destroy all the information from the disk dedicated to CHARON VM 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:
Div class small set DUA container[2]="\\.\PhysicalDrive(DevID= 6008-05F3-0005-2950-BF8E-0B86-A0C7-0001)"
.
- "\\.\PhysicalDrive(DevID = <XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX>)"
Mapping to iSCSI disks.
"\\.\PhysicalDrive(iScsiTarget = <iSCSI target>, LUN = <LUN number>)"
iScsiTarget addresses the disk by its iSCSI target name. LUN specifies LUN on connected iSCSI disk.Example:
Div class small set DUA container[3]="\\.\PhysicalDrive(iScsiTarget= iqn.2008-04:iscsi.charon-target-test1, LUN= 1)"
Mapping to CD-ROM device.
"\\.\CdRom<N>"
Example:
set DUA container[4]="\\.\CdRom0"
.
- Mapping to an ISO file for reading distribution CD-ROM image.
"<file-name>.iso"
Mapping may also include the full path (recommended), for example: "C:\My disks\vms_distributive.iso"
Example:
set DUA container[5]="vms_distributive.iso"
.
- Mapping to Floppy drive.
"\\.\A:"
Example:
set DUA container[6]="\\.\A:"
.
- Mapping to some other type of drive, for example magneto-optical drive.
"\\.\<N>:"
Example:
set DUA container[6]="\\.\H:"
.
The numbers in the square brackets represent the unit numbers associated with each container of the MSCP controller. For example, the 3rd "set DUA" line of the configuration sample above creates disk "DUA2". The maximum unit number allowed is 9999, significantly more than the original hardware provided.
It is possible to load several RQDX3 controllers DUB, DUC, etc. (see lines 6-7, above) by configuring specific addresses for them on the Qbus. Use the "CONFIGURE" utility available on the VAX console to determine the addresses. Please refer to specific HP documentation for further information.
Please also refer to the HP documentation for information on placement of additional KDM70 controllers on an XMI bus (VAX 6000 models) and additional KDB50 controllers on a BI bus (VAX 6310).
Note that the KDM70 controller is capable of mapping to files representing tapes (tape images) and physical tape devices:
set PUA container[600] = "<file-name>.vtape" |
Follow this link for details of (T)MSCP controllers configuration.
Include Page | ||||
---|---|---|---|---|
|
Div | ||
---|---|---|
| ||
SCSI controller NCR53C94
The VAX 4000 and MicroVAX 3100 models have an NCR53C94 SCSI controller on board for the support of different types of SCSI devices including disks and tapes. Optionally a second controller can be added.
Below is a typical configuration template for a preloaded "PKA" NCR53C94 SCSI controller:
|
...
class | pagebreak |
---|
Note that NCR53C94 SCSI controller mapping to system resources is done via specific auxiliary objects:
Mapping Object | Description | ||||
---|---|---|---|---|---|
virtual_scsi_disk | Mapping to a file representing VAX/PDP11 disk (disk image) on the host physical disk:
These files can be created from scratch with "MkDisk" 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: "C:\My disks\my_boot_disk.vdisk"
Be careful not to destroy all the information from the disk dedicated to CHARON VM by mistake! These disks must not be formatted by the host OS. "\\.\PhysicalDrive(DevID =XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX)" - mapping to physical disk by its WWID. Be careful not to destroy all the information from the disk dedicated to CHARON VM 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). iScsiTarget addresses the disk by its iSCSI target name. LUN specifies LUN on connected iSCSI disk. | physical_scsi_device | Mapping to a host SCSI device:"\\.\Tape<N>" - mapping to a SCSI tape drive known to Windows "\\.\ScsiN:X:Y:Z" - name of some SCSI device unknown to Windows for direct mapping, 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. | ||
Parameter | Description | ||||
N | A logical number assigned by host operating system (Microsoft Windows) to logical or host’s physical storage resource such as physical SCSI HBA | ||||
X | An internal SCSI bus number (usually 0) on host’s physical SCSI HBA | ||||
Y | A SCSI ID of physical SCSI target device attached to host’s physical SCSI HBA | Z | A logical unit number inside physical SCSI target device attached to host’s physical SCSI HBA
Div | ||
---|---|---|
| ||
Note that NCR53C94 SCSI controller mapping to system resources is done via specific auxiliary objects:
Mapping Object | Description | ||
---|---|---|---|
virtual_scsi_disk | Mapping to a file representing VAX/PDP11 disk (disk image) on the host physical disk:
| ||
physical_scsi_device | Mapping to a host SCSI device:
| ||
virtual_scsi_cdrom | Mapping to a host CD-ROM (not only SCSI) or to ISO image:
| ||
virtual_scsi_tape | Mapping to a file representing tape (tape image). It may contain a path, for example: "C:\M y tapes\backup.vtape " | ||
floppy_scsi_device | Mapping to a host floppy drive:
|
...
Follow this link for details of NCR53C94 SCSI controller controllers configuration.
...
Include Page | ||||
---|---|---|---|---|
|
Tape subsystem
Some MSCP and SCSI controllers support tape devices. CHARON also emulates specific MSCP tape devices such as TQK50 and TUK50.
...
The first line loads a UNIBUS BI adapter "DWBUA". Configure then the "TUK50" tape controller the same way as the TQK50.
...
Include Page | ||||
---|---|---|---|---|
|
Serial Lines
CHARON supports the following serial lines controllers: CXA16, CXB16, CXY08, DHQ11, DHV11, DZV11, DZQ11, DL11, DLV11, DZ11, DHW42-AA, DHW42-BA and DHW42-CA.
...
Note that additional parameters for CHARON VM serial lines configuration can be added. Follow this link for details.
...
Include Page | ||||
---|---|---|---|---|
|
Div | ||
---|---|---|
| ||
Networking
...
Follow this link for more details of CHARON VM network controllers configuration.
...
Include Page | ||||
---|---|---|---|---|
|
Div | ||
---|---|---|
| ||
Auto boot
CHARON can be configured to automatically boot an operating system at start up.
...
The ROM of certain VAX models (MicroVAX II, MicroVAX 3600, MicroVAX 3900, VAXserver 3600 and VAXserver 3900) does not allow the SRM console to accept the commands to enable auto booting. In this case, a specific parameter can be defined in the configuration file as a workaround:
set bdr boot=auto |
...
The CHARON-VAX 6000 models have a similar configuration setting:
...
These configuration lines are specified in the template configuration files in commented out form. In case of absence please add the corresponding line according to the examples above.
...
Include Page | ||||
---|---|---|---|---|
|
Host load balance for SMP systems
...
Setting | Description | Example | ||||||||
---|---|---|---|---|---|---|---|---|---|---|
affinity | This setting binds the running instance of the emulator CPUs to particular host CPUs.This should be used for soft partitioning host CPU resources or for isolating multiple CHARON instances on the same host from each other. By default the emulator instance allocates as many host CPUs as possible. The “affinity” parameter overrides the default and allows explicit specification of which host CPUs will be used by the instance. The affinity does not reserve the CPU for exclusive use. |
| ||||||||
n_of_io_cpus | Reserves host CPUs (of those specified by “affinity” parameter, if any) for use by the emulator for I/O handling. By default the emulator instance reserves one third of available host CPUs for I/O processing (round down, at least one). The “n_of_io_cpus” parameter overrides the default by specifying the number of I/O host CPUs explicitly. |
|
...
Include Page | ||||
---|---|---|---|---|
|