Installation¶
1) Full installation instructions on Ubuntu LTS 16.04.2:¶
Instructions on how to install adaguc-services, adaguc-viewer and adaguc-server on ubuntu can be found here:
https://dev.knmi.nl/projects/adagucserver/wiki/Install_Adaguc_on_Ubuntu
These are also used to create the preinstalled virtual machine.
2) Docker¶
See the Docker page.
3) Quick install ADAGUCServer¶
When all prerequisites are met (Required libraries and a web server supporting CGI scripts), ADAGUC server can be installed in the following way:
- cd # Home dir
- git clone https://github.com/KNMI/adaguc-server
- cd ~/adagucserver
- bash compile.sh
- cp ~/adagucserver/data/cgi-bin/adaguc.testdata.cgi <your cgi-bin directory>
- chmod +x <your cgi-bin directory>adaguc.testdata.cgi
- ADAGUCServer is now accessible in your webbrowser via: http://<your host>/cgi-bin/adaguc.testdata.cgi?service=WMS&REQUEST=GetCapabilities
- This URL can be explored in an ADAGUC viewer with access to your host via "Add Layers"->"Add Custom WMS Service"->Enter your URL in the box and press "Enter"
- GetMap looks like http://bhw485.knmi.nl:8080/cgi-bin/adaguc.testdata.cgi?SERVICE=WMS&&SERVICE=WMS&VERSION=1.3.0&REQUEST=GetMap&LAYERS=testdata&WIDTH=1585&HEIGHT=1075&CRS=EPSG%3A4326&BBOX=30.894567523974764,-27.842459360000003,72.34692747602523,33.27567136&STYLES=testdata%2Fnearestcontour&FORMAT=image/png&TRANSPARENT=TRUEx%x%
- Complete!
Note: If CURL,GDAL and POSTGRESQL are missing, you can still compile by adding the following line before step 5:
export ADAGUCCOMPONENTS="-DADAGUC_USE_SQLITE"
This only uses SQLITE, without CURL, GDAL and POSTGRESQL, e.g. WMS ONLY! If you have all prerequisites, leave this out.
4) Quick install ADAGUCViewer¶
- cd <your documentroot directory>
- git clone https://github.com/KNMI/adaguc-viewer
- Visit http://<your host>/adagucviewer
- Complete!
Adjust adagucviewer/config.js to add your own services, or just use "Add Layers"->"Add Custom WMS Service"->Enter your URL in the box and press "Enter".
5) Complete installation instructions for other OS's¶
Installation on Ubuntu¶
There is a detailed description available for installing Adaguc on Ubuntu, this has been used to create the virtual machine available from Preinstalled_virtual_environment
Installation on Fedora, KNMI workstations¶
Installation on Red Hat 6 (related systems: Scientific Linux, Fedora)¶
Shell script and configuration file examples¶
- Shell script templates can be found here: https://dev.knmi.nl/projects/adagucserver/repository/show/data/cgi-bin The shell script template needs to be put in your cgi-bin directory. It sets environment variables and calls the adaguc executable. Make sure it has the right permissions: readable and executable by the webserver. See Overview for details.
- For sample config scripts you can look here: https://dev.knmi.nl/projects/adagucserver/repository/show/data/config
ADAGUC installation environment variables¶
Before you do compile.sh, you can set the environment variable ADAGUCCOMPONENTS to select which components to include. Possible components are:
- -DADAGUC_USE_GDAL - Compile with GDAL, enables the Web Coverage Service
- -DADAGUC_USE_POSTGRESQL - Compile with PostgreSQL, supports the PostGresql database
- -DADAGUC_USE_SQLITE - Supports the SQLITE database
- -DENABLE_CURL - Compile with CURL, used for cascaded WMS services.
- -DADAGUC_USE_KDCMONGODB - Compile KDC MongoDB support (boost and mongodb client required)
- -DADAGUC_USE_WEBP - Compile Google WEBP support for exporting images, needs package libweb-dev installed
By default -DENABLE_CURL -DADAGUC_USE_GDAL -DADAGUC_USE_SQLITE -DADAGUC_USE_POSTGRESQL are enabled.
You can select the ones you which via de environment variable ADAGUCCOMPONENTS. For example if you want a WMS without GDAL, PostgreSQL (No WCS!), you can set:
export ADAGUCCOMPONENTS="-DADAGUC_USE_SQLITE -DENABLE_CURL" # No GDAL or PostgreSQL: WMS Only