Download

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

git clone Esta dirección de correo electrónico está siendo protegida contra los robots de spam. Necesita tener JavaScript habilitado para poder verlo.:olmozavala/OWGIS_V2.git

Build OWGIS

If you downloaded the WAR file, then you can skip this section and go directly to the Install section. To build OWGIS directly from source it is recommended to use ant, to ease the building process. In this case, OWGIS provides a configuration file buildTemplate.xml which can be used by ant to build the project. The only lines that a new user may need to modify are the ones that correspond to local paths. These are the first lines of the file, and you normally will modify only the path where Tomcat (or another web server) is installed. (line 5 in buildTemplate.xml).

<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"/> ... 

The next step is to build the WAR with:

ant -f buildTemplate.xml dist

This step will create the Web archive in the folder $OWGIS/dist.

Install

You need a servlet container in order to deploy the WAR file, like the Apache Tomcat. Version 8 of Tomcat can be downloaded here or if you happen to have Ubuntu on your machine is as easy as typing:

sudo apt-get install tomcat8

Once you have Tomcat installed, copy the war file into the $CATALINA_HOME/webapps folder or upload the file using the manager normally http://localhost:8080/manager Finally access the OWGIS template by going to http://localhost:8080/OWGISV2Template/mapviewer

Configuration

Once OWGIS is installed, you can configure the look and content of the Web Site. This is done through a Java properties file and some XML files. Go to the tutorials menu for documentation on how to do it.

Quick start using Netbeans

Building a Netbeans project for OWGIS is very easy.

Step 1. Clone the repository:

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

Step 2. Create a new project in Netbeans

Delete `buildTemplate.xml` file (from OWGISV2Template directory)
File -> New Project (Ctrl-Shift-N)
Java Web -> Web Application with Existing Sources (Next)
Location: point to the root folder "OWGISV2Template" (Next)
Select your server (Tomcat, JBOSS, etc.) (Next)
If not set by default set:
    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 (in Project Properties)

Sources -> Change source to JDK 7 if necessary
Run -> Relative URL -> /mapviewer (Ok)

Step 4. Test your OWGIS Template at http://localhost:8080/OWGISV2Template/mapviewer

Once OWGIS template is working, you can modify the layers shown in the map as well as the look of the website by following the documentation at Layer configuration.