| Matteo Scandolo | f380a97 | 2020-09-11 12:09:40 -0700 | [diff] [blame] | 1 | SADIS Configuration |
| 2 | =================== |
| 3 | |
| 4 | BBSim generates a ``sadis`` configuration starting from the :ref:`Service <ConfiguringServices>` |
| 5 | configuration file. |
| 6 | |
| 7 | For example if you consider this Service configuration: |
| 8 | |
| 9 | .. literalinclude:: ../../configs/att-services.yaml |
| 10 | |
| 11 | The corresponding ``sadis`` configuration that you'll need to use in ONOS is: |
| 12 | |
| 13 | .. literalinclude:: ../../examples/sadis-att.json |
| 14 | |
| 15 | As you can imagine this file will get pretty big pretty quickly as soon as you scale |
| 16 | the number of ONUs and/or Services in your setup. For that reason (and to avoid mistakes) |
| 17 | we strongly suggest to configure ONOS to fetch informations from BBSim. |
| 18 | |
| 19 | If you are using ``kind-voltha`` to deploy your setup, you can easily achieve that by: |
| 20 | |
| 21 | .. code:: bash |
| 22 | |
| 23 | CONFIG_SADIS=external voltha up |
| 24 | |
| 25 | Or you can manually configure ONOS as explained below. |
| 26 | |
| 27 | Using the BBSim Sadis server in ONOS |
| 28 | ------------------------------------ |
| 29 | |
| 30 | BBSim provides a simple server for testing with the ONOS Sadis app. The server |
| 31 | listens on port 50074 by default and provides the endpoints |
| 32 | ``subscribers/<id>`` and ``bandwidthprofiles/<id>``. |
| 33 | |
| 34 | To configure ONOS to use the BBSim ``Sadis`` server endpoints, the Sadis app |
| 35 | must use be configured as follows (see ``examples/sadis-in-bbsim.json``): |
| 36 | |
| 37 | .. literalinclude:: ../../examples/sadis-in-bbsim.json |
| 38 | |
| 39 | This base configuration may also be obtained directly from the BBSim Sadis |
| 40 | server: |
| 41 | |
| 42 | .. code:: bash |
| 43 | |
| 44 | curl http://<BBSIM_IP>:50074/v2/cfg -o examples/sadis.json |
| 45 | |
| 46 | It can then be pushed to the Sadis app using the following command: |
| 47 | |
| 48 | .. code:: bash |
| 49 | |
| 50 | curl -sSL --user karaf:karaf \ |
| 51 | -X POST \ |
| 52 | -H Content-Type:application/json \ |
| 53 | http://localhost:8181/onos/v1/network/configuration/apps/org.opencord.sadis \ |
| 54 | --data @examples/sadis-in-bbsim.json |
| 55 | |
| 56 | You can verify the current Sadis configuration: |
| 57 | |
| 58 | .. code:: bash |
| 59 | |
| 60 | curl --user karaf:karaf http://localhost:8181/onos/v1/network/configuration/apps/org.opencord.sadis |
| 61 | |
| 62 | In ONOS subscriber information can be queried using ``sadis <uni-id>``. |