User Tools

Site Tools


Sidebar

openbach:exploitation:reference_scenarios:access:opensand_satcom_conf:index

OpenSAND Satcom Conf

Objective

The purpose of this scenario is to push the OpenSAND configuration files from the Controller to the agents. This step is mandatory to run OpenSAND.

Requirements of the scenario

  • 1 OpenBACH project
  • 1 Satellite entity
  • at least 1 Gateway and 1 Satellite Terminal entities
  • the OpenSAND configuration files (infrastructure.xml, topology.xml and profile.xml) for each entity

Information on how to generate adequate files can be found in OpenSAND wiki.

Description of the Scenario

The scenario performs the following actions :

  • Push OpenSAND configuration files from the Controller to the /etc/opensand folder of the corresponding agent
  • Filter the files to send depending on the type of the receiving entity

How to launch

The scenario can be launched with the reference executor executor_opensand_satcom_conf :

python3 executor_opensand_satcom_conf.py --controller <controller_ip> --login <login_openbach> --password <password_openbach> {scenario_parameters} -- <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 parameters description

The scenario accepts different optional parameters in order to push all, some of them or none of the OpenSAND configuration files. Indeed, some of those files could already be present in the entities and the user could wish to not push new ones. The following table describes the purpose and the arguments of each parameter:

Parameter Purpose Arguments
--topology push the common topology.xml file to all entities <topology_filepath>
--satellite push the infrastructure.xml file to the satellite <sat_entity> <infrastructure_filepath>
--satellite-no-conf do not push the infrastructure.xml file to the satellite <sat_entity>
--ground-entity push the infrastructure.xml and profile.xml file to a ground entity (ST or GW) <entity> <infrastructure_filepath> <profile_filepath>
--ground-entity-no-conf push neither the infrastructure.xml nor profile.xml file to a ground entity (ST or GW) <entity>
--ground-entity-no-infra push profile.xml but do not push infrastructure.xml file to a ground entity (ST or GW) <entity> <profile_filepath>
--ground-entity-no-profile push infrastructure.xml but do not push profile.xml file to a ground entity (ST or GW) <entity> <infrastructure_filepath>
The parameters --topology, --satellite and --satellite-no-conf can only be set once. The parameters --ground-entity* can be set multiple times in order to configure multiple GWs and multiple STs.

The following commands are examples for a system with 1 SAT, 1 GW and 2 ST :

Example 1 : Push new configuration files to all the entities

python3 executor_opensand_satcom_conf.py -controller 192.168.1.1 --login openbach --password openbach --topology ~/opensand/topology.xml --satellite mySAT ~/opensand/sat/infrastructure.xml --ground-entity myGW ~/opensand/gw/infrastructure.xml /opensand/gw/profile.xml --ground-entity myST1 ~/opensand/st1/infrastructure.xml ~/opensand/st1/profile.xml --ground-entity myST2 ~/opensand/st2/infrastructure.xml ~/opensand/st2/profile.xml -- my_openbach_project run

Example 2 : Push new configuration files to SAT, GW and ST1 but only profile.xml to ST2

python3 executor_opensand_satcom_conf.py -controller 192.168.1.1 --login openbach --password openbach --topology ~/opensand/topology.xml --satellite mySAT ~/opensand/sat/infrastructure.xml --ground-entity myGW ~/opensand/gw/infrastructure.xml ~/opensand/gw/profile.xml --ground-entity myST1 ~/opensand/st1/infrastructure.xml ~/opensand/st1/profile.xml --ground-entity-no-infra myST2 ~/opensand/st2/profile.xml -- my_openbach_project run

Example 3 : Push new configuration file to SAT, GW and ST1 but none to ST2

python3 executor_opensand_satcom_conf.py -controller 192.168.1.1 --login openbach --password openbach --topology ~/opensand/topology.xml --satellite mySAT ~/opensand/sat/infrastructure.xml --ground-entity myGW ~/opensand/gw/infrastructure.xml ~/opensand/gw/profile.xml --ground-entity myST1 ~/opensand/st1/infrastructure.xml ~/opensand/st1/profile.xml --ground-entity-no-conf myST2 -- my_openbach_project run

Extra information

The code of the scenario is available in opensand_satcom_conf.

openbach/exploitation/reference_scenarios/access/opensand_satcom_conf/index.txt ยท Last modified: 2021/03/17 15:39 by kuhnn