Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: typo / document reviewed

Anchor
TopNetPage
TopNetPage

...

Each virtual network controller has the following parameters that are specified with the "set" command:

Parameter

Type

Value

interface

Text String

Name of the corresponding instance of the "packet_port" component

station_address

Text String

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

rx_fifo_size

Numeric

"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 the receive queue.

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

adapter_modeText String

Defines the link speed and the duplex settings of the virtual network adapter (except for DE602/DE602AA - see below).

The values are:

ParameterDescription
"Auto"Auto-negotiate (default)
"10BaseT-HD"10Mbps half duplex
"10BaseT-FD"10Mbps full duplex
"100BaseT-HD"100Mbps half duplex
"100BaseT-FD"100Mbps full duplex

Example:

set EWA adapter_mode="100BaseT-HD"

...

(warning) The EIx0_MODE variable name is case insensitive, while its values are case sensitive! This is feature of OpenVMS EIDRIVER.

The values are:

ParameterDescription
"Auto"Auto-negotiate (default)
"Twisted"10Mbps half duplex
"Full"10Mbps full duplex
"Fast"100Mbps half duplex
"FastFD" 100Mbps full duplex

...

"packet_port" uses several configuration parameters to control its behavior.

Parameter

Type

Value

interface

Text string

This parameter identifies an Ethernet adapter of the host system dedicated to CHARON-AXPwith a . The leading keyword "connection:" preceeding itis mandatory.

Syntax:

set <name> interface="connection:<adapter>"

Example:

set NDIS interface="connection:Charon"

port_enable_mac_addr_change

Boolean

If "true" is specified (default value), CHARON-AXP sets the appropriate Ethernet address automatically.

If "false" is specified, set the Ethernet address manually.

Example:

set NDIS port_enable_mac_addr_change=false

port_ignore_on_rx

Numeric

The "port_ignore_on_rx" parameter provides the ability to shutdown the port when a specified number of sequential "on receive" errors is exceeded.

Typically, errors "on receive" indicate serious (unrecoverable) errors.

By default, the value is set to the value of the "port_pending_rx_number" parameter. A value of ‘0’ means infinite.

Example:

set NDIS port_ignore_on_rx=16

port_retry_on_tx

Numeric

The "port_retry_on_tx" parameter controls the number of times a port will attempt to transmit a packet before giving up.

By default, the value is 3.

Increasing this value may introduce problems in carrier loss logic, because not all NIC drivers support a carrier status query.

Typically, you do not need to increase the value.

Example:

set NDIS port_retry_on_tx=8

port_pending_rx_number

Numeric

The "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 NDIS port_pending_rx_number=128

port_pending_rx_number

Numeric

The "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 NDIS port_pending_rx_number=128

suspend_msg_on_mac_change

Boolean

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 NDIS suspend_msg_on_mac_change=false
legacy_modeBoolean

If this parameter is set to "true" CHARON-AXP 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-AXP runs in VMware environment for example.

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

Example:

set NDIS 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-AXP 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;

...