BGP Monitoring Protocol User Guide
==================================
Overview
--------
The OpenDaylight Karaf distribution comes preconfigured with baseline
BMP configuration.
- **32-bmp.xml** (initial configuration for BMP messages handler
service provider and BMP client/server dispatcher settings)
- **42-bmp-example.xml** (sample initial configuration for the BMP
Monitoring Station application)
Configuring BMP
---------------
Server Binding
~~~~~~~~~~~~~~
The default shipped configuration will start a BMP server on
0.0.0.0:12345.You can change this behavior in **42-bmp-example.xml**:
.. code:: xml
prefix:bmp-monitor-impl
example-bmp-monitor
12345
...
- **binding-address** - adress on which BMP will be started and listen;
to change value, uncomment then line first
- **binding-port** - port on which the address will be started and
listen
Multiple instances of the BMP monitoring station (**bmp-monitor-impl**
module) can be created. However, each instance must have a unique pair
of **binding-address** and **binding-port**
Active mode
~~~~~~~~~~~
OpenDaylight’s BMP might be configured to act as an active party of the
connection (ODL BMP < = > Monitored router). To enable this
functionality, configure monitored-router with mandatory parameters:
- address (must be unique for each configured "monitored-router"),
- port,
- active.
See following example from 42-bmp-example.xml:
.. code:: xml
192.0.2.2
1234
true
Configuration through RESTCONF
------------------------------
Server Binding
~~~~~~~~~~~~~~
**URL:**
*`http://:8181/restconf/config/network-topology:network-topology/topology/topology-netconf/node/controller-config/yang-ext:mount/config:modules/config:module/odl-bmp-impl-cfg:bmp-monitor-impl/example-bmp-monitor :8181/restconf/config/network-topology:network-topology/topology/topology-netconf/node/controller-config/yang-ext:mount/config:modules/config:module/odl-bmp-impl-cfg:bmp-monitor-impl/example-bmp-monitor>`__*
**Content-Type:** application/xml
**Method:** PUT
**Body:**
.. code:: xml
example-bmp-monitor
x:bmp-monitor-impl
bmp-dispatcher
global-bmp-dispatcher
x:binding-codec-tree-factory
runtime-mapping-singleton
x:extensions
global-rib-extensions
0.0.0.0
x:dom-async-data-broker
pingpong-broker
12345
- change values for **binding-address** and/or **binding-port**
Active mode
~~~~~~~~~~~
**URL:**
*`http://:8181/restconf/config/network-topology:network-topology/topology/topology-netconf/node/controller-config/yang-ext:mount/config:modules/config:module/odl-bmp-impl-cfg:bmp-monitor-impl/example-bmp-monitor :8181/restconf/config/network-topology:network-topology/topology/topology-netconf/node/controller-config/yang-ext:mount/config:modules/config:module/odl-bmp-impl-cfg:bmp-monitor-impl/example-bmp-monitor>`__*
**Content-Type:** application/xml
**Method:** PUT
**Body:**
.. code:: xml
example-bmp-monitor
x:bmp-monitor-impl
bmp-dispatcher
global-bmp-dispatcher
x:binding-codec-tree-factory
runtime-mapping-singleton
x:extensions
global-rib-extensions
0.0.0.0
x:dom-async-data-broker
pingpong-broker
12345
127.0.0.1
1234
true
- change values for **address** and **port**