Versions Compared

Key

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

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

Table of Contents

Table of Contents
excludeTable of Contents

...

Creation of your own configuration file using a template

By default, all the CHARON templates are located in the "/opt/charon/cfg" folder. Copy the appropriate template configuration file(s) to your home directory or to any directory intended for CHARON-VAX, name them meaningfully and set proper privileges.

...

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

Div
classpagebreak


VAX model specification

The first configuration statement is the specification of the exact VAX hardware model to emulate.

...

If you create the CHARON-VAX configuration file from scratch, it must be the very first uncommented line in the configuration file.

...

...

Configuration name

The next configuration statement is the "Configuration name" option.

...

You can optionally uncomment this line to differentiate this CHARON-VAX instance from all others in a multi-instances environment. The configuration name can be any label that is meaningful. It is reported in the log file and is used to set the log file name for rotating log (see further: Rotating log (default)).

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

Div
classpagebreak


Log file parameters

Execution of CHARON-VAX 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 possible problems either with the running CHARON-VAX or the emulated system configuration (such as the absence or malfunction of certain devices), the log file(s) is the primary source to be analyzed for troubleshooting.  If it becomes necessary to contact Stromasys for support, the configuration and log files, plus the license number, will be requested to begin problem resolution.Here is an example of a field test

Panel
borderColor#EDEDEE
bgColor#FFFFFF
titleColor#000000
titleBGColor#EDEDEE
titleCHARON-VAX log file

...

Code Block
languagetext
example (part1)

20190523:074333:INFO

:0:000003A5:hexane.cxx(5952):

session:

loading

built-in

configuration

"VAX_6610"...


20190523:074333:INFO

:0:000003A6:hexane.cxx(5973):

session:

...

done

loading

built-in

configuration

"VAX_6610"


20190523:074333:INFO

:0:000003AA:hexane.cxx(6002):

session:

loading

configuration

file

"vx6k610.cfg"...


20190523:074333:INFO

:0:000003AB:hexane.cxx(6026):

session:

...

done

loading

configuration

file

"vx6k610.cfg"


20190523:074333:INFO

:0:000003F2:sesmgr.cxx(1419):

session:

default

log

file

size

limit

is

4194304

bytes


20190523:074333:INFO

:0:0000032B:hexane.cxx(2698):

Start

request

received.


20190523:074334:INFO

:0:000003AC:hexane.cxx(1424):

session:

process

affinity

is

000000000000000F,

system

affinity

is

000000000000000F


20190523:074334:INFO

:0:000003D1:hexane.cxx(1686):

session:

I/O

domain

affinity

is

0000000000000001,

CPU

domain

affinity

is

000000000000000E


20190523:074334:INFO

:0:0000024D:licenseman(1823):

Checking

the

available

license

key

"1422726238".


20190523:074334:INFO

:0:0000024D:licenseman(1823):

Found

license

key:

"1422726238".


20190523:074334:INFO

:0:0000024D:licenseman(1823):

Checking

product

section

0.


20190523:074334:INFO

:0:0000024D:licenseman(1823):

The

value

"VAX_6610"

of

the

required

parameter

"P_HW"

is

not

found

in

the

list

"AlphaServer_400,AlphaServer_800,AlphaServer_1000,AlphaServer_1000A,AlphaServer_1200,AlphaServer_2000,AlphaServer_2100,AlphaServer_4000,AlphaServer_4100"

for

the

product

0.


20190523:074334:INFO

:0:0000024D:licenseman(1823):

Checking

product

section

1.


20190523:074334:INFO

:0:0000024D:licenseman(1823):

The

value

"VAX_6610"

of

the

required

parameter

"P_HW"

is

not

found

in

the

list

"AlphaServer_DS10,AlphaServer_DS10L,AlphaServer_DS15,AlphaServer_DS20,AlphaServer_DS25,AlphaServer_ES40,AlphaServer_ES45,AlphaServer_GS80,AlphaServer_GS160,AlphaServer_GS320"

for

the

product

1.


20190523:074334:INFO

:0:0000024D:licenseman(1823):

Checking

product

section

2.


20190523:074334:INFO

:0:0000024D:licenseman(1823):

The

value

"VAX_6610"

of

the

required

parameter

"P_HW"

is

not

found

in

the

list

"PDP1193,PDP1194"

for

the

product

2.


20190523:074334:INFO

:0:0000024D:licenseman(1823):

Checking

product

section

3.


20190523:074334:INFO

:0:0000024D:licenseman(1823):

HASP

clock:

23-May-2019

08:47:05.


20190523:074334:INFO

:0:0000024D:licenseman(1823):

Host

clock:

23-May-2019

07:43:34.


20190523:074334:INFO

:0:0000024D:licenseman(1823):

License

number:

"003.msc.test.center.kirill".


20190523:074334:INFO

:0:0000024D:licenseman(1823):

Product

License

number:

"p.vax".


20190523:074334:INFO

:0:0000024D:licenseman(1823):

