Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 30 Next »

Table of Contents

Creation of CHARON VM configuration

When a CHARON Virtual Machine (VM) is created from a template using the CHARON Virtual Machines Manager, it has to be updated to meet the desired configuration.

This configuration is represented as a text file ("configuration file") containing some specific keywords to define the main settings such as amount of memory, number of CPUs, peripheral devices as well as specifics of CHARON VM executions such as name of VM log file, number of host CPUs used for emulation, etc.

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:


Notepad will be used to edit the configuration file:


Back to Table of Contents

HP Alpha model specification

The first configuration statement is the specification of the exact HP Alpha hardware model to emulate, for example:

set session hw_model = AlphaServer_ES40

You must leave this line untouched.

(warning) If you create the CHARON VM configuration file from scratch, it must be the very first uncommented line in the configuration file.

Back to Table of Contents

Configuration name

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

#set session configuration_name = My_ES40

You can optionally uncomment this line to differentiate this CHARON VM 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:

set session configuration_name = "My ES40"

The configuration name is reported in the log file and is used to set the log file name for rotating log (see further: Rotating log (default) ).

Back to Table of Contents

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 operations: 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.

(info) If it becomes necessary to contact Stromasys for support, the configuration and log files, plus the license number, will be requested to begin the problem resolution.

Here is an example of a CHARON VM log file:

20160906:123954:INFO :0:00000249:ethane.cxx(8343): Logging started.
20160906:123954:INFO :0:000003A5:ethane.cxx(9414): session: loading built-in configuration "AlphaServer_ES40"...
20160906:123954:INFO :0:000003A6:ethane.cxx(9446): session: ... done loading built-in configuration "AlphaServer_ES40"
20160906:123954:INFO :0:000003A7:ethane.cxx(9604): session: loading service configuration "My_ES40"...
20160906:123954:INFO :0:000003A8:ethane.cxx(9639): session: ... done loading service configuration "My_ES40"
20160906:123954:INFO :0:000003AA:ethane.cxx(9687): session: loading configuration file "C:\Program Files\CHARON\Virtual Machines\My_ES40\My_ES40\es40.cfg"...
The previous message has been repeated 2 times.
20160906:123954:INFO :0:000003AB:ethane.cxx( 540): session: ... done loading configuration file "configuration_name.icfg"
The previous message has been repeated 2 times.
20160906:123954:INFO :0:000003F2:sesmgr.cxx(1394): session: default log file size limit is 4194304 bytes
20160906:123954:INFO :0:0000032B:ethane.cxx(2581): Start request received.
20160906:123954:INFO :0:000003AC:ethane.cxx( 739): session: process affinity is 00000000000000FF, system affinity is 00000000000000FF
20160906:123954:INFO :0:000003D1:ethane.cxx(1397): session: I/O domain affinity is 0000000000000003, CPU domain affinity is 00000000000000FC
20160906:123954:INFO :0:000003BA:ll_sentine( 730): Looking for a license key ...
20160906:123954:INFO :0:000003DC:ll_sentine( 825): ... found license key 1422726238.
20160906:123954:INFO :0:0000024D:ethane.cxx(2712): STROMASYS SA, (C) 2009-2016
20160906:123954:INFO :0:00000408:ethane.cxx(2754): CHARON-AXP (AlphaServer ES40), V 4.8 B 18302, Nov 11 21 2016 / 000.MSC.TEST.CENTER.KIRILL / 1422726238
20160906:123954:INFO :0:00000336:ethane.cxx(2795): 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
20160906:123954:INFO :0:0000009D:ethane.cxx(2859): License info:
CHARON product code: "CHAXP-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.
20160906:123954:INFO :0:00000097:ethane.cxx(2868): OS Environment: Microsoft Windows 7 Professional, 64-bit, Service Pack 1 (Build 7601).
20160906:123954:INFO :0:00000098:ethane.cxx(2873): Host CPU: Intel(R) Xeon(R) CPU E31275 @ 3.40GHz x8.
20160906:123954:INFO :0:00000099:ethane.cxx(2878): Host Memory: 24320Mb
20160906:123955:INFO :0:0000032C:ethane.cxx(2617): "My_ES40" started.

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

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

Rotating log (default)

By default the CHARON VM utilizes a so-called "rotating log" method. This means that a new default log file is always created each time the CHARON VM starts and if the size of the log file exceeds 64Kb (previous log files are kept).

This mode is turned on if all the log parameters above are disabled (commented out) or the "session_log" parameter is pointing to a 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" to separate log files with the same time of creation.

