Skip to content
Snippets Groups Projects
Commit 27f397cf authored by Swen Vermeul's avatar Swen Vermeul
Browse files

more info about vagrant

parent b1942217
No related branches found
No related tags found
No related merge requests found
......@@ -5,14 +5,16 @@ openBIS. You can download Vagrant from this website:
https://www.vagrantup.com
Vagrant needs a virtualizing software in order to run the virtual machine. Vagrant works well with many backend providers; by default it
works with VirtualBox (https://www.virtualbox.org/).
Vagrant needs a virtualizing software in order to run the virtual machine. Vagrant works well with many backend providers; by default it works with VirtualBox (https://www.virtualbox.org/), but you can use other providers as well. Vagrant acts like a remote control to start virtual machines.
When setting up a machine the first time, Vagrant reads a file called «Vagrantfile». This file contains information about which OS template to start with (we use CentOS 7). It then continues with all the shell commandos in order to set up our virtual machine.
## First Run
0. cd to src/vagrant
1. `vagrant plugin install vagrant-vbguest`
2. `vagrant up` -- this will provision a VM and install most software prerequisites (python, jupyterhub, etc.)
2. `vagrant up --provision --provider virtualbox` -- this will read Vagrantfile and provision a CentOS 7 VM and install most software prerequisites (python, jupyterhub, etc.). This can take a while and needs a fast internet connection too.
3. Download openBIS and put it in the vagrant folder so it is visible within the VM.
4. `vagrant ssh` -- log into the machine.
5. Install openbis
......@@ -26,8 +28,10 @@ works with VirtualBox (https://www.virtualbox.org/).
7. `exit` -- Reverse the sudo su openbis and return to being the vagrant user
8. `sync/initialize/start_services.sh` -- start openbis and jupyterhub
## Subsequent Runs
1. `vagrant up`
2. `vagrant ssh`
3. `sync/initialize/start_services.sh`
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment