Live GIS Disc Testing

''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.

= template =


 * Tests written for
 * .package. [version], arramgong [version]


 * Test Description last updated
 * .date.


 * Steps


 * .action.


 * Verify that ...


 * Eg: From menu, select GeoSpatial-&gt;Application-&gt;Start


 * Eg: Verify that a browser opens at url: http://localhost:... and shows the application start page.


 * Update the wiki with test results (after these test steps)


 * 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


 * link to bug reports


 * Add more test results below, most recent results at the top

= geoserver =
 * double click on "Start GeoServer"
 * wait for GeoServer to complete initialization..
 * when Firefox opens, click on "Layer Preview"
 * click on the 'OpenLayers' link on any layer
 * you should see a web page with sample data in an interactive map

= gvSIG =


 * Tests written for
 * gvSIG 1.9 (BN1253), arramgong 3.0rc2


 * Test Description last updated
 * 2010/03/10


 * Steps


 * Go to applications->education and start gvSIG


 * Verify that gvSIG starts correctly


 * Create a new view and add some shapefiles from /usr/local/share/mapserver/demos/itasca/data


 * Verify that the shapefiles are correctly added to the view


 * Create a new view and add any of the two TIFF files from /usr/local/share/mapserver/demos/itasca/data


 * Verify that the raster files are correctly loaded to the view


 * If you have Internet access, try to add a WMS layer from the combo list (i.e. the NASA JPL server)


 * Verify that a WMS layer can be accessed


 * Open the sample project included in the LiveDVD at /usr/local/share/gisvm/app-data/gvsig/sample-project.gvp


 * Verify the project loads all the data and layouts configured are available.


 * You can also try to access any of the other data available from the LiveDVD like the PostGIS Data, or WxS services by the map servers configured


 * This tests are related with the correct functioning of the other software installed on the LiveDVD


 * Update the wiki with test results (after these test steps)


 * 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


 * Click desktop icon "Start Geomajas" which will start the Geomajas startup script. This will in turn start up a Tomcat server.
 * Verify firefox opens a new tab at the page http://localhost:3420/geomajas-tutorial/applications/tutorial/html/


 * Click on the "Start demo!" link for the Attributes & Features demo.
 * Verify that a sample demo page has opened with an application, showing the provinces of Belgium.


 * Doubleclick on one of the rows in the attribute table bottom right.
 * Verify that a floating window appears, showing the rows' contents in more detail.


 * Click on the desktop icon "Stop Geomajas".
 * Verify that the Tomcat server that runs Geomajas has stopped.
 * This can be done by refreshing the page. Firefox should give a warning that it is unable to connect.


 * 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 =

= deegree =


 * Tests written for
 * deegree 2.2, arramagong 2.0/3.0-rc2


 * Test Description last updated
 * 4 March 2010


 * Steps


 * Click desktop icon "start deegree" which will run "catalina.sh start".


 * Verify firefox opens a new tab at the page http://localhost:8081/


 * Click the service links ("deegree-wms", "deegree-wfs", "deegree-wcs") in top left box ("deegree Web Applications").


 * Verify they open test pages for WMS, WFS, and WCS. These pages will contain links to
 * "GetCapabilities" (for each of the services)
 * "Test WMS", "Test WFS" or "Test WCS" (depending on the chosen service)
 * a link for the "Generic Client", a client for sending XML requests (http post) to the services.


 * Click on "TestW*S"


 * Verify you get either maps or xml fragments.
 * TestWMS will contain some images (results of WMS requests), and links for further KVP requests (http get).
 * TestWFS will open a page with several links for WFS requests (KVP). Either one will return XML fragments. There is also a link to the generic client.
 * TestWCS will open a page with several links for WCS requests (KVP). Either one will return XML fragments.


 * Click the client link ("deegree iGeoPortal") in top left box ("deegree Web Applications").


 * 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"


 * Click on the desktop icon "stop deegree"


 * Verify the deegree-tomcat process is stopped.
 * click any of the links previously used: you will get a "Failed to Connect" message from firefox.
 * open a terminal and try . You should not get any results other than the grep itself.


 * Update the wiki with test results (after these test steps)


 * 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 =

= udig =
 * open UDig
 * from the Layer menu, choose "Add..."
 * Choose Files; click on Next at the bottom of the dialog window
 * navigate to /usr/local/share/udig/udig-data/data-v1_2 
 * select bc_border.shp
 * you may also select others, for example all shp files starting with bc_
 * click OK
 * you should see Canadian British Columbia data

