You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »

Introduction

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 PMC.

Downloading & Building SIS

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

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

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:

svn checkout http://svn.apache.org/repos/asf/incubator/sis/trunk /usr/local/src/sis-site

SIS is based on Java 5 and uses the Apache Maven (version 2) 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

Running on Tomcat

The build consists of a number of components, including a web-based application ('.war') file that you can use to try out SIS features. You can run it on top of Apache Tomcat like this:

Shut down Tomcat if it's already running:

$TOMCAT_HOME/bin/shutdown.sh

mkdir /usr/local/sis
cd /usr/local/sis
cp -R /path/to/apache-sis-X.Y-src/sis-webapp/target/sis-webapp-X.Y.war ./
cp -R /path/to/apache-sis-X.Y-src/sis-webapp/src/main/webapp/META-INF/context.xml ./sis.xml
edit sis.xml (set the docBase to /usr/local/sis/sis-webapp-X.Y.war and the property
org.apache.sis.services.config.filePath to /usr/local/sis/sis-location-config.xml,
org.apache.sis.services.config.qIndexPath to /usr/local/sis/qtree,
org.apache.sis.services.config.geodataPath to /usr/local/sis/geodata)
cp -R /path/to/apache-sis-X.Y-src/sis-webapp/src/main/resources/sis-location-config.xml ./
edit sis-location-config.xml (add or delete GeoRSS URLs)
ln -s /usr/local/sis/sis.xml /usr/local/tomcat/conf/Catalina/localhost/sis.xml
/usr/local/tomcat/bin/startup.sh

Running on Jetty

Jetty is now supported too 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

Demonstration

Visit http://localhost:8080/sis/demo.jsp and checkout the demo!
Try some queries:

Bounding Box:
0, 50, 50, 100

Point Raidus:
0, 80, 400km

Mailing Lists

Discussion about SIS takes place on the following mailing lists:

  • sis-user@incubator.apache.org - about using SIS
  • sis-dev@incubator.apache.org - about developing SIS
  • sis-commits@incubator.apache.org - notifications on all code changes for SIS

The mailing lists are open to anyone and publicly archived.

You can subscribe to the mailing lists by sending a message to: sis-<LIST>subscribe@incubator.apache.org (for example, sis-user-subscribe@incubator.apache.org). To unsubscribe, send a message to sis<LIST>unsubscribe@incubator.apache.org. For more instructions, send a message to sis<LIST>-help@incubator.apache.org.

Issue Tracker

If you encounter errors in SIS or want to suggest an improvement or a new feature, please visit the SIS issue tracker. There you can also find the latest information on known issues and recent bug fixes and enhancements.

  • No labels