Versions Compared

Old Version 7

changes.mady.by.user Bruno Miretti

Saved on

compared with

New Version 8

changes.mady.by.user Bruno Miretti

Saved on

Key

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

...

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

interface

Parameterinterface
Type

Value

interface

Text String

ValueName of the corresponding instance of the "packet_port" component

station_address

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"

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

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

Example

...

load packet_port/chnetwrk EZA0 interface = "connection:Charon"
set EZA interface = EZA0
set EZA station_address="0C:FE:35:AA:67:3B"

...

load DEQNA/DEQNA <logical name>
load DESQA/DEQNA <logical name>
load DELQA/DEQNA <logical name>
load DEUNA/DEUNA <logical name>
load DELUA/DEULA <logical name>

Example:

load DESQA/DEQNA XQA

DEQNA, DESQA, DELQA, DEUNA and DELUA offer the following configuration parameters that can be specified using the "set" command:

address

address
Parameteraddress
Type

Numeric

Value

Numeric

Specifies the CSR address. The address must be a valid QBUS and UNIBUS address in I/O space. Initial value is 017774440, which is the factory setting for DEQNA, DESQA and DELQA Ethernet controllers.

Use the address parameter if loading several instances of DEQNA, DESQA, DELQA, DEUNA and DELUA Ethernet controllers.

"address" parameter values must be unique for every instance of an DEQNA, DESQA, DELQA, DEUNA and DELUA Ethernet controller.

Example:

load DEQNA/DEQNA XQA address=017774440
load DEQNA/DEQNA XQB address=017764460

interface

Parameterinterface
Type

Text String

ValueName of the corresponding instance of the "packet_port" component

station_address

Text String 
Parameter"station_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 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"

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

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

Example

...

load DESQA/DEQNA QNA interface = QNA0
set QNA station_address="0C:FE:35:AA:67:3B"

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

...

load DEMNA/DEMNA <logical name>

Example:

load DEMNA/DEMNA EXA

DEMNA Ethernet controllers offer the following configuration parameters that can be specified using the "set" command:

...

Parameter

...

Type

...

xmi_node_id

Parameter

xmi_node_id

TypeNumber
Value

Specifies the XMI slot in which the virtual DEMNA controller is placed.

For CHARON-VAX/66X0 a free slot between 10 (A) and 14 (E) must be chosen.

interface

Parameterinterface
Type

Text String

ValueName of the corresponding instance of the "packet_port" component

station_address

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

rx_fifo_size

Parameter

rx_fifo_size

Type

Numeric

Value

The "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.

Example

...

load DEMNA/DEMNA EXA xmi_node_id = 11 interface = EXA0
set EXA station_address = "0C:FE:35:AA:67:3B" 

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

...

load DEBNI/DEMNA <logical name>

Example:

load DEBNI/DEMNA EXA

DEBNI Ethernet controllers offer the following configuration parameters that can be specified using the "set" command:

vax_bi_node_id

Type
Parameter

Value

vax_bi_node_id
Type

Number

ValueSpecifies the VAXBI slot in which the virtual DEBNI controller is placed.

interface

Parameterinterface
Type

Text String

ValueName of the corresponding instance of the "packet_port" component

station_address

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

rx_fifo_size

Parameter

rx_fifo_size

Type

Numeric

Value

The "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.

Example

...

load DEBNI/DEMNA EXA vax_bi_node_id = 11 interface = EXA0
set EXA station_address = "0C:FE:35:AA:67:3B" 

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

...

PMAD-AA TurboChannel Ethernet controllers use the following configuration parameters that can be specified using the "set" command:

interface

Parameter

interface

Type

Value

interface

Text String

ValueName of the corresponding instance of the "packet_port" component

station_address

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

rx_fifo_size

Parameter

rx_fifo_size

TypeNumeric
Value

The "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 debugging purposes.

Example

...

load PMADAA/PMADAA ECA interface = ECA0

set ECA station_address = "0C:FE:35:AA:67:3B"

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

...

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

interface

interface
Parameterinterface
Type

Value

Text string

Value

This parameter identifies an Ethernet adapter of the host system dedicated to CHARON-VAX / CHARON-PDP with a keyword "connection" preceeding it.

Syntax:

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

Example:

set pp_1 interface="connection:Charon"

port_enable_mac_addr_change

Parameterport_enable_mac_addr_change
TypeBoolean
Value

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

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

Example:

set pp_1 port_enable_mac_addr_change=false

port_ignore_on_rx

Parameter

port_ignore_on_rx

TypeNumeric
Value

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 pp_1 port_ignore_on_rx=16

port_retry_on_tx

Parameter

port_retry_on_tx

TypeNumeric
Value

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 pp_1 port_retry_on_tx=8=8

port_pending_rx_number

Parameter

port_pending_rx_number

TypeNumeric
Value

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 pp_1 port_pending_rx_number=128

port_pending_rx_number

Parameter

port_pending_rx_number

Type

Numeric

Value

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 pp_1 port_pending_rx_number=128

suspend_msg_on_mac_change

Parameter

suspend_msg_on_mac_change

TypeBoolean
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

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. 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 / CHARON-PDP use 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;

 

Example

...

load DEQNA/DEQNA XQA

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

set XQA interface=XQA0

...

Back to Table of Contents

...

classpagebreak

...

Ethernet Q-bus Adapter and Cluster configuration rules

...