diff options
| author | CoprDistGit <infra@openeuler.org> | 2023-05-05 14:29:08 +0000 |
|---|---|---|
| committer | CoprDistGit <infra@openeuler.org> | 2023-05-05 14:29:08 +0000 |
| commit | 68c7ae0076dc7f2cc5014d9cdc53a3e0397ae2a0 (patch) | |
| tree | b6fcb72d1216672a4359c1c4022ae0a0074b338c | |
| parent | 8a7c7da650cd05cb8f52cab985efc15ff14a70d6 (diff) | |
automatic import of python-a10-neutron-lbaasopeneuler20.03
| -rw-r--r-- | .gitignore | 1 | ||||
| -rw-r--r-- | python-a10-neutron-lbaas.spec | 707 | ||||
| -rw-r--r-- | sources | 1 |
3 files changed, 709 insertions, 0 deletions
@@ -0,0 +1 @@ +/a10-neutron-lbaas-1.8.1.tar.gz diff --git a/python-a10-neutron-lbaas.spec b/python-a10-neutron-lbaas.spec new file mode 100644 index 0000000..d56b690 --- /dev/null +++ b/python-a10-neutron-lbaas.spec @@ -0,0 +1,707 @@ +%global _empty_manifest_terminate_build 0 +Name: python-a10-neutron-lbaas +Version: 1.8.1 +Release: 1 +Summary: A10 Networks Openstack LBaaS Driver Middleware +License: Apache +URL: https://github.com/a10networks/a10-neutron-lbaas +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/09/67/8c5550db6543ef985ab4ae59cbdab312eadc27af27bb6639381ecde590cc/a10-neutron-lbaas-1.8.1.tar.gz +BuildArch: noarch + +Requires: python3-acos-client +Requires: python3-a10-openstack-lib + +%description +A10 Networks LBaaS Driver for Thunder, vThunder and AX Series Appliances +Supported releases: +* OpenStack: Liberty through current release. +* LBaaS versions: 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: v1 on any release, v2 Havana through Kilo +## A10 github repos +- [a10-neutron-lbaas](https://github.com/a10networks/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](https://github.com/a10networks/acos-client) - AxAPI client used by A10's OpenStack driver +- [a10-openstack-lbaas](https://github.com/a10networks/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](https://github.com/a10networks/a10-openstack-lbaas/tree/havana) - OpenStack +LBaaS driver, for the Havana release. Pypi package 'a10-openstack-lbaas-havana'. +- [a10networks-ci/project-config](https://github.com/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 +```sh +sudo pip install a10-neutron-lbaas +``` +#### Installation from cloned git repository. +Download the driver from: <https://github.com/a10networks/a10-neutron-lbaas> + +```sh +sudo pip install git+https://github.com/a10networks/a10-neutron-lbaas.git +``` +```sh +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` or `lbaasv2` is listed depending on your configuration. +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` +#### Extension configuration +Open `/etc/neutron/neutron.conf` in your preferred text editor. +Under the `service_plugins` setting, ensure `a10_neutron_lbaas.neutron_ext.services.a10_device_instance.plugin.A10DeviceInstancePlugin` is listed. The `service_plugins` are separated by `,`s. +Under the `api_extensions_path` setting, ensure the path to `a10_neutron_lbaas.neutron_ext.extensions` is listed. The `api_extensions_path`s are separated by `:`s. You can find the path of the installed extension by running `python -c "import os; import a10_neutron_lbaas.neutron_ext.extensions as m; print(os.path.dirname(os.path.abspath(m.__file__)))"`. +#### 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: +```python +devices = { + "ax1": { + "name": "ax1", + "host": "10.10.100.20", + "port": 443, + "username": "admin", + "password": "a10", + "autosnat": True, + "api_version": "3.0", + } +} +``` +#### vThunder Appliance Configuration +A10's LBaaS driver supports a default scheduling strategy of "one appliance per tenant". Below is a sample configuration (stored in `/etc/a10/config.py`): +```python +vthunder = { + 'username': 'admin', + 'password': 'a10', + 'api_version': '3.0', + 'nova_flavor': 'acos.min', + 'glance_image': 'c2722746-0c06-48b1-93c3-a9dbc2f6e628', + 'vthunder_tenant_name': 'admina', + 'vthunder_tenant_username': 'admina', + 'vthunder_tenant_password': 'password', + 'vthunder_management_network': 'private', + 'vthunder_data_networks': ['vipnet', 'membernet'] +} +``` +##### `username` (required) +The administrator username on your vThunder appliance image. +##### `password` (required) +The administrator password on your vThunder appliance image. +##### `api_version` (required) +The AXAPI version utilized to access vThunder appliances. This is dependent on your vThunder appliance image version: +* 2.7.x - `"2.1"` +* 4.x.x - `"3.0"` +##### `nova_flavor` (required) +The name of the nova flavor used to construct vThunder device instances. The minimum requirements are dependent on your vThunder appliance image version: +###### 2.7.x +* CPU: 1 VCPU +* RAM: 2GB +* Storage: 12GB +###### 4.x.x +* CPU: 1 VCPU +* RAM: 4GB +* Storage: 12GB +##### `glance_image` (required) +The Glance or Nova image ID of your vThunder appliance image. This can be obtained through Horizon or the Openstack CLI. +##### `vthunder_tenant_name` (required) +The name of the service tenant where vThunder appliance instances will be created. +##### `vthunder_tenant_username` (required) +The Openstack user login name which has access to the above-named service tenant. +##### `vthunder_tenant_passsword` (required) +The Openstack password of the above-mentioned login. +##### `vthunder_management_networks` (required) +The Openstack network name or ID that the vThunder management interface will be connected to. +##### `vthunder_data_networks` (required) +A list of Openstack network names or IDs that the vThunder data interfaces will be connected to. A minimum of one is required. +For complete documentation of the a10 config.py file, please refer to the [sample config file](https://github.com/a10networks/a10-neutron-lbaas/blob/master/a10_neutron_lbaas/etc/config.py). +#### 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. +#### vThunder License Manager Configuration +The A10 vThunder virtual load balancing appliance has a flexible system for licensing. Below is a sample configuration for license management (stored in `/etc/a10/config.py`): +```python +license_manager = { + "hosts": [ + {"ip": "pdx.a10cloud.com", "port": 443}, + {"ip": "sfo.a10cloud.com", "port": 443}, + {"ip": "iad.a10cloud.com", "port": 443} + ], + "serial": "SN0123456789ABCDEF", + "instance-name": "SCALING_INSTANCE", + "bandwidth-base": 100, + "interval": 3, + "use-mgmt-port": True +} +``` +##### `hosts` (required) +A list of host entries specifying the IP address or hostname and TCP port of licensing servers. +##### `serial` (required) +The serial number used for your vThunder appliances +##### `instance-name` (required) +The instance name attached to the license. +##### `bandwidth-base` (required for Pay-As-You-Go licensing) +The feature's bandwidth base measured in megabytes. +##### `interval` (required for Pay-As-You-Go licensing) +The feature's bandwidth allowance interval. +* 1 - Monthly +* 2 - Daily +* 3 - Hourly +##### `use-mgmt-port` +The appliance will use the management port for communicating with the licensing server if set to True. By default, the appliance will use the use the first available interface for license server operations. +More details about A10 Licensing can be found at `TODO(Add licensing info url)`. +## 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.) +```sh +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._ +## Default and Name-based configuration +See [name-based config example](https://github.com/a10networks/a10-neutron-lbaas/tree/master/a10_neutron_lbaas/etc) for details. +## Changes +See [CHANGELOG](https://github.com/a10networks/a10-neutron-lbaas/tree/master/CHANGELOG) for changes made. NOTE: We didn't have a changelog until 1.6.5 +## 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 + +%package -n python3-a10-neutron-lbaas +Summary: A10 Networks Openstack LBaaS Driver Middleware +Provides: python-a10-neutron-lbaas +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-a10-neutron-lbaas +A10 Networks LBaaS Driver for Thunder, vThunder and AX Series Appliances +Supported releases: +* OpenStack: Liberty through current release. +* LBaaS versions: 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: v1 on any release, v2 Havana through Kilo +## A10 github repos +- [a10-neutron-lbaas](https://github.com/a10networks/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](https://github.com/a10networks/acos-client) - AxAPI client used by A10's OpenStack driver +- [a10-openstack-lbaas](https://github.com/a10networks/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](https://github.com/a10networks/a10-openstack-lbaas/tree/havana) - OpenStack +LBaaS driver, for the Havana release. Pypi package 'a10-openstack-lbaas-havana'. +- [a10networks-ci/project-config](https://github.com/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 +```sh +sudo pip install a10-neutron-lbaas +``` +#### Installation from cloned git repository. +Download the driver from: <https://github.com/a10networks/a10-neutron-lbaas> + +```sh +sudo pip install git+https://github.com/a10networks/a10-neutron-lbaas.git +``` +```sh +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` or `lbaasv2` is listed depending on your configuration. +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` +#### Extension configuration +Open `/etc/neutron/neutron.conf` in your preferred text editor. +Under the `service_plugins` setting, ensure `a10_neutron_lbaas.neutron_ext.services.a10_device_instance.plugin.A10DeviceInstancePlugin` is listed. The `service_plugins` are separated by `,`s. +Under the `api_extensions_path` setting, ensure the path to `a10_neutron_lbaas.neutron_ext.extensions` is listed. The `api_extensions_path`s are separated by `:`s. You can find the path of the installed extension by running `python -c "import os; import a10_neutron_lbaas.neutron_ext.extensions as m; print(os.path.dirname(os.path.abspath(m.__file__)))"`. +#### 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: +```python +devices = { + "ax1": { + "name": "ax1", + "host": "10.10.100.20", + "port": 443, + "username": "admin", + "password": "a10", + "autosnat": True, + "api_version": "3.0", + } +} +``` +#### vThunder Appliance Configuration +A10's LBaaS driver supports a default scheduling strategy of "one appliance per tenant". Below is a sample configuration (stored in `/etc/a10/config.py`): +```python +vthunder = { + 'username': 'admin', + 'password': 'a10', + 'api_version': '3.0', + 'nova_flavor': 'acos.min', + 'glance_image': 'c2722746-0c06-48b1-93c3-a9dbc2f6e628', + 'vthunder_tenant_name': 'admina', + 'vthunder_tenant_username': 'admina', + 'vthunder_tenant_password': 'password', + 'vthunder_management_network': 'private', + 'vthunder_data_networks': ['vipnet', 'membernet'] +} +``` +##### `username` (required) +The administrator username on your vThunder appliance image. +##### `password` (required) +The administrator password on your vThunder appliance image. +##### `api_version` (required) +The AXAPI version utilized to access vThunder appliances. This is dependent on your vThunder appliance image version: +* 2.7.x - `"2.1"` +* 4.x.x - `"3.0"` +##### `nova_flavor` (required) +The name of the nova flavor used to construct vThunder device instances. The minimum requirements are dependent on your vThunder appliance image version: +###### 2.7.x +* CPU: 1 VCPU +* RAM: 2GB +* Storage: 12GB +###### 4.x.x +* CPU: 1 VCPU +* RAM: 4GB +* Storage: 12GB +##### `glance_image` (required) +The Glance or Nova image ID of your vThunder appliance image. This can be obtained through Horizon or the Openstack CLI. +##### `vthunder_tenant_name` (required) +The name of the service tenant where vThunder appliance instances will be created. +##### `vthunder_tenant_username` (required) +The Openstack user login name which has access to the above-named service tenant. +##### `vthunder_tenant_passsword` (required) +The Openstack password of the above-mentioned login. +##### `vthunder_management_networks` (required) +The Openstack network name or ID that the vThunder management interface will be connected to. +##### `vthunder_data_networks` (required) +A list of Openstack network names or IDs that the vThunder data interfaces will be connected to. A minimum of one is required. +For complete documentation of the a10 config.py file, please refer to the [sample config file](https://github.com/a10networks/a10-neutron-lbaas/blob/master/a10_neutron_lbaas/etc/config.py). +#### 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. +#### vThunder License Manager Configuration +The A10 vThunder virtual load balancing appliance has a flexible system for licensing. Below is a sample configuration for license management (stored in `/etc/a10/config.py`): +```python +license_manager = { + "hosts": [ + {"ip": "pdx.a10cloud.com", "port": 443}, + {"ip": "sfo.a10cloud.com", "port": 443}, + {"ip": "iad.a10cloud.com", "port": 443} + ], + "serial": "SN0123456789ABCDEF", + "instance-name": "SCALING_INSTANCE", + "bandwidth-base": 100, + "interval": 3, + "use-mgmt-port": True +} +``` +##### `hosts` (required) +A list of host entries specifying the IP address or hostname and TCP port of licensing servers. +##### `serial` (required) +The serial number used for your vThunder appliances +##### `instance-name` (required) +The instance name attached to the license. +##### `bandwidth-base` (required for Pay-As-You-Go licensing) +The feature's bandwidth base measured in megabytes. +##### `interval` (required for Pay-As-You-Go licensing) +The feature's bandwidth allowance interval. +* 1 - Monthly +* 2 - Daily +* 3 - Hourly +##### `use-mgmt-port` +The appliance will use the management port for communicating with the licensing server if set to True. By default, the appliance will use the use the first available interface for license server operations. +More details about A10 Licensing can be found at `TODO(Add licensing info url)`. +## 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.) +```sh +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._ +## Default and Name-based configuration +See [name-based config example](https://github.com/a10networks/a10-neutron-lbaas/tree/master/a10_neutron_lbaas/etc) for details. +## Changes +See [CHANGELOG](https://github.com/a10networks/a10-neutron-lbaas/tree/master/CHANGELOG) for changes made. NOTE: We didn't have a changelog until 1.6.5 +## 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 + +%package help +Summary: Development documents and examples for a10-neutron-lbaas +Provides: python3-a10-neutron-lbaas-doc +%description help +A10 Networks LBaaS Driver for Thunder, vThunder and AX Series Appliances +Supported releases: +* OpenStack: Liberty through current release. +* LBaaS versions: 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: v1 on any release, v2 Havana through Kilo +## A10 github repos +- [a10-neutron-lbaas](https://github.com/a10networks/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](https://github.com/a10networks/acos-client) - AxAPI client used by A10's OpenStack driver +- [a10-openstack-lbaas](https://github.com/a10networks/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](https://github.com/a10networks/a10-openstack-lbaas/tree/havana) - OpenStack +LBaaS driver, for the Havana release. Pypi package 'a10-openstack-lbaas-havana'. +- [a10networks-ci/project-config](https://github.com/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 +```sh +sudo pip install a10-neutron-lbaas +``` +#### Installation from cloned git repository. +Download the driver from: <https://github.com/a10networks/a10-neutron-lbaas> + +```sh +sudo pip install git+https://github.com/a10networks/a10-neutron-lbaas.git +``` +```sh +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` or `lbaasv2` is listed depending on your configuration. +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` +#### Extension configuration +Open `/etc/neutron/neutron.conf` in your preferred text editor. +Under the `service_plugins` setting, ensure `a10_neutron_lbaas.neutron_ext.services.a10_device_instance.plugin.A10DeviceInstancePlugin` is listed. The `service_plugins` are separated by `,`s. +Under the `api_extensions_path` setting, ensure the path to `a10_neutron_lbaas.neutron_ext.extensions` is listed. The `api_extensions_path`s are separated by `:`s. You can find the path of the installed extension by running `python -c "import os; import a10_neutron_lbaas.neutron_ext.extensions as m; print(os.path.dirname(os.path.abspath(m.__file__)))"`. +#### 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: +```python +devices = { + "ax1": { + "name": "ax1", + "host": "10.10.100.20", + "port": 443, + "username": "admin", + "password": "a10", + "autosnat": True, + "api_version": "3.0", + } +} +``` +#### vThunder Appliance Configuration +A10's LBaaS driver supports a default scheduling strategy of "one appliance per tenant". Below is a sample configuration (stored in `/etc/a10/config.py`): +```python +vthunder = { + 'username': 'admin', + 'password': 'a10', + 'api_version': '3.0', + 'nova_flavor': 'acos.min', + 'glance_image': 'c2722746-0c06-48b1-93c3-a9dbc2f6e628', + 'vthunder_tenant_name': 'admina', + 'vthunder_tenant_username': 'admina', + 'vthunder_tenant_password': 'password', + 'vthunder_management_network': 'private', + 'vthunder_data_networks': ['vipnet', 'membernet'] +} +``` +##### `username` (required) +The administrator username on your vThunder appliance image. +##### `password` (required) +The administrator password on your vThunder appliance image. +##### `api_version` (required) +The AXAPI version utilized to access vThunder appliances. This is dependent on your vThunder appliance image version: +* 2.7.x - `"2.1"` +* 4.x.x - `"3.0"` +##### `nova_flavor` (required) +The name of the nova flavor used to construct vThunder device instances. The minimum requirements are dependent on your vThunder appliance image version: +###### 2.7.x +* CPU: 1 VCPU +* RAM: 2GB +* Storage: 12GB +###### 4.x.x +* CPU: 1 VCPU +* RAM: 4GB +* Storage: 12GB +##### `glance_image` (required) +The Glance or Nova image ID of your vThunder appliance image. This can be obtained through Horizon or the Openstack CLI. +##### `vthunder_tenant_name` (required) +The name of the service tenant where vThunder appliance instances will be created. +##### `vthunder_tenant_username` (required) +The Openstack user login name which has access to the above-named service tenant. +##### `vthunder_tenant_passsword` (required) +The Openstack password of the above-mentioned login. +##### `vthunder_management_networks` (required) +The Openstack network name or ID that the vThunder management interface will be connected to. +##### `vthunder_data_networks` (required) +A list of Openstack network names or IDs that the vThunder data interfaces will be connected to. A minimum of one is required. +For complete documentation of the a10 config.py file, please refer to the [sample config file](https://github.com/a10networks/a10-neutron-lbaas/blob/master/a10_neutron_lbaas/etc/config.py). +#### 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. +#### vThunder License Manager Configuration +The A10 vThunder virtual load balancing appliance has a flexible system for licensing. Below is a sample configuration for license management (stored in `/etc/a10/config.py`): +```python +license_manager = { + "hosts": [ + {"ip": "pdx.a10cloud.com", "port": 443}, + {"ip": "sfo.a10cloud.com", "port": 443}, + {"ip": "iad.a10cloud.com", "port": 443} + ], + "serial": "SN0123456789ABCDEF", + "instance-name": "SCALING_INSTANCE", + "bandwidth-base": 100, + "interval": 3, + "use-mgmt-port": True +} +``` +##### `hosts` (required) +A list of host entries specifying the IP address or hostname and TCP port of licensing servers. +##### `serial` (required) +The serial number used for your vThunder appliances +##### `instance-name` (required) +The instance name attached to the license. +##### `bandwidth-base` (required for Pay-As-You-Go licensing) +The feature's bandwidth base measured in megabytes. +##### `interval` (required for Pay-As-You-Go licensing) +The feature's bandwidth allowance interval. +* 1 - Monthly +* 2 - Daily +* 3 - Hourly +##### `use-mgmt-port` +The appliance will use the management port for communicating with the licensing server if set to True. By default, the appliance will use the use the first available interface for license server operations. +More details about A10 Licensing can be found at `TODO(Add licensing info url)`. +## 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.) +```sh +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._ +## Default and Name-based configuration +See [name-based config example](https://github.com/a10networks/a10-neutron-lbaas/tree/master/a10_neutron_lbaas/etc) for details. +## Changes +See [CHANGELOG](https://github.com/a10networks/a10-neutron-lbaas/tree/master/CHANGELOG) for changes made. NOTE: We didn't have a changelog until 1.6.5 +## 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 + +%prep +%autosetup -n a10-neutron-lbaas-1.8.1 + +%build +%py3_build + +%install +%py3_install +install -d -m755 %{buildroot}/%{_pkgdocdir} +if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi +if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi +if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi +if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi +pushd %{buildroot} +if [ -d usr/lib ]; then + find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/lib64 ]; then + find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/bin ]; then + find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/sbin ]; then + find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst +fi +touch doclist.lst +if [ -d usr/share/man ]; then + find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst +fi +popd +mv %{buildroot}/filelist.lst . +mv %{buildroot}/doclist.lst . + +%files -n python3-a10-neutron-lbaas -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Fri May 05 2023 Python_Bot <Python_Bot@openeuler.org> - 1.8.1-1 +- Package Spec generated @@ -0,0 +1 @@ +d87cb914054aa047c8c0ab293b70c46c a10-neutron-lbaas-1.8.1.tar.gz |