blob: 7ee9017b3cda9e8132198d623324823fdbeb6a4c [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
19If 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
25Or you can manually configure ONOS as explained below.
26
27Using the BBSim Sadis server in ONOS
28------------------------------------
29
30BBSim provides a simple server for testing with the ONOS Sadis app. The server
31listens on port 50074 by default and provides the endpoints
32``subscribers/<id>`` and ``bandwidthprofiles/<id>``.
33
34To configure ONOS to use the BBSim ``Sadis`` server endpoints, the Sadis app
35must use be configured as follows (see ``examples/sadis-in-bbsim.json``):
36
37.. literalinclude:: ../../examples/sadis-in-bbsim.json
38
39This base configuration may also be obtained directly from the BBSim Sadis
40server:
41
42.. code:: bash
43
44 curl http://<BBSIM_IP>:50074/v2/cfg -o examples/sadis.json
45
46It 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
56You 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
Matteo Scandolo0e9fabf2020-09-30 17:19:27 -070062In ONOS subscriber information can be queried using ``sadis <uni-id>``.