Installation

Manual Installation

Before installing neutron-fwaas-dashboard, you first need to install horizon in your environment.

Fetch the source code from git and run pip install. Make sure to install neutron-fwaas-dashboard into the same python environment where horizon is installed.

$ git clone https://opendev.org/openstack/neutron-fwaas-dashboard
$ cd neutron-fwaas-dashboard
$ sudo pip install .

Enable the horizon plugin.

$ cp neutron_fwaas_dashboard/enabled/_70*_*.py \
      /opt/stack/horizon/openstack_dashboard/local/enabled/

Note

The directory local/enabled may be different depending on your environment or distribution used. For example, for Ubuntu, this is /usr/share/openstack-dashboard/openstack_dashboard/local/enabled.

Note

The number of the plugin enabled file determines the order of panels. If you would like to configure the place of the Neutron FWaaS dashboard, change the number of the file.

Note

For more detail of the horizon plugin settings, see Pluggable Settings in the horizon documentation.

Configure the policy file for Neutron FWaaS dashboard in OpenStack Dashboard local_settings.py. <fwaas-dashboard-config-dir> is a directory which contains configurations for Neutron FWaaS dashboard and the location varies across distributions or deployments.

POLICY_FILES['neutron-fwaas'] = '<fwaas-dashboard-config-dir>/etc/neutron-fwaas-policy.json'

Note

If you do not configure POLICY_FILES in your local_settings.py, you also need to define the default POLICY_FILES in local_settings.py. If you use the example local_settings.py file from horizon, what you need is to uncomment POLICY_FILES (which contains the default values).

Compile the message catalogs of Neutron FWaaS dashboard.

$ cd neutron-fwaas-dashboard
$ ./manage.py compilemessages

Run the Django update commands (if you use).

$ DJANGO_SETTINGS_MODULE=openstack_dashboard.settings python manage.py collectstatic --noinput
$ DJANGO_SETTINGS_MODULE=openstack_dashboard.settings python manage.py compress --force

Restart Apache:

$ sudo service apache2 restart