Table 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-AXP, name them meaningfully and set proper privileges.

Example:

$ cp /opt/charon/cfg/es40.cfg.template /my_charon_cfg/my_es40.cfg $ chmod 644 /my_charon_cfg/my_es40.cfg

Please do not edit the original template configuration files since they can be updated or even removed on update/deinstallation of Charon-AXP

Once the file has been created you can open it in your favorite editing tool and proceed with modifications to reflect the exact features of the system you are going to emulate.

We will review all the parameters step by step issuing some recommendations and guidelines.

Note: the lines preceded by the comment sign "#" inside the configuration files will not be interpreted. You can use this sign to debug your configuration.

Alpha model specification

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

Example:

set session hw_model = AlphaServer_ES40

You must leave this line untouched.

If you create the Charon-AXP 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.

Example:

# set session configuration_name = My_ES40

You can optionally uncomment this line to differentiate this Charon-AXP 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) ).

Log file parameters

Execution of CHARON-AXP 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-AXP 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.

CHARON-AXP log file example (part1)

20200310:035210:INFO :0:000003A5:hexane.cxx(5938): session: loading built-in configuration "AlphaServer_ES40"... 20200310:035210:INFO :0:000003A6:hexane.cxx(5959): session: ... done loading built-in configuration "AlphaServer_ES40" 20200310:035210:INFO :0:000003AA:hexane.cxx(5988): session: loading configuration file "es40.cfg"... 20200310:035210:INFO :0:000003AB:hexane.cxx(6012): session: ... done loading configuration file "es40.cfg" 20200310:035210:INFO :0:000003F2:sesmgr.cxx(1410): session: default log file size limit is 4194304 bytes 20200310:035210:INFO :0:0000032B:hexane.cxx(2698): Start request received. 20200310:035211:INFO :0:000003AC:hexane.cxx(1424): session: process affinity is 000000000000000F, system affinity is 000000000000000F 20200310:035211:INFO :0:000003D1:hexane.cxx(1686): session: I/O domain affinity is 0000000000000001, CPU domain affinity is 000000000000000E 20200310:035211:INFO :0:0000024D:licenseman(1823): Checking the available license key "1918154109". 20200310:035211:INFO :0:0000024D:licenseman(1823): Found license key: "1918154109". 20200310:035211:INFO :0:0000024D:licenseman(1823): Checking product section 0. 20200310:035211:INFO :0:0000024D:licenseman(1823): License number: "000.msc.test.center.nikolaev". 20200310:035211:INFO :0:0000024D:licenseman(1823): Product License number: "CHAXP/AXP". 20200310:035211:INFO :0:0000024D:licenseman(1823): CHARON product code: "CHAXP-411xx-WI-LI". 20200310:035211:INFO :0:0000024D:licenseman(1823): Unlimited license. 20200310:035211:INFO :0:0000024D:licenseman(1823): Feature 2 check interval 1 hour(s). 20200310:035211:INFO :0:0000024D:licenseman(1823): Concurrency info: 20200310:035211:INFO :0:0000024D:licenseman(1823): There are 10 instances allowed. 20200310:035211:INFO :0:0000024D:hexane.cxx(2848): STROMASYS SA, (C) 2009-2020 20200310:035211:INFO :0:00000408:hexane.cxx(2892): CHARON-AXP (AlphaServer ES40), V 4.12 B 21009, Mar 10 2023 / 000.msc.test.center.nikolaev / 1918154109 20200310:035211: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: http://www.stromasys.com/pub/doc/30-17-033.pdf

CHARON-AXP log file example (part2)

20200310:035211: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. 20200310:035211: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 20200310:035211:INFO :0:00000099:hexane.cxx(3009): Host Memory: 3840Mb 20200310:035211:INFO :0:0000041F:hexane.cxx(3224): Configuration dump:: . session: . . configuration_name = "AlphaServer_ES40" . . log_method = "overwrite" . . hw_model = "AlphaServer_ES40" . . log_mode = "shared" . . log_locale = "english" . RAM: . . size = "256"