(warning) The "log" parameter, if specified, must correspond to an existing folder.

(info) If the path is not specified, the log file is created in the "Home directory" mentioned in the VM Configuration tab of the CHARON Virtual Machine Manager.

Single log

Alternatively it is possible to use a single log file. Uncomment the "set session log" line and specify the desired log file name. Optionally, a path can be added to the log file name.

(info) If the path is not specified, the log file is created in the "Home directory" mentioned in the VM Configuration tab of the CHARON Virtual Machine Manager.

The log file can be extended specifying "log_method = append" (*recommended for reporting issues*) or overwritten, specifying "log_method = overwrite".

Below is a specification of a CHARON VM log file located in the "C:\CHARON logs" directory which will be appended each time the CHARON VM starts:

set session log_method = append
set session log = "C:\CHARON logs\my_ES40.log"

Back to Table of Contents 

CPU affinity

This setting binds the running CHARON VM CPUs to particular host CPUs.This should be used for soft partitioning host CPU resources or for isolating multiple CHARON VMs 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.

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

The example above directs CHARON VM to use CPU 0,1,2 and 3.

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

(warning) 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 HP Alpha model) and number of CPUs needed for CHARON application itself ("n_of_io_cpus").

Back to Table of Contents

Number of host CPUs dedicated to CHARON I/O

