A10 Networks Openstack LBaaS v1/v2 Driver

===========================================

A10 Networks LBaaS Driver for Thunder, vThunder and AX Series Appliances

Supported releases:

• OpenStack: Icehouse, Juno, Kilo, Liberty, Mitaka
• LBaaS versions: v1, v2
• ACOS versions: ACOS 2/AxAPI 2.1 (ACOS 2.7.2+), ACOS 4/AxAPI 3.0 (ACOS 4.0.1-GA +)

Working but not available for support:

• OpenStack: git/master

Unsupported, but may work with minor tweaking:

• OpenStack: Havana

A10 github repos

• a10-neutron-lbaas - Main A10 LBaaS driver repo. Middleware sitting between the openstack driver and our API client, mapping openstack constructs to A10's AxAPI.
• acos-client - AxAPI client used by A10's OpenStack driver
• a10-openstack-lbaas - OpenStack LBaaS driver, identical to the files that are currently merged into neutron-lbaas. Pypi package 'a10-openstack-lbaas'.
• a10-openstack-lbaas, havana branch - OpenStack LBaaS driver, for the Havana release. Pypi package 'a10-openstack-lbaas-havana'.
• a10networks-ci/project-config - A10 Networks OpenStack third-party CI setup scripts

Implementation:

Installation steps:

Step 1:

Make sure you have neutron installed, and neutron-lbaas if applicable. This driver will need to be installed on all of your neutron controller nodes (anywhere that neutron-server is running.)

Step 2:

The latest supported version of a10-neutron-lbaas is available via standard pypi repositories and the current development version is available on github.

Installation from pypi

sudo pip install a10-neutron-lbaas

Installation from cloned git repository.

Download the driver from: https://github.com/a10networks/a10-neutron-lbaas

sudo pip install git+https://github.com/a10networks/a10-neutron-lbaas.git

git clone https://github.com/a10networks/a10-neutron-lbaas.git
cd a10-neutron-lbaas
sudo pip install -e .

Configuration

Post-installation configuration requires modification of your neutron.conf or neutron_lbaas.conf (neutron_lbaas.conf is only present in LBaaSv2) typically located in /etc/neutron.

LBaaS v1 configuration

Open /etc/neutron/neutron.conf in your preferred text editor. Under the service_plugins setting, ensure lbaas is listed.

In the list of service_provider settings, add a service provider for A10 Networks: service_provider = LOADBALANCER:A10Networks:neutron_lbaas.services.loadbalancer.drivers.a10networks.driver_v1.ThunderDriver:default

Save and close neutron.conf

LBaaS v2 configuration

Open /etc/neutron/neutron.conf in your preferred text editor. Under the service_plugins setting, ensure lbaasv2 is listed. Save and close neutron.conf.

Open /etc/neutron/neutron_lbaas.conf in your preferred text editor.

In the list of service_provider settings, add a service provider for A10 Networks: service_provider = LOADBALANCERV2:A10Networks:neutron_lbaas.drivers.a10networks.driver_v2.ThunderDriver:default

Device configuration

After installation, you will need to provide configuration for the driver so the driver is aware of the appliances you have configured. The configuration is a python file stored in /etc/a10/config.py. Below is a sample to show options and formatting, though any legal python can be used to calculate values or define classes:

devices = {
    "ax1": {
        "name": "ax1",
        "host": "10.10.100.20",
        "port": 443,
        "username": "admin",
        "password": "a10",
        "autosnat": True,
        "api_version": "3.0",
}

For complete documentation of the a10 config.py file, please refer to the sample config file.

Essential device configuration

host (required)

The ip address or host name of the A10 appliance. For a virtual chassis configuration, this should be the floating host or ip address of the master.

port (default 443)

Port that the AXAPI is exposed on

username and password (required)

Authentication credentials to control the A10 appliance via the AXAPI.

api_version (default "2.1")

Version of the A10 appliance's AXAPI. "2.1" for 2.X series ACOS versions, "3.0" for 4.X versions.

Install database migrations

If 'use_database' is enabled, after installing the package and after any upgrades, run:

a10-manage upgrade

Restart necessary services

Restart neutron after configuration updates (exact command may vary depending on OpenStack packaging.)

service neutron-server restart

Example architectures

You must configure the network elements of the Thunder appliance for OpenStack.

SNAT:

VLAN:

Verifying installation (lbaas v1)

Step 1:

Login to the OpenStack dashboard.

Step 2:

Under the “Network” menu, go to the “Load Balancers” tab and select “Add Pool”:

Once you have added a pool, a success message should appear.

Step 3:

Login to the GUI on your Thunder or AX device, and validate which configuration was applied if the ADPs are set. The ADP name is the first 13 characters of the tenant ID.

Repeat this for all configuration steps, then delete all resources if ADPs are configured. They should be deleted when the tenant has no more resources configured.

A10 Community

Feel free to fork, submit pull requests, or join us on freenode IRC, channel #a10-openstack. Serious support escalations and formal feature requests must still go through standard A10 processes.

Contributing

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request