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