This setting reserves host CPUs (of those specified by “affinity” parameter, if any) for use by CHARON VM for I/O handling. By default CHARON VM reserves one third of available host CPUs for I/O processing (round 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 VM to use 2 CPUs for CHARON I/O operations.

(warning) Note that the number of the specified CPUs dedicated to CHARON VM I/O operations must correspond to the total number of available for CHARON CPUs (restricted by "affinity" parameter if needed) and the number of the virtual HP Alpha CPUs to be emulated.

Back to Table of Contents

Setting a specific HP Alpha model

CHARON-AXP allows to specify an exact model of HP Alpha.

For example for HP AlphaServer ES40 family the template 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 and other models that can be also configured is available in the "Configuration details" chapter of this User's Guide.

Back to Table of Contents

Reducing number of emulated CPUs

If the CHARON host does not contain enough CPUs to emulate full range of the CPUs provided by a certain HP Alpha model, it is possible to direct the CHARON VM to reduce the number of emulated Alpha CPUs:

set session n_of_cpus=1

Back to Table of Contents

Setting system serial number

If necessary, a specific system serial number instead of the default one:

set rom system_serial_number = SN01234567

Back to Table of Contents

TOY and ROM containers

The TOY and ROM containers have to be configured. Their presence depends on the HP Alpha model. It is always recommended to enable them. If a container file of the given name does not exist, starting the CHARON VM will create it.

TOY means "Time of Year". Its container records time, date and some console parameters while the CHARON VM is not running. It is highly recommended to define and activate this container:

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 and activate this container:

set rom container="clipper.bin"

Back to Table of Contents

Emulated memory (RAM) size

The next parameter defines the amount of host memory the CHARON VM reserves for the emulation:

#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 HP Alpha model. It is very important to keep the listed predefined increment between possible memory values.

The following table shows all the parameters:

Hardware ModelRAM size (in MB)

MinMaxDefaultIncrement
AlphaServer 40064102451264
AlphaServer 8002568192512256
AlphaServer 10002561024512256
AlphaServer 1000A2561024512256
AlphaServer 120025632768512256
AlphaServer 200064204851264
AlphaServer 210064204851264

AlphaServer 4000

643276851264
AlphaServer 4100643276851264
AlphaServer DS10643276851264
AlphaServer DS10L643276851264
AlphaServer DS15643276851264
AlphaServer DS20643276851264
AlphaServer DS25643276851264
AlphaServer ES40643276851264
AlphaServer ES45643276851264
AlphaServer GS8025665536512256
AlphaServer GS160512131072512512
AlphaServer GS320102426214410241024

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 HP Alpha model.

Back to Table of Contents

Console

Mapping to system resources

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

#load physical_serial_line OPA0 line="COM1:"
#load virtual_serial_line OPA0 port=10003
#load virtual_serial_line OPA0 port=10003 application="opa0.ht"
load virtual_serial_line OPA0 port=10003 application="putty -load OPA0"
#load virtual_serial_line OPA0 port=10003 application="c:\kea\user\opa0.ktc"

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

OptionDescription
physical_serial_lineMapping to host "\\.\COM<n>" ("COM<n>:") physical serial line.
virtual_serial_line

Mapping to an IP port of CHARON host.
Using this mapping it is possible to connect to the CHARON VM console and disconnect from it at any time without usage of CHARON Virtual Machines Manager "Show Console" option. It is also possible to start up some chosen application to connect to the CHARON console IP port.

ParameterDescription
portSpecifies a unique IP port on the host to which the CHARON VM console will be mapped.
applicationA string specifying a name of an application to be started together with CHARON to provide emulation of HP Alpha console (terminal emulator). It is assumed that this application has already been configured to use the IP port specified by the corresponding "port" parameter

Example:

load virtual_serial_line/chserial OPA0 port=10003 application="putty.exe -load OPA0"

In the example above, the CHARON VM uses the IP port "10003" for the HP Alpha console and starts the "Putty" terminal emulator (included in the CHARON installation kit) with the "OPA0" saved session directing it to connect to the IP port "10003". If the terminal emulator is closed, it is always possible to reopen it with the "Show Console" feature from the CHARON Virtual Machines Manager.

BM MARKER

The default setting is:

load virtual_serial_line/chserial OPA0 port=10003 application="putty.exe -load OPA0"

The second console line "TTA0" can be also optionally configured (for 1 CPU models such as HP AlphaServer 400, HP AlphaServer 800, HP AlphaServer 1000, HP AlphaServer 1000A, HP AlphaServer DS10, HP AlphaServer DS10L and HP AlphaServer DS15):

#load physical_serial_line TTA0 line="COM1:"
#load virtual_serial_line TTA0 port=10003
#load virtual_serial_line TTA0 port=10003 application="tta0.ht"
load virtual_serial_line TTA0 port=10003 application="putty -load TTA0"
#load virtual_serial_line TTA0 port=10003 application="c:\kea\user\tta0.ktc"
set COM2 line=TTA0

Note that additional parameters for the CHARON VM serial lines configuration can be added. Follow this link for details.


Exit on pressing F6 button

Despite the fact that the CHARON VM can stop with the "power off" command entered at SRM console level, it is recommended to set a hot key to stop the VM from the console (when the console is accessed remotely for example):

set OPA0 stop_on = F6

This line allows the CHARON VM to be stopped by pressing the "F6" key.

Back to Table of Contents

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 the system time or the system clock intervals in the guest OS.

Back to Table of Contents

ATAPI CD/DVD-ROM configuration

If the sample configuration file provides this parameter it is possible to map this particular CHARON VM emulator's "DQA0" CD-ROM to the host CD/DVD-ROM with the following setting:

set ide container="\\.\CdRom0"

Back to Table of Contents

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="connection:Charon"

load DE602/i8255x EIA interface=EIA0
load packet_port/chnetwrk EIA0 interface="connection:Charon"

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 with DE602 and DE602AA adapters); the following line maps it to the host network interface having a name "Charon" ("connection" is a key word). Note that the mapping is performed in 2 steps:

  1. A mapping object "packet_port" with a name "EWA0"/"EIA0" is loaded and connected to the host interface named "Charon", so the CHARON VM will use this interface for its networking
  2. The loaded DE500BA/DE602 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="connection:Charon1"
load DE500BA/dec21x4x EWB interface=EWB0
load packet_port/chnetwrk EWB0 interface="connection:Charon2"


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

load packet_port/chnetwrk EWA0 interface = "connection:Charon"


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-AXP network controllers configuration.

Back to Table of Contents

Disk/tape subsystem

The disk and tapes subsystems and the mapping to the system resources can be done 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 the KZPBA PCI SCSI disk/tape controller:

load KZPBA PKA scsi_id = 7

#set PKA container[0] = "<file-name>.vdisk"

#set PKA container[100]="\\.\PhysicalDrive0"
#set PKA container[101]="\\.\PhysicalDrive(DevID=XXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX)"
#set PKA container[102]="\\.\PhysicalDrive(iScsiTarget = <iSCSI target>, LUN = <LUN number>)"

#set PKA container[200]="\\.\ScsiN:X:Y:Z"

#set PKA container[300]="\\.\CdRom0"
#set PKA container[300]="\\.\CdRom<N>"

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

#set PKA container[500]="\\.\Tape0"
#set PKA container[500]="\\.\Tape<N>"

#set PKA container[600] = "<file-name>.vtape"

