The Development Infrastructure consists of two parts.
- The Docker-based development Infrastructure to be installed on your computer.
- The database containing HMI images and preprocessed data, which is hosted on the FLARECAST cluster in France.
This document explains how to install the FLARECAST development infrastructure on your computer. Access to the Infrastructure inf France is documented in Setup access to FLARECAST cluster.
In case you run into problems or think we should improve things please send a message to marco.soldati@fhnw.ch or leave a comment below. Many thanks.
System Requirements
- 64-bit host system (OSX or Linux, Windows is currently not tested/supported)
- min. 3.5 GB free disk space (the more the better, depends on how much HMI data you want to download)
- min 4.0 GB RAM (the more the better)
Recommended versions
(Tested, running on cluster)
| Tool/Library | Recommended version |
|---|---|
| Docker | 1.9.1 |
| Docker Compose | 1.5.1 |
| docker-py | 1.5.0 |
| IDL | 8.3 |
Install software
Note: Windows has not been tested yet
| Software | OS X | Linux | ||
|---|---|---|---|---|
| Python | Install https://www.python.org/downloads/release/python-2711/ | Should be preinstalled. Test with python --version Otherwise check here. | ||
| PIP (Python installer) | PIP is shipped with Python 2.7.9+ and Python 3.4+. pip --version If you don't have it follow https://pip.pypa.io/en/stable/installing/ | |||
| Python IDE | We suggest PyCharm, but any text editor or Spyder will work as well. | |||
| IDL | You can use your normal IDL setup to access data and prototype your algorithms. Note: We do not support execution of IDL code on our cluster due to licensing issues. Let us know if this is a problem. Please avoid SolarSoft/SSW-specific functionality in your algorithms. They tend to be hard to be ported to a cluster. | |||
Git (source code repository) |
|
| ||
Docker and docker-compose | Install https://www.docker.com/community-edition#/download
|
| ||
Setup Docker
Make sure you have decent internet connection.
On OS X
- Run "
/Applications/Docker.app", if needed - Open any terminal and continue
On Linux
Usually, the Docker daemon is started automatically.
If not, follow this guide: https://www.digitalocean.com/community/tutorials/how-to-install-and-use-docker-getting-started
Create a base directory for the FLARECAST development infrastructure (e.g. mkdir ~/flarecast/dev-infra). We assume the following commands are executed in this directory.
# download the helper script local> curl -o infrastructure.sh https://dev.flarecast.eu/stash/projects/INFRA/repos/dev-infra/browse/infrastructure.sh?raw local> chmod a+x infrastructure.sh # setup infrastructure or update to most recent version local> ./infrastructure.sh update # run development infrastructure local> ./infrastructure.sh run # when you want to stop the development infrastructure, press <CTRL> + C # cleanup everythin, this may be necessary in case of errors or old and incompatible containers # this will also remove all the data you sent to the hmi/property services local> ./infrastructure.sh clean # in case you need already generated data, add a flag "keep_db" local> ./infrastructure.sh clean keep_db
All FLARECAST docker containers can be found at DockerHub
Troubleshooting:
curl: SSL certificate problem: Invalid certificate chain (OS X only)
- Open Safari (not Firefox, Opera, Chrome or similar)
- visit https://dev.flarecast.eu
- A certificate warning should pop up. -> Click "Show Certificate"
- Click on "Trust" and set to "Always trust"
- Retry curl
curl: SSL certificate problem: unable to get local issuer certificate
- Run curl with the --insecure option
docker: cannot resolve hostname
1.
Test Docker
On OS X
After starting infrastructure.sh switch to "Kitematic"
Select Container "devinfrastest_webapp_1"
On the right side panel click on the arrow icon next to "Web Preview"
On Linux