Overview

This pages summarizes the procedure of obtaining and installing the LKB software. The LKB is available as either a precompiled binary (for select platforms) or as Common-Lisp source code. Unless users do not have access to one of the hard- and software configurations for which ready-to-run binaries are provided or need to compile the sources because they have code of their own that requires interation with the LKB, we recommend you start out with a binary installation. It will be easier to set up and run. The complete LKB software is Open Source, see the LkbCopyright page for details. Users running a precompiled binary may choose to install the source code too, of course, for example when trying to decide how to customize LKB behavior, or simply as a somewhat low-level form of reference documentation.

Should you have any problems with installation, please email the support address for the LKB (and other LinGO resources): lingo@delph-in.net.

Supported Hard- and Software Platforms

We recommend the use of Linux. However Windows users can run recent versions of the LKB via Live CD: Knoppix LKB

The latest working binary of the LKB for MicroSoft Windows is the version at http://lingo.delph-in.net/builds/2004-09-17/. There are no newer binary versions due to unresolved licensing issues.

There is only limited support from the LKB developers for the Macintosh version; see LkbMacintosh for differences between this version and the LKB documentation.

Automated Installation

For Linux (x86) and Solaris (sparc), there is experimental support to perform a semi-automated installation. In a nutshell, users designate a top-level directory for DELPH-IN resources (which we will refer to as DELPHINHOME), download the installer, and then have everything downloaded and installed for them. This procedure will also work in Windows environments when the free CygWin environment is installed, but note that the wget utility must be requested explicity when installing CygWin. For Macintosh users, and Windows users without CygWin (or ones who cannot work out how to re-run the CygWin installer in order to add wget), please see the instructions for manual installation below.

Assuming you want all DELPH-IN tools and resources in a sub-directory delphin/ to your own home directory, try the following:

  wget http://lingo.delph-in.net/etc/install
  bash install --home ~/delphin

The installer should successively retrieve archive files from the LKB download site and generate reassuring messages like:

  install: `lkb_data.tgz' ... done.
  install: `lkb_linux.x86.32.tgz' ... done.
  install: `lkb_source.tgz' ... done.
  install: `itsdb_libraries.tgz' ... done.
  install: `itsdb_tsdb.tgz' ... done.
  install: `itsdb_capi.tgz' ... done.
  install: `itsdb_linux.x86.32.tgz' ... done.
  install: `itsdb_data.tgz' ... done.
  install: `itsdb_documentation.tgz' ... done.
  install: `itsdb_source.tgz' ... done.
  install: `eli.tgz' ... done.
  install: `erg.tgz' ... done.

Towards the end of the procedure, the installer will instruct you to add a few lines to your shell initialization file (called .bashrc or .cshrc, typically) and emacs start-up file, respectively. To record the choice of the DELPH-IN top-level directory for future sessions, add a line like:

  export DELPHINHOME=~/delphin

to the file ~/.bashrc in your home directory, in case your Unix login shell is bash (the default in Linux), or use:

  setenv DELPHINHOME ~/delphin

in the file ~/.cshrc (or sometimes ~/.tcshrc) if you were using tcsh or another csh derivative. Should you not know the type of your Unix login shell, try:

  echo $SHELL

In case you are installing on Windows using CygWin, the DELPHINHOME environment variable will need to be set in the global environment, i.e. somewhere in the Properties dialogue that you get from left-clicking on My Computer on the Windows desktop. Note that the DELPHINHOME path must not include a trailing slash (or back slash depending on your OS), i.e. it should be something like ~/delphin and not ~/delphin/.

This much should suffice to run the LKB, but the installer also suggests that you set up emacs, the standard editor, for use with the LKB. Integration of the LKB and emacs will simplify starting the LKB and makes available some improved editing functionality for LKB grammars. Following the instructions provided by the installer, use an editor to open the file ~/.emacs from your home directory and paste the block of lines suggested by the installer into this file, e.g.

  (let ((root (or (getenv "DELPHINHOME")
                  "/home/oe/delphin")))
    (if (file-exists-p (format "%s/lkb/etc/dot.emacs" root))
      (load (format "%s/lkb/etc/dot.emacs" root) nil t t)))

Save the file, then exit the editor and start a fresh emacs for the changes to take effect. Assuming there were no further error messages, the following command in emacs will start the LKB:

  M-x lkb RET