#set PKA container[600]="\\.\A:"
#set PKA media_type[600]="RX23"

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

  • File representing a physical disk of the HP Alpha 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, for example: "C:\My disks\my_boot_disk.vdisk". If the path is not specified, the disk images are expected to be in the CHARON VM home directory.

      Using compressed folders to store virtual disks and tapes is not supported

      .

  • Physical disk
    • "\\.\PhysicalDrive<N>"
      (warning) 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.

      .
  • Physical disk by its WWID
    • "\\.\PhysicalDrive(DevID =XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX)"
      (warning) 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:

      set PKA container[100]="\\.\PhysicalDrive(DevID= 6008-05F3-0005-2950-BF8E-0B86-A0C7-0001)"

      .

  • iSCSI disks
    • "\\.\PhysicalDrive(iScsiTarget = <iSCSI target>, LUN = <LUN number>)"

      ParameterDescription
      iScsiTargetAddresses the disk by its iSCSI target name.
      LUNSpecifies the LUN on the connected iSCSI disk. 

      Example:

      set PKA container[200]="\\.\PhysicalDrive(iScsiTarget= iqn.2008-04:iscsi.charon-target-test1, LUN= 1)"

      .

  • SCSI device unknown to Windows for direct mapping, for example, a SCSI disk or tape reader
    • "\\.\Scsi<N>:<X>:<Y>:<Z>"
      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.

      ParameterDescription
      NA logical number assigned by host operating system (Microsoft Windows) to logical or host’s physical storage resource such as physical SCSI HBA
      XAn internal SCSI bus number (usually 0) on host’s physical SCSI HBA
      YA SCSI ID of physical SCSI target device attached to host’s physical SCSI HBA
      ZA logical unit number inside physical SCSI target device attached to host’s physical SCSI HBA

      .

  • CD-ROM device
    • "\\.\CdRom<N>"
      .
  • ISO file for reading distribution CD-ROM image
    • "<file-name>.iso"
      Mapping may also include the full path, for example: "C:\My disks\vms_distributive.iso". If the path is not specified, the CD-ROM images are expected to be in the CHARON VM home directory.
      .
  • Host tape device
    • "\\.\Tape<N>"
      .
  • File representing the tape (tape image)
    • "<file-name>.vtape"
      These files are created automatically.
      Mapping may also include a full path, for example: "C:\My tapes\backup.vtape". If the path is not specified, the tape images are expected to be in the CHARON VM home directory.

      Using compressed folders to store virtual disks and tapes is not supported

      .

  • Floppy drive
    • "\\.\A:"
      .
  • Other type of drive, for example magneto-optical drive
    • "\\.\<N>:"
      .

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"

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

[XXYY], where

ParameterRangeDescription
XX0...15

Stands for SCSI ID of each connected unit.

(info) Note that the 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.

YY00...07Stands 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 HP Alpha systems emulated by CHARON-AXP have already one or two KZPBA controllers pre-loaded. 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 on the KZPBA controllers configuration.

Back to Table of Contents

KGPSA-CA PCI FC disk controller

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

They can be configured in 3 modes:

Below is an example of a KGPSA-CA controller loading:

load KGPSA FGA

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

load KGPSA FGB

Follow this link for details on the KGPSA-CA controllers configuration.

Back to Table of Contents

KGPSA-CA mapping to the host resources

Below is the typical configuration options for a KGPSA-CA PCI FC disk controller, mapped to the host resources:

load KGPSA FGA

#set FGA container[0] = "<file-name>.vdisk"

#set FGA container[100]="\\.\PhysicalDrive0"
#set FGA container[200]="\\.\PhysicalDrive(DevID=XXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX)"
#set FGA container[300]="\\.\PhysicalDrive(iScsiTarget = <iSCSI target>, LUN = <LUN number>)"


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

  • File representing a physical disk of the HP Alpha 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, for example: "C:\My disks\my_boot_disk.vdisk". If the path is not specified, the disk images are expected to be in the CHARON VM home directory.

      Using compressed folders to store virtual disks and tapes is not supported

      .

  • Physical disk
    • "\\.\PhysicalDriveN"
      (warning) 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.
      .

  • Physical disk by its WWID
    • "\\.\PhysicalDrive(DevID =XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX)"
      (warning) 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:

      set PKA container[100]="\\.\PhysicalDrive(DevID= 6008-05F3-0005-2950-BF8E-0B86-A0C7-0001)"

      .

  • iSCSI disks
    • "\\.\PhysicalDrive(iScsiTarget = <iSCSI target>, LUN = <LUN number>)"
      iScsiTarget addresses the disk by its iSCSI target name. LUN specifies LUN on the connected iSCSI disk.

      Example:

      set PKA container[200]="\\.\PhysicalDrive(iScsiTarget= iqn.2008-04:iscsi.charon-target-test1, LUN= 1)"

      .

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

