Open Sensor Search (OSS) is a platform for discovery of in-situ sensor data. across all sensor web supporting major specifications (OGC SWE) and popular IoT websites (Xively, Thingspeak, ...). It spans across large scale networks based on powerful OGC Sensor Web standards and protocols (Sensor Observation Service, SensorML) and specific individual platforms by providing a modular and open architecture and a flexible mechanism to include data from many different sources.
OSS is written in Java and organized as a Maven multi-module project. The modules and their functionaliy are briefly desribed here, but they also contain their own README.md files with more detailed information.
- arsearch: service endpoints that can as callback URLs for popular augmented reality applications
- it: integration tests
- service: service implementation of the OSS API
- sir-common: common files for the SIR modules
- sir-it: integration tests for SIR API
- sir-json: json datamodel files
- website: browser user interface for the OSS API
The basic installation steps are:
- Download code from GitHub:
git clone https://github.com/52North/OpenSensorSearch.git - Build the project using Maven:
mvn install - Deploy the created web archives in a servlet container
- Add configuration files in home folder to override default settings.
- Create an new database for a user with the required rights to create new tables.
- If you use PostGIS < 9.1, make sure to use a postgis_template.
- If you use PostGIS > 9.1, the commands to install the extension are included in the database creation script. If you added the exentions manually please remove the respetive lines from the script.
- Make sure that the database user has sufficient rights on the database. If you create the db with the superuser
postgresthis might require an extra configuration step.
- Run the database creation script from the directory
service/src/main/resource/db - Edit your settings based on the file
service/src/main/resource/prop/org.n52.oss.service.db-sample.propertiesand save that file in the home folder of the machine running OSS. - Restart the service application
For details please check the PostgreSQL (http://www.postgresql.org/docs/) and PostGIS (http://postgis.net/docs/) documentation.
- Download and install solr 4.4.0: There are good tutorials for several platforms around, such as these for Debian/Linux: http://www.arunchinnachamy.com/apache-solr-installation-and-configuration/ and http://andreas-lehr.com/blog/archives/536-installing-apache-solr-on-debian-squeeze-6-0-and-tomcat7.html
- Download the solr configuration file from https://raw.github.com/52North/OpenSensorSearch/master/service/src/main/resources/db/solrconfig.xml and save it, e.g. as /tmp/solrconfig.xml
- Download the solr schema file from https://raw.github.com/52North/OpenSensorSearch/master/service/src/main/resources/db/solrschema.xml and save it, e.g. as /tmp/solrschema.xml
- Create a node in solr
- See http://wiki.apache.org/solr/CoreAdmin for a detailed description, and http://wiki.apache.org/solr/ConfiguringSolr for configuration options.
- Create a new core with the following call to the admin API:
.../admin/cores?action=CREATE&name=opensensorsearch&instanceDir=opensensorsearch&config=/tmp/solrconfig.xml&schema=/tmp/solrschema.xml&persist=true&loadOnStartup=true
The current implementation supports performance tests using both Apache JMeter and a dummy sensor generation which can be used to insert test data as well.
There are two classes in the test package that can fill your backend with the dummy sensors , namely
org.org.n52.sir.ds.solr.data.TempelateSensorTestorg.org.n52.sir.ds.solr.data.JSONSensorParserTest
Alternatively you can harvest sensors from remote platforms to fill you database.
The service is mostly configured with Guice-loaded named bindings based on a couple of configuration files. No Maven profiles are needed for building a configured service, instead you can overwrite all settings in the base files by adding your own configuration files to your user home directory (or the user home of the servlet container user on a server).
Several files have to be used so that Guice does not try to bind the same property twice, which results in creation errors. So if you configure a property from one base file in a different overwriting file you will have errors.
- server module
org.n52.oss.service.propertiesare added to (and potentially overwrite) the base filesrc/main/resources/app.propertiesorg.n52.oss.service.db.propertiesare added to (and potentially overwrite) the base filesrc/main/resources/prop/db.propertiesorg.n52.oss.service.sir.propertiesare added to (and potentially overwrite) the base filesrc/main/resources/prop/sir.properties
- website module
org.n52.oss.website.propertiesoverwrites the values in website module's filesrc/main/resources/org.n52.oss.website.properties
There are sample files in the same directories of the base file to get you started.
For organisational information about Open Sensor Search please visit the Wiki page.
If you want to join the Open Sensor Search developer team, take a look at the CONTRIBUTE.md file.
The integration tests can be activated during build with a Maven profile: mvn clean install -Pintegration-test
OSS is published under Apache Software License, Version 2.0.
See NOTICE file.
The website module uses a collection of Javascript libraries:
- AngularJS, https://github.com/angular/angular.js/blob/master/LICENSE - MIT License
- Angular-UI Bootstrap, https://github.com/angular-ui/bootstrap/blob/master/LICENSE - MIT License
- CodeMirror, http://codemirror.net/LICENSE - MIT License
- jQuery, https://jquery.org/license/ - MIT License
- Bootstrap, https://github.com/twbs/bootstrap/blob/master/LICENSE - MIT License
- angucomplete-alt, http://ngmodules.org/modules/angucomplete-alt - MIT License
- Swagger API Documentation
- swagger-js, https://github.com/wordnik/swagger-js - Apache Software License, Version 2.0
- jQuery BBQ, http://benalman.com/code/projects/jquery-bbq/docs/files/jquery-ba-bbq-js.html#License - MIT License
- underscore.js, https://github.com/jashkenas/underscore/blob/master/LICENSE - MIT License
- Backbone.js, http://github.com/jashkenas/backbone/blob/master/LICENSE - MIT License
- SocialSharePrivacy, https://github.com/patrickheck/socialshareprivacy - MIT License
- Handlebars.js, https://github.com/wycats/handlebars.js/blob/master/LICENSE - MIT License
- highlight.js, https://github.com/isagalaev/highlight.js/blob/master/LICENSE - BSD 3 clause license