Conceptpower Installation (Outdated - v1.0)

Installing Conceptpower is quite easy. You need to have WordNet and a servlet container installed and you need to be able create war-files.

System Requirements

You need the following software to be installed on your computer:
  • A servlet container such as Apache Tomcat (http://tomcat.apache.org/). Conceptpower 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 Conceptpower installation, make sure to use the same version of Wordnet on both servers.
    OS X Mountain Lion or later:
    • Make sure that XQuartz is installed.
    • If you try to install WordNet on Mac OSX 10.8 or 10.9 you might get the following error:
      When you run ./configure it aborts with checking for Tcl configuration... configure: WARNING: Can't find Tcl configuration definitions and if you try to run make afterwards, you get the error make: *** No targets specified and no makefile found. Stop. If this happens, make sure that you have the XCode Command Line Tools installed. If you already have XCode installed, run xcode-select --install. A description of the problem is described here.
    • Another error you might encounter is:
      In file included from tkAppInit.c:16:
      /usr/include/tk.h:78:23: error: X11/Xlib.h: No such file or directory".

      You can find a description of how to solve that problem here.

Installation Process

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

Download

There are two ways of getting Conceptpower, 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 Conceptpower here.

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

Configure Conceptpower

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

web.xml
  1. To configure the path to the database, path to WordNet and the URI prefix, 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. <!-- Database paths --> <context-param> <param-name>Db4oDatabasePath</param-name> <param-value>/path/to/conceptpower/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>
  4. To change the default URI prefix or XML namespace (for REST interface) modify the following section as needed. <!-- XML/URI stuff --> <context-param> <param-name>URIPrefix</param-name> <param-value>http://www.digitalhps.org/concepts/</param-value> </context-param> <context-param> <param-name>XMLNamespace</param-name> <param-value>http://www.digitalhps.org/</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 Conceptpower

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

If you downloaded the latest release of Conceptpower 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 conceptpower.war * A new war-file will be create in the current folder.