Back to Table of Contents

KGPSA-CA mapping to a storage controller using its "presentation" mode

Some storage controllers allows CHARON VM to use their resources using so called "presentation" mode. 

In this type of mapping the CHARON VM automatically creates a set of virtual FC devices for each of the units provided by the storage controller and connects to them through its KGPSA-CA FC adapter.

The main benefit in this type of mapping is a flexible way of the virtual disks management depending on the mapped storage controller configuration. For example if an extra disk is added to the storage controller, it automatically appears as a new disk unit on the corresponding KGPSA-CA virtual adapter mapped to that storage controller.

Below is an example of KGPSA-CA PCI FC disk controller mapped to some storage controller (for example SAN) using its "presentation" mode:

load KGPSA FGA storage_controller_path_id = 5008-05F3-0005-2950-5008-05F3-0005-2951


This line loads an instance of KGPSA-CA controller and maps it to some external controller having ID "5008-05F3-0005-2950-5008-05F3-0005-2951".

Type of mappingDescription
storage_controller_path_id = <Storage controller path ID>

"Storage controller path ID" is a storage (for example SAN) controller path ID.

This ID can be obtained from the special utility "Device check tool" (accessible in the "Host Information and Utilities" section of the CHARON Virtual Machines Manager). Once specified, all the disks attached to the storage are automatically mapped as disk units to the CHARON VM.

Back to Table of Contents

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 = "PCI bus X, device Y, function Z"
#set FGB host_bus_location = "PCI bus A, device B, function C"

The "host_bus_location" parameter addresses the host EMULEX LightPulse PCI/PCI-X/PCIe FC adapter in the following way:

ParametersDescription
"PCI bus X"

PCI bus number of the host EMULEX LightPulse PCI/PCI-X/PCIe FC adapter

"device Y"PCI bus device number of the host EMULEX LightPulse PCI/PCI-X/PCIe FC adapter
"function Z"The "function" parameter of the the host EMULEX LightPulse PCI/PCI-X/PCIe FC adapter

To establish "pass through" mode do the following:

  1. Install the EMULEX LightPulse PCI/PCI-X/PCIe FC adapter (see below for a list of supported models) to some spare PCI/PCI-X/PCIe slot of the host system
  2. Boot a Windows operating system
  3. Install the EMULEX LightPulse PCI/PCI-X/PCIe FC adapter driver from the following directory "C:\Program Files\CHARON\Drivers\EMULEX_X.X.0.XXXXX" by choosing the "Install from a list or specific location (Advanced)" option and then selecting the "emulex_lp_ppt_amd64.inf" file.
  4. Reboot the host

Now it is possible to collect the parameters for CHARON VM mapping to the EMULEX LightPulse PCI/PCI-X/PCIe FC adapter.


Open the “Computer Management” application and select “Device Manager”:


On the right panel select the desired physical EMULEX LP FibreChannel adapter under "CHARON PCI Pass Through":


Open the properties sheet by double-clicking on the selected adapter:

The “Location:” on the above picture gives X, Y, and Z for the "host_bus_location" parameter. For example:

set FGA host_bus_location = "PCI bus 3, device 1, function 0"

(warning) Non-US-EN installations of Windows may present “Location:” string in local language, but "host_bus_location" parameter requires English notation, so the words “PCI”, “bus”, “device”, and “function” must be specified in English.

The following is the list of EMULEX LightPulse PCI/PCI-X/PCIe FC adapters supported by the CHARON-AXP PCI Pass Through driver and suitable for the emulation of a KGPSA-CA PCI FC adapter in CHARON PCI Pass Through mode:

SupportedNot SupportedNot tested

LP8000
LP9000
LP9002
LP9802
LP10000
LP10000DC
LP10000-S
LPX1000
LP11002
LPe11002 (FC2242SR, A8003A)
LPe1105

LPe1150 (FC2142SR, A8002A)LPe11000

Back to Table of Contents


FDDI support via DEFPA PCI FDDI controller in "pass through" mode

Optionally it is possible to configure a DEFPA PCI FDDI controller in "pass through" mode, mapped to a physical DEFPA FDDI adapter installed on the host:

load defpa FDDI host_bus_location = "PCI bus X, device Y, function Z"
set FDDI bus=pci_1 device=1 function=0 irq=24 irq_bus=isa

