Getting started

This page describes the installation procedure of CoDAK on Debian/Ubuntu. For now, CoDAK is not packaged for any other OS.

To install, follow the steps below.

Enable the CoDAK repository

The following command will enable the CoDAK repository on your system (NOTE: the repository has moved - Oct 18, 2011).

echo 'deb http://downloads.sourceforge.net/project/codak/deb experimental main' \
| sudo tee /etc/apt/sources.list.d/codak.list

Download and install

Update the local package database:

sudo apt-get update

For a basic CoDAK installation, type:

sudo apt-get install codak-core

To install also the (optional) terms extension, type:

sudo apt-get install codak-terms

It may happen that you see the following error after apt-get install:

Failed to fetch http://downloads.sourceforge.net/project/codak/deb/pool/main/c/codak-terms/codak-terms_0.9.0+svn20111115-1_all.deb  Undetermined error

If that happens, most likely APT failed to fetch the file even though it is downloadable as normal. For the moment, the workaround is to fetch and install the file manually:

wget http://downloads.sourceforge.net/project/codak/deb/pool/main/c/codak-terms/codak-terms_0.9.0+svn20111115-1_all.deb

dpkg -i codak-terms_0.9.0+svn20111115-1_all.deb

(replace the filename with the actual filename shown in the error message)

Setup CoDAK

To complete the installation:

1. Point your browser to http://localhost:8080/codak/setup.vm. This will produce an error in your browser, saying that the page is protected.
2. Unlock the page by creating an empty file with a name as instructed.
3. Refresh the page in your browser.
4. Choose 'install database', which will setup the database and create an admin account.
5. Review the actions and remember the password of the 'admin' account. If you forgot it, you may reset the password by going back to this page and select 'reset admin account'.
6. Disable the setup page by removing the unlock file.
7. Go to http://localhost:8080/codak/ and start using your brand new CoDAK installation.

Frog

A Frog module is included in the codak-core package, but Frog itself must be installed separately for the module to work. Frog and its dependencies can be downloaded and installed from source by running its installation script:

install-ilktools

To test if Frog works, do:

frog -v

This should output something like:

frog 0.12.3(c) ILK 1998 - 2011
Induction of Linguistic Knowledge Research Group, Tilburg University

Ontology connection

The ontology connection requires a working installation of Sesame.

1. Download the Sesame files here (choose zip or tar.gz): http://www.openrdf.org/download.jsp
2. Unpack the archive and install the WAR files (located in the war directory) in a servlet container. In case of Jetty on Ubuntu, simply copy the files into the directory named /var/lib/jetty/webapps
3. Create a repository. Launch the Sesame client using the script named bin/console.sh in the Sesame archive which was unpacked in step 2. At the sesame prompt, enter the commands below.
4. Point CoDAK to the repository in the codak-terms configuration page, which is found in the web application under Wiki, Configure. Enter the repository URL (e.g. http://localhost:8080/openrdf-sesame) and ID (which must match the ID entered during repository creation).

Create repository at the Sesame command prompt:

connect http://localhost:8080/openrdf-sesame.
create native.

Support

Stuck in the installation process? Get help...