openstack
/
manila-ui
Code Issues Proposed changes

Update installation docs for Manila UI 

After dropping old oslo-incubator file (tools/install_venv.py)
we needed to update the installation docs and remove references
to it. This patch set add new instructions and also includes
Devstack as an installation alternative.

Change-Id: I896b27107f2c8ca9f0c6c98b7b782c59ff754fea
Closes-Bug: #1770209
This commit is contained in:
Victoria Martinez de la Cruz 2018-05-09 15:01:34 -04:00 committed by Goutham Pacha Ravi
parent 0f2a2a20ed
commit bb144b4b9f
1 changed files with 17 additions and 30 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

47
doc/source/install/installation.rst
View File

@ -2,40 +2,27 @@
Installation Installation
============ ============
DevStack Installation
---------------------
Add this repo as an external repository into your ``local.conf`` file::
[[local|localrc]]
enable_plugin manila-ui git://git.openstack.org/openstack/manila-ui
Manual Installation Manual Installation
------------------- -------------------
For Manila UI installation in RDO, see: :ref:`install-rdo`. Begin by installing Horizon following the `Horizon Manual Installation Guide <https://docs.openstack.org/horizon/latest/install/from-source.html>`__
For other distributions, begin by and clone Manila UI repository::
cloning the Horizon and Manila UI repositories::
git clone https://github.com/openstack/horizon git clone git://git.openstack.org/openstack/manila-ui
git clone https://github.com/openstack/manila-ui
Create a virtual environment and install Horizon dependencies:: Install Manila UI with all dependencies. From within the horizon folder::
cd horizon pip install -e ../manila-ui/
python tools/install_venv.py
Set up your ``local_settings.py`` file:: And enable it in Horizon.::
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/local/enabled/_*.py openstack_dashboard/local/enabled cp ../manila-ui/manila_ui/local/enabled/_*.py openstack_dashboard/local/enabled
cp ../manila-ui/manila_ui/local/local_settings.d/_90_manila_*.py openstack_dashboard/local/local_settings.d cp ../manila-ui/manila_ui/local/local_settings.d/_90_manila_*.py openstack_dashboard/local/local_settings.d
@ -49,9 +36,9 @@ In order to install Manila UI in `RDO <https://www.rdoproject.org>`__,
please follow the steps below (you may need to use `sudo` privileges please follow the steps below (you may need to use `sudo` privileges
if you are not root):: if you are not root)::
# yum install -y openstack-manila-ui # yum install -y openstack-manila-ui
# systemctl restart httpd # systemctl restart httpd
# systemctl restart memcached # systemctl restart memcached
Manila UI will now be available through OpenStack Horizon; look for Manila UI will now be available through OpenStack Horizon; look for
the Shares tab under Project > Compute. You can access Horizon with the Shares tab under Project > Compute. You can access Horizon with