Pay attention to the proper placement of the emulated DEFPA adapter on the virtual HP Alpha PCI bus (it is controlled by "bus", "device", "function", "irq" and "irq_bus" parameters). Refer to this chapter of this Guide for more information.

The "host_bus_location" parameter addresses the host DEFPA FDDI adapter in the following way:

ParametersDescription
"PCI bus X"

PCI bus number of the host DEFPA FDDI adapter

"device Y"PCI bus device number of the host DEFPA FDDI adapter
"function Z"The "function" parameter of the the host DEFPA FDDI adapter

To establish the "pass through" mode do the following:

  1. Install the DEFPA FDDI adapter to some spare PCI slot of the host system. 
    (warning) Note that PCIe and PCI-X are not supported by the DEFPA FDDI adapter.
  2. Boot a Windows operating system
  3. Install the DEFPA FDDI adapter driver from the following directory: "C:\Program Files\CHARON\Drivers\DEFPA_X.X.X.XXXXX" by choosing the "Install from a list or specific location (Advanced)" option and then selecting the "defpa_ppt_amd64.inf" file.
  4. Reboot the host

Now it is possible to collect the parameters for CHARON VM mapping to the DEFPA FDDI host adapter.


Open the “Computer Management” application and select “Device Manager”:


On the right panel select the installed DEFPA adapter:


Open the properties sheet by double-clicking on the selected adapter:


The “Location:” on the above picture gives X, Y, and Z for the "host_bus_location" parameter. For example:

set FDDI host_bus_location = "PCI bus 1, device 9, function 0"

(warning) Non-US-EN installations of Windows may present “Location:” string in local language, but "host_bus_location" parameter requires English notation, so the words “PCI”, “bus”, “device”, and “function” must be specified in English.

Back to Table of Contents


Serial lines support via emulated PBXDA-xx family PCI controllers in "pass through" mode

Optionally it is possible to configure the folIowing models of PBXDA-xx family controllers mapped to specific models of the physical DIGI serial lines adapters installed on the CHARON VM host:

DEC PBXDA-xx adapterName of the device to map toControllerVendor IDDevice ID
PBXDA-BADIGI AccelePort 4r 920ASIC PCI114Fh0026h
PBXDA-BBDIGI AccelePort 8r 920ASIC PCI114Fh0027h
PBXDA-ACDIGI AccelePort XemASIC PCI114Fh0004h
PBXDA-ACDIGI AccelePort XemASIC PCI114Fh0008h

Below is an example of mapping to a physical DIGI adapter installed on the host:

load digi PBXDA host_bus_location=“PCI bus 3,device 1,function 0”
set PBXDA bus=pci_1 device=1 function=0 irq=24 irq_bus=isa

Pay attention to the proper placement of the emulated PBXDA-xx adapter on the virtual HP Alpha PCI bus (it is controlled by "bus", "device", "function", "irq" and "irq_bus" parameters). Refer to this chapter of this Guide for more information.

The "host_bus_location" parameter addresses the host DIGI adapter in the following way:

ParametersDescription
"bus X"

PCI bus number of the host DIGI adapter

"device Y"PCI bus device number of the host DIGI adapter
"function Z"The "function" parameter of the the host DIGI adapter

To establish the "pass through" mode do the following:

  1. Install the DIGI adapter of the required type to some spare PCI/PCI-X/PCIe slot of the host system. 
  2. Boot a Windows operating system
  3. Install the DIGI adapter driver from the following directory: "C:\Program Files\CHARON\Drivers\DIGI_X.X.X.XXXXX" by choosing "Install from a list or specific location (Advanced)" option and then selecting the "digi_ppt_amd64.inf" file.
  4. Reboot the host

Now it is possible to collect the parameters for CHARON VM mapping to the DIGI host adapter.


Open the “Computer Management” application and select “Device Manager”:


On the right panel select proper physical DIGI adapter:


Open te properties sheet by double-clicking on the selected adapter:

The “Location:” on the above picture gives X, Y, and Z for the "host_bus_location" parameter. For example:

set PBXDA host_bus_location = "PCI bus 1, device 7, function 0"

(warning) Non-US-EN installations of Windows may present “Location:” string in local language, but "host_bus_location" parameter requires English notation, so the words “PCI”, “bus”, “device”, and “function” must be specified in English.

Back to Table of Contents

Auto boot

The CHARON VM 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

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

Back to Table of Contents


  • No labels