GroupBasedPolicy/InstallUbuntu

Installing and Running GBP

The following are a set of instructions for installing and working with GBP on Ubuntu 14.04:

1. Add the following line to /etc/apt/sources.list

 deb http://ppa.launchpad.net/group-based-policy-drivers/ppa/ubuntu utopic main

2. Install GBP packages

 sudo apt-get update
 sudo apt-get install group-based-policy group-based-policy-automation group-based-policy-ui python-group-based-policy-client

3. To configure the GBP service plugin and drivers, edit /etc/neutron/neutron.conf

3.1 Append "group_policy" and "servicechain" entry-point names to the previously enabled service plugins:

  service_plugins = <already configured service plugins including l3, lbaas, and fwaas>,group_policy,servicechain

3.2 Configure GBP policy and service-chain drivers

 [group_policy]
 policy_drivers = implicit_policy, resource_mapping

 [servicechain]
 servicechain_drivers = simplechain_driver

4. To configure GBP heat plugin, edit /etc/heat/heat.conf

  plugin_dirs=<existing heat plugins>,/usr/lib/python2.7/dist-packages/gbpautomation/heat

5. Update GBP automation package name to work correctly with pbr

  sed -i 's/gbpautomation/group_based_policy_automation/g' /usr/lib/python2.7/dist-packages/gbpautomation/__init__.py

6. Enable GBP UI on horizon dashboard

 ln -s /usr/lib/python2.7/dist-packages/gbpui/_*project*.py /usr/share/openstack-dashboard/openstack_dashboard/enabled

7. Create GBP Database tables

 gbp-db-manage --config-file /etc/neutron/neutron.conf upgrade head

8. Restart the services to apply the configuration changes

 service neutron-server restart
 service heat-api restart
 service heat-api-cfn restart
 service heat-engine restart
 service apache2 restart

9. Use the "gbp" CLI binary ("gbp --help" will give you the commands). For details on the workflow check this.