. ACE: . . num_entries = "2139" . . num_translators = "0" . . cache_size = "1024" . . cache_base_size = "200" . . host_options = " --locked-size=16" . . enabled = "true" . . ext_compiler = "ml64.exe" . . ext_path = "" . . cpu_architecture = "EV67" . . locked_size = "16" . cpu_0: . . locked_size = "16" . . wtint_idle = "true" . cpu_1: . . locked_size = "16" . . wtint_idle = "true" . cpu_2: . . locked_size = "16" . . wtint_idle = "true" . cpu_3: . . locked_size = "16" . . wtint_idle = "true" . ROM: . . container = "clipper.bin" . . dsrdb[0] = "1820" . . dsrdb[1] = "50" . . dsrdb[4] = "50" . . dsrdb[11] = "1050" . . dsrdb[12] = "1050" . . system_name = "AlphaServer ES40 6/667" . ISA: . . clock_period = "10000" . TOY: . . container = "clipper.dat" . COM1: . . line = "OPA0" . . communication = "console" . COM2: . . line = "(void)" . . communication = "ascii" . OPA0: . . trace = "disabled" . . stop_on = "F6" . . tx_flush_delay = "0"

CHARON-AXP log file example (part3)

. EWA: . . adapter_mode = "auto" . . interface = "EWA0" . . rx_fifo_delay_on_overload = "false" . EWA0: . . interface = "eth1" . . disabled_mode = "10BaseT-HD" . . port_show_driver_statistics = "false" . . port_enable_mac_addr_change = "true" . . port_snd_sock_buf_size_kb = "0" . PKA: . . scsi_id = "7" . . min_n_of_threads = "0" . . container[0] = "/home/charon/Charon/test/performancecomparison-axp.vdisk"

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

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

Rotating log (default)

By default Charon-AXP 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 4 MB (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).

This mode is turned on if the log_method is not specified or the "session_log" parameter is pointing to an existing directory rather than to a file. If a directory is specified, the log files will be created in that directory.

The names of the rotating log files are composed as follows:

configuration_name-YYYY-MM-DD-hh-mm-ss-xxxxxxxxx.log

If the "Configuration name" parameter described before is omitted (commented out), the log name has the following format instead:

hw_model-YYYY-MM-DD-hh-mm-ss-xxxxxxxxx.log

Note that "xxxxxxxxx" is an increasing decimal number starting from "000000000". During a session (the time between start and stop of the emulator), when the log file is rotated, this number will be incremented by 1.

Please 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-AXP 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.

The log file can be extended ("log_method = append") or overwritten ("log_method = overwrite") by Charon-AXP.

Below is a specification of a Charon-AXP log file located in the "/my_logs" directory which will be appended each time Charon-AXP starts:

set session log_method = append
set session log = "/my_logs/my_es40.log"

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

“Affinity” overrides the default and allows explicit specification of which host CPUs will be used by the instance. Affinity does not reserve the CPU for exclusive use.

Example:

set session affinity="0, 1, 2, 3"

The example above directs Charon-AXP to use CPU 0,1,2 and 3.

If this parameter is omitted Charon host will allocate available CPUs automatically.

Note that the number of the specified host CPUs must correspond to the number of the emulated CPUs (one host CPU for one emulated CPU; this value is specific for each Alpha model) and number of CPUs needed for Charon application itself ("n_of_io_cpus").

Number of host CPUs dedicated to Charon I/O

This parameter reserves host CPUs for use by the emulator for I/O handling. By default the emulator instance reserves one third of the number host CPUs for I/O processing (rounded down, at least one).

The “n_of_io_cpus” overrides the default by specifying the number of I/O host CPUs explicitly

Example:

set session n_of_io_cpus=2

The example above directs Charon-AXP to use 2 CPUs for Charon I/O operations.

Note that the number of the specified CPUs dedicated to Charon I/O operations can NOT exceed the total number of host CPUs minus the number of Alpha emulated CPUs.

