Cloud Docs Home > F5 OpenStack LBaaSv2 Index

Before You Begin

In order to use F5® LBaaSv2 services, you will need the following:

  • Operational OpenStack cloud (Mitaka release).
  • Licensed, operational BIG-IP® device or device cluster; can be deployed either as an OpenStack instance (BIG-IP VE) or external to the cloud (VE or hardware).

Important

You must have the appropriate license for the BIG-IP features you wish to use.

The use of GRE or VxLAN tunnels requires an active BIG-IP SDN Services License.

Tip

  • You must have both pip and git installed on your Neutron controller in order to use these commands.
  • It may be necessary to use sudo, depending on your environment.

Install the F5 Service Provider Package

Warning

If the F5 service provider package isn’t installed on your Neutron controller, F5 LBaaSv2 will not work.

Download the F5 LBaaSv2 service provider package and add it to the python path for neutron_lbaas.

  1. Download from GitHub.
$ curl -O -L https://github.com/F5Networks/neutron-lbaas/releases/download/v9.1.0/f5.tgz
  1. Install the service provider package on the Neutron controller.

    1. CentOS:
    $ sudo tar xvf f5.tgz -C /usr/lib/python2.7/site-packages/neutron_lbaas/drivers/
    
    1. Ubuntu:
    $ sudo tar xvf f5.tgz –C /usr/lib/python2.7/dist-packages/neutron_lbaas/drivers/
    

Install the F5 Agent

To install the f5-openstack-agent package for v 9.3.1.b1:

$ sudo pip install git+https://github.com/F5Networks/f5-openstack-agent@v9.3.1.b1

Tip

See the F5 Agent documentation for rpm and dpkg installation instructions.

Install the F5 LBaaSv2 Driver

Quick Start

Install the f5-openstack-lbaasv2-driver package for v 9.3.1.b1:

$ sudo pip install git+https://github.com/F5Networks/f5-openstack-lbaasv2-driver@v9.3.1.b1

Tip

You can install packages from HEAD on a specific branches by adding @<branch_name> to the end of the install command instead of the release tag.

Example:

$ sudo pip install git+https://github.com/F5Networks/f5-openstack-lbaasv2-driver@mitaka

Warning

You must install the f5-openstack-agent package, and its dependencies, before installing the f5-openstack-lbaasv2-driver via dpkg or rpm.

Debian Package

The f5-openstack-lbaasv2-driver package can be installed using dpkg.

  1. Download the package:
$ curl –L –O https://github.com/F5Networks/f5-openstack-lbaasv2-driver/releases/download/v9.3.1.b1/python-f5-openstack-lbaasv2-driver_9.3.1.b1-1_1404_all.deb
  1. Install the package on the Neutron controller:
$ sudo dpkg –i python-f5-openstack-lbaasv2-driver_9.3.1.b1-1_1404_all.deb

RPM Package

The f5-openstack-lbaasv2-driver package can be installed using rpm.

  1. Download the package:
$ curl –L –O https://github.com/F5Networks/f5-openstack-lbaasv2-driver/releases/download/v9.3.1.b1/f5-openstack-lbaasv2-driver-9.3.1.b1-1.el7.noarch.rpm
  1. Install the package on the Neutron controller:
$ sudo rpm –ivh f5-openstack-lbaasv2-driver-9.3.1.b1-1.el7.noarch.rpm

Tip

Release tags always use the format “vx.x.x”