The UI component for Manila
Go to file
Jenkins aae086aed6 Merge "Remove vim headers" 2016-07-12 22:02:36 +00:00
doc/source Initial project creation 2015-03-13 14:01:16 -07:00
manila_ui Merge "Remove vim headers" 2016-07-12 22:02:36 +00:00
releasenotes Imported Translations from Zanata 2016-06-16 08:33:01 +00:00
tools Make 'cover' job use always venv 2016-04-28 18:52:03 +03:00
.coveragerc Upgrade coverage tox job 2016-04-20 14:37:33 +03:00
.gitignore Add support for releasenotes 2016-05-25 17:19:09 +00:00
.gitreview Add .gitreview file for manila-ui 2015-04-30 13:43:01 -04:00
.mailmap Initial project creation 2015-03-13 14:01:16 -07:00
.testr.conf Initial project creation 2015-03-13 14:01:16 -07:00
CONTRIBUTING.rst Initial project creation 2015-03-13 14:01:16 -07:00
HACKING.rst Initial project creation 2015-03-13 14:01:16 -07:00
LICENSE Initial project creation 2015-03-13 14:01:16 -07:00
README.rst Add RDO install instructions for Manila UI 2016-06-03 12:44:03 -04:00
babel-django.cfg Enable translation for manila-ui 2016-05-11 21:36:40 +00:00
babel-djangojs.cfg Enable translation for manila-ui 2016-05-11 21:36:40 +00:00
babel.cfg Initial project creation 2015-03-13 14:01:16 -07:00
manage.py Fix pep8 violations via run_tests.sh -p 2015-04-20 15:12:46 -07:00
requirements.txt Updated from global requirements 2016-07-09 19:21:42 +00:00
run_tests.sh Place all unit tests under single subdir 2016-05-04 13:52:09 +03:00
setup.cfg Enable translation for manila-ui 2016-05-11 21:36:40 +00:00
setup.py Updated from global requirements 2015-10-17 02:55:30 +00:00
test-requirements.txt Updated from global requirements 2016-06-24 03:12:41 +00:00
tox.ini Add support for releasenotes 2016-05-25 17:19:09 +00:00

README.rst

manila-ui

Manila Management Dashboard

  • Free software: Apache license

Installation instructions

For Manila UI installation in RDO, see: Installing Manila UI in RDO. For other distributions, begin by cloning the Horizon and Manila UI repositories:

git clone https://github.com/openstack/horizon
git clone https://github.com/openstack/manila-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:

  • OPENSTACK_HOST should be configured with the hostname of your OpenStack server. Verify that the OPENSTACK_KEYSTONE_URL and OPENSTACK_KEYSTONE_DEFAULT_ROLE settings are correct for your environment. (They should be correct unless you modified your OpenStack server to change them.)

Install Manila UI with all dependencies in your virtual environment:

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

And enable it in Horizon:

cp ../manila-ui/manila_ui/enabled/_90_manila_*.py openstack_dashboard/local/enabled

Starting the app

If everything has gone according to plan, you should be able to run:

./run_tests.sh --runserver 0.0.0.0:8080

and have the application start on port 8080. The horizon dashboard will be located at http://localhost:8080/

Installing Manila UI in RDO

In order to install Manila UI in [RDO](https://www.rdoproject.org), please follow the steps below (you may need to use sudo privileges if you are not root):

# yum install -y openstack-manila-ui
# systemctl restart httpd
# systemctl restart memcached

Manila UI will now be available through OpenStack Horizon; look for the Shares tab under Project > Compute. You can access Horizon with Manila UI using the same URL and port as before.

Unit testing

The unit tests can be executed directly from within this Manila UI plugin project directory by using:

cd ../manila-ui
./run_tests.sh

This is made possible by the dependency in test-requirements.txt upon the horizon source, which pulls down all of the horizon and openstack_dashboard modules that the plugin uses.