where M-x means pressing the Alt and x keys simultaneously, and RET means pressing the Enter key (Return on some keyboards). A new window named LKB Top should pop up. Hooray!

Those who prefer running the LKB without emacs, the LKB can be started from a Unix command shell by executing the file lkb in a platform-specific sub-directory of the DELPHINHOME tree, e.g. (for 32-bit Linux on x86):

  $DELPHINHOME/bin/lkb

In Windows, you can launch the LKB by locating the file lkb.exe (which resides in $DELPHINHOME/lkb/windows) and double-clicking on it.

Which Version to Use: Stable vs. Latest

The LKB system evolves constantly. On-going development adds new features and makes bug fixes as problems are discovered. Aiming to (i) make both the latest functionality and fixes available to all users and (ii) guarantee a functional baseline system at all times, the LKB developers team maintains the system in two versions, stable and latest. The stable version, usually, has been more thoroughly tested than later code snapshots but may lack newer functionality or support for recent versions of some operating systems (notably Linux). As of June 2005, the current LKB stable release was frozen in November 2002 and will likely not work on recent Linux distributions; this version of the LKB is available for download from http://lingo.delph-in.net/stable/. Also available from the download site are regular code snapshots of the current head revision in the LKB source code repository (versioned according to build dates); the most recent snapshot of these can be retrieved from http://lingo.delph-in.net/latest/. While the LKB team is preparing an updated stable release, right now, we recommend that all new users consider using the latest version. The automated installer by default picks the latest snapshot, thus can be run repeatedly to obtain updates.

Note that there will not always be a Windows or Macintosh version of the latest release and that you may have to work backwards to find it.

Manual Installation

For users who cannot use the automated installer for some reason, following is a step-by-step account of what needs to be done for a full LKB installation.

  1. Check the supported platforms and decide on which version to install;
  2. Check system requirements and third-party software (e.g. OpenMotif on Linux);

  3. Create a top-level directory to hold the DELPH-IN software and resources;
  4. Create a directory for the LKB to create temporary files;
  5. Download the appropriate selection of archive files and unpack each;
  6. Add LKB-specific settings to your shell and emacs start-up files.

For the following, we will refer to the top-level directory as DELPHINHOME. Good choices for this directory could be c:\delphin\ in Windows, ~/delphin/ on Unix systems, or ~/Documents/delphin/ on Macintosh. Decide on where you want your DELPH-IN files and make sure the target directory exists (and is writable to you). Also, for successful operation, the LKB will need a writable directory to store its temporary files. In Windows, make sure that the environment variable TEMP (or TMP) points to a valid and writable directory, or create a new directory c:\tmp. For Unix, make sure a directory called ~/tmp/ exists in your home directory (or ~/Documents/tmp/ on the Macintosh).

Next, download the archive lkb_data.tgz plus either (i) a binary archive for your hardware (e.g. lkb_windows.zip or lkb_linux.x86.32.tgz) or (ii) the LKB source code as lkb_source.tgz. Getting all three is fine too, of course. Unpack all archives into the DELPHINHOME, e.g. using a tool like PowerArchiver or WinZip on Windows, Stuffit Expander on Macintosh, or the Unix gzip and tar shell commands (which are also included in the free CygWin package for Windows), e.g.

  gunzip -c lkb_data.tgz | tar xvf -

If doing a binary install, at this point, you should be able to locate the LKB precompiled binary (lkb.exe in Windows and lkb on Unix/Mac OS X; also see the automated install section above) and just execute it. Confirm that the LKB Top window pops up and is functional and then proceed to adding settings to your .emacs and .bashrc (or .tcshrc) files; see above. Should you need or want to compile the LKB source code, please consult the instructions on the LkbCompilation page.

First-Time Use

Once you can run the LKB and get the LKB Top window (or alternatively a version of the LKB source code loaded into Lisp in tty mode), proceed to make sure the system is really functional.

A more detailed account of a first-time tour is available as an excerpt from Copestake (2002).

Directory for LKB Temporary Files

These details can be ignored by most non-Windows users.

