AquamapsServiceAdminGuide
Aquamaps Service Installation
The Installation of the Aquamaps Service on top of a gCube container (gHN), cannot be performed by exploiting the dynamic deployment mechanism offered by the gCube framework.
Therefore a manual installation process need to be performed in order to install the service and its dependenceny and to correctly configure access to Aquamaps DB.
Aquamaps Service packages and dependencies installation
The current stable repository for gCube (v 2.2.1) can be found at :
https://grids16.eng.it/BuildReport/browse/Recent_Builds/org.gcube.2-2-1/BUILD_6
The following package has been released as part of gCube 2.2.1:
- org.gcube.application.aquamaps.aquamapsservice-servicearchive-2.4.2-0 [1]
The tar archive contains the following packages to install:
- Aquamaps Service gar
The Aquamaps Service package, to be installed inside a gHN container using the following command:
gcore-deploy-service org.gcube.application.aquamaps.gar
- Aquamaps stubs
The Aquamaps Service stubs library ( org.gcube.application.aquamaps.stubs.jar ) to be copied inside the gHN library folder ( $GLOBUS_LOCATION/lib )
- gCube GeoServer Interface library
The geoserverInt.jar automatically installed into the $GLOBUS_LOCATION/lib folder when installing Aquamaps Service gar, however it depends from the following packages which are distributed as part as the Geo Tools framework available from Geo Tools official website[2]:
- geoapi-2.3-M1.jar
- geoapi-pending-2.3-M1.jar
- geodb-0.3.jar
- gt-api-2.6.4.jar
- gt-arcgrid-2.6.4.jar
- gt-arcsde-2.6.4.jar
- gt-arcsde-common-2.6.4.jar
- gt-brewer-2.6.4.jar
- gt-charts-2.6.4.jar
- gt-coverage-2.6.4.jar
- gt-cql-2.6.4.jar
- gt-data-2.6.4.jar
- gt-db2-2.6.4.jar
- gt-directory-2.6.4.jar
- gt-epsg-extension-2.6.4.jar
- gt-epsg-hsql-2.6.4.jar
- gt-epsg-postgresql-2.6.4.jar
- gt-epsg-wkt-2.6.4.jar
- gt-feature-pregeneralized-2.6.4.jar
- gt-geotiff-2.6.4.jar
- gt-graph-2.6.4.jar
- gt-gtopo30-2.6.4.jar
- gt-image-2.6.4.jar
- gt-imageio-ext-gdal-2.6.4.jar
- gt-imagemosaic-2.6.4.jar
- gt-imagemosaic-jdbc-2.6.4.jar
- gt-imagepyramid-2.6.4.jar
- gt-jdbc-2.6.4.jar
- gt-jdbc-db2-2.6.4.jar
- gt-jdbc-h2-2.6.4.jar
- gt-jdbc-mysql-2.6.4.jar
- gt-jdbc-oracle-2.6.4.jar
- gt-jdbc-postgis-2.6.4.jar
- gt-jdbc-spatialite-2.6.4.jar
- gt-jdbc-sqlserver-2.6.4.jar
- gt-jp2k-2.6.4.jar
- gt-legacy-2.6.4.jar
- gt-main-2.6.4.jar
- gt-metadata-2.6.4.jar
- gt-postgis-2.6.4.jar
- gt-property-2.6.4.jar
- gt-referencing-2.6.4.jar
- gt-referencing3D-2.6.4.jar
- gt-render-2.6.4.jar
- gt-sample-data-2.6.4.jar
- gt-shapefile-2.6.4.jar
- gt-svg-2.6.4.jar
- gt-swing-2.6.4.jar
- gt-validation-2.6.4.jar
- gt-wfs-2.6.4.jar
- gt-wms-2.6.4.jar
- gt-xml-2.6.4.jar
- gt-xsd-core-2.6.4.jar
- gt-xsd-filter-2.6.4.jar
- gt-xsd-gml2-2.6.4.jar
- gt-xsd-gml3-2.6.4.jar
- gt-xsd-kml-2.6.4.jar
- gt-xsd-ows-2.6.4.jar
- gt-xsd-sld-2.6.4.jar
- gt-xsd-wfs-2.6.4.jar
- gt-xsd-wps-2.6.4.jar
- Third Party Libraries
The Following Third Party Libraries are automatically installed togheter with Aquamaps Service gar into the $GLOBUS_LOCATION/lib folder:
- commons-codec-1.3.jar
- commons-httpclient.jar
- csv4j_gcube.jar ( gCube specific extension to csv4j library)
- postgresql-8.4-701.jdbc3.jar
In addition the following libraries need to be manually installed under $GLOBUS_LOCATION/lib:
CMAR C-Square Mapper Software and dependencies Installation
The CMAR C-Square Mapper software ( http://www.marine.csiro.au/csquares/about-mapper.htm) is a perl utility which plots dataset exents on a range of base maps, according to a string of c-squares.
The original version running as web application has been modified in order to run on a gCube Hosting Node as well as on a gLite Working node. This way the software can be exploited by the gCube Aquamaps Service Suite to plot Aquamaps Species Distribution and Biodiversity Maps.
The customized version of the software can be download from :
-- Link to add --
The installation of the customized version of the C-Square Mapper on the gHN hosting the Aquamaps Service should be carried as follows:
- Untar the tar archive c-squaresOnGrid.tar.gz
- Move the c-squaresOnGrid folder under the $GLOBUS_LOCATION folder
Dependencies Installation
The C-Square Mapper software depends on third party libraries to be installed on the gHN host:
- Xplanet v.1.2.1 (http://xplanet.sourceforge.net/) [11]
The Xplanet tar archive should be installed under the /usr/local/share folder of the gHN host
- GD Library (http://www.libgd.org/Main_Page )
- perl GD Library (http://search.cpan.org/dist/GD/)
Mysql Installation and Aquamaps DB Import
AquaMaps Service is designed to work with a MySQL DB server 4.1.22, which documentation is available at MySQL official website[12].
Aquamaps Service Configuration
In order to configure the Aquamaps Service, the following configuration file need to be customized:
- $GLOBUS_LOCATION/etc/org.gcube.application.aquamaps/dbprop.properties: the credentials to contact the local mysql db need to be provided by specifying the dbusername and dbpassword values
- $GLOBUS_LOCATION/etc/org.gcube.application.aquamaps/geoserver.properties: this file contains the configuration parameters needed to customize the integration with the GeoServer Service.
- $GLOBUS_LOCATION/etc/org.gcube.application.aquamaps/pool.properties: performance configuration parameters regarding the size of the submitting queue
Aquamaps Publisher Installation
The Installation of the Aquamaps Publisher Service on top of a gCube container (gHN), can be performed by exploiting the dynamic deployment mechianism offered by the gCube framework.
For a manual installation the following steps need to be followed:
- Download the latest stable version of the Aquamaps Publisher [13]
- Untar the archive
- Deploy the Aquamaps Publisher gar file into the gHN container by typing:
gcore-deploy-service org.gcube.application.aquamaps.aquamapspublisher.gar
- Copy the aquamaps-publisher-stubs library (org.gcube.application.aquamaps.aquamapspublisher.stubs.jar) into the $GLOBUS_LOCATION/lib folder
In addition the following library need to be manually installed under $GLOBUS_LOCATION/lib
- Jetty v. 7.0.0 [14]
