History

Preinstalled virtual environment with ADAGUC Viewer and ADAGUC Server¶

For the workshop a preinstalled virtual machine is available. This machine has apache-tomcat, postgres, adaguc-services, adaguc-server, adaguc-viewer and apache httpd with php and cgi support installed.

The installation instructions can be found here: Install_Adaguc_on_Ubuntu

The following repositories are used:

https://github.com/KNMI/adaguc-services - Java application for running adaguc-server from tomcat or as a spring boot application
https://github.com/KNMI/adaguc-server - C++ server for serving WMS, WCS and OpenDAP
https://github.com/KNMI/adaguc-viewer - Javascript web client for connecting to WMS
https://github.com/KNMI/adaguc-datasets - Example dataset configurations

Installation of the virtual image¶

The virtual image can be downloaded from http://geoservices.knmi.nl/adagucworkshop/adaguc-xubuntu-2017.ova (8.5 Gb, when unpacked 20 Gb)
Install Oracle Virtualbox with the corresponding extension pack from https://www.virtualbox.org/wiki/Downloads
Start Virtualbox, click File -> Import appliance. In the settings, set the memory as high as possible, by default it is set to 2048Mb, but 4096Mb is recommended.
In the VM, just start firefox and the adaguc-viewer will show as default page
From the viewer, the AutoWMS plugin can be opened via clicking on the big gear and selecting AutoWMS from the list. A window on the right opens, displaying all files and folders available.

The VM exposes port 80 and 8080 to localhost, which means that links should work outside of the VM on the host as well.
Use the password "adaguc" to obtain sudo rights

Important directories and files¶

