Page History

...

Apache SIS is a spatial framework that enables better representation of coordinates for searching, data clustering, archiving, or any other relevant spatial needs. SIS is undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator PMCThe project home page is http://sis.apache.org.

This page describe the steps for running the 'webapp' module, which still in early draft. This page does not describe other modules like coordinate by referencing, metadata, NetCDF or Shapefile storage.

Downloading & Building SIS

The latest released source code can be obtained by visiting the downloads page. You can download the 'apache-sis-src.tar.gzzip' archive and run the following commands to unpack it to a local folder, for example as follows:

mkdir /usr/local/src
mkdir /usr/local/src/sis-site
tarunzip xzvf apache-sis-src.tar.gz -C /usr/local/src/sis-sitezip

You can also check out the latest code from the SIS Subversion repository. Below is an example command to get the latest code and copy it to folder /usr/local/src/sis-site:

...

See http://

...

sis.apache.org/

...

source.html.

SIS is based on Java 5 6 and uses the Apache Maven (version 23) build system. Once you have obtained the source files, to build SIS, run the following command from within the top source directory (e.g. /usr/local/src/sis-site):

mvn clean install

Eclipse

...

svn co https://svn.apache.org/repos/asf/sis/trunk/ sis-site
cd sis-site 
mvn test   # this will deploy the test resources and download and build necessary libraries
mvn eclipse:eclipse  

Open eclipse in a new workspace.
Go to Eclipse->Preferences->General->Workspace
Change Text file encoding to Other: UTF-8, Apply, Ok

Go to File-> Import -> General -> Existing Projects in Workspace
Choose the sis directory and import

or NetBeans Integration

See httpshttp://buildssis.apache.org/job/sis-trunk/site/develop.htmlsource.html#ide.

Running The SIS Web Application

...

Jetty is now supported as of 11th February 2012. After building SIS, navigate to the sis-webapp directory. To run the built-in Jetty server, run the following command:

mvn jetty:run

Running on Tomcat

...

Shut down Tomcat if it's already running:

$TOMCAT_HOME/bin/shutdown.sh

Copy the SIS web application from the SIS build directory to the Tomcat web applications directory. The SIS web application can be found in the 'sis-webapp/target' directory within your SIS source directory. The web applications directory for Tomcat 7 is by default '$TOMCAT_HOME/webapps'. For example, the following command will copy the SIS web application directory to the Tomcat webapps directory and rename it to 'sis'.

cp -R /usr/local/src/sis-site/sis-webapp/target/sis-webapp /$TOMCAT_HOME/webapps/sis

Create the following directories to store data returned from SIS queries. These can be created anywhere you like. The example below creates them within the SIS webapp directory:

mkdir $TOMCAT_HOME/webapps/sis/qtree
mkdir $TOMCAT_HOME/webapps/sis/geodata

Edit the '$TOMCAT_HOME/webapps/sis/WEB-INF/web.xml' file and add references to your data directories as follows:

<context-param>
  <param-name>org.apache.sis.services.config.qIndexPath</param-name>
  <param-value>/$TOMCAT_HOME/webapps/sis/qtree</param-value>
</context-param>

<context-param>
  <param-name>org.apache.sis.services.config.geodataPath</param-name>
  <param-value>/$TOMCAT_HOME/webapps/sis/geodata</param-value>
</context-param>

Modify the parameter for 'org.apache.sis.services.config.filePath' to point to the location of your 'sis-location-config.xml' file. By default, this is located in the 'WEB-INF/classes' directory of the SIS web application:

<context-param>
  <param-name>org.apache.sis.services.config.filePath</param-name>
  <param-value>/$TOMCAT_HOME/webapps/sis/WEB-INF/classes/sis-location-config.xml</param-value>
</context-param>

You can use the 'sis-location-config.xml' file to configure the RSS feeds that SIS will process. Feeds can be added by inserting their URLs into the 'sis-location-config.xml' file between <url> ... </url> tags, as in the following example:

<url>http://earthquake.usgs.gov/earthquakes/catalogs/shakerss.xml</url>

After making the above changes to the SIS web application configuration files, restart Tomcat with the following command:

$TOMCAT_HOME/bin/startup.sh

...

On loading the page, you should see the Apache SIS logo, a simple form and a map. Use the form to enter some queries and return results from RSS feeds to SIS on the map. Below are two example queries to try:

Bounding Box:

Lower Left: Latitude: 0, Longitude: 50
Upper Right: Latitude: 50, Longitude: 100

Point Radius:

Latitude: 0
Longitude: 80
Radius: 400km

...