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

A10 Networks, Openstack Neutron LBaaS Driver for Juno

This package enables LBaaS v1/v2 support for A10 appliances.

A10 github repos:

• a10-openstack-lbaas - OpenStack LBaaS driver, identical to the files that are currently merged into Juno. Also supports Icehouse. Pypi package 'a10-openstack-lbaas'.
• a10-openstack-lbaas, havana branch - OpenStack LBaaS driver, for the Havana release. Pypi package 'a10-openstack-lbaas-havana'.
• a10-neutron-lbaas - 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.
• neutron-thirdparty-ci - Scripts used by our Jenkins/Zuul/Devstack-Gate setup, used to test every openstack code review submission against A10 appliances and our drivers.

Installation of A10's LBaaS implementation for Neutron is simple. Install, configure, and restart affected services. The latest release version of a10-neutron-lbaas is available via standard pypi repositories and the current development version is available here.

sudo pip install a10-neutron-lbaas

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

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.

Open /etc/neutron/neutron.conf in your preferred text editor. Under the service_plugins setting, ensure neutron.services.loadbalancer.plugin.LoadBalancerPlugin is listed.

In the list of service_provider settings, ensure there is only a single entry for LOADBALANCER (you can comment out existing entries) enabled: service_provider = LOADBALANCER:A10Networks:neutron_lbaas.services.loadbalancer.drivers.a10networks.driver_v1.ThunderDriver:default

Save and close neutron.conf

Open /etc/neutron/neutron.conf in your preferred text editor. Under the service_plugins setting, ensure neutron_lbaas.services.loadbalancer.plugin.LoadBalancerPluginv2 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, ensure there is only a single entry for LOADBALANCERV2 (you can comment out existing entries) enabled: service_provider = LOADBALANCERV2:A10Networks:neutron_lbaas.drivers.a10networks.driver_v2.ThunderDriver:default

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 standard JSON structure stored in /etc/a10/config.py. Below is a sample to show options and formatting:

devices = {
    "ax1": {
        "name": "ax1",
        "host": "10.10.100.20",
        "port": 443,
        "username": "admin",
        "password": "a10",
        "status": True,
        "default_virtual_server_vrid": 1,
        "autosnat": False,
        "api_version": "3.0",
        "v_method": "ADP",
        "max_instance": 5000,
        "use_float": False,
        "method": "hash",
        "max_partitions": 10,
        "per_partition_lif_max": 10,
        "peer_mgmt_ip": "",
        "peer_mgmt_port": "",
        "vlan": 0,
        "gateway_mode": 1,
    },
    "ax4": {
        "host": "10.10.100.23",
        "username": "admin",
        "password": "a10",
    },
}

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 that the AXAPI is exposed on

Authentication credentials to control the A10 appliance via the AXAPI.

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

Set to True to use the automatic source NAT pool. Corresponds to configuring virtual-server ports with source-nat auto. This functionality is only supported on devices with ACOS version 2.7.2 P3 or newer.

Virtual router number for new virtual servers. Setting it to a number X corresponds to configuring vitual-servers with vrid X.

Restart the q-svc and q-lbaas2 services after configuration updates.