This repository has been archived on 2023-11-20. You can view files and clone it, but cannot push or open issues or pull requests.
foam-extend4.1-coherent-io/vagrantSandbox/README

52 lines
2.3 KiB
Org Mode

# -*- 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]]
To make sure that for the boxes the have the newest
VirtualBox-additions do
: vagrant plugin install vagrant-vbguest
This installs a plugin that tries to update the guest addition if
they are for an older version of VirtualBox
* 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
- freebsd92 :: FreeBSD 9.2 32-bit machine. Untested
- freebsd10 :: FreeBSD 10.0 32-big machine. Currently does not boot
properly
- opensuse12 :: OpenSUSE 12.3 machine. Boots but is not provisioned
Some machines (read: the BSD-boxes) need the =VirtualBox Extension
Pack= installed (because they have USB 2.0)
* 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