The LKB requires some temporary files be created for lexicon handling (unless you use the LkbLexDb, which is recommended for moderate to large lexicons but not for new users with small lexicons). Unfortunately, there is no way of ensuring that the temporary files will be created in a sensible place for every user on every system. For Unix and Linux, the default location for the files is in a directory tmp in the user's home directory. For Windows, the default location is whereever the environment variable TEMP or TMP points or if that is not a valid directory C:\tmp. For Macintosh, the default location is ~/Documents/tmp. If it is possible to use these locations, then simply create the requisite directory before loading the first grammar. If it is not convenient to have these directories, and you are using a binary, then you need to add a function lkb-tmp-dir() to the user-fns.lsp file for every grammar you use. For instance, you can add something like the following to user-fns.lsp (or replace the function lkb-tmp-dir() if it exists already):

  (defun lkb-tmp-dir ()
    (make-pathname :device "D" :directory "tmp"))

If you are compiling the LKB yourself from the source files, you can edit the file $DELPHINHOME/lkb/src/main/user-fns.lsp so that the function lkb-tmp-dir() identifies a more suitable directory, rather than change it in every grammar. Or you may want to add the function definition to a file that you use to load the LKB.

Live CD

There is a live CD, which boots you into linux with the LKB from the University of Washington: Knoppix LKB.

Development and Supported Lisp Environments

The main development environment for the LKB is Franz Allegro CL and CLIM. The source code is known to work in Allegro CL on MacOS X and will likely compile with ease on other platforms for which Allegro CL and CLIM are available. Most current development targets Allegro CL versions 8.0 and 7.0 primarily, but older versions back to, at least, Allegro CL and CLIM 5.0 should still work. The current LKB user interface is built atop CLIM (the Common-Lisp Interface Manager), such that graphical interactions and visualization will only be available with Allegro CLIM; there is partial support for LispWorks CLIM. The Macintosh binary is built using Macintosh Common Lisp, with native OS X graphics; note that this only runs on PowerPC-based platforms, not the newer x86. The core of the LKB is ANSI Common-Lisp and is known to compile in a variety of free Lisp implementations, including

The above list is ordered according to recent experience of LKB developers. These free, open-source Lisp implementations typically vary in which features are available on which platforms (e.g. native code compilation, UniCode support, multi-threading, or socket support), and users may need to experiment a little. The LKB provides a non-graphical mode of interactions (called tty mode; see the LkbTty page) that enables basic grammar writing or deployment of an existing grammar. Also, there is experimental support to provide graphical tools without CLIM for select platforms; see the LkbLui pages. For instructions on compiling the LKB source code, please see the LkbCompilation pages.

Further Pointers

In case of problems, please see the LkbFaq page. For additional information on obtaining, installing, and running the LKB, see:

Trouble Shooting

amd64 Version

(2007-02-08) On ubuntu edgy the latest amd64 binaries require you to

Warning: Loading clim2:climxm.so failed with error: libXm.so.3: wrong
ELF class: ELFCLASS32.

On a redhat based system you need to install something like

For example, vinelinux 4.1 requires

libXm.so.4

For recent versions of the lkb you may get this error message

Warning: Loading sys:climxm.so failed with error:
        libXm.so.4: cannot open shared object file: No such file or directory.

If your distribution doesn't have the latest Open Motif, it should be enough to link version three to version 4:

sudo ln -s /usr/lib/libXm.so.3 /usr/X11R6/lib/libXm.so.4
sudo ln -s /usr/lib/libXm.so.3 /usr/lib/libXm.so.4

Thanks to Cecilia Seidel for the bug report and work around.

You can also do something like this with recent LKBs (and it doesn't require sudo privileges):

export LD_LIBRARY_PATH=/path/to/delphin/lkb/lib/linux.x86.64/:$LD_LIBRARY_PATH

Thanks to Xuchen Yao for the solution (2010-04-18).

uming font problem

There is a problem with CLIM and the Chinese Unicode TrueType font collection "AR PL UMing". The font does not returni one of its x-properties correctly, and that causes CLIM to crash.

Removing ttf-arphic-uming is the easiest solution.

sudo dpkg --purge ttf-arphic-uming

Michael Goodman has filed a bug with the font in Ubuntu: https://bugs.launchpad.net/ubuntu/+source/ttf-arphic-uming/+bug/296161

We encourage people to file bugs in their own distributions, and/or confirm the bug in Ubuntu so that it gets a higher priority. Alternatively, if you know about fonts then please fix it...

LkbInstallation (last edited 2012-08-01 15:31:37 by AnnCopestake)

(The DELPH-IN infrastructure is hosted at the University of Oslo)