/src/KNMI/adaguc-server - Git repo where adaguc-server is installed, compiled with gcc, and location where default configuration files are stored. Compiled with "bash compile.sh"
/src/KNMI/adaguc-services - Git repo where adaguc-services is installed, build with maven and deployed in webapps dir
/src/config/adaguc-services-config-tomcat.xml - Adaguc-services configuration file. Note: this is the tomcat web application to run adaguc-server.
/src/KNMI/adaguc-server/data/config/adaguc.vm.xml - Adaguc-server configuration file, this file is in the adaguc-server repository on github
/src/log - Log file directory
/src/tomcatstarter.sh - Tomcat startup script
/src/crontab - Crontab to start tomcat
/src/apache-tomcat-8.0.44 - http://localhost:8080/ - Home of apache tomcat
- /src/apache-tomcat-8.0.44/webapps/adaguc-viewer - Adaguc viewer served with Apache tomcat
- /src/apache-tomcat-8.0.44/webapps/adaguc-services
/data/adaguc-autowms - Location where NetCDF files can be stored and are automatically available in a WMS via the source= kvp (http://localhost:8080/adaguc-services/adagucserver?source=<URL Encoded NetCDF file location)
/data/adaguc-datasets - Location where Adaguc dataset configurations are stored. Examples below.
/var/www/html - http://localhost/ - Documentroot of Apache http server
- /var/www/html/adaguc-viewer - Adaguc viewer served with Apache HTTP
/var/www/cgi-bin
- /var/www/cgi-bin/adaguc-datasets.cgi - OpenDAP server demo http://localhost/cgi-bin/adaguc-datasets.cgi/opendap/opendapdataset/RADNL_OPER_R___25PCPRR_L3_KNMI.nc
http://localhost:8080/adaguc-services/adagucserver? - Adaguc server via adaguc-services and apache tomcat
http://localhost/cgi-bin/adaguc-datasets.cgi? - Adaguc server via CGI and apache HTTP server

Adaguc viewer¶

The viewer is located at:
http://localhost:8080/adaguc-viewer/

The AutoWMS plugin can be opened via clicking on the big gear and selecting AutoWMS from the list. A window on the right opens, displaying all files and folders available.

Example NetCDF files¶

To update example NetCDF files, please run:

cd /data/adaguc-autowms/testsets
./update.sh

This will load new files from the KDC. (https://data.knmi.nl)

Links to dataset configuration examples:¶

These example configuration datasets are hosted at https://github.com/KNMI/adaguc-datasets
They can be linked into the service by doing: http://localhost:8080/adaguc-services/adagucserver?dataset=<dataset name>
See Dataset for details on how ADAGUC datasets work.
adaguc-datasets can be updated from github by doing:
- ```
cd /data/adaguc-datasets/
git pull
```

Radar - RADNL_OPER_R___25PCPRR_L3:

https://github.com/KNMI/adaguc-datasets/blob/master/RADNL_OPER_R___25PCPRR_L3.xml
/data/adaguc-datasets/RADNL_OPER_R___25PCPRR_L3.xml

UpdateDB command:

export ADAGUC_PATH=/src/KNMI/adaguc-server/
export ADAGUC_TMP=/tmp
cd /src/KNMI/adaguc-server
./bin/adagucserver --updatedb --recreate --config /src/KNMI/adaguc-server/data/config/adaguc.vm.xml,/data/adaguc-datasets/RADNL_OPER_R___25PCPRR_L3.xml

# The postgres DB can be checked by doing
psql "user=adaguc password=adaguc host=localhost dbname=adaguc" 
select * from radnl_oper_r___25pcprr_l3_knmi_time;

http://localhost:8080/adaguc-services/adagucserver?dataset=RADNL_OPER_R___25PCPRR_L3&service=wms&request=getcapabilities
http://localhost:8080/adaguc-viewer/?srs=EPSG%3A3857&bbox=90859.44342245569,6226189.307935331,1154637.6754393307,7127898.264872712&service=http%3A%2F%2Flocalhost%3A8080%2Fadaguc-services%2Fadagucserver%3Fdataset%3DRADNL_OPER_R___25PCPRR_L3%26service%3Dwms%26request%3Dgetcapabilities&layer=RADNL_OPER_R___25PCPRR_L3_COLOR%24image%2Fpng%24true%24default%241%240&selected=0&dims=time$2015-06-05T14:30:00Z&baselayers=streetmap$ne_10m_admin_0_countries_simplified

Himawari - adaguc.tiled:

TU Delft / RWS traffic demo - tud_traffic:

Last 100 earthquakes in NL - urn_xkdc_ds_nl.knmi__aardbevingen_nederland_2_

Actual 10 minute data from KNMI automated weather stations (Run cd /data/adaguc-autowms/testsets && ./update.sh first to get actual data from KDC) - urn_xkdc_ds_nl.knmi__Actuele10mindataKNMIstations_1_

Climatology of automated weather stations 1950-present - urn_xkdc_ds_nl.knmi__etmaalgegevensKNMIstations_1_:

Demo dataset - dataset_a:

Masking via DataPostProcessor - datapostproc_mask:

Viewer examples¶

The viewer has several examples located at http://localhost/adaguc-viewer/examples/

To see current radar images, go to:

http://localhost/adaguc-viewer/examples/animateradar_latest.php

Opendap Server¶

Besides being an OpenDAP client, adaguc-server has the capability to serve OpenDAP by itself. It can serve a set of files and concatenate those virtually over dimensions, e.g. aggregations are possible. To demonstrate this go to:

http://localhost/cgi-bin/adaguc-datasets.cgi/opendap/opendapdataset/RADNL_OPER_R___25PCPRR_L3_KNMI.nc.das

To view an OpenDAP URL with ncview, do:

ncview http://localhost/cgi-bin/adaguc-datasets.cgi/opendap/opendapdataset/RADNL_OPER_R___25PCPRR_L3_KNMI.nc

To view an OpenDAP URL with adaguc-server, do

http://localhost:8080/adaguc-services/adagucserver?source=http://localhost/cgi-bin/adaguc-datasets.cgi/opendap/opendapdataset/RADNL_OPER_R___25PCPRR_L3_KNMI.nc&service=wms&request=getcapabilities

In the viewer:
http://localhost:8080/adaguc-viewer/?srs=EPSG%3A4326&bbox=-1.4898835339861791,48.003163864360104,12.244851747183871,56.48619526075794&service=http%3A%2F%2Flocalhost%3A8080%2Fadaguc-services%2Fadagucserver%3Fsource%3Dhttp%3A%2F%2Flocalhost%2Fcgi-bin%2Fadaguc-datasets.cgi%2Fopendap%2Fopendapdataset%2FRADNL_OPER_R___25PCPRR_L3_KNMI.nc&layer=precipitation%24image%2Fpng%24true%24auto%2Fnearest%241%240&selected=0&dims=time$2015-06-05T15:55:00Z&baselayers=naturalearth2$ne_10m_admin_0_countries_simplified

Adaguc as OpenDAP client¶

http://localhost:8080/adaguc-services/adagucserver?source=<URL Encoded OpenDAP URL>
You can explore http://opendap.knmi.nl/

Project

General

Profile

ADAGUC » adagucserver

Wiki