| Anchor | ||||
|---|---|---|---|---|
|
...
CHARON-AXP maps the virtual adapter to a dedicated Ethernet adapter in the Windows Linux host system.
All the emulated controllers are loaded and configured in the same way.
The Ethernet adapter in the Windows Linux host system must support dynamic changes of its MAC address (i.e. no reboot of the host system is required to change the MAC address), which is the case with nearly all modern Ethernet adapters.
...
Load network adapter (if required)
Use the "load" command as shown below.
Example:For DEC21040 adapters For Intel i8255x adapters load DE500BA/dec21x4x NICload DE602/i8255x NIC
By default each loaded virtual network adapter uses first available PCI slot. If instead some particular slot is neded, refer to this section for details of specific placement of PCI peripherals on CHARON-AXP PCI bus.Load "packet_port" or "tap_port"
Load "packet_port" or "tap_port" to connect network adapter to the host hardware network card (or to a virtual network interface).
Example:load packet_port/chnetwrk NDIS interface = "connection:Charoneth1"Connect the loaded "packet_port" ("tap_port") to the loaded virtual network adapter
Connect the network adapter to the "packet_port" ("tap_port") by setting the interface name.
Example:set NIC interface = NDIS
...
Parameter | Type | Value | |||||||||||||
interface | Text String | Name of the corresponding instance of the "packet_port" or "tap_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:
or
Example:
| |||||||||||||
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_mode | Text String | Defines the link speed and the duplex settings of the virtual network adapter (except for DE602/DE602AA - see below). The values are:
Example:
|
...
|
...
The EIx0_MODE variable name is case insensitive, while its values are case sensitive! This is feature of OpenVMS EIDRIVER.
The values are:
| Parameter | Description |
|---|---|
| "Auto" | Auto-negotiate (default) |
| "Twisted" | 10Mbps half duplex |
| "Full" | 10Mbps full duplex |
| "Fast" | 100Mbps half duplex |
| "FastFD" | 100Mbps full duplex |
...
The CHARON-specific "packet_port" interface establishes a connection between an Ethernet adapter in the Windows Linux host system and a network adapter in the virtual HP Alpha system.
...
load packet_port/chnetwrk NDISpp1 |
"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-AXP. The leading keyword "connection:" is mandatory. Syntax:
Example:
| |||
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:
| |||
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:
| |||
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:
| |||
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:
| |||
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:
| |||
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:
| |||
| legacy_mode | Boolean | 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:
|
...
|
| Info |
|---|
CHARON-AXP supports VLAN adapters. If for some reasons you are going to use them, proceed with their installation and configuration according to the network adapter's vendor's User's Guide and then use the resulting VLAN interface the same way as the regular network interface. |
...