Download

You can download the stable version of OWGIS as a Web archive (WAR) file from here, but we suggest you fork the source code on GitHub.

git clone git@github.com:olmozavala/OWGIS_V2.git

Build OWGIS

If you downloaded the WAR file, skip this section and go directly to Install. To build OWGIS from source it is recommended to use ant. OWGIS provides buildTemplate.xml, which ant can use to build the project. The only lines a new user usually needs to modify are local paths — typically the Tomcat (or other web server) install path on line 5:

<project name="OWGIS Template" default="help" basedir=".">
  <!-- Define the properties used by the build -->
  <property name="app.name"      value="OWGISTemplate"/>
  <property name="app.version"   value="1.0.0"/>
  <property name="tcserver.home" value="/usr/local/tomcat" />
  <property name="work.home"     value="${basedir}/work"/>
  <!-- ... -->
</project>

Build the WAR with:

ant -f buildTemplate.xml dist

This creates the Web archive in $OWGIS/dist.

Install

You need a servlet container such as Apache Tomcat. Version 8 can be downloaded here, or on Ubuntu:

sudo apt-get install tomcat8

Copy the WAR into $CATALINA_HOME/webapps, or upload it through the manager at http://localhost:8080/manager. Then open:

http://localhost:8080/OWGISV2Template/mapviewer

Configuration

Once OWGIS is installed, configure the look and content through a Java properties file and XML files. See the tutorials for documentation.

Quick start using Netbeans

Step 1. Clone the repository

git clone https://github.com/olmozavala/OWGIS_V2.git OWGISV2Template

Step 2. Create a new project in Netbeans

1. Delete buildTemplate.xml from the OWGISV2Template directory.
2. File → New Project (Ctrl-Shift-N)
3. Java Web → Web Application with Existing Sources → Next
4. Location: point to the root folder OWGISV2Template → Next
5. Select your server (Tomcat, JBOSS, etc.) → Next
6. If not set by default:
   • Web Pages Folder → OWGISV2Template/web
   • Web-INF Folder → OWGISV2Template/web/WEB-INF
   • Libraries Folder → OWGISV2Template/libraries
   • Source package folders → OWGISV2Template/src/java → Finish

Step 3. Common Netbeans configuration (Project Properties)

• Sources → Change source to JDK 7 if necessary
• Run → Relative URL → /mapviewer → Ok

Step 4. Test

Open http://localhost:8080/OWGISV2Template/mapviewer

Once the template works, modify layers and site look following Layer configuration.