This page describes how to test each application installed on the Live GIS Disc. Application test steps describe how an Ubuntu user who is unfamiliar an application can try it out and confirm that everything has been installed correctly within 5 minutes. Test Results document when the application was last verified to be working.

This page is maintained at: http://wiki.osgeo.org/wiki/Live_GIS_Disc_Testing and copied onto each release of the LiveDVD.

Contents

template

Tests written for
.package. [version], arramgong [version]
Test Description last updated
.date.
Steps

Verify that ...
Eg: Verify that a browser opens at url: http://localhost:... and shows the application start page.
test results from .date.
Run by: FirstName LastName
System: VMWare Player, 2Gig RAM, on ubuntu 9.0 base
Version: distribution version: eg: arramagong 3.0 rc2
Results: Pass, Pass with issues, Fail
Add more test results below, most recent results at the top


geopublishing (geopublisher and atlasstyler)

Tests written for
Geopublisher and AtlasStyler 1.4, Arramgong 3.0rc5
Test Description last updated
12.03.2010
Steps

Let that be the basic testing for Geopublisher now.

test results from 16 March 2010
Run by: Stefan Tzeggai
System: kvm, 600Mb RAM, on ubuntu 9.10 base
Version: arramagong 3.0 rc5
Results: Pass with issues. Two minor problems:

geoserver

Tests written for
GeoServer 2.0.1, arramagong 3.0rc4
Test Description last updated
13 March 2010
Steps
Verify the GeoServer web page opens at http://localhost:8082/geoserver/web
Verify you get a list of map layers
Verify you should see a web page with sample data in an interactive map
test results from 13 March 2010
Run by: Cameron Shorter
System: VMWare Player, 2Gig RAM, on ubuntu 9.10 base
Version: arramagong 3.0 rc4
Results: Pass

gvSIG

Tests written for
gvSIG 1.9 (BN1253), arramgong 3.0rc2
Test Description last updated
2010/03/10
Steps

Verify that gvSIG starts correctly
Verify that the shapefiles are correctly added to the view
Verify that the raster files are correctly loaded to the view
Verify that a WMS layer can be accessed
Verify the project loads all the data and layouts configured are available.
This tests are related with the correct functioning of the other software installed on the LiveDVD
test results from 2010/03/10
Run by: Jorge Sanz
System: Sun Virtual Box 3.1.4, with 700MB RAM for the VM
Version: distribution version: arramagong 3.0 rc2
Results: Passed all tests, well I wrote them at this session ;-)

geomajas

Tests written for
Geomajas 1.4.2, arramagong 2.0/3.0-rc2
Test Description last updated
9 March 2010
Steps

Verify firefox opens a new tab at the page http://localhost:3420/geomajas-tutorial/applications/tutorial/html/
Verify that a sample demo page has opened with an application, showing the provinces of Belgium.
Verify that a floating window appears, showing the rows' contents in more detail.
Verify that the Tomcat server that runs Geomajas has stopped.
test results from 9 March 2010
Run by: Pieter De Graef
System: Virtualbox, ~512MB RAM, on Windows XP
Version: distribution version: arramagong-3.0rc2
Results: Pass

geonetwork

Tests written for
Geonetwork, LiveDVD 3.0
Test Description last updated
14 March 2010
Steps

Result

deegree

Tests written for
deegree 2.2, arramagong 2.0/3.0-rc2
Test Description last updated
4 March 2010
Steps

Verify firefox opens a new tab at the page http://localhost:8081/
Verify they open test pages for WMS, WFS, and WCS. These pages will contain links to
Verify you get either maps or xml fragments.
Verify this will open a new tab with a list of available WebMapContexts. Either one of these links (Utah, SaltLakeCity or Playground) should open a full working portal in this tab. Once the WMC is loaded you may switch to the other WMCs by using the drop down box labled "Theme selection"
Verify the deegree-tomcat process is stopped.
test results from 4 March 2010
Run by: Judit Mays
System: Virtualbox, ~600MB RAM, on ubuntu 9.0 base
Version: distribution version: arramagong-3.0rc2
Results: Pass

kosmo

Tests written for
Kosmo 2.0 RC1, LiveDVD 3.0
Test Description last updated
18 March 2010

Theming layer with PostGIS backend

Shapefile and image loading


test results from 18 March 2010
Run by: Sergio Baños
System: VirtualBox 3.1.4 with Guest additions, 3Gb RAM, on Windows Vista
Version: 3.0 rc5
Results: Pass


udig

Tests written for
udig , arramgong 3.0rc5
Test Description last updated
18 March 2010
Steps
Verify you see a Welcome screen
Verify you see Canadian British Columbia data
test results from 14 March 2010
Run by: Cameron Shorter
System: VMWare Player, 2Gig RAM, on ubuntu 9.10 base
Version: distribution version: arramagong 3.0 rc4
Results: Pass with issues