Setting a specific Alpha model

Charon-AXP allows to specify an exact model of Alpha.

For example for AlphaServer ES40 family the "es40.cfg" sample configuration file contains the following options:

#============================================================================
#
# AlphaServer ES40 6/500
#
#----------------------------------------------------------------------------

#set ace cpu_architecture = EV6
#set rom dsrdb[0] = 1816 system_name = "AlphaServer ES40 6/500"
#set rom version[1] = 1.98-4 version[2] = 1.92-5

#============================================================================
#
# AlphaServer ES40 6/667
#
#----------------------------------------------------------------------------

set ace cpu_architecture = EV67
set rom dsrdb[0] = 1820 system_name = "AlphaServer ES40 6/667"

Just uncomment the provided lines to apply a certain model (It is "AlphaServer ES40 6/667" in the example above).

The full description of the parameters, with other models that can be also configured, is available in the "Configuration details" chapter of this User's Guide.

Do not change the basic Alpha model ("DS10", "DS20", "ES40", "ES45", etc). You should always start with the appropriate configuration template file for the model you wish to emulate in /opt/charon/cfg/.

Configuring the number of emulated CPUs

If the number of emulated CPUs is not specified, the emulator will try to create the maximum number of CPUs as determined by the Alpha model being emulated. See the Software Product Description to determine the maximum number of CPUs possible for a particular Alpha model.

If you wish to emulate fewer CPUs that the maximum, for example because the Charon host does not contain enough CPUs to emulate the maximum number of CPUs provided by a certain Alpha model, it is possible to specify the number of emulated Alpha CPUs in the configuration:

set session n_of_cpus=1

This parameter can also be used to avoid warning messages in the log if the number of CPUs allowed by the license is less than the default number of CPUs of the emulated Alpha model. For example, the default number of CPUs for an Alpha DS20 is 2. Many DS20 installations have only 1CPU and are licensed that way. To avoid any warning messages, the use of the command above would be advised. Please note that the warning message is just that and will not cause any problems or issues.

Setting system serial number

This parameter is used to set a specific system serial number instead of the default one:

set rom system_serial_number = SN01234567

TOY and ROM containers

The next objects to be configured are TOY and ROM containers (their presence depends on the Alpha model). It is always recommended to enable them. If a container file of the given name does not exist, Charon-AXP will create it. It is recommended to specify the path for each file so that time and console parameters will be kept whatever the current directory is when starting the guest.

TOY means "Time of Year"; its container records time, date and some console parameters while Charon-AXP is not running. To enable the TOY, uncomment the following line:

set toy container="clipper.dat"

The ROM container stores an intermediate state of the Flash ROM and some console parameters. It is highly recommended to define its location:

set rom container="clipper.bin"

Emulated memory (RAM) size

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

Example:

#set ram size=4096
set ram size=32768

The amount of RAM is specified in MB. It cannot exceed or be lower than certain values specific for each Alpha model. It is very important to keep the listed predefined increment between possible memory values.

The following table lists all the parameters per model:

Hardware Model	RAM size (in MB)
	Min	Max	Default	Increment
AlphaServer 400	64	1024	512	64
AlphaServer 800	256	8192	512	256
AlphaServer 1000	256	1024	512	256
AlphaServer 1000A	256	1024	512	256
AlphaServer 1200	256	32768	512	256
AlphaServer 2000	64	2048	512	64
AlphaServer 2100	64	2048	512	64
AlphaServer 4000	64	32768	512	64
AlphaServer 4100	64	32768	512	64
AlphaServer DS10	64	32768	512	64
AlphaServer DS10L	64	32768	512	64
AlphaServer DS15	64	32768	512	64
AlphaServer DS20	64	32768	512	64
AlphaServer DS25	64	32768	512	64
AlphaServer ES40	64	32768	512	64
AlphaServer ES45	64	32768	512	64
AlphaServer GS80	256	65536	512	256
AlphaServer GS160	512	131072	512	512
AlphaServer GS320	1024	262144	1024	1024