= openjump =
 * Tests written for
 * OpenJUMP, arramagong 2.0/3.0-rc2


 * Test Description last updated
 * 8 March 2010


 * Layer Theme with PostGIS backend
 * Open OpenJUMP
 * under the File menu select 'Open...'
 * select Data Store Layer
 * on the Connection line, click on the database icon (far right)
 * click on Add
 * enter Name: medford; Server: localhost; Port: 5432; Instance: medford; User: user; Password: user
 * click OK; click OK in the parent dialog box; you should be back in the Data Store Layer dialog
 * from the Dataset: menu choose 'medford_zoning'; click Finish
 * select the medford zoning layer at left under 'Working'
 * click on the Palette Icon in the menu bar
 * select the 'Colour Theming' tab; click 'Enable colour theming' checkbox
 * choose Attribute => zoning
 * choose a colour theme; click 'OK' to dismiss the dialog
 * you should see the zoning areas of Medford in various colours

= postgis =


 * Tests written for
 * PostGIS, arramagong 2.0/3.0-rc2


 * Test Description last updated
 * 4 March 2010

ST_Contains( medford_wards.the_geom, jacksonco_schools.the_geom ) ORDER BY medford_wards.council_me, jacksonco_schools.students DESC;
 * Spatial Query with the Graphical Query Builder helper
 * Open PGAdmin III from the Development menu
 * double-click on 'local'
 * under Databases, double-click on medford
 * open 'schemas'
 * open 'public'
 * select 'Tables', click on the 'Execute SQL' Icon above (it has a pencil in it)
 * expand the window and click on 'Graphical Query Builder'
 * open 'Schemas', double-click on 'public'
 * click and drag 'medford_wards' to the work area on the right
 * click and drag 'jacksonco_schools' to the work area on the right
 * choose 'jacksonco_schools' name, address, city and students
 * choose 'medford_wards' council_me (meaning council members)
 * click and drag from the_geom in 'medford_wards' to the_geom in 'jacksonco_schools' (you should see a solid line form with an '=' in it)
 * click on the 'SQL Editor' tab above, to navigate away from the Graphical Query Builder
 * edit the WHERE line to say
 * add an additional line
 * the entire query ends with one semicolon ';'
 * click on the 'execute query' icon above (a green triangle pointing to the right) you should see a list of council districts, schools, school sizes and the names of council members for each district as a result


 * 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

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

Then try to view it in QGIS.

= pgrouting =


 * Tests written for
 * pgRouting SVN trunk revision 356, arramagong 2.0/3.0


 * Last updated
 * March 2010


 * Steps


 * Open a terminal

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


 * File → Open → /usr/local/share/osm/Barcelona.osm.bz2


 * Gosmore


 * Open a terminal
 * Import data with:

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

= mapserver =

= geokettle =

= gmt =

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


 * Open a terminal

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


 * Double click on the GRASS desktop icon


 * Verify you see a slick "Welcome to GRASS" GUI


 * Select Spearfish60 for location, User1 for mapset
 * Click on [Start Grass]
 * In the Layer Manager GUI window add a raster layer
 * On the toolbar click the icon with a + and a checkerboard
 * On map to be displayed pull down the list and select elevation.dem
 * from the PERMANENT mapset and click [ok]
 * In the Layer Manager GUI window add a vector layer
 * On the toolbar click the icon with a + and a "V" line
 * For input map name pull down the list and select roads from the PERMANENT mapset and click [ok]
 * Over in the Map Display window toolbar click on the eyeball icon to render


 * Verify you see the maps displayed


 * See also


 * http://trac.osgeo.org/grass/wiki/HowToTestGrass6


 * (North Carolina dataset is already installed in grassdata/)


 * More details in the on-disc help page
 * http://grass.osgeo.org/grass64/manuals/html64_user/helptext.html

= qgis =


 * FIXME
 * These instructions are not tested! Just off the top of my head.


 * open GeoTiff


 * where on the disc is one?


 * (if needed geotiff and shapefile export could be added to the GRASS testing procedure to make some)


 * open PostGIS data I


 * From the menu: Layer → Add PostGIS Layer ...
 * PostgreSQL Connections: [New]

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!)


 * From the menu: Layer → Add PostGIS Layer ...
 * PostgreSQL Connections: [New]

