/SensorWebClient

The 52°North SensorWebClient provides easy access to timeseries data provided by web services of the Sensor Web domain.

Primary LanguageJavaGNU General Public License v2.0GPL-2.0

General Infos

project = 52North Sensor Web Client version = ${project.version} builddate = ${timestamp}

About

The SensorWebClient provides easy access to timeseries data stored within Sensor Observation Services (SOS). A station measuring the phenomenon of interest can easily be picked from a map, discovered by station's metadata. After a station has been chosen, the data can be loaded and displayed in the client as diagram for further investigation.

There is a Wiki page describing the Sensor Web Client in general and give access points to more resources of interest:

https://wiki.52north.org/bin/view/SensorWeb/SensorWebClient

Two deployment scenarios are possible.

  • Simple: only for timeseries visualization
  • Complex: Like simple scenario, plus event subscription

For the complex scenario be aware, that further web services are needed in the setup (see below).

Requirements

Software needed to be installed beforehand

  • Oracle Java JDK v1.6
  • Servlet Container (e.g. Apache Tomcat)

To setup an event subscription architecture further components are needed to be installed:

  • PostgreSQL 8.4 (or higher)

Further web applications involved:

  • 52n-ses-1.1.0.war
  • 52n-wns-2.1.1.war
  • 52n-notification-translator-1.1.1.war

Installation

Install all required software and prepare a database if you want to setup an event notification architecture. Deploy all web applications needed into your the servlet container.

The Sensor Web Client .war file can be found under /bin/sensorwebclient-webapp/.

Deploy it to your servlet container (copy into webapps folder or upload it via the container's manager tool). Wait until the Sensor Web Client grabs all information from configured SOS instances (takes some time). After that the client is available at

http://localhost:8080/sensorwebclient-webapp-${project.version}

Plugins/Ext API

By default the Sensor Web Client includes only the default SOS connector. The release provides further connectors:

  • sensorwebclient-eea
  • sensorwebclient-hydro

These are shipped in their own directories and can be placed into WEB-INF/lib folder so that those SOS dialects/profiles are also supported. Have a look at the ds/sos-instances.data.xml file for SOS instance examples.

The sensorwebclient-ext module provides an API which can be used to create permalinks to access to the Sensor Web Client. Please note that new SOS instances have to be known or at least supported by the client.

Build from Source

Sources are available under ./src directory.

Configure the sensorwebclient-build-example.properties file and build the client from command line using Apache Maven. You can separate several configuration contexts by renaming (the <new-context> part) and saving it under sensorwebclient-build-<new-context>.properties into your ${user.home}-folder. Build your context dependent Client instance by running

  mvn clean install -P env-dev -Denv=<context>

By default the Sensor Web Client build with the default SOS connection only. If you want to build and include another one, you have to activate the accoring profile, e.g. for the Hydro connector:

  mvn clean install -P env-dev,connector-hydro -Denv=<context>

For detailed installation and configuration explanation, please consult the Wiki page

https://wiki.52north.org/bin/view/SensorWeb/SensorWebClientInstallationGuide