Versions Compared

Key

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

...

Table of Contents
excludeTable of Contents

Div
classpagebreak


Introduction

To configure CHARON-VAX 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" or "tap_port" 

    Load "packet_port" or "tap_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 = "eth0"
    div


  3. classpagebreak

    Connect the loaded "packet_port" ("tap_port") to the loaded virtual network adapter

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

    Example

    set NIC interface = NDIS


...

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

Div
classpagebreak


SGEC Ethernet Controller

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

...

Parameterstation_address
Type

Text String

Value

"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 which 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 EXA station_address="AF:01:AC:78:1B:CC"



Div
classpagebreak


rx_fifo_size

Parameter

rx_fifo_size

TypeNumeric
Value

"rx_fifo_size" sets the receive FIFO size.

The value is specified in Kb and by default is pre-calculated from the connected port’s size of receive queue.

Typically, you do not need to change the "rx_fifo_size" parameter. It is available for extended tuning and bug hunting purposes.

...

Parameter

interface

Type

Text String

Value

Name of corresponding instance of "packet_port" or "tap_port" component


Div
classpagebreak


station_address

Parameterstation_address
Type

Text String

Value

"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 which 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 EXA station_address="AF:01:AC:78:1B:CC"


...

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

Div
classpagebreak


PMAD-AA TurboChannel Ethernet Adapter

...

Parameterstation_address
Type

Text String

Value

"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 which 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 ECA station_address="AF:01:AC:78:1B:CC"



Div
classpagebreak


rx_fifo_size

Parameter

rx_fifo_size

TypeNumeric
Value

"rx_fifo_size" sets the receive FIFO size.

The value is specified in Kb and by default is pre-calculated from the connected port’s size of receive queue.

Typically, you do not need to change the "rx_fifo_size" parameter. It is available for extended tuning and bug hunting purposes.

...

Parameterinterface
Type

Text string

Value

This parameter Identifies an Ethernet adapter of the host system dedicated to CHARON-VAX.

Syntax:

set <name> interface="<adapter>"

Example:

set pp_1 interface="eth0"



Div
classpagebreak


port_enable_mac_addr_change

...

Parameter

port_pending_rx_number

Type

Numeric

Value

"port_pending_rx_number" parameter sets the number of pending receive buffers.

The default value is 63. The maximum value allowed is 195.

You may want to increase the "port_pending_rx_number" when you have very busy networking and experience problems like losing connections not related to the carrier loss.

Typically, you do not need to change this parameter.

Example:

set pp_1 port_pending_rx_number=128



Div
classpagebreak


port_pending_tx_number

Parameter

port_pending_tx_number

TypeNumeric
Value

"port_pending_tx_number" parameter sets the number of buffers the port uses to transmit.

The default value is 62.

You may want to increase the "port_pending_tx_number" value if the log file indicates dropped TX packets due to TX queue overflow.

Typically, you do not need to change this parameter.

Example:

set pp_1 port_pending_tx_number=128


...

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 logs Recv and Xmit packets at the emulated port layer.

If an existing directory is specified, CHARON 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 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="/charon/logs"


Note

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



Div
classpagebreak


log_flush_period

Parameterlog_flush_period
TypeNumeric
Value
  • <period-in-seconds>

Defines a period of flushing log to disk.

Default period is 60 seconds (it means that every minute log file is flushed to disk)

Examples:

set pp_1 log_flush_period=30



Info

"tap_port" parameters are the same as "packet_port" ones

...