Files
heat-dashboard/doc/source/install/installation.rst
Akihiro Motoki 20ccb58e67 Improve doc structure
The current top page of heat-dashboard doc is a bit tricky.
The content of installation is duplicated, for example.

This commit revisit the document structure.

* Drop installation instruction from README
* Drop meaningless indices and tables (which are not working)
* Move DevStack setup to the contributor document
* Merge installation_contents.rst into installation.rst

Change-Id: I897cfe0094358db63a364088fd2b977e234101e8
2018-02-22 09:56:09 +09:00

1.6 KiB

Installation

Manual Installation

Clone both Horizon and Heat Dashboard repositories:

git clone https://github.com/openstack/horizon
git clone https://github.com/openstack/heat-dashboard

Create a virtual environment and install Horizon relevant packages:

pip install -r horizon/requirements.txt

Create your local_settings.py file:

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

Open newly created local_settings.py with your text editor, and set some parameter to connect to your OpenStack environment:

  • Set OPENSTACK_HOST as hostname or IP address 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 Heat Dashboard with all relevant packages to your Horizon environment:

pip install -e ./heat-dashboard/

Enable heat-dashboard plugin in your Horizon environment:

cp heat-dashboard/heat_dashboard/enabled/* \
  horizon/openstack_dashboard/local/enabled

cp heat-dashboard/heat_dashboard/conf/* \
  horizon/openstack_dashboard/conf/

cp heat-dashboard/heat_dashboard/local_settings.d/* \
  horizon/openstack_dashboard/local/local_settings.d/

Finally you can launch Horizon with Heat Dashboard plugin:

cd horizon
python manage.py runserver 0.0.0.0:8080

Now you can connect to your Horizon including Heat Dashboard plugin from your browser with URL http://localhost:8080/.