CHARON

product

code:

"CHVAX-4110xx-WI-LI".


20190523:074334:INFO

:0:0000024D:licenseman(1823):

Unlimited

license.


20190523:074334:INFO

:0:0000024D:licenseman(1823):

Feature

1

check

interval

1

hour(s).


20190523:074334:INFO

:0:0000024D:licenseman(1823):

Concurrency

info:


20190523:074334:INFO

:0:0000024D:licenseman(1823):

There

are

7

instances

allowed.


20190523:074334:INFO

:0:0000024D:hexane.cxx(2848):

STROMASYS

SA,

(C)

2009-2019


20190523:074334:INFO

:0:00000408:hexane.cxx(2892):

CHARON-VAX

(VAX

6000

Model

610),

V

4.

11

10 B

20300

20200,

May

14

2019

/

003.msc.test.center.kirill

/

1422726238


20190523:074334:INFO

:0:00000336:hexane.cxx(2924):

The

end

user

of

this

software

has

agreed

to

STROMASYS'

Terms

and

Conditions

for

Software

License

and

Limited

Warranty,

as

described

at:

/pub/doc/30-17-033.pdf


20190523:074334:INFO

:0:00000097:hexane.cxx(2999):

OS

Environment:

Red

Hat

Enterprise

Linux

Server

release

7.4

(Maipo),

Linux

3.10.0-693.5.2.el7.x86_64

#1

SMP

Fri

Oct

13

10:46:25

EDT

2017

x86_64.


20190523:074334:INFO

:0:00000098:hexane.cxx(3004):

Host

CPU:

GenuineIntel,

Family

6,

Model

42,

Stepping

1,

Intel

Xeon

E312xx

(Sandy

Bridge),

1

Sockets,

1

Cores

per

Socket,

4

Threads

per

Core,

at

~2593

MHz,

4

cpu's

available


20190523:074334:INFO

:0:00000099:hexane.cxx(3009):

Host

Memory:

3840Mb 20190523:074334:INFO

3840Mb


Div
classpagebreak



Panel
borderColor#EDEDEE
bgColor#FFFFFF
titleColor#000000
titleBGColor#EDEDEE
titleCHARON-VAX log file example (part2)

20190523:074334:INFO :0:0000041F:hexane.cxx(3224):

Configuration

dump::


.

session:


.

.

configuration_name

=

"VAX_6610"


.

.

log_method

=

"overwrite"


.

.

hw_model

=

"VAX_6610"


.

.

log_mode

=

"shared"


.

.

log_locale

=

"english"


.

XMI:


.

.

clock_period

=

"20000"


.

.

boot

=

"manual"


.

RAM:


.

.

size

=

"512"


.

eeprom:


.

.

container

=

"charon.rom"


.

TOY:


.

.

container

=

"charon.dat"


.

OPA0:


.

.

trace

=

"disabled"


.

.

stop_on

=

"F6"


.

.

tx_flush_delay

=

"0"


.

PUA:


.

.

container[0]

=

"/home/charon/Charon/test/performancecomparison-66x0.vdisk"


.

.

xmi_node_id

=

"11"


.

EXA:


.

.

adapter_mode

=

"auto"


.

.

interface

=

"EXA0"


.

.

rx_fifo_delay_on_overload

=

"false"


.

.

extended_command_ring

=

"false"


.

.

xmi_node_id

=

"13"


.

EXA0:


.

.

interface

=

"eth1"


.

.

disabled_mode

=

"10BaseT-HD"


.

.

port_show_driver_statistics

=

"false"


.

.

port_enable_mac_addr_change

=

"true"


.

.

port_snd_sock_buf_size_kb

=

"0"


20190523:074336:WARN

:1:00000431:lnxpackpor(1006):

(95)

Operation

not

supported:

EXA0:

ioctl("eth1",

SIOCETHTOOL,

GSET)


20190523:074336:INFO

:0:00000001:

tpool.cxx(1374):

CPU:

The

ACE

option

is

omitted;

enable

ACE

as

license

default.


20190523:074337:INFO

:0:00000133:

tpool.cxx(1606):

Advanced

CPU

Emulation

(ACE)

enabled.


20190523:074337:INFO

:0:00000400:ethdev.cxx(

388):

EXA:

RX

FIFO

size

is

512KB.


20190523:074338:INFO

:0:0000032C:hexane.cxx(2740):

"VAX_6610"

started.


20190523:074345:INFO

:0:0000014F:lnxpackpor(1652):

EXA0:

Carrier

loss

detected.


20190523:074539:INFO

:0:000003D7:hexane.cxx(5548):

All

virtual

CPUs

of

"VAX_6610"

have

been

stopped

by

now.


20190523:074539:INFO

:0:0000032D:hexane.cxx(2784):

"VAX

6000

Model

610"

stop

request

received.


20190523:074539:INFO

:0:0000014C:lnxpackpor(

433):

EXA0:

Stopping

network

interface

...

please

wait.


20190523:074539:INFO

