Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Manual configuration part removed, use ncu instead

Anchor
TOC
TOC
Include Page
KBCOMMON:KB-CSSstyle
KBCOMMON:KB-CSSstyle

...

It is strongly recommended to use only physical network adapters for CHARON-VAX networking to gain maximum performances. In situations where the host has only one network adapter, you can use Linux virtual network Interfaces ("TUN/TAP") and map individual CHARON-VAX instances to their own virtual interfaces.

There are 2 ways to create the Linux virtual network Interfaces ("TUN/TAP"):

...

This can be done using the ncu utility.

(question) It is also possible to perform the operations manually. Refer to your Operating System Network Administration guide for details.

Note

On Red Hat Enterprise Linux 6 & 7 and CentOS 7, the following packages are needed:

  • bridge-utils - optional
  • tunctl - optional, need only if command 'ip tuntap' not worked
  • ethtool - mandatory
  • vconfig - optional, if VLAN is needed

Using "ncu" utility to establish CHARON virtual network

Login a root and start the "ncu" utility utiltiy:

ncu

CHARON Network Configuration Utility, STROMASYS (c) 2016 Version 1.6 

Interfaces Dedicated to State
---------- ------------ -----
eth0 host connected to host
eth1 host disconnected from host
lo host unmanaged from host
=================================================================
bridge name bridge id STP enabled interfaces
========================== VLAN =================================
=================================================================
select action:
1 - Dedicate to CHARON
2 - Release to host
3 - Create Bridge with TAPs
4 - Remove Bridge
5 - Add VLAN
6 - Remove VLAN
7 - Print status
8 - Exit

:> 3

...

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

...

classpagebreak

Manual configuration of CHARON virtual network

Host preparation

...

Configure the physical network interface to run in promiscuous mode using the following command. This interface will be dedicated to the whole network bridge (created later).

...

# ifconfig eth<N> 0.0.0.0 promisc up

...

In case the firewall is enabled on the host system, the following command should be executed to allow the bridge to forward IP packets:

Red Hat Enterprise Linux 6.x:

...

# /sbin/iptables -I FORWARD -m physdev --physdev-is-bridged -j ACCEPT

This command can also be performed from the bridge configuration script. It has to be executed each time the iptables service is (re)started.

It is also possible to make this setting system-wide. Either:

...

Issue the given command from the firewall control panel.

Add the following line to the end of the "/etc/sysconfig/iptables" file:

...

-I FORWARD -m physdev --physdev-is-bridged -j ACCEPT

Red Hat Enterprise Linux 8.x, 7.x and CentOS 8.x, 7.x (the '>' sign below is the continuation line character):

...

# 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 -m physdev --physdev-is-bridged \

> -j ACCEPT

# firewall-cmd --reload

...

Virtual interface creation

The creation of the desired number of virtual network interfaces (TAPs) can be performed in the following way:

...

# tunctl [-t tap<N>]

where “tap<N>” is a name of an instance of the virtual network interface, i.e. “tap0”, “tap1” etc.

Once each virtual network interface instance is created it must be set to promiscuous mode:

...

# /sbin/ifconfig tap<N> promisc up

...

classpagebreak

Bridge creation

To interconnect the physical and virtual network interfaces created in the previous step, the network bridge must be introduced in the following way:

...

# /usr/sbin/brctl addbr br0

where “br0” stands for a name of the created bridge.

Now it is possible to add the network interfaces to the created bridge:

...

# /usr/sbin/brctl addif br0 eth<N>
# /usr/sbin/brctl addif br0 tap0

# /usr/sbin/brctl addif br0 tap<N>

Example:

...

# /usr/sbin/brctl addif br0 eth1

# /usr/sbin/brctl addif br0 tap0

The proposed configuration assumes one and only one network bridge so loops are not possible. It is required to turn off the spanning tree protocol with the following command:

...

# /usr/sbin/brctl stp br0 off

...

Starting bridge

To start the created bridge “br0”, use the following command:

...


Usage of the virtual interface in CHARON-VAX configuration

Once the “tap<N>” interfaces have been created, the load command maps those interfaces to CHARON-VAX:

...
load tap_port/chnetwrk XQA0 interface="tap<N>"

... 

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