Live GIS Disc Quick Start

= Arramagong Live DVD =

System Requirements

 * RAM: 512 Meg, preferably 1 Gig.
 * CPU: 1 GHz i686 or compatible (Intel/AMD)
 * Spare Hard Disk Space: No hard drive required.
 * At least 3 Gig if you wish to install the operating system.


 * Mouse: a 3-button mouse is useful, especially for Mac trackpad users.

Download the ISO Image
Download the latest arramagong-livedvd image from http://download.osgeo.org/livedvd.

On linux use: wget http://download.osgeo.org/livedvd/ .iso

Note: if your image stops half way through, you can restart with: wget -c http://download.osgeo.org/livedvd/ .iso

If the image is to be downloaded in multiple parts, then you can put it together again with 7zip on MS-Windows, or on Mac or Linux with: cat image.iso.1 image.iso.2 > image.iso

Another way to put these together on MS-Windows without 7zip is:

Open a Command-Prompt (cmd.exe), navigate to the parts folder and type "copy /B image.iso.1 + image.iso.2 image.iso"

Burn the ISO onto a DVD
Use your favourite program to burn the ISO to a DVD.

Boot from the DVD

 * Put the DVD into your computer's CD drive, then reboot your computer.
 * If your computer is set to boot from CD (as is often the case) you should boot up into an Xubuntu system, with Geospatial applications installed. Otherwise you'll have to adjust the BIOS boot settings or press the boot menu button just after powering-up.


 * If you find yourself at a pretty login page simply press return or wait for the countdown to timeout.
 * Try out the different applications from the desktop and from the Applications &rarr; Education menu.

= Arramagong GISVM as a Virtual Machine =

For full project details, refer to: Live GIS Disc.

System Requirements for VM

 * RAM: 1 Gig, preferably 2Gig if you plan to run other applications as well
 * Spare Hard Disk Space: 9 Gig to install the VM (at version FOSS4G 2009 alpha 4). This will likely increase to 13 Gig. 20 if you've got it.

Install a Virtual Machine
Download a Virtual Machine player. VMWare Player is recommended as the image has been built and tested using VMWare, however VMWare is a pain to install due to all the personal details you need to enter). If you are on linux, it is much easier to install VirtualBox, and the applications work almost as well, a few window resize glitches and the like. apt-get install virtualbox-ose

If you plan to build an image from scratch, you will need VMWare Server (and 2 Gig or RAM).

Download VM Image
Download the latest ArramagongGISVM from http://download.osgeo.org/livedvd. On GNU/Linux use: wget http://download.osgeo.org/livedvd/ .7z

Note: if your image stops half way through, you can restart with: wget -c http://download.osgeo.org/livedvd/ .7z

If the image was downloaded in multiple parts you must put it back together again with 7zip on MS-Windows, or on UNIXes with the command: cat image.7z.1 image.7z.2 > image.7z

Uncompress Image
You will need to uncompress the image using 7zip. Windows installers here: http://www.7-zip.org/

On linux: sudo apt-get install p7zip-full 7z x 
 * 1) install
 * 1) uncompress

Install in Virtual Box

 * As the Live GIS Disc is a VMWare virtual machine, you should convert it to the Virtual Box format. There are detailed instruction at the Ubuntu wiki to convert it on a linux box.


 * On recent versions of Virtual Box (tested on Sun Virtual Box 3.0.2) you can add to the virtual disks catalog the vmdk image without any conversion so the only thing you have to do is create a new VM and assign the disk to it.

Install in VMWare Player
Add details about how to set up the image ...

Test
For details about how to test each application, refer to Live GIS Disc Testing and the program links in the main help page, which can be found on the Live-image's desktop.