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

Compare with Current View Page History

Version 1 Next »

Introduction

Apache SIS(TM) is a spatial framework that enables better representation of coordinates for searching, data clustering, archiving, or any other relevant spatial needs.

Downloading SIS

http://incubator.apache.org/sis

http://incubator.apache.org/sis/download.html

apache-sis-src.tar.gz

Building SIS

Download apache-sis-src.tar.gz and run the following command to unpack:

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

You can also check out the source code from the Subversion repository as follows:

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 Maven 2 <http://maven.apache.org/> build system. To build SIS, use the following command in the top source directory:

    mvn clean install

Running on Tomcat

The build consists of a number of components, including a web-based application
file (WAR) 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 02/11/2012). Simply build the project at the root level

mvn clean install

Then browse to the sis-webapp directory. To run the built-in Jetty server, type the 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

Notification on all code changes are sent to the following mailing list: sis-commits@incubator.apache.org

The mailing lists are open to anyone and publicly archived.

You can subscribe 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 at https://issues.apache.org/jira/browse/SIS. There you can also find the latest information on known issues and recent bug fixes and enhancements.

  • No labels