It is possible to leave the RAM line commented out. In this case the model's default RAM amount is used.

Note that in some particular orders your license may restrict the maximum RAM amount of each Alpha model.

Console

Mapping to system resources

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

Example:

#set OPA0 line = "/dev/ttyN" #set OPA0 port = 10003 #set OPA0 port = 10003 application = "xterm -title OPA0 -e telnet 127.0.0.1 10003" #set OPA0 port = 10003 application = "xterm -title OPA0 -e chterm -h 127.0.0.1:10003" set OPA0 line = (console)

The goal of this configuration step is to tell Charon-AXP what host device to use as the virtual system console. The following options are available:

Option	Description
line	Mapping to host serial line, both physical and virtual. Use the following mapping for different types of host serial lines: `/dev/tty<N>` for virtual serial lines `/dev/ttyS<N>` for onboard serial lines `/dev/ttyUSB<N>` for modem or usb serial lines adapters `(console)` for mapping to the current TTY console Please note: If the emulator will be configured to use a physical serial port ("/dev/ttyNN"), it must either be run as the `root` user or the non-privileged user must be a member of the `dialout` group.
port	Mapping to an IP port of the CHARON host. Using this mapping it is possible to connect to the Charon console and disconnect from it at any time.
application	Starting some application (typically another xterm terminal) with its specific options and switches to communicate to Charon using the IP port defined by the "port" parameter (see above)
alias	Define some meaningful name for "COM1" and "COM2". Usually it is "OPA0" for "COM1" and "TTA0" for "COM2" (see below)

The default setting for OPA0 is "line = (console)".

The second serial line "COM2"/"TTA0" can be also optionally configured for all Alpha models ("TTA0" is a predefined alias for "COM2"):

#set TTA0 line = "/dev/ttyN" #set TTA0 port = 10000 set TTA0 port = 10000 application = "xterm -title TTA0 -e telnet 127.0.0.1 10000" #set TTA0 port = 10000 application = "xterm -title TTA0 -e chterm -h 127.0.0.1:10000"

There are a number of additional parameters for Charon-AXP serial lines configuration. Follow this link for details.

Exit on pressing F6 key

Charon-AXP can be exited by issuing the "power off" command on the SRM console. It is also possible to configure a hot key to immediately terminate the emulator from the console:

set OPA0 stop_on = F6

This line configures the "F6" key to send the emulator the signal to immediately stop itself. Unless you have no choice, you should never stop the emulator if the guest is still running.

Improve granularity of emulated timer

The next configuration option can be applied for improving granularity of emulated CHARON-AXP timer:

#set isa clock_period=1000

Do not uncomment this parameter unless there are some problems with system time or system clock intervals in guest OS.

Networking

Charon-AXP supports DE435, DE450, DE500AA, DE500BA, DE602 and DE602AA virtual network adapters.

All of them are configured in a similar way:

load DE500BA/dec21x4x EWA interface=EWA0
load packet_port/chnetwrk EWA0 interface="eth0"

load DE602/i8255x EIA interface=EIA0
load packet_port/chnetwrk EIA0 interface="eth0"

In the examples above the first line loads DE500BA/DE602 virtual adapter with a name "EWA"/"EIA" (note that "/i8255x" syntax must be used only in case of DE602 and DE602AA adapters); the following line maps it to host network interface "eth0". Note that the mapping is performed in 2 steps:

A mapping object "packet_port" with a name "EWA0"/"EIA0" is loaded and connected to host interface "eth0", so Charon-AXP will use this interface for its networking
The loaded virtual adapter "EWA"/"EIA" is connected to the "packet_port" object "EWA0"/"EIA0"

It is possible to load several DE435, DE450, DE500AA, DE500BA or DE602 controllers, for example (for DE500BA):

load DE500BA/dec21x4x EWA interface=EWA0
load packet_port/chnetwrk EWA0 interface="eth0"

load DE500BA/dec21x4x EWB interface=EWB0
load packet_port/chnetwrk EWB0 interface="eth1"

