Page History

h1. Content
{toc}

h1. Download the Virtual Machine
{info}
You will need 5 Gb for the installation file (.ova) + ~10 Gb free for the Virtual Machine. If you need to save some space, you can save 5 Gb of the .ova file by saving it on an external drive.
{info}

# Download the Virtual Machine installation file (.ova) on your local computer (your laptop, or a computer in which you have access to the admin/root account). The file is *5 Gb*, so plan the download accordingly (i.e., the sooner the better! :-) ). You can choose from:

h1. grab a copy of the virtual machine.

h1. Download Virtual Box or update it to version 4.2.10
# Download and install Virtual Box (if you have it already, be sure to have the very latest version, 4.2.10):
## Linux: there are many packages for all main distributions [https://www.virtualbox.org/wiki/Linux_Downloads]
## Mac: [http://download.virtualbox.org/virtualbox/4.2.10/VirtualBox-4.2.10-84104-OSX.dmg]
## Windows: [http://download.virtualbox.org/virtualbox/4.2.10/VirtualBox-4.2.10-84105-Win.exe]

h1. Install the virtual machine
See the following video ([watch it on YouTUBE if it does not work for you on confluence|http://www.youtube.com/watch?v=L1MKQihrJOA]) and the instructions below:

{html}
<iframe width="480" height="360" src="http://www.youtube.com/embed/L1MKQihrJOA" frameborder="0" allowfullscreen></iframe>
{html}

# Open virtual box, click on the File menu and choose "Import appliance"
# Click on "Open appliance", and select the file GRB_VM.ova you just downloaded. Then click "Next" ("Continue" on Mac)
# Just click on "Import" and wait for VirtualBox to import the Virtual Machine
# Voit la', the VM should show up in the list of installed VM. 


h1. Configuration
# Make a directory on your host machine:
cd ~
mkdir GRBWorkdir

# Share the GRBWorkdir folder between your computer and the Virtual Machine. See the following video ([watch it on YouTUBE if it does not work for you on confluence|http://www.youtube.com/watch?v=WgEI9TJYuGs]) and the instructions below:

{html}
<iframe width="480" height="360" src="http://www.youtube.com/embed/WgEI9TJYuGs" frameborder="0" allowfullscreen></iframe>
{html}


## Open Virtual Box, and click on the GRB_VM machine, then on Settings. 
## Go to "Shared folder" on the list on the left
## click on the "+" icon, then insert in the "Folder path" the path to the GRBWorkdir folder (or navigate there). Use "GRBWorkdir" as 'Folder Name' (if you use another name IT WON'T WORK!)
{info}
When you open the virtual machine you will find the GRBWorkdir directory in the home of the grb user (~/GRBWorkdir). All files you create there will be available on your computer even when the virtual machine is powered off.
{info}


h1. Starting the virtual machine and basic usage
{html}
<iframe width="480" height="360" src="http://www.youtube.com/embed/UmEmyLwIR6I" frameborder="0" allowfullscreen></iframe>
{html}

# Open Virtual Box, click on the virtual machine "GRB_VM" and click on "start"
# Wait for the system to boot
# To open a terminal, right click on an empty area of the desktop and select "Terminal"
# Your shared folder is in your home. You can always get back there by doing "cd ~/GRBWorkdir"
# The Google Chrome web browser is pre-installed. The VM share the same internet connection as your computer, so if your compute is online you can use Chrome in the VM to browse the internet, download data, etc.. directly on the VM
# The atom icon at the bottom left corner is a menu where you find all the installed applications
# To close the Virtual Machine select "Leave" and the "Shut down" from the menu.

h1. What you need to know about your new operating system
# There is only one regular user (grb), with password "glast"
# The password for the root user is "grbanalysis"
# Software
** A complete Scientific Linux 6.3 OS with KDE
** Fermi Science Tools 09-30-01
** gtburst
** Rmfit v. 4.3BA (just write "rmfit" in a terminal to use it)
** Heasoft 12.3 (Xspec, FTOOLS, Swift science tools)
** Root 5.26a
** Entough python free (Python 2.17, IPython 0.13, numpy, scipy, matplotlib and more)


h1. Update gtburst (within the virtual machine) 
* Open a terminal: Click “alt+F2” then write “terminal”, or write
“terminal” in the “start menu” then click on the Terminal icon
* “cd software/gtburst/gtburst-code/”
* “git pull”
* Done!
* Next time, you could use the “Update” function from inside
gtburst

h1. GRB130518A

This is trigger 390578080 / 130518580

See the circulars on this burst here:
http://gcn.gsfc.nasa.gov/gcn3_archive.html