Getting started

wauter

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

If you use an old version of APT you will 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

The workaround is to upgrade APT or 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 (optional)

Depends: codak-core

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

MediaWiki connection (optional)

Depends: codak-terms

MediaWiki is used as a storage back-end for term descriptions.

To start using MediaWiki, download and install MediaWiki manually. Then, go to the wiki configuration page and update the "wiki prefix" field by entering the URL of your MediaWiki installation.

Depends: codak-terms

Wikilink uses Wikipedia to automatically detect links between terms. This should improve the relevance ranking of the terms. It takes about 1GB of disk space and setting it up may take several hours.

To install, just run and do something else in the meantime:

codak-wikilink-setup

Ontology connection (optional)

Depends: codak-terms

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 WAR files into the directory named /var/lib/jetty/webapps and restart Jetty.
  3. To see if Sesame is installed, point your browser to http://localhost:8080/openrdf-sesame . If you see an error, visit http://www.openrdf.org/
  4. 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 following commands:
connect http://localhost:8080/openrdf-sesame.
create native.
  1. 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).

The ontology is now ready for use. Use the "import" page in the wiki menu to import an RDF or OWL ontology.

Support

Stuck in the installation process? Get help...

Related

Home: Home

MongoDB Logo MongoDB