Skip to main content
Donate to the Python Software Foundation or Purchase a PyCharm License to Benefit the PSF! Donate Now

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

This version
History Node

1.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
horizon-openfoam-1.0.tar.gz (17.7 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page