adjutant-ui/doc/source/installation.rst

Installation instructions

Begin by cloning the Horizon and Adjutant UI repositories:

git clone https://github.com/openstack/horizon
git clone https://github.com/catalyst/adjutant-ui

Create a virtual environment and install Horizon dependencies:

cd horizon
python tools/install_venv.py

Set up your local_settings.py file:

cp openstack_dashboard/local/local_settings.py.example openstack_dashboard/local/local_settings.py

Open up the copied local_settings.py file in your preferred text editor. You will want to customize several settings:

• Verify that the OPENSTACK_KEYSTONE_URL is correct for your environment.
• OPENSTACK_ADJUTANT_URL should also be configured to point to your Adjutant server and version.

You will also need to update the keystone_policy.json file in horizon with the following lines:

"project_mod": "role:project_mod",
"project_admin": "role:project_admin",
"project_mod_or_admin": "rule:admin_required or rule:project_mod or rule:project_admin",
"project_admin_only": "rule:admin_required or rule:project_admin",
"identity:project_users_access": "rule:project_mod_or_admin",

Install Adjutant UI with all dependencies in your virtual environment:

tools/with_venv.sh pip install -e ../adjutant-ui/

And enable it in Horizon:

cp ../adjutant-ui/enabled/_* openstack_dashboard/local/enabled