openjump

Tests written for
OpenJUMP, arramagong 2.0/3.0-rc2
Test Description last updated
8 March 2010

Layer Theme with PostGIS backend

postgis

Tests written for
PostGIS, arramagong 2.0/3.0-rc2
Test Description last updated
4 March 2010

Spatial Query with the Graphical Query Builder helper 
 ST_Contains( medford_wards.the_geom, jacksonco_schools.the_geom )

 ORDER BY medford_wards.council_me, jacksonco_schools.students DESC;


test results from 4 March 2010
Run by: Brian Hamlin
System: Virtualbox, 1024mb RAM, on debian 5.03 base
Version: distribution version: arramagong-3.0rc2
Results: user tested, passed in less than 5 minutes with no previous experience


New Database 
$ createdb -T template_postgis osm_barcelona
$ osm2pgsql -d osm_barcelona  /usr/local/share/osm/Barcelona.osm.bz2

Then try to view it in QGIS.

spatialite

Tests written for
spatialite, LiveDVD 3.0
Last updated
14 March 2010
Steps 

spatialite /usr/local/share/spatialite/regions.sqlite
select r.NOME_REG, a.Nome from Aeroporti a, reg2008_s r where CONTAINS( r.Geometry, a.Geometry ) order by r.NOME_REG;
a graphical view of the same data

open file /usr/local/share/spatialite/regions.sqlite

Result - test please

You should see a set of Airports in Italy

pgrouting

Tests written for
pgRouting SVN trunk revision 356, arramagong 2.0/3.0
Last updated
March 2010
Steps 

sudo -u user psql -c "SELECT gid, AsText(the_geom) AS the_geom FROM dijkstra_sp_delta('sydney', 101, 114, 0.003)"  sydney
sudo -u user psql -c "SELECT gid, AsText(the_geom) AS the_geom FROM astar_sp_delta('sydney', 101, 114, 0.003)"  sydney
sudo -u user psql -c "SELECT gid, AsText(the_geom) AS the_geom FROM shootingstar_sp('sydney', 8, 24, 0.1, 'length', true, true)"  sydney

After each command you should see some output which is not hopefully 'library not found' error.

osm

JOSM

Gosmore 

bzip2 -dc /usr/local/share/osm/Barcelona.osm.bz2 | gosmore rebuild

mapserver

Tests written for
MapServer 5.6.1, arramagong 3.0rc4
Test Description last updated
13 March 2010
Steps
Verify the MapServer web page opens at file:///usr/local/share/livedvd-docs/doc/mapserver_description.html
Select "Basic Application" and click on "Initialize".
Verify you get a map.
Verify you get a list of features.
Verify you get a map and a legend with icons rendered.
Verify that the documentation version is appropriate versus the MapServer version.
test results from 14 March 2010
Run by: Cameron Shorter
System: VMWare Player, 2Gig RAM, on ubuntu 9.0 base
Version: arramagong 3.0 rc4
Results: Pass with issues

geokettle

Tests written for
GeoKettle 3.2.0-20090609
Last updated
March 2010
Steps
Verify you get a window prompting you to select a repository.
Verify the GeoKettle application is opened.
Verify you see the "intersection" transformation in the work area, with a big yellow comment box and some step icons.
Verify you see the result in the "Examine preview data" dialog (two rows with four columns: GEOM1_ID, geom1, GEOM2_ID, geom2. The geom1 and geom2 fields should contain MULTIPOLYGON WKT geometries).
test results from 13 March 2010
Run by: Cameron Shorter
System: VMWare Player, 2Gig RAM, on ubuntu 9.10 base
Version: arramagong 3.0 rc4
Results: Pass

gmt

There are 29 example jobs built in, and a script to run them all: 

cp -r /usr/share/doc/gmt-examples/examples/ gmt-examples
cd gmt-examples/
./do_examples.sh

[whiz .. bang .. whirl]

View results: (type 'q' to quit gv) 

for PLOT in `find . -name *.ps` ; do
   echo "$PLOT"
   gv "$PLOT"
done

Cleanup: 

cd ..
rm -rf gmt-examples/

grass

Tests written for
grass 6.4.0rc5, arramagong 2.0/3.0
Last updated
March 2010
Steps

Verify you see a slick "Welcome to GRASS" GUI
Verify you see the maps displayed
See also
(North Carolina dataset is already installed in grassdata/)
test results from 14 March 2010.
Run by: John Tate
System: VirtualBox v3.0.8_OSE r53138, 2Gig RAM, on ubuntu 9.10 base
Version: arramagong vm 3.0 rc4
Results: Pass (including extended test at ...wiki/HowToTestGrass6)


