Setting up Wandora Piccolo server

Wandora comes with a Java servlet based web application that can be used to publish a topic map created with Wandora. The samples folder contains a SampleWebApp. This page will describe how to setup your own simple web application using it as a starting point and how to customize the web application to suit your needs.

Requirements

You will need to setup and configure Apache Tomcat server. You will also need most of the external libraries needed by Wandora (see How to install Wandora).

Setting up the web application

Create a new folder for your web application in the webapps folder inside the Tomcat folder. Name it Wandora or whatever you want your web application to be called. Copy the contents in the SampleWebApp folder in the webapp folder you created. You will find SampleWebApp folder inside wandora samples folder.

Next you will have to edit several of the files you copied to match your system. If you named your web application something else that Wandora you will need to put this name in META-INF/context.xml file and WEB-INF/web.xml file. Also update all paths found in WEB-INF/web.xml and WEB-INF/classes/piccoloconfig.xml to match your environment.

Create a lib folder under WEB-INF folder and copy there all external libraries, i.e. all files, from the lib folder of Wandora installation directory. Also copy build/classes/com folder from Wandora installation folder under WEB-INF folder. That is, you should have a WEB-INF/com folder which will contain gripstudios folder which in turn will contain a complex directory structure with the compiled Java classes.

Now you should be able to start Tomcat and use the web application.