zun-ui/doc/source/install/index.rst
Hongbin Lu 020e9ad7dd Update installation docs
* Add a note about python3 installation
* Fix the order of install steps

Change-Id: Ia5c1b3eae55196a3bc2cc38d90890985cd41ecea
Related-Bug: #1829871
2019-11-25 11:46:53 +00:00

47 lines
1.2 KiB
ReStructuredText

============
Installation
============
Manual Installation
-------------------
Install Horizon according to `Horizon documentation <https://docs.openstack.org/horizon/>`_.
.. note::
If your Horizon was installed by python3, Zun UI needs to be installed by
python3 as well. For example, replace ``pip`` with ``pip3`` and replace
``python`` with ``python3`` for commands below.
Clone Zun UI from git repository, checkout branch same as Horizon and Zun, and install it::
git clone https://github.com/openstack/zun-ui
cd zun-ui
git checkout <branch which you want>
pip install .
Enable Zun UI in your Horizon::
cp zun_ui/enabled/* <path to your horizon>/openstack_dashboard/local/enabled/
Run collectstatic command::
python <path to your horizon>/manage.py collectstatic
Compress static files (if enabled)::
python <path to your horizon>/manage.py compress
Then restart your Horizon.
After restart your Horizon, reload dashboard forcely using [Ctrl + F5] or etc. in your browser.
Enabling in DevStack
--------------------
Add this repo as an external repository into your ``local.conf`` file::
[[local|localrc]]
enable_plugin zun-ui https://github.com/openstack/zun-ui