User Tools

Site Tools



OpenSAND Run


OpenSAND emulates the main features of a SATCOM system, and has been inspired from the DVB-S2/RCS2 standards. OpenSAND is released under free licenses GPL and LGPL. Thales Alenia Space and the CNES as co-founders of OpenSAND Community and major contributors, are the first Members of OpenSAND Steering Committee, in charge of all technical and administrative decisions concerning OpenSAND. Viveris Technologies is the current operational maintainer of OpenSAND.

Set and run an OpenSAND test can be time-consuming and repetitive. The approach of setting and running OpenSAND through OpenBACH scenarios makes the task easier and more pragmatical.


The purpose of this scenario is to run the OpenSAND test on the satellite, gateways and satellite terminals, with the job opensand.

  • This scenario requires a proper network and satcom configuration. You can get that by running OpenSAND Net Conf and OpenSAND Satcom Conf previously.
  • If you prefer an “all-in-one” scenario which performs all those operations together, we recommend to use the scenario Example OpenSAND.

Requirements of the scenario

  • an OpenBACH project
  • 1 Satellite entity
  • at least 1 Gateway and 1 Satellite Terminal entities
  • the opensand jobs installed on all the entities
  • a proper network and OpenSAND configuration (use of opensand_net_conf and opensand_satcom_conf)
  • the OpenSAND configuration files (infrastructure.xml, topology.xml and profile.xml)

How to launch

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

python3 --controller <controller_ip> --login <login_openbach> --password <password_openbach> --duration <duration> --sat <sat_args> --ground <gw_args> --ground <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

  • duration : duration of the opensand run test (optional, do not set for endless emulation)
  • sat_args : <openbach_entity> <infrastructure_filepath> <topology_filepath>
    • ex : --sat mysat “~/opensand_conf/sat/infrastructure.xml” “~/opensand_conf/sat/topology.xml”
  • gw_args & st_args : <openbach_entity> <infrastructure_filepath> <topology_filepath> <profile_filepath>
    • ex : --ground mygw “~/opensand_conf/gw/infrastructure.xml” “~/opensand_conf/gw/topology.xml” “~/opensand_conf/gw/profile.xml”
    • ex : --ground myst “~/opensand_conf/st/infrastructure.xml” “~/opensand_conf/st/topology.xml” “~/opensand_conf/st/profile.xml”

The argument --sat must be set only once. The argument --ground is indistinctly used for GW and ST entities and can be set multiple times in order to run multiple GWs and multiple STs.

Extra information

The code of the scenario is available in opensand_run. It uses the helper opensand to simplify the structure of the code.

openbach/exploitation/reference_scenarios/access/opensand_run/index.txt · Last modified: 2021/05/28 15:40 by dfernandes