General Information

This section provides information on basic aspects of configuring an Ethernet interface for the emulator. For details on the configuration parameters used and for additional parameters, please refer to the Configuration File Reference.

The emulated Ethernet interfaces of Charon-PAR can be linked either to a

physical host interface, or
to a TAP interface on the host.

Notes for TAP interfaces:

A TAP interface can either be created by the user or will be created automatically by the emulator if it does not already exist.
For automatically created TAP interfaces, the user can specify a name or let the emulator select a name.
A automatically created TAP interface is not automatically added to a bridge, this must be configured via the initialize_command.
An automatically created TAP interface is deleted automatically upon emulator stop.

By default, emulated models have one Ethernet device. Depending on the model, more Ethernet devices can be added.

The emulated network devices

DE 500 PCI based cards (for 64-bit systems), and
LASI-82596 cards (for the 32-bit system)

do not support Jumbo frames. For physical interfaces, this feature must be disabled in the emulator configuration (together with any other offloading parameters) using the initialize_command parameter.

Basic Configuration Components

Ethernet Interface Names

Names on 64-bit systems:

The name of the Ethernet interface in the emulator configuration file has the format EWXN with the following definitions:

X - an uppercase letter starting with A for the first interface and then continues with B, C, etc. for additional interfaces. The possible number of network cards depends on the features of the original physical system. The absolute maximum number is 16.
N - the device number of the card starting with 0 for each value of x.

Names on 32-bit systems:

The currently supported 32-bit system supports only one Ethernet card named system.lan0.card.

Minimal Configuration Parameters

The configuration of each network interface must at least have two basic components as shown below:

64-bit system (example shows the first Ethernet card EWA0):

Interface definition (EWA0.iface)
Interface initialization command: (EWA0.initialize_command)

32-bit system:

Interface definition (system.lan0.card.iface)
Interface initialization command: (system.lan0.card.initialize_command)

The default configuration assumes that a physical network interface will be used.

Please refer to the Configuration File Reference and the configuration template of your model for more information.

Basic Configuration Example

Example of a basic network card configuration using a physical interface on a 64-bit emulated system:

EWA0.iface="enp0s20f0u3u4"
EWA0.initialize_command="ethtool -K $IFACE rx off ; ethtool -K $IFACE tx off ; ethtool -K $IFACE sg off ; ethtool -K $IFACE gso off ; ethtool -K $IFACE gro off ; ethtool -K $IFACE txvlan off ; ethtool -K $IFACE rxvlan off"

The variable IFACE is set automatically by the emulator upon start. The initialize_command parameter is used to turn off all relevant offloading parameters on the interface used by the emulator.

Adding Additional Emulated Network Cards

Please note: if / how many additional Ethernet controllers can be loaded depends on the emulated model.

This section will show an example. Please refer to the section I/O Slot Configuration in the Configuration File Reference chapter and the Emulated Model Hardware Configuration Details chapter for details.

To add an additional Ethernet controller to your emulator configuration, you must perform the following steps:

Identify a free PCI slot (model configuration template or Emulated Model Hardware Configuration Details).
Add a load command to the configuration to load an Ethernet module into the identified emulator slot (see the Configuration File Reference chapter for details).
Add the network card configuration to your configuration file.
Start the emulator and configure the interface in the guest system.

Step 1: identify a free PCI slot for your emulated model. The available slots depend on your model and the existing configuration.

Example: model "rp7400-1-650" has a PCI I/O expansion slot 4 (device path 0/8/0)

Step 2: Add the load command for the Ethernet module to the configuration file.

Sample configuration command for slot 4: load ETH tulip PCI 4

Step 3: Add the network card configuration to your configuration file selecting the correct host interface name (example: eth2). Note that the name of the second emulated interface is EWB0.

Example (important: the initialization command must be in one continuous line):

EWB0.iface="eth2" EWB0.initialize_command="ethtool -K $IFACE rx off; ethtool -K $IFACE tx off; ethtool -K $IFACE sg off; ethtool -K $IFACE gso off; ethtool -K $IFACE gro off; ethtool -K $IFACE txvlan off; ethtool -K $IFACE rxvlan off"

Step 4: Start the emulator, boot the guest system and configure the second interface.

On PA3, use the ISL > ODE > RUN MAPPER2 command (access from console via: Interaction with IPL) to verify the existence of the new interface and the correct device path.
The above command also works on PA9, but on HP-UX you can also use the lanscan command to verify the existence of the new interface (on HP-UX it is normally lan1).
Configure the interface.
- The easiest way on HP-UX is to use SAM > Network and Communication > Network Interface Cards (Actions > Configure).
- On MPE/iX, the interface must be added via NMMGR (for interactive use, xhpterm can be used to access this tool), and the interface must be started using the NETCONTROL command. Please refer to the documentation of your operating system for further information.

The following image shows a sample of a HP-UX system with two Ethernet interfaces:

The following shows a sample of the second Ethernet interface being configured on device path 0/8/0/0:

On an MPE/iX system, the device path is needed to configure the new network link.

The following shows a sample of two active Ethernet interfaces on MPE/iX:

Supplemental Information: Virtual Bridge and TAP Interfaces

The following sections describe the basic steps for the configuration of virtual bridges and TAP interfaces.

Please note:

