Environment Setup - dibley1973/OpenRMS GitHub Wiki

This page describes the steps required to setup the environment that OpenRMS can be deployed to - not your local development environment (e.g. IDE/libraries).

The OpenRMS environment consists of the following servers:

• openrms-db (PostgreSql database server)

The environment creation has been automated, making it easy to bring up a consistent environment at home on your laptop, at work on your network, or on a cloud provider. Before you can bring up the environment, you need to install 2 tools - Vagrant and VirtualBox, so download:

https://releases.hashicorp.com/vagrant/1.8.6/vagrant_1.8.6.msi http://download.virtualbox.org/virtualbox/5.1.6/VirtualBox-5.1.6-110634-Win.exe

Note links for Windows only! Download a version for the OS you're using if not Windows.

Once installed, bring up a terminal window and navigate to your local repository directory, and install the vagrant host manager by typing the following command:

vagrant plugin install vagrant-hostmanager

Once installed, in the same window, type the following command:

vagrant up

This will take a while the first time you run the command.

It will create the virtual servers in VirtualBox, install their operating systems and provision them with the required software and configuration. Whenever you need to bring the environment back up (e.g. following a restart), re-run the vagrant up command.

Should a change ever be made to the server configuration, it may be necessary to run the following command in order to force vagrant to re-provision the box:

vagrant up --provision

Should you want to destroy the environment completely, run the following command:

vagrant destroy