Name: ________ "OpenStreetMap Import" Database: ____ "osm_barcelona"


 * Click on [Test Connect], with luck you will get a message that the connection to the database was successful.
 * Click [Ok] to close the New Database window.
 * Click on [Connect] in the top left of the Add PostGIS Table window. You should see a listing of tables come up.
 * Click on all of the table names to highlight them.
 * Click on [Add] at the bottom.
 * After some moments you should see the data displayed in the main map canvas.
 * Zoom, pan, query as you like.

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


 * open shapefile


 * where on the disc is one?
 * From the menu: Layer → Add Vector Layer ...


 * Do not select New Vector Layer ... (that's for creating new data, not opening existing data)


 * Dataset: [Browse]


 * ? where on disc ?


 * Ctrl-click on each of the *.shp files in that directory, then click [Open] and finally [Ok]
 * After some momements you should see the data displayed in the main map canvas.
 * Because the some of the shapefiles use a different map projection than the PostGIS database, things may not line up exactly. In the Settings → Projection Properties, Coordinate Reference System tab, you can tick the [•] Enable 'on the fly' CRS transformation box to overlay them. Be warned that this is computationally expensive and the layer may need to have its CRS set manually.
 * Zoom, pan, query as you like. Drag layer names up and down in the left-pane list to change their position in the stack.


 * open OSM data


 * need to enable plugin?
 * open /usr/local/share/osm/Barcelona.osm.bz2


 * Test the GRASS plugin


 * (it's installed, right?)
 * Go menu "Plugins, Pluginmanager, activate "GRASS plugin", OK button: a set of new buttons should appear
 * open location/mapset → ~/grassdata/spearfish90/PERMANENT
 * click "Add GRASS raster layer" button, select "elevation" map
 * click "Add GRASS raster layer" button, select "elevation_shade" map
 * click right mouse button in legend on "elevation_shade" map, move transparency to 40%
 * click "Add GRASS vector layer" button, select "roadsmajor" map, select layer "1-line" (level 1 is the topological level), OK

= mapnik = see "Mapnik Introduction" ( RC4 - in the Education menu, but the docs explicitly in error about versions)

= maptiler =

= marble =


 * Tested against ver 2.0


 * Click on the desktop icon
 * If you have used Google Earth before you should be able to figure this one out without much difficulty.
 * In the Settings menu select full-screen mode
 * Explore ...
 * In the bottom-left corner of the program window there is a subtle tab called "Map View". Click on it.
 * Select another map (e.g. 'Precipitation (July)')
 * Explore some more ...

= octave =


 * Open a terminal
 * Start program by typing "octave" at the prompt

% 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


 * Open a terminal
 * Type "opencpn_noaa_agreement.sh" at the prompt


 * Run program

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


 * Double click the OpenCPN icon on the desktop or type "opencpn" at a terminal
 * Left-click recenters the view
 * Left-click-drag pans the view
 * Mouse-wheel zooms in/out
 * The blue bars in the bottom show previews of overlapping maps and clicking on them switches to them.


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

= geopublishing =

= gpsdrive =


 * (copied from install_gpsdrive.sh)
 * More details in the on-disc help page

If no GPS is plugged in

 * Double click on the GpsDrive desktop icon
 * You should see a map of downtown Sydney, after about 10 seconds a waypoint marker for the Convention Centre should appear.
 * Set the map scale to 1:10,000 either by dragging the slider at the bottom or by using the +,- buttons (not magnifying glass)
 * Enter Explore Mode by pressing the "e" key or in the Map Control button.
 * Use the arrow keys or left mouse button to move off screen.
 * Right click to set destination and leave Explore Mode

Downloading maps

 * Change the scale setting to 1:1,000,000 you should see a continental map
 * Enter Explore Mode again ("e") and left click on the great barrier reef
 * Options -&gt; Map -&gt; Download
 * Map source: NASA LANDSAT, Scale: 1:500,000, [Download Map]
 * When download is complete click [ok] then change the preferred scale slider to 1:500,000
 * This will be of more use in remote areas.
 * Explore to the coast, click on an airport, headland, or some other conspicuous feature. You might want to use the magnifying glass buttons to zoom in on it better. Use a right click set the target on some other conspicuous feature nearby then demagnify back out.
 * Options -&gt; Map -&gt; Download
 * Map source: OpenStreetMap, Scale: 1:150,000, left-click on map to center the green preview over your target and what looks like a populated area.
 * [Download Map]
 * When download is complete click [ok] then change the preferred scale slider to 1:150,000 and you should see a (rather rural) road map. This will be more interesting in built up areas.

Overlay a GPX track

 * In the ~/.gpsdrive/tracks/ directory you will find australia.gpx which is a track line following the coastline.
 * Options -&gt; Import -&gt; GPX track
 * Hidden folders are hidden in the file picker, but just start typing ~/.gpsdrive and hit enter. You should then see the tracks/ directory and be able to load australia.gpx.
 * A red trace should appear along the coastline.
 * Check that it lines up well with the coast as shown in map tiles of varying scale.

If a GPS is plugged in

 * Make sure gpsd is running by starting "xgps" from the command line.
 * The program will automatically detect gpsd and jump to your current position. This should bring up a continental map as you won't have any map tiles downloaded for your area yet.
 * See the above "Downloading Maps" section to get some local tiles.
 * If you have a local GPX track of some roads try loading that and making sure everything lines up, as detailed in the above "Overlay a GPX track" section.

That's it.

= mb-system =


 * Open a terminal

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 ./mbm_plot_test5.cmd
 * 1) which creates this script:

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


 * (this also acts as a test of the GMT plotting package)

= mapfish =


 * Tested against ver 2.0


 * Make sure you have a working internet connection
 * Double click on the Mapfish icon on the desktop
 * After a few seconds the web browser should open and you should see a map of the southwestern pacific
 * Click the magnifying glass just under the word "Map" at the top of the map.
 * Zoom in on Sydney
 * Explore

= R =
 * double click on the R Icon
 * at the command line, type demo(graphics) and hit return
 * follow the prompt and watch the target window for examples

''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 ?

Some examples to try here:
 * http://r-spatial.sourceforge.net/xtra/xtra.RHnw.html

= ossim =

= ugvsigmobile =
 * Tests written for
 * Unofficial gvSIG Mobile for Linux 0.1.6, arramagong 3.0-rc2


 * Test Description last updated
 * 3 March 2010


 * Steps


 * Click menu icon "Applications / Geospatial Beta software / Unofficial gvSIG Mobile for Linux".


 * 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.


 * Click button 5 and choose EPSG:25833 in the top combo box.
 * Click button 3, choose "Rome (Italy) Aerial" in the bottom combo box and click on the button located to the right of the combo box (with a little triangle).


 * Verify that an aerial image of Rome appears after a few seconds.


 * Click button 3, click one of the [...] buttons.


 * Verify that a simple file browser opens up.


 * By clicking on the folder names (one click) and on the "Parent folder" button, go to the folder /usr/local/share/ugvsigmobile


 * Verify that the file CapitolineHill_25833.shp is listed in the box to the right.


 * Select that file (click on it once) and click the green "OK" button.
 * Check the check box located immediately to the left of the file name (to make it visible on the map) and click on the button located to the right of the [...] button you clicked before (little triangle).


 * Verify that the map moves to a bean-shaped little shapefile that contains the Capitoline Hill in the center of Rome.


 * Click button 3 and uncheck the check box you checked before (to make the shapefile invisible).
 * Click button 5 and choose EPSG:3857 in the top combo box.
 * Click button 3, choose "OSM Mapnik" in the bottom combo box and click on the button located to the right of the combo box.


 * Verify that the Mapnik tiles appear on the map.


 * Open this URL (it's a simple WMS request) in a new web browser tab or window.


 * Verify that you see a map including Africa, South America and Europe, possibly with some colorful icons on it.


 * Click button 3 and check the check box tagged as "Waypts".
 * Click button 5 and click the "Sync" button.


 * 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.


 * Click button 1 several times until a red circle is visible on it.
 * Click somewhere on the map. A new dialog will show. Choose random values for the attributes and click the green (accept) button. Repeat this step two or three times.
 * Click button 5 and push the "Sync" button.


 * Verify that after a few seconds you see a large dialog saying "Sync OK".


 * Click the green (accept) button.


 * Go back to the web browser tab or window you opened before and click on "Refresh".


 * Verify that the points you added appear now on the map.


 * Click button 6 and click "Quit"


 * Verify that the application diappears.


 * Update the wiki with test results.

= Main Documentation =


 * Tests written for
 * arramgong_3.0rc4


 * Test Description last updated
 * 11 March 2010


 * Steps
 * Double click on the help icon (a yellow sign with a wombat)
 * Verify that the firefox web browser opens at file:///usr/local/share/livedvd-docs/index.thml


 * Eg: From menu, select GeoSpatial-&gt;Application-&gt;Start
 * Eg: From menu, select GeoSpatial-&gt;Application-&gt;Start


 * Eg: Verify that a browser opens at url: http://localhost:... and shows the application start page.


 * Update the wiki with test results (after these test steps)
 * Confirm that Firefox is opened at startup
 * Confirm that it opens up at file:///usr/local/share/livedvd-docs/index.html
 * Confirm that the homepage is set to file:///usr/local/share/livedvd-docs/index.html
 * Confirm that you can see descriptions about the different projects.


 * test results from 11 March 2010
 * Run by: Cameron Shorter
 * System: VMWare Player, 2Gig RAM, on ubuntu 9.10
 * Version: arramagong 3.0 rc4
 * Results: Pass with issues


 * When Firefox starts for the first time, it asks for confirmation for the language pack plugins