The examples describe a virtual bridge that connects host and guest system to the local LAN via a physical NIC.
The described virtual bridge configuration is mostly suited for on-premises installations where the host system runs on a physical system.
For VMware (or similar environments) it is recommended to add additional vNICs for the guest as needed - instead of using a bridge configuration on the host.
In most cloud environments, a virtual bridge cannot directly link bridge traffic to the LAN via a host NIC. There are usually restrictions about MAC addresses allowed on the NICs of a cloud instance. Also promiscuous mode is usually not possible. Hence, in such environments, traffic between a virtual bridge and the rest of the network must usually be NAT'ed or routed. The virtual bridge is then internal to the Linux host and not connected directly to the LAN.

Basic Bridge Configuration Using ip Commands

The following table shows a simple example of how to create a virtual bridge on Linux and how to add TAP interfaces to it using ip commands:

Step	Command
Gather information about the existing network configuration.	List all existing interfaces, their status and their MAC addresses: `# ip link show` List all configured IP addresses and netmasks: `# ip addr show` List the routing table entries: `# ip route show`
Create a TAP interface (not needed if emulator automatic creation is used).	`# ip tuntap add dev my_tap0 mod tap`
Activate TAP interface (can also be done via the initialize command in emulator configuration).	`# ip link set my_tap0 up`
Create a new bridge - if needed.	`# ip link add name my_bridge type bridge`
Activate the bridge - if needed	`# ip link set my_bridge up`
If needed, add a physical interface to the bridge. This interface will connect the bridge to the physical LAN.	`# ip link set <physical-int> master my_bridge`
Remove any configured IP address from the physical interface.	`# ip addr delete <ip-address>/<netmask> dev <physical-int>`
Add the IP address previously configured on the physical interface (or another IP address to be used by the host system) to the bridge interface.	`# ip addr add <ip-address>/<netmask> dev my_bridge`
Add any routes (including the default gateway) to be routed across the bridge interface - if needed.	`# ip route add <network>/<netmask> via <gwy-IP> dev my_bridge` `# ip route add default via <gwy-IP> dev my_bridge`
Add the TAP interface to the bridge (can also be done via the initialize command in the emulator configuration).	`# ip link set my_tap0 master my_bridge`

Please note: The commands above are not persistent. They would need to be scripted and added to the host system startup as required.

To delete TAP and bridge interfaces, you can use the command ip link delete <interface-name>.

Basic Bridge Configuration Using nmcli

The following table shows a simple example of how to create a virtual bridge on Linux and how to add TAP interfaces to it using nmcli commands (NetworkManager command-line interface):

Step	Description
Gather information about the existing network configuration.	List all existing interfaces, their status and their MAC addresses: `# ip link show` List all configured IP addresses and netmasks: `# ip addr show` List the routing table entries: `# ip route show`
If needed, create a new connection for the physical interface to be used with the bridge.	`# nmcli conn add type ethernet autoconnect yes \ con-name <physical-int-name> \ifname <pysical-int-name> ip4 0.0.0.0`
If needed, create a bridge and set a static IP address for it.	`# nmcli con add type bridge autoconnect yes \ con-name``mybr0` `ifname` `mybr0` \ ipv4.method manual ip4 <ipaddr/mask> `stp off`
If needed, activate bridge.	`# nmcli con up bridge-mybr0`
If needed, add physical interface to bridge.	`# nmcli conn modify <physical-int-conn> master mybr0 \ slave-type bridge`
Activate changes to interface.	`# nmcli conn up <physical-int-conn>`

After the bridge has been created, you can use the initialize command in the emulator configuration to add the required TAP interfaces for the emulator to the bridge.

Please note: By default, nmcli commands are persistent (connection information is stored in /etc/sysconfig/network-scripts/).

Basic Emulator Configuration Using a TAP Interface

The following example shows how to use a TAP interface in the emulator configuration, where the interface is automatically created and removed by the emulator. The initialization command adds the interface to an existing bridge named my_bridge:

EWA0.mapping_mode="TAP"
EWA0.initialize_command="ip link set ${IFACE} master my_bridge"

Please refer to the Configuration File Reference and the configuration template of your model for more information.

Linux Firewalls and Virtual Bridges

If firewall rules are to be used for bridged traffic, the kernel can be instructed to apply iptables (also arptables and ip6tables) rules to bridged traffic. In older versions, this option was included in the bridge functionality itself. Starting with kernel 3.18, the filtering functionality in the form of the br_netfilter module was moved into a separate module that can be loaded by the user if required. If the module is not loaded, no firewall rules are applied to bridge traffic and no further actions are required to pass the bridged traffic through the Linux host system.

To check, if the module is loaded use the command

# lsmod | grep netfilter

To use the firewall for bridged traffic on newer Linux kernels, the module must be loaded using the command

# modprobe br_netfilter

or by defining an iptables rule that uses the physdev module.

If the module has been loaded, the following system configuration parameters are available:

net.bridge.bridge-nf-call-iptables
bridge-nf-call-arptables
bridge-nf-call-ip6tables

They are set to 1 by default (equivalent to echo 1 > /proc/sys/net/bridge/bridge-nf-call-iptables). This value enables iptables rules for bridged traffic (and by default blocks bridged traffic).

Setting the parameters to 0 will disable the firewall for bridged traffic. They can be set permanently via /etc/sysctl.conf.

To allow bridged traffic through the enabled firewall, use commands like the following:

# firewall-cmd --permanent --direct --add-rule ipv4 filter INPUT 1 \

-m physdev --physdev-is-bridged -j ACCEPT

# firewall-cmd --permanent --direct --add-rule ipv6 filter INPUT 1 \