*****************************************
Tutorial on MC event generators and Rivet
*****************************************

Deepak Kar, Leif Lönnblad, Stefan Gieseke and Patrick Kirchgaeßer

at the MPI@LHC 2017 workshop in Shimla, India


*** Prerequisites *** 

This tutorial uses a virtual machine. Please install Oracle Virtual Box
on your personal computer prior to the tutorial. Due to time constraints
we cannot assist you with setting up software during the tutorial
itself. If you have questions regarding installation, please ask them
beforehand.


*** Download the virtual machine *** 

from

https://www.itp.kit.edu/mpi2017/

or 

<enter a local link?> 

and unpack the disk in a suitable directory using bunzip2.


*** Create the virtual machine ***

Create a new machine with VirtualBox using the GUI. In the first step,
VirtualBox will ask for the name of the machine and its OS. For the
latter choose Linux -> Debian (64 bit). In the next step, set the size
of the memory. About 2GB should be fine. In the last step, select the
virtual disk. Choose 'Use an existing virtual hard drive file' and open
the *.vdi file you just downloaded and extracted.


*** Starting the virtual machine ***

We are booting a lightweight Linux, which you can customize.

The login name is 'patrick', the password is 'rootformpi'.

The keyboard layout can be set by running setxkbmap LC in the terminal,
where LC is your language code (us, de,...).

Common tools which are installed include xterm, nano, evince and
firefox. If you need root privileges to install further programs of your
choice, use the same password as above.


*** Running the tutorial ***

Further instructions for the tutorial can be found in the directory
'Tutorials', where you will find README files, e.g. in 'Herwig' which
include pointers to more documentation.