Difference between revisions of "Live GIS Disc Quick Start"

From OSGeo
Jump to navigation Jump to search
 
(23 intermediate revisions by 3 users not shown)
Line 1: Line 1:
The Arramagong image can be run in a number of different formats:
+
Looking to download a copy or read the help for the OSGeo Live DVD/USB/VM go to http://live.osgeo.org
  
= Click2Try: run from browser =
+
The page below and the list of other wiki pages are aimed at the developers of the project.
The old 2.0 Virtual Machine can be viewed from http://click2try.com from within a web browser with Java plugin enabled.
+
See also:
  
# Open http://www.click2try.com/catalog/Web-Development/Geospatial/Arramagong-GISVM/details
+
* [[Live GIS Disc Quick Start for Virtual Machines]]
# Click the big '''Try this application now''' button.
+
* [[Live GIS Disc Quick Start for USB]]
# Review the connection test results and fix, if necessary.
+
* Back to the [[Live GIS Disc]] main page
# Either wait for the application to launch or click the '''Launch App''' button.
+
* The [[Live GIS Disc FAQ]]
* Login to the Arramagong desktop using the login credentials in the Quick Start guide in the left pane of the window.
 
* You should see the icons for the Geospatial applications on the desktop. You can start and try any application.
 
* To save data, you'll need to apply for a free click2try account at http://www.click2try.com/component/user/?task=register.
 
  
= Arramagong Live DVD ISO =
+
=Running OSGeo-Live from a DVD=
  
== System Requirements ==
+
;System Requirements
 
* RAM: 512 Meg, preferably 1 Gig.
 
* RAM: 512 Meg, preferably 1 Gig.
 
* CPU: 1 GHz i686 or compatible (Intel/AMD)
 
* CPU: 1 GHz i686 or compatible (Intel/AMD)
* Spare Hard Disk Space: No hard drive required.
+
* Hard Disk:
: At least 3 Gig if you wish to install the operating system.
+
: None required if running directly from the DVD
 +
: At least 5 Gig if you wish to install the operating system.
 
* Mouse: a 3-button mouse is useful, especially for Mac trackpad users.
 
* 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 <nowiki>http://download.osgeo.org/livedvd/<image name>.iso</nowiki>
 
 
Note: if your image stops half way through, you can restart with:
 
