Newton Series Release Notes¶

Prelude¶

LBaaS API v1 has been removed. Do not upgrade before migrating to LBaaS API v2.

New Features¶

• Adds support for creating a load balancer with a Neutron network id.
  • Adds an optional vip_network_id attribute when creating a load balancer.
  • When creating a load balancer, vip_subnet_id is optional if a vip_network_id is provided.
  • If vip_network_id is provided the VIP will be allocated on a subnet with an available address. An IPv4 subnet will be chosen if possible.

• Adds support for Layer 7 switching and shared pools features to Neutron LBaaS v2. Neutron LBaaS v1 is unaffected by this new feature.
  • Layer 7 policies allow a tenant / user to define actions the load balancer may take other than routing requests to the default pool.
  • Layer 7 rules control the logic behind whether a given Layer 7 policy is followed.
  • Works for HTTP and TERMINATED_HTTPS listeners.
  • Shared pools allow listeners or Layer 7 REDIRECT_TO_POOL policies to share back-end pools.

• LBaaS API v1 has been removed.

Upgrade Notes¶

• Upgrade requires a database migration.
  • Shared-pools introduces a new loadbalancer_id column into the lbaas_pools table.
  • lbaas_pools.loadbalancer_id column is populated from lbaas_listeners data using ETL in the migration.
  • Two new tables are created to handle Layer 7 switching. These are lbaas_l7policies and lbaas_l7rules.

• Driver updates may be required.
  • Maintainers of third-party drivers in the neutron-lbaas code tree will need to update their drivers to take advantage of the new Layer 7 switching features.
  • Pains have been taken to ensure that all interfaces (both API and internally) are compatible with the new shared-pools feature. Nevertheless, maintainers of third-party drivers should double-check their code to ensure they haven’t made assumptions about listener-pool relationships which are now not true.

• MUST migrate to LBaaS v2 before upgrading.

Critical Issues¶

• LBaaS API v1 has been removed.