qgis

FIXME
These instructions are not tested! Just off the top of my head.
open GeoTiff
(if needed geotiff and shapefile export could be added to the GRASS testing procedure to make some)
open PostGIS data I 
    Name: medford
    Host: localhost
    Database: medford
    Port: 5432
    username: user
    password: user
    SSL Mode: allow

   Test Connect should show success
   select sample point, line and poly layers
   view selected data
open PostGIS data
(run the PostGIS test first so that the osm_barcelona DB exists!) 
Name: ________ "OpenStreetMap Import" 
Database: ____ "osm_barcelona"

This should at least prove to you that the database is correctly populated and running.

open shapefile
Do not select New Vector Layer ... (that's for creating new data, not opening existing data)
 ? where on disc ?
open OSM data
Test the GRASS plugin

mapnik

see file:///usr/local/share/livedvd-docs/doc/mapnik_description.html Mapnik Description

maptiler

Tests written for
maptiler 1.0 all versions
Test Description last updated
11.3.2010
Steps

Verify that ...

Alternative "real" geodata for testing are for example USGS maps or NOAA RNCs.

test results from 11.3.2010
Run by: Klokan Petr Pridal
System: VMWare Fusion, 512MB RAM in virtual machine, on MacOSX Leopard
Version: arramagong livedvd 3.0 rc4
Results: Pass

Another way to try it:

  1. Start MapTiler by clicking the icon on the Desktop
  2. Load in the second step example raster GEODATA (with georerence/srs)
  3. Go trough all the steps with 'Next' up to the Render
  4. Once the render is finished you can click in the GUI to open a folder with tiles. When you open googlemaps.html or openlayers.html then you see your geodata warped to the overlay of popular interactive web maps as Google Maps.

The map tiles are displayed directly from your disk. To publish the map to Internet just upload the folder with tiles to any webserver or Amazon S3"

marble

Tested against ver 2.0

octave 

% Which way to Barcelona from Sydney?
sydney = [-33.8750 151.2005]
barcelona = [41+23/60 2+11/60]

dirn = azimuth(sydney, barcelona);
deg_symb = 176;
disp(['Heading: ' num2str(dirn) deg_symb])

% How far's the trip? (roughly!)
system('proj -le')
wgs84_a = 6378137.0  % major radius of the Earth, in meters
dist_deg = distance(sydney, barcelona)
dist_meters = pi * wgs84_a * (dist_deg / 360.0)
disp(['Distance: ' num2str(dist_meters / 1000) ' km'])

Type "exit" to quit.

opencpn

Activate data
Run program

(assuming your GPS is not plugged in and gpsd is not running)

More details in the on-disc help page
and specifically the Getting Started help page.

gpsdrive

Testing

If no GPS is plugged in

Downloading maps
Overlay a GPX track

If a GPS is plugged in

That's it.

mb-system 

cd /usr/local/mbsystem/examples/

List summary information about the contents of some bathymetric data files: 

cd mbinfo/
./mbinfo.cmd

Grid some sample data and then view it: 

cd ../mbm_plot/
./mbm_plot_5.cmd

# which creates this script:
./mbm_plot_test5.cmd

You should now see a nice plot of the seafloor off Baja California.

mapfish

Tested against ver 2.0

R

If it is possible please add steps here to test the included geostats packages, they are both more interesting and more likely to have problems in the build. tx

e.g. something with r-cran-maps(.deb), gstat, sp, rgdal, or spgrass6 ? 
#Load a library
library(sp)
#list the demos available
demo()
#Run the demo from the sp package
#This will step you through several examples of code and the resulting plots
demo(gallery)


Some examples to try here:

http://r-spatial.sourceforge.net/xtra/xtra.RHnw.html

ossim

Tests written for
Ossim 1.8, arramagong 3.0rc4 + fixes
Test Description last updated
16 March 2010
Steps
Imagelinker
OssimPlanet
you should see the scene zoom to the location 
   ossim-image-info /usr/local/share/ossim/ossim_data/band1.tif

Note: to turn off the daylight auto-shading, un-check Preferences -> Environment -> Enable Ephemeris

test results from 16 March 2010
Run by: Cameron Shorter
System: VMWare Player, 2Gig RAM, on ubuntu 9.10 base
Version: distribution version: eg: arramagong 3.0 rc4 + fixes
Results: Pass with issues

ugvsigmobile

Tests written for
Unofficial gvSIG Mobile for Linux 0.1.6, arramagong 3.0-rc4
Test Description last updated
13 March 2010
Steps
Verify a new window opens up (size: 800 x 600 pixels approx.). From now on, buttons on the left side will be called (from top): button 1, button 2, button 3, button 4, button 5 and button 6. Button 1 is a cycle button with four different states corresponding to four different tools, so that active tool is the visible one.
Verify that an aerial image of Rome appears after a few seconds.
Verify that a simple file browser opens up.
Verify that the file CapitolineHill_25833.shp is listed in the box to the right.
Verify that the map moves to a bean-shaped little shapefile that contains the Capitoline Hill in the center of Rome.
Verify that the Mapnik tiles appear on the map.
Verify that you see a map including Africa, South America and Europe, possibly with some colorful icons on it.
Verify that after a few seconds you see a large dialog saying "Sync OK". Click the green (accept) button, which will take you to the map, where new red flags may have appeared.
Verify that after a few seconds you see a large dialog saying "Sync OK".
Verify that the points you added appear now on the map.
Verify that the application diappears.
Test results from 13 March 2010
Run by: Juan Lucas Dominguez jldominguez
System: Arramagong livedvd 3.0 rc4 ISO within Virtual Box on Windows Vista
Version: Arramagong livedvd 3.0 rc4
Result: Pass

osgearth

Tests written for
osgearth, LiveDVD 3.0
Last updated
14 March 2010
Steps 

 osgearth_simple /usr/share/osgearth/maps/nexrad.earth
Result - test please

You should see a globe with radar data over some parts of North America.

click to navigate; right-click or scroll wheel to zoom in and out.

hit the 'escape' key to quit

gdal / ogr

Tests written for
GDAL, LiveDVD 3.0
Last updated
14 March 2010
Steps 

 ogrinfo PG:dbname=medford
 ogrinfo PG:dbname=medford -so -al

 gdalinfo /usr/share/osgearth/data/terrain/mt_rainier_90m.tif
Result

You should see a summary of the contents of the medford PostGIS database, and of a geoTIFF of Mt Rainier

main documentation

Tests written for
arramgong_3.0rc4 + fixes
Test Description last updated
15 March 2010
Steps
Verify that the firefox web browser opens at file:///usr/local/share/livedvd-docs/index.thml
Verify that the browser opens with "Home", "Contents", "Contact and Support", "Tests", "Sponsors" tabs.
Verify the respective pages are opened.
Verify that each project is mentioned.
Verify that the project version numbers matches version numbers here: http://spreadsheets.google.com/ccc?key=0Al9zh8DjmU_RdGIzd0VLLTBpQVJuNVlHMlBWSDhKLXc&hl=en_GB
Verify that when clicking on each project title, a description page is opened. 
sudo apt-get install linkchecker

linkchecker /usr/local/share/livedvd-docs/index.html 2>&1 | tee /var/log/arramagong/linkchecker.log
Verify there are not errors in the log file
test results from 13 March 2010
Run by: Cameron Shorter
System: VMWare Player, 2Gig RAM, on ubuntu 9.10
Version: arramagong 3.0 rc4 + fixes
Results: Pass with issues

Windows Installers

Tests written for
arramgong 3.0rc5
Test Description last updated
20 March 2010
Steps
Verify the installers are the same version number as the rest of the DVD, as listed at http://spreadsheets.google.com/ccc?key=0Al9zh8DjmU_RdGIzd0VLLTBpQVJuNVlHMlBWSDhKLXc&hl=en_GB
Verify the application installs without errors
test results from 20 March 2010
Run by: Jody Garnett
System: Windows XP, with a burned DVD and 1Gig RAM
Version: arramagong 3.0 rc5
Results: Pass with issues

As emailed here: http://lists.osgeo.org/pipermail/live-demo/2010-March/001595.html

FWTools243

geonetwork-install-2.4.2-0

geoserver-1.7.6-ng

gpsbabel-1.3.6

gpsVPxp_0.4.18

gvSIG-update-1_1_2-windows-i586

Kosmo_Desktop_2.0-RC1_windows_jre

maptiler-1.0-beta2-setup

MgServerSetup-2.0.2.3011

ms4w_3.0-beta7

OpenCPN_136_Setup

QGIS-1.4.0-1-No-GrassSetup

udig-1.1.1

vcredist_x86

WinGRASS-6.4.SVN-r41454-1-Setup

Mac Installers

Tests written for
arramgong 3.0rc5
Test Description last updated
20 March 2010
Steps
Verify the installers are the same version number as the rest of the DVD, as listed at http://spreadsheets.google.com/ccc?key=0Al9zh8DjmU_RdGIzd0VLLTBpQVJuNVlHMlBWSDhKLXc&hl=en_GB
Verify the application installs without errors
Retrieved from "http://wiki.osgeo.org/wiki/Live_GIS_Disc_Testing"
© The Open Source Geospatial Foundation and LISAsoft 2010