foam-extend4.1-coherent-io/vagrantSandbox

# -*- mode: org -*-
#+TITLE: Virtual machines for testing and Packaging
* Prerequisites
  These virtual machines require
  - VirtualBox :: for running from [[https://www.virtualbox.org]]
  - Vagrant :: to automatically set them up from [[http://www.vagrantup.com]]
* Starting
  A virtual machine is set up with
: vagrant up <machineName>
  will download a virtual machine image and set it up. It will then
  modify the image:
  - add packages required to compile OpenFOAM and package it
  - mount the directory of the sources
  - from this directory clone it to the local disc with mercurial or
    git (whatever the parent uses)
  One can then connect to the virtual machine with
: vagrant ssh <machinName>
  and will be in the =$HOME= directory of the user =vagrant= where in
  the directory =~/foam/foam-extend-3.0= the sources are
  available. Modifications can be pushed "outside" the virtual machine
  with
: hg push
  There is also a symbolic link =~/foam/foam-extend-3.0-parent=
  to the sources if you want to edit there directly. Use with care
  and don't compile in that directory unless you know what you're
  doing
* Virtual machines
  Currently existing virtual machines are
  - precise :: Latest LTS Ubuntu.
  - lucid :: Previous LTS Ubuntu. Currently problems
             with automatic setting up (something with the
             =postfix=-package)
  - maverick :: Tries to fix the problems with the
                =lucid=-machine. Not yet working
  - centos65 :: A CentOS 6.5 machine with preinstalled development
                tools
* Scripts
  In the home directory these scripts are found
  - bootstrapFoam.sh :: A script whose aim it is to compile Foam and
       the ThirdParty-packages in one go (no paraview and QT). If this
       works the box is considered operational