Some network adapters available in Charon-AXP are preloaded (for example, an AlphaServer DS15 contains 2 preloaded adapters EWA and EWB), so their configuration is even more simple:

load packet_port/chnetwrk EWA0 interface = "eth0"

load packet_port/chnetwrk EWB0 interface = "eth1"

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.

Please note:

The AlphaServer DS15 and DS25 contain two built-in PCI Ethernet adapters. Models and names (EI* or EW*) of them depend on configuration addon. Choose one of the two or none, but not both. The first instantiates onboard network interfaces as EIA and EWA. While the second - EWA and EWB (enabled by default for backward compatibility)

Example:
#include ds25-onboard-nics.icfg
include ds25-onboard-nics-ew.icfg

It could be necessary to specify the path to the .icfg file if you use your own configuration file using the "include /opt/charon/cfg/ds25-onboard-nics-ew.icfg" syntax.

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

Disk/tape subsystem

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

Charon-AXP supports KZPBA and KGPSA-CA adapters.

KZPBA PCI SCSI disk/tape controller

Below is the typical configuration options for KZPBA PCI SCSI disk/tape controller:

load KZPBA PKA scsi_id = 7

# Disks
#set PKA container[0] = "<file-name>.vdisk"
#set PKA container[100] = "/dev/sd<L>"

# Unknown SCSI device
#set PKA container[200] = "/dev/sg<N>"

# CD-ROM
#set PKA container[300] = "/dev/cdrom"
#set PKA container[300] = "/dev/cdrom1"
#set PKA container[300] = "/dev/cdrom<N>"
#set PKA container[300] = "/dev/sr0"
#set PKA container[300] = "/dev/sr<N>"

# CD-ROM image
#set PKA container[400] = "<file-name>.iso"

# Tape
#set PKA container[500] = "/dev/sg<N>"
#set PKA container[600] = "<file-name>.vtape"

The first line ("load KZPBA PKA") loads disk controller KZPBA with name "PKA", followed by 8 group of lines showing different ways of mapping to the host resources:

