Important

End of Software Development for F5 OpenStack LBaaS version 1

F5 announces the End of Software Development (EoSD) for the F5 OpenStack LBaaS version 1 integration, effective October 1, 2016. This announcement is in compliance with the OpenStack community deprecation of the OpenStack Neutron LBaaS version 1 plugin. Customers are encouraged to move to OpenStack LBaaS version 2.

F5 will continue to repair defects and perform maintenance on the F5 OpenStack LBaaS version 1 integration until the Openstack Ocata release in April 2017.

For additional information, please refer to the F5 OpenStack Releases and Support Matrix.

F5® OpenStack LBaaSv1 Plugin

Build Status

Introduction

This site hosts the documentation for the F5® OpenStack OpenStack Neutron LBaaSv1 plugin and agent, used to deploy F5® BIG-IP® services in OpenStack. You can access the source code and download release packages at F5Networks/f5-openstack-lbaasv1.

Releases and Versions

The F5® OpenStack LBaaSv1 v 8.0.2 plugin supports the OpenStack Liberty releases. See F5® OpenStack Releases and Support Matrix for information about the LBaaSv1 plugin, BIG-IP®, and OpenStack release compatibility.

Quick Start

Downloads

You can download a release package directly from GitHub using curl or wget. Then, un-tar the package into the location of your choice.

Tip

Replace “<version_number>” with the version appropriate for your environment.

Example:

# curl -L -O https://github.com/F5Networks/f5-openstack-lbaasv1/releases/download/<version_number>/f5-lbaasv1_<version_number>.tgz
# tar -xf f5-lbaasv1_<version_number>.tgz

Installation

Debian/Ubuntu

  1. Install the F5 BIG-IP common libraries.

    $ dpkg -i build/deb_dist/f5-bigip-common_8.0.2-final_all.deb
    
  2. Install the plugin driver.

    $ dpkg -i build/deb_dist/f5-lbaas-driver_8.0.2-final_all.deb
    
  3. Install the plugin agent.

    $ dpkg -i build/deb_dist/f5-bigip-lbaas-agent_8.0.2-final_all.deb
    

RedHat/CentOS

  1. Install the F5 BIG-IP common libraries.

    $ rpm -i build/el7/f5-bigip-common_8.0.2-final.noarch.el7.rpm
    
  2. Install the plugin driver.

    $ rpm -i build/el7/f5-lbaas-driver-8.0.2-final.noarch.el7.rpm
    
  3. Install the agent.

    $ rpm -i build/el7/f5-bigip-lbaas-agent-8.0.2-final.noarch.el7.rpm
    

Upgrading

If you are upgrading from an earlier version, F5 recommends that you uninstall the current version before installing the new version.

Note

Perform the following steps on every server running the F5® agent.

  1. Make a copy of the F5 agent configuration file. An existing configuration file in /etc/neutron will be overwritten during installation.

    $ cp /etc/neutron/f5-oslbaasv1-agent.ini ~/
    
  2. Stop and remove the old version of the libraries, plugin driver and agent.

    Debian/Ubuntu

    $ sudo service f5-oslbaasv1-agent stop
    $ dpkg -r f5-bigip-common f5-lbaas-driver f5-bigip-lbaas-agent
    

    Red Hat/CentOS

    $ sudo service f5-oslbaasv1-agent stop
    $ yum remove f5-bigip-common.noarch f5-oslbaasv1-agent.noarch f5-oslbaasv1-driver.noarch
    
  3. Follow the installation instructions in the previous section.

  4. Restore the F5 agent configuration file.

    Compare the backup file with the new one created during installation to make sure only the necessary settings for your deployment are modified. Then, copy your configuration file back into /etc/neutron/.

    $ cp ~/f5-oslbaasv1-agent.ini /etc/neutron/f5-oslbaasv1-agent.ini
    

Support

See Support.

License

Apache V2.0

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. ou may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Contributor License Agreement

Individuals or business entities who contribute to this project must have completed and submitted the F5 Contributor License Agreement to Openstack_CLA@f5.com prior to their code submission being included in this project.