User Tools

Site Tools


Sidebar

openbach:exploitation:reference_scenarios:access:opensand_net_conf:index

OpenSAND Net Conf

Objective

The purpose of this scenario is to create and set the necessary bridges and TAP interfaces inside the ground entities. This way, the user gets a fully proper network configuration to be able to run OpenSAND tests.

Requirements of the scenario

  • 1 OpenBACH project
  • 1 Satellite (SAT) entity
  • at least 1 Gateway (GW) and 1 Satellite Terminal (ST) entities
  • the jobs ip_route, ip_tuntap, ip_address, sysctl and ip_link installed on all the entities
  • a proper network configuration between the GW(s), SAT and ST(s) to send traffic through them

How to launch

The scenario can be launched with the reference executor executor_opensand_net_conf. The following command is an example for a system with 1 SAT, 1 GW and 1 ST :

python3 executor_opensand_net_conf.py --controller <controller_ip> --login <login_openbach> --password <password_openbach> --entity <gw_args> --entity <st_args> -- <openbach_project_name> run

OpenBACH arguments description

  • controller_ip : IP address of the OpenBACH Controller machine
  • login_openbach : user login of the OpenBACH platform
  • password_openbach : user password of the OpenBACH platform
  • openbach_project_name : name of the OpenBACH project where the scenario will be launched

Scenario arguments description

  • gw_args : <gw_openbach_entity> <bridge_address> <tap_iface_name> <bridge_name> <tap_mac>
  • st_args : <st_openbach_entity> <bridge_address> <tap_iface_name> <bridge_name> <tap_mac>
    • <bridge_address> must include the mask address
    • <bridge_address> can be replaced by <bridge_interface>

The argument --entity is indistinctly used for GW and ST entities and can be set multiple times in order to run multiple GWs and multiple STs.

Example

The following command will create the red elements (bridge and tap interface) of the network architecture shown in the figure :

python3 executor_opensand_net_conf.py --controller 192.168.1.1 --login openbach --password openbach --entity myGW "10.0.0.254/24" tap br "00:6f:70:73:00:FF" --entity myST1 "10.0.0.1/24" tap br "00:6f:70:73:00:01" --entity myST2 "10.0.0.2/24" tap br "00:6f:70:73:00:02" -- my_openbach_project run

The following command will clear the red elements (bridge and tap interface) of the network architecture shown in the figure above.

python3 executor_opensand_net_conf.py --controller 192.168.1.1 --login openbach --password openbach --clear --entity myGW "10.0.0.254/24" tap br "00:6f:70:73:00:FF" --entity myST1 "10.0.0.1/24" tap br "00:6f:70:73:00:01" --entity myST2 "10.0.0.2/24" tap br "00:6f:70:73:00:02" -- my_openbach_project run

Extra information

The code of the scenario is available in opensand_net_conf. It uses the following helpers to simplify the code structure of the code:

openbach/exploitation/reference_scenarios/access/opensand_net_conf/index.txt ยท Last modified: 2021/03/18 08:56 by kuhnn