Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Back to Table of Contents

...

Configuration steps

To configure CHARON-VAX / CHARON-PDP networking, follow these 3 steps:

  1. Load network adapter (if required)

    If you are configuring a DEQNA, DESQA, DELQA, DEUNA, DELUA, DEMNA, DEBNI or PMADAA adapter, use the "load" command as shown below. CHARON-VAX 3100/96/98 and 4000/106/108 emulations automatically load SGEC (with the name "EZA") and therefore no "load" command is required.

    Example:

    load DELQA/DEQNA NIC

              .

  2. Load "packet_port"

    Load "packet_port" to connect the SGEC, DEQNA, DESQA, DELQA, DEUNA, DELUA, DEMNA, DEBNI or PMADAA adapter to the host hardware network card (or to a virtual network interface).

    Example:

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

               .

  3. Connect the loaded "packet_port" to the loaded virtual network adapter

    Connect the SGEC, DEQNA, DESQA, DELQA, DEUNA, DELUA, DEMNA, DEBNI or PMADAA adapter to the "packet_port" by setting the interface name.

    Example

    set NIC interface = NDIS

Back to Table of Contents

SGEC Ethernet Controller

The built-in SGEC controller emulator ("EZA") has the following parameters that are specified with the "set" command:

interface

...

Text string. Can be either "(disabled)" for a disabled interface or "connection:<Windows network interface name>"

...

  1. .

Info

The interface name can be either "(disabled)" for a disabled interface or "connection:<Windows network interface name>"

Examples:

load packet_port/chnetwrk NIC1 interface="(disabled)"

load packet_port/chnetwrk NIC2 interface="connection:CHARON_NIC"


(warning) Network booting is supported with exception of VAX6xxx models.

Back to Table of Contents

SGEC Ethernet Controller

The built-in SGEC controller emulator ("EZA") has the following parameters that are specified with the "set" command:

interface

Parameterinterface
Type

Text string

Value

Name of the corresponding instance of the "packet_port" component

...

Parameterstation_address
Type

Text String

Value

The "station_address" provides the ability to configure the adapter’s permanent address. By default the adapter’s permanent address is read from the host system’s NIC.

Set the "station_address" when you need to configure a satellite (remotely booted) system that will run DECnet or when the migrated software uses the permanent address on the network adapter.

Format:

XX-XX-XX-XX-XX-XX

or

XX:XX:XX:XX:XX:XX

Example:

set eza station_address="AF:01:AC:78:1B:CC"


...

Parameter

suspend_msg_on_mac_change

Type

Boolean

Value

To avoid confusion arising from non critical errors during a MAC address change, logging is by default suppressed (default value is "true").

To enable tracing during a MAC address change set this parameter to "false"

Example:

set pp_1 suspend_msg_on_mac_change=false


log

Parameter

log

TypeText string
Value

If this parameter is set to some valid file name or a directory where the log files for each individual session will be stored CHARON VM logs Recv and Xmit packets at the emulated port layer.

If an existing directory is specified, CHARON VM automatically enables creation of individual log files, one for each session using the same scheme as used for the generation of the rotating log files. If the "log" parameter is omitted, CHARON VM does not create log.

In certain situations enabling this parameter may help to detect loss of packets.

Example:

set pp_1 log="pp_1.log"


set pp_1 log="C:\Charon\Logs"


Note

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


legacy_mode

Parameterlegacy_mode
TypeBoolean
Value

If this parameter is set to "true" CHARON-VAX tries to use very first implementation of "packet_port" having certain restrictions such as inability to automatically change MAC address on given interface etc.

This setting may be needed if CHARON-VAX runs in VMware environment for example and you do not want to allow promiscuous mode.

In other situations please do not change its default value ("false").

Example:

set pp_1 legacy_mode=true


Info

This parameter is required only if you do not want to allow promiscuous traffic for the VMware adapter/port. In this mode, CHARON-VAX uses legacy MAC address change logic, so use of this option is not desirable.

Thus for ESXi networking configuration:

  1. Create the port with e1000 adapter;
  2. Enable the promiscuous traffic;
  3. Do not use legacy_mode option in Charon's configuration file


...