:0:0000024D:licenseman(1823):

Licensing

component

received

stop

request.


20190523:074539:INFO

:0:0000032E:hexane.cxx(2811):

Stopped.


20190523:074539:INFO

:0:0000014C:lnxpackpor(

433):

EXA0:

Stopping

network

interface

...

please

wait.

The next group of parameters defines the name of the CHARON-VAX log file and how CHARON-VAX will use it:

set session log_method = append
#set session log_method = overwrite
#set session log = "MicroVAX_3600.log"


Div
classpagebreak


Anchor
ROTA
ROTA
Rotating log (default)

By default CHARON-VAX utilizes a so called "rotating log" mechanism. This means that a new default log file is created each time CHARON starts and can switch to another log file if the size of the log file exceeds 64Kb (this behavior can be changed with the "set session log_file_size" and "set session log_rotation_period" parameters; see more details in the "General Settings" chapter of this guide). 

...

Note

Only an existing directory can be used as a value of the "log" parameter.

Single log

Alternatively it is possible to use a single log file: uncomment the "set session log" line and specify the desired CHARON-VAX log file name. Optionally, a path can be added to the log file name. If the path is not specified, the log file is created in the directory from where the guest (emulated machine) is started.

...

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

TOY, ROM and EEPROM containers

The next objects to be configured are TOY, ROM and EEPROM containers (their presence depends on the VAX model). It is always recommended to enable them. If a container file of the given name does not exist, CHARON-VAX will create it. Specific paths can be added to the file name specification.

...

set eeprom container="charon.rom"

...


...

Div
classpagebreak


Emulated memory (RAM) size

The next parameter defines the amount of host memory the chosen CHARON-VAX model reserves for the emulation.

...

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

Div
classpagebreak


Console

Mapping to system resources

The next step is the specification of the VAX console (OPA0) serial line.

...

(warning) Note there are a number of additional parameters for CHARON-VAX serial line configuration. Follow this link for details.

Div
classpagebreak


Exit on pressing F6 key

A hot key can be defined to stop the execution of the CHARON-VAX virtual machine:

...

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

Disk subsystem

The next step is the configuration of the disk subsystem and mapping it to the system resources using the samples given in the template configuration files.

CHARON-VAX supports MSCP, DSSI, CI and SCSI disk controllers. The examples below are for MSCP and SCSI controllers only. DSSI controllers are discussed in details in the following section and CI controllers in this section.

MSCP disk controllers (RQDX3, KDB50, KDM70)

Below is a typical configuration sample for MSCP disk controller RQDX3:

load RQDX3 DUA

#set DUA container[0]="<file-name>.vdisk"
#set DUA container[1]="/dev/sdN"
#set DUA container[2]="/dev/srN"
#set DUA container[3]="<file-name>.iso"

#load RQDX3 DUB address=...
#load RQDX3 DUC address=...


Div
classpagebreak


The first line ("load RQDX3 DUA") loads disk controller RQDX3 with name DUA, followed by 4 lines showing different ways of mapping to the host resources:

...

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

Div
classpagebreak


SCSI controller NCR53C94

The VAX 4000 and MicroVAX 3100 have an NCR53C94 SCSI controller onboard for support of different types of SCSI devices including disks and tapes. Optionally a second controller can be added.

...

Note that versions of VAX/VMS older than 5.5-2H4 do not support the optional SCSI controller and might fail to boot if it is loaded.

Follow this link for details of NCR53C94 SCSI controller controllers configuration.

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

Tape subsystem

Some MSCP and SCSI controllers support tape devices, however CHARON-VAX also emulates specific MSCP tape devices such as TQK50 and TUK50.

Follow this link for more details of (T)MSCP controllers configuration.

TQK50 controller

Example statements to configure TQK50 are shown below:

...

It is possible to load several TQK50 controllers (see the lines 4-5) 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.

TUK50 controller

TUK50 is a UNIBUS controller used by the VAX 6310:

...

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

Div
classpagebreak


Serial Lines

CHARON-VAX supports the following serial lines controllers: CXA16, CXB16, CXY08, DHQ11, DHV11, DZV11, DZQ11, DL11, DLV11, DZ11, DHW42-AA, DHW42-BA and DHW42-CA.

...

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

Networking

CHARON-VAX supports DEQNA, DESQA, DELQA, DEUNA, DELUA, DEMNA, DEBNI and PMADAA virtual network adapters.

...

Info

CHARON supports VLAN adapters. If used, proceed with their installation and configuration according to the network adapter vendor User's Guide and then use the resulting VLAN interface the same way as the regular network interface. 

Follow this link for more details of CHARON-VAX network controllers configuration.

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

Div
classpagebreak


Auto boot

CHARON-VAX can be configured to automatically boot an operating system at start up.

...

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

Host load balance for SMP systems

The VAX 6620 through VAX 6660 models emulate 2-6 CPUs respectively. In this situation, loading of the host system can be tuned with the following configuration file settings:

...