Type of mapping	Description
"<file-name>.vdisk"	Mapping to files representing physical disks of the Alpha system (disk images). 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, for example: "/my_disks/my_boot_disk.vdisk"
"/dev/sd<L>"	Mapping to physical disk. "L" is letter here. 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. 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. Please note: Since "/dev/sd<L>" addressing is not persistent, it is strongly recommended to use "/dev/disk/by-id/wwn-*" syntax instead to refer the disk by its WWID - especially in the enviroments utilizing FC and SAN storages (see below).
"/dev/dm-<N>" "/dev/mapper/mpath<N>" "/dev/mapper/disk<N>"	Mapping to multipath disk. 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.
"/dev/disk/by-*"	Mapping to physical disk. by-id (addressing by the disk ID, for example "/dev/disk/by-id/ata-ST1000DM003-9YN162_S1D01QJ4") by-label (addressing by the disk label, for example "/dev/disk/by-label/MyStorage") by-uuid (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 mistake. These disks must not be formatted by the host OS.
"/dev/sg<N>"	Direct mapping to some SCSI device, for example, a SCSI disk or tape reader. How to find proper "/dev/sg" device is explained in this section.
"/dev/sr<N>" "/dev/cdrom" "/dev/cdrom<N>	Mapping to host CD-ROM device.
"<file-name>.iso"	Mapping to an ISO file for reading distribution CD-ROM image. Mapping may also include the full path (recommended), for example: "/my_disks/vms_distributive.iso"
"<file-name>.vtape"	Mapping to the file representing the tape (tape image). These files are created automatically. Mapping may also include a full path (recommended), for example: "/my_tapes/backup.vtape"

Additionally it is possible to specify a parameter "media_type" to assign the type of the attached media explicitly.

Example:

set PKA media_type[600]="RX23"

Numbers in the square brackets represent SCSI addresses and LUNs associated with each container of the KZBPA controller. They have the following structure:

[XXYY], where

Parameter Range Description

XX

0...15

Stands for SCSI ID of each connected unit.

Note that KZPBA itself has some ID associated with it. By default it is 7, but it can be changed in the following way:

load KZPBA PKA scsi_id = 0

In this example an instance "PKA" of KZPBA controller is assigned with SCSI ID 0.

YY 00...07 Stands for LUN.

It is possible to load several KZPBA controllers: DKB, DKC, etc. by configuring specific placement for them on the PCI bus. It is discussed in details in the "Configuration details" chapter of this Guide.

Some Alpha systems emulated by CHARON-AXP have already had one or two KZPBA controllers preloaded. If the system has only one preloaded controller, the template configuration file usually provides some sample line on how to add another one, for example:

load KZPBA PKA bus=pci_1 device=1 function=0 irq_bus=isa irq=24

Follow this link for details of KZPBA controllers configuration.

KGPSA-CA PCI FC disk controller

Optionally it is possible to configure KGPSA-CA FC disk controller.

It can be configured in 2 modes:

Below is an example of KGPSA-CA controller loading:

load KGPSA FGA

Optionally another KGPSA-CA adapter can be loaded similar way:

load KGPSA FGB

Follow this link for details of KGPSA-CA controllers configuration.

KGPSA-CA mapping to the host resources

Below is the typical configuration options for KGPSA-CA PCI FC disk controller, mapped to the host resources ("L" is letter here):

load KGPSA FGA
#set FGA container[0] = "<file-name>.vdisk"
#set FGA container[100]="/dev/sd<L>"

The first line ("load KGPSA FGA") loads disk controller KGPSA with name "FGA", followed by 2 groups of lines showing different ways of mapping to the host resources:

Type of mapping	Description
"<file-name>.vdisk"	Mapping to the file representing a physical disk of the Alpha system (disk image). 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/my_boot_disk.vdisk"
"/dev/sd<L>"	Mapping to physical disk. "L" is letter here. 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. 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. Please note: Since "/dev/sd<L>" addressing is not persistent, so it is strongly recommended to use "/dev/disk/by-id/wwn-*" syntax instead to refer the disk by its WWID - especially in the enviroments utilizing FC and SAN storages (see below).
"/dev/dm-<N>" "/dev/mapper/mpath<N>" "/dev/mapper/disk<N>"	Mapping to multipath disk. 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.
"/dev/disk/by-*"	Mapping to physical disk. by-id (addressing by the disk ID, for example "/dev/disk/by-id/ata-ST1000DM003-9YN162_S1D01QJ4") by-label (addressing by the disk label, for example "/dev/disk/by-label/MyStorage") by-uuid (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 mistake. These disks must not be formatted by the host OS.

Numbers in the square brackets represent KGPSA-CA units. They can be in the range 0..32766, but no more than 255 units can be configured on a single controller.

KGPSA-CA pass through mode

It is also possible to use the emulated KGPSA-CA in "pass through" mode to address a physical EMULEX LightPulse PCI/PCI-X/PCIe FC adapter plugged into the host’s PCI/PCI-X/PCIe slot.

The sample configuration file provides a template for this type of mapping:

#set FGA host_bus_location = "/dev/kgpsaX"
#set FGB host_bus_location = "/dev/kgpsaY"

Follow this link for detailed description of building and installation of an EMULEX LightPulse PCI/PCI-X/PCIe FC adapter driver.

Auto boot

Charon-AXP can be configured to automatically boot an operating system at start up by specifying the default boot device and setting the 'auto_action' parameter to 'restart' from the console.

Example: dka0 is defined as the default boot device

P00>>>set bootdef_dev dka0
P00>>>set auto_action restart

Network boot

Charon-AXP can be configured to boot on network if the legacy operating system allows it via MOP. MOPv3 (DECnet) and MOPv4 (LANCP) are supported.

Usage/example:

P00>>>boot [-flags ...] [-file ...] ewa0

Both EW and EI adapters are supported for MOP network boot.

Browser not supported