wget -c <nowiki>http://download.osgeo.org/livedvd/<image name>.iso</nowiki>
 
 
If the image is to be downloaded in multiple parts, then you can put it together again with [http://www.7-zip.org 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"
+
; Download
 +
: Download .iso from http://download.osgeo.org/livedvd
  
== Burn the ISO onto a DVD ==
+
; Create DVD
Use your favourite program to burn the ISO to a DVD.
+
: Burn the ISO onto a DVD (or boot in a [[Live GIS Disc Quick Start for Virtual Machines|Virtual Machine]]
  
== Boot from the DVD ==
+
; Run
 
* Put the DVD into your computer's CD drive, then reboot your computer.
 
* 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 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.
 
<!-- Mac instructs for boot from CD? -->
 
<!-- Mac instructs for boot from CD? -->
 
* If you find yourself at a pretty login page simply press return or wait for the countdown to timeout.
 
* 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.
+
* Try the many applications from the "GeoSpatial" menu.
  
= Arramagong Live Virtual Machine =
 
  
''For full project details, refer to: [[Live GIS Disc]].''
+
= Installing and running in a Virtual Machine =
  
== System Requirements for VM ==
+
The exact instructions depend on the VM software you will use:
* RAM: 1 Gig, preferably 2Gig if you plan to run other applications as well
+
* [http://live.osgeo.org/quickstart/virtualbox_quickstart.html VirtualBox]
* 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.
+
* [[Live_GIS_Build#Run_the_the_ISO_in_a_QEMU_.2F_KVM_Virtual_Machine|KVM-Qemu]]
 +
* [[Live_GIS_Build#Creating_a_fresh_Virtual_Machine|VMWare]]
  
== Install a Virtual Machine ==
+
The basic idea is that you create an empty VM disk space (10-20gb is typical), mount the downloaded ISO image as a DVD (or CD) drive, then boot and [http://live.osgeo.org/quickstart/osgeolive_install_quickstart.html install to the VM disk from the Live DVD]. Once it is installed you can boot directly into the VM without having the DVD image attached.
Download a Virtual Machine player. [http://www.vmware.com/download/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 [http://www.virtualbox.org/ 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 ==
+
= Click2Try: run from browser =
Download the latest Arramagong VM from http://download.osgeo.org/livedvd.
+
(''this information now out-of-date?'')
On GNU/Linux use:
 
wget <nowiki>http://download.osgeo.org/livedvd/<image name>.7z</nowiki>
 
  
Note: if your image stops half way through, you can restart with:
+
The old 2.0 Virtual Machine can be viewed from http://click2try.com from within a web browser with Java plugin enabled.
wget -c <nowiki>http://download.osgeo.org/livedvd/<image name>.7z</nowiki>
 
 
 
If the image was downloaded in multiple parts you must put it back together again with [http://www.7-zip.org/ 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:
 
# install
 
sudo apt-get install p7zip-full
 
 
# uncompress
 
7z x <filename.7z>
 
 
 
On Mac OSX:
 
# sudo port install p7zip
 
 
# 7za x <filename.7z>
 
 
 
== Install in Virtual 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.
 
** Make a '''New''' virtual machine.
 
** When asked about the hard drive choose to use and existing image, in the subsequent dialogs add the vmdk you downloaded and choose it.
 
** Choose your RAM, video memory and other options.
 
** The image should now boot like any other Virtual Box image.
 
 
 
If the above doesn't work try to convert the vmdk to a vbox image
 
* 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 [https://wiki.ubuntu.com/UbuntuMagazine/HowTo/Switching_From_VMWare_To_VirtualBox:_.vmdk_To_.vdi_Using_Qemu_+_VdiTool#Converting%20your%20existing%20.vmdk%20Virtual%20Disc%20Image%20To%20a%20.vdi%20File Ubuntu wiki] to convert it on a linux box.
 
 
 
== 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.
 
 
 
 
 
= Install to a Live USB Stick =
 
 
 
You can install the ISO onto a USB drive. This will boot faster than the DVD and any work you do on the live system will be persistent. So you can carry your work around with you and use it on any PC you come across.
 
 
 
You will need a modern computer BIOS which allows you to boot from a USB-HDD device. (''if not, there are alternatives, see pendrivelinux.com's tutorials below'')
 
 
 
We recommend an empty 4GB (or larger) USB drive.
 
 
 
== Xubuntu 9.04 based LiveDVD ==
 
 
 
* [http://www.pendrivelinux.com/usb-boot-cd-for-xubuntu-904/ Install to USB from within the LiveDVD environment]
 
* [http://www.pendrivelinux.com/usb-xubuntu-904-persistent-install-windows/ Install to USB from within MS-Windows]
 
 
 
== Xubuntu 9.10 based LiveDVD ==
 
 
 
These tutorials from [http://www.pendrivelinux.com/ PenDriveLinux.com] give the method:
 
* [http://www.pendrivelinux.com/create-a-xubuntu-9-10-flash-drive-using-the-cd/ Install to USB from within the LiveDVD environment]
 
* [http://www.pendrivelinux.com/create-a-xubuntu-9-10-flash-drive-using-windows/ Install to USB from within MS-Windows]
 
 
 
;Quick-start:
 
 
 
Boot with the LiveDVD and plug in your USB drive.
 
From the main Ubuntu menu select:
 
Applications &rarr; System &rarr; USB Startup Disk Creator
 
 
 
Then choose your drive (partition actually) from the list (carefully!), select "Documents stored in extra space" and set the size to its maximum, and click "Make startup disk".
 
 
 
This tool wants your USB drive to start with an empty FAT32 partition.
 
 
 
 
 
== Tips ==
 
 
 
* The base install is compressed and static. All changes (package installs, upgrades, user files) reside in an uncompressed ext3 filesystem-file in the remaining space on the USB stick (which due to this tends to fill up rather quickly). So ultimately the USB stick isn't truly a "perpetual" install, but with careful use it could last you until the next release of the distribution is out.
 
 
 
* Setting the local timezone: run the <tt>tzselect</tt> program from the terminal prompt and follow the directions.
 
 
 
* Do not attempt to upgrade your kernel. You will mostly likely end up with an unbootable system. If this happens to you, you can still get your data off or attempt a manual repair. The compressed base system can be mounted with:  (e.g. from the Live-DVD)
 
mount /media/usbdrive/syslinux/file.squashfs mount_point/ -o loop -t squashfs
 
and the user data filesystem can be mounted with:
 
mount /media/usbdrive/casper/casper-rw mount_point/ -o loop
 
  
 +
# Open http://www.click2try.com/catalog/Web-Development/Geospatial/Arramagong-GISVM/details
 +
# Click the big '''Try this application now''' button.
 +
# Review the connection test results and fix, if necessary.
 +
# Either wait for the application to launch or click the '''Launch App''' button.
 +
* Login with user=user, password=user
 +
* You should see the icons for the Geospatial applications on the desktop. You can start and try any application.
 +
* To save data, you'll need to apply for a free click2try account at http://www.click2try.com/component/user/?task=register.
  
  
 
[[Category: Live-demo]]
 
[[Category: Live-demo]]

Latest revision as of 16:19, 5 February 2011

Looking to download a copy or read the help for the OSGeo Live DVD/USB/VM go to http://live.osgeo.org

The page below and the list of other wiki pages are aimed at the developers of the project. See also:

Running OSGeo-Live from a DVD

System Requirements
  • RAM: 512 Meg, preferably 1 Gig.
  • CPU: 1 GHz i686 or compatible (Intel/AMD)
  • Hard Disk:
None required if running directly from the DVD
At least 5 Gig if you wish to install the operating system.
  • Mouse: a 3-button mouse is useful, especially for Mac trackpad users.


Download
Download .iso from http://download.osgeo.org/livedvd
Create DVD
Burn the ISO onto a DVD (or boot in a Virtual Machine
Run
  • 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 the many applications from the "GeoSpatial" menu.


Installing and running in a Virtual Machine

The exact instructions depend on the VM software you will use:

The basic idea is that you create an empty VM disk space (10-20gb is typical), mount the downloaded ISO image as a DVD (or CD) drive, then boot and install to the VM disk from the Live DVD. Once it is installed you can boot directly into the VM without having the DVD image attached.


Click2Try: run from browser

(this information now out-of-date?)

The old 2.0 Virtual Machine can be viewed from http://click2try.com from within a web browser with Java plugin enabled.

  1. Open http://www.click2try.com/catalog/Web-Development/Geospatial/Arramagong-GISVM/details
  2. Click the big Try this application now button.
  3. Review the connection test results and fix, if necessary.
  4. Either wait for the application to launch or click the Launch App button.
  • Login with user=user, password=user
  • You should see the icons for the Geospatial applications on the desktop. You can start and try any application.
  • To save data, you'll need to apply for a free click2try account at http://www.click2try.com/component/user/?task=register.