2.8 KiB
Sahara UI Installation Guide
Sahara UI is a plugin for OpenStack Dashboard. There are two ways to install it. One is to plug it into existing Dashboard installation and another is to setup another Dashboard and plug Sahara UI there. The first approach advantage is that you will have Sahara UI in the very same Dashboard with which you work with OpenStack. The disadvantage is that you have to tweak your Dashboard configuration in order to enable the plugin. The second approach does not have this disadvantage.
Further steps describe installation for the first approach. For the
second approach see /horizon/dev.environment.guide
1. Prerequisites
- OpenStack environment (Folsom, Grizzly or Havana version) installed.
- Sahara installed, configured and running, see
/userdoc/installation.guide
.
2. Sahara Dashboard Installation
Go to the machine where Dashboard resides and install Sahara UI:
For RDO:
$ sudo yum install python-django-savanna
Otherwise:
$ sudo pip install sahara-dashboard
This will install latest stable release of Sahara UI. If you want to install master branch of Sahara UI:
$ sudo pip install 'http://tarballs.openstack.org/sahara-dashboard/sahara-dashboard-master.tar.gz'
- Configure OpenStack Dashboard. In
settings.py
add sahara to
= {
HORIZON_CONFIG 'dashboards': ('nova', 'syspanel', 'settings', ..., 'sahara'),
and also add saharadashboard to
= (
INSTALLED_APPS 'saharadashboard',
....
Note:
settings.py
file is located in/usr/share/openstack-dashboard/openstack_dashboard/
by default.
- Also you have to specify SAVANNA_URL in local_settings.py. For example:
= 'http://localhost:8386/v1.1' SAVANNA_URL
If you are using Neutron instead of Nova Network:
= True SAVANNA_USE_NEUTRON
If you are not using nova-network with auto_assign_floating_ip=True, also set:
= False AUTO_ASSIGNMENT_ENABLED
Note: For RDO, the
local_settings.py
file is located in/etc/openstack-dashboard/
, otherwise it is in/usr/share/openstack-dashboard/openstack_dashboard/local/
.
Now all installations are done and apache web server can be restarted for the changes to take effect:
For Ubuntu:
$ sudo service apache2 restart
For Centos:
$ sudo service httpd reload
You can check that service has been started successfully. Go to Horizon URL and if installation is correct you'll be able to see the Sahara tab.