Installation

This page describes how to install Wordpower.

System Requirements

You need the following software to be installed on your computer:

• A servlet container such as Apache Tomcat (http://tomcat.apache.org/). Wordpower was developed and tested on Apache Tomcat 6.0.
• WordNet has to be installed (http://wordnet.princeton.edu/). Note: if you're migrating an existing Wordpower installation, make sure to use the same version of Wordnet on both servers.

Installation Process

To install Wordpower three steps are necessary: download Wordpower, configure Wordpower, and deploy Wordpower. In the following each step is described in more detail.

Download

There are two ways of getting Wordpower, check out its code from the repository or download the latest release. It is recommended to use the latest release.

You can download the latest release of Wordpower here.

The latest version of the source code of Wordpower can be checked out using Subversion.

Configure Wordpower

There are three settings that need to be configured before deploying Wordpower: path to the database, path to WordNet, and admin users. If you downloaded the latest release, rename it from wordpower-vX.Y.Z.war to wordpower.zip and unzip the downloaded file. Then do the following.

web.xml

1. To configure the path to the database and the path to WordNet, open the file web.xml that is located in the folder WEB-INF.
2. In the XML file find the section that defines the database path and replace the param-value with the full path to the folder where the database files should be stored. Make sure that the database folder is modifiable by the servlet container.

   <context-param>
   	<param-name>Db4oDatabasePath</param-name>
   	<param-value>/path/to/wordpower/db/folder/</param-value>
   </context-param>
   

3. Then find the section that defines the path to WordNet and replace the param-value with the full path to your WordNet installation (e.g. /usr/local/WordNet-3.0 on a Unix system).

   <context-param>
   	<param-name>WordNetPath</param-name>
   	<param-value>/usr/local/WordNet-3.0</param-value>
   </context-param>
   

users.xml

To configure the admin password open the file users.xml in the folder WEB-INF/conf and change it as needed. You can add more admin accounts by adding additional user tags:

<user name="admin" password="password"/>

Deploy Wordpower

To deploy Wordpower first create a war-file from the modified code and then deploy it in your servlet container. If you update an existing Wordpower installation, make sure to restart your servlet container. Otherwise the database connection will cause problems.

If you downloaded the latest release of Wordpower as a war-file (and unzipped it) and if you are using a Unix-based system, you can create a war-file by navigating into the unzipped folder using a terminal. Then type

jar -cvf wordpower.war *

A new war-file will be create in the current folder.