Rushil Chugh ee8fa6deca Adds Ironic-UI Devstack plugin

This change proposes to add Ironic-UI Devstack plugin.

Change-Id: Ided8819c2ec9f8fbbbbf1d76a7ec41ae7717288a
Closes-Bug: #1663840

2017-03-24 14:59:25 -04:00

3.2 KiB

Raw Blame History

Team and repository tags

Ironic UI

The Ironic UI is a Horizon plugin that will allow users to view and manage bare metal nodes, ports and drivers.

Free software: Apache license
Documentation: http://docs.openstack.org/developer/ironic-ui
Source: http://git.openstack.org/cgit/openstack/ironic-ui
Bugs: http://bugs.launchpad.net/ironic-ui

Features

View bare metal nodes
View node details
Apply maintenance and power on/off actions to the nodes

Installation Instructions

Please note that the following instructions assume that you have an existing installation of the OpenStack Horizon dashboard application. For Horizon installation please see http://docs.openstack.org/developer/horizon/quickstart.html

Clone the Ironic UI repository:

git clone https://git.openstack.org/openstack/ironic-ui

Change into the root directory of your horizon installation and activate the python virtual environment. Example:
```
source .venv/bin/activate
```
Note

The .venv folder is preinstalled when horizon is setup with ./run_tests.sh. Do not attempt to reinstall the virtual environment.
Copy the _2200_ironic.py file from ironic_ui/enabled/_2200_ironic.py file to horizon/openstack_dashboard/local/enabled directory. Example, set as if being executed from the root of the ironic-ui repository:
```
cp ./ironic_ui/enabled/_2200_ironic.py ../horizon/horizon/openstack_dashboard/local/enabled
```
Change into the ironic-ui repository and package the plugin:
```
pip install -e .
```
This will build and install the ironic-ui plugin into the active virtual environment associated with your horizon installation. The plugin is installed in "editable" mode as a link back to your ironic-ui plugin directory.

Also ensure that all packages as per requirements.txt have been installed.
Change back into the horizon repository and bring up your environment:
```
./run_tests.sh --runserver
```
The Ironic Bare Metal Provisioning plugin should now be visible in the Horizon navigation.

Installation Instructions with devstack

In order to use the Ironic UI with devstack, you will need to enable the UI plugin separately. This is done in a similar fashion to enabling Ironic for devstack. Make sure you have horizon enabled (enabled by default in devstack). Then, enable the Ironic UI plugin appending the following line to the end of the local.conf file, just after Ironic plugin enablement:

enable_plugin ironic-ui https://github.com/openstack/ironic-ui

After this, you can run ./stack.sh from the devstack directory.

The Ironic Bare Metal Provisioning plugin should now be visible in the Horizon navigation.

Uninstallation

To uninstall, use pip uninstall ironic-ui from with-in the horizon virtual environment. You will also need to remove the openstack_dashboard/enabled/_2200_ironic.py file from the horizon installation.

3.2 KiB Raw Blame History