Install and Configuration¶
The details related to how a package should be installed may depend on your environment.
If possible, you should rely on packages provided by your Linux and/or Openstack distribution.
If you use
pip, follow these steps to install networking-bgpvpn:
identify the version of the networking-bgpvpn package that matches your Openstack version:
Liberty: most recent of 3.0.x
Mitaka: most recent of 4.0.x
Newton: most recent of 5.0.x
Ocata: most recent of 6.0.x
Pike: most recent of 7.0.x
indicate pip to (a) install precisely this version and (b) take into account Openstack upper constraints on package versions for dependencies (example for ocata):
$ pip install -c https://releases.openstack.org/constraints/upper/ocata
The service plugin is enabled in Neutron, by
bgpvpn to the list
of enabled service plugins in
neutron.conf (typically in
but the location used may depend on your setup or packaging). For instance:
service_plugins = router,bgpvpn
The BGPVPN driver to use is then specified in the
file (located by default under
/etc/neutron/, but in any case in one of the
directories specified with
--config-dir at neutron startup, which may
/etc/neutron in your setup):
[service_providers] service_provider = BGPVPN:BaGPipe:networking_bgpvpn.neutron.services.service_drivers.bagpipe.bagpipe_v2.BaGPipeBGPVPNDriver:default #service_provider= BGPVPN:Dummy:networking_bgpvpn.neutron.services.service_drivers.driver_api.BGPVPNDriver:default
A given driver may require additional packages to work; the driver section provides detailed installation information for each specific driver.
API Policy for the BGPVPN service plugin can be controlled via the standard policy framework.
When pip is used to install the package, a default policy file is installed at
The DB tables for networking-bgpvpn are created and upgraded with:
neutron-db-manage --config-file /etc/neutron/neutron.conf --subproject networking-bgpvpn upgrade
You can easily test the bgpvpn service plugin with devstack, by adding the following line to your local.conf:
enable_plugin networking-bgpvpn https://git.openstack.org/openstack/networking-bgpvpn.git
Or the following if you want a specific branch or version (example for Mitaka):
enable_plugin networking-bgpvpn https://git.openstack.org/openstack/networking-bgpvpn.git stable/mitaka
By default, the service driver will use a dummy driver, that only responds to API calls, and stores data in the database. If you want to test a fully functional driver with devstack, you can configure the bagpipe driver with its devstack plugin (see OVS/linuxbridge driver (bagpipe)).
Detailed information on how to use other drivers is provided in the documentation for each of these drivers.