OpenFOAM horizon dashboard app.
Project description
This repository provides a horizon dashboard for the OpenFOAM cloud application. To use it, you must also install the backend application.
Installing via pip to an existing OpenStack Horizon installation
You can install the horizon-openfoam dashboard via pip package manager:
pip install horizon-openfoam
Edit openstack_dashboard/local/local_settings.py and add the following parameters at the end:
OFCLOUD_API_URL = 'your_ofcloud_api_url' S3_ACCESS_KEY_ID = 'your_s3_access_key_id' S3_SECRET_ACCESS_KEY = 'your_s3_secret_access_key' S3_HOST = 's3 host' S3_PORT = 443
The OFCLOUD_API_URL is the root URL of the OpenFOAM Backend.
To enable the dashboard copy _6010_horizon-openfoam.py to openstack-dashboard/openstack_dashboard/local/enabled (usually under /usr/share)
After installing restart your apache2 server where horizon is running.
Ubuntu/debian:
systemctl restart apache2.service
CentOS:
systemctl restart httpd.service
Installing locally
In order to use the OpenFOAM Horizon dashboard, one must first clone the OpenStack’s Horizon project and checkout the Liberty version:
git clone https://github.com/openstack/horizon.git git checkout stable/liberty
Install the required packages (we suggest to use virtualenv for this):
cd horizon pip install -r requirements.txt
Then add the ofcloud dashboard submodule
cd horizon/openstack_dashboard/dashboards/ git submodule add --name ofcloud https://github.com/mikelangelo-project/openfoam-ui.git ofcloud
In order to enable the dashboard, go to horizon/openstack_dashboard/enabled. This directory contains several files configuring the dashboards and panels. File ordering is important in that it sets the structure of the Horizon dashboard.
Create a file in this directory, for example _50_ofcloud.py and copy the following content:
# The name of the dashboard to be added to HORIZON['dashboards']. Required. DASHBOARD = 'ofcloud' # If set to True, this dashboard will not be added to the settings. DISABLED = False # A list of applications to be added to INSTALLED_APPS. ADD_INSTALLED_APPS = [ 'openstack_dashboard.dashboards.ofcloud', ]
Finally, edit the local settings file (horizon/openstack_dashboard/local/local_settings.py) and put the following settings (replace with values appropriate to your system setup):
OFCLOUD_API_URL = 'ofcloud-backend-url' S3_ACCESS_KEY_ID = 'your-s3-key' S3_SECRET_ACCESS_KEY = 'your-s3-secrect-key' S3_HOST = 's3-host' S3_PORT = s3-port
The OFCLOUD_API_URL is the root URL of the OpenFOAM Backend.
Running
Start the OpenStack Horizon application, login and look for the OpenFOAM Cloud dashboard.
cd horizon python manage.py runserver 0.0.0.0:8000
Acknowledgements
This project has been conducted within the RIA MIKELANGELO project (no. 645402), started in January 2015, and co-funded by the European Commission under the H2020-ICT- 07-2014: Advanced Cloud Infrastructures and Services programme.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.