Installation & aftermath

WARNING

This content and the child pages is deprecated in favour of the Readme on the main repository

WARNING


This page describes what are possible next steps after installation.

Table of Contents

Next steps to take

First steps - a basic tutorial

Check out this page on what steps to take next in order to get to know the system and the workflow with a step-by-step tutorial.

Tip!

This is especially useful if you are somewhat new to programming!

Usage tips

Did you just skip the tutorial? We really recommend having a look at it, but if you are sure here are some tips for more advanced users.

See the usage tips page for usage tips without a step-by-step guide.

Troubleshooting

In case you are running into problems during installation and running of the system.

See the troubleshooting page for troubleshooting.

Individual containers

For prerequisites and installation of individual containers, see their docker files, located in the (service)/docker folder in their respective repository.

Under the hood

Virtualbox is a utility that lets people creating virtual machines on your computer.

Vagrant is used as a tool to define VMs characteristics, that will be then run through Virtualbox - in other words, it is used so we can write a manifesto that defines the characteristics of a VM, and the VM generated has always the same characteristics. It is useful in this case to model the development VM just as if it was the server on which we will run the application.

Deployment

To aid deployment of the system there is a helper bash script `oms-docker/deploy.sh` that cleanly installs the newest version, as well as providing a way to keep the environment variables between versions. When deploying on fraktis.aegee.org (our public test server) this script should be used (located in `/srv/`).