Jesse Pretorius 24e63abeb2 Fix 'D001 Line too long' documentation lint failures

Change-Id: I4522fe318541dac7f4ff4e45d72d4cd8869420ba

2016-07-13 21:32:31 +00:00

5.8 KiB

Raw Blame History

Home OpenStack-Ansible Installation Guide

Configuring the Networking service (neutron) (optional)

The OpenStack Networking service (neutron) includes the following services:

Firewall as a Service (FWaaS): Provides a software-based firewall that filters traffic from the router.
Load Balancer as a Service (LBaaS): Provides load balancers that direct traffic to OpenStack instances or other servers outside the OpenStack deployment.
VPN as a Service (VPNaaS): Provides a method for extending a private network across a public network.

Firewall service (optional)

The following procedure describes how to modify the /etc/openstack_deploy/user_variables.yml file to enable FWaaS.

Override the default list of neutron plugins to include firewall:
```
neutron_plugin_base:
  - firewall
  - ...
```

neutron_plugin_base is as follows:

neutron_plugin_base:
   - router
   - firewall
   - lbaas
   - vpnaas
   - metering
   - qos

Execute the neutron install playbook in order to update the configuration:

# cd /opt/openstack-ansible/playbooks
# openstack-ansible os-neutron-install.yml

Execute the horizon install playbook to show the FWaaS panels:

# cd /opt/openstack-ansible/playbooks
# openstack-ansible os-horizon-install.yml

The FWaaS default configuration options may be changed through the conf override mechanism using the neutron_neutron_conf_overrides dict.

Load balancing service (optional)

The neutron-lbaas plugin for neutron provides a software load balancer service and can direct traffic to multiple servers. The service runs as an agent and it manages HAProxy configuration files and daemons.

The Newton release contains only the LBaaS v2 API. For more details about transitioning from LBaaS v1 to v2, review the lbaas-special-notes section below.

Deployers can make changes to the LBaaS default configuration options via the neutron_lbaas_agent_ini_overrides dictionary. Review the documentation on the conf override mechanism for more details.

Deploying LBaaS v2

Add the LBaaS v2 plugin to the neutron_plugin_base variable in /etc/openstack_deploy/user_variables.yml:
```
neutron_plugin_base:
  - router
  - metering
  - neutron_lbaas.services.loadbalancer.plugin.LoadBalancerPluginv2
```
Ensure that neutron_plugin_base includes all of the plugins that you want to deploy with neutron in addition to the LBaaS plugin.

Run the neutron and horizon playbooks to deploy the LBaaS v2 agent and enable the LBaaS v2 panels in horizon:

# cd /opt/openstack-ansible/playbooks
# openstack-ansible os-neutron-install.yml
# openstack-ansible os-horizon-install.yml

Special notes about LBaaS

LBaaS v1 was deprecated in the Mitaka release and is not available in the Newton release.

LBaaS v1 and v2 agents are unable to run at the same time. If you switch LBaaS v1 to v2, the v2 agent is the only agent running. The LBaaS v1 agent stops along with any load balancers provisioned under the v1 agent.

Load balancers are not migrated between LBaaS v1 and v2 automatically. Each implementation has different code paths and database tables. You need to manually delete load balancers, pools, and members before switching LBaaS versions. Recreate these objects afterwards.

Virtual private network service (optional)

The following procedure describes how to modify the /etc/openstack_deploy/user_variables.yml file to enable VPNaaS.

Override the default list of neutron plugins to include vpnaas:
```
neutron_plugin_base:
  - router
  - metering
```

neutron_plugin_base is as follows:

neutron_plugin_base:
   - router
   - metering
   - vpnaas

Override the default list of specific kernel modules in order to include the necessary modules to run ipsec:

openstack_host_specific_kernel_modules:
   - { name: "ebtables", pattern: "CONFIG_BRIDGE_NF_EBTABLES=", group: "network_hosts" }
   - { name: "af_key", pattern: "CONFIG_NET_KEY=", group: "network_hosts" }
   - { name: "ah4", pattern: "CONFIG_INET_AH=", group: "network_hosts" }
   - { name: "ipcomp", pattern: "CONFIG_INET_IPCOMP=", group: "network_hosts" }

Execute the openstack hosts setup in order to load the kernel modules at boot and runtime in the network hosts
```
# openstack-ansible openstack-hosts-setup.yml --limit network_hosts\
--tags "openstack_hosts-config"
```