Getting Started

This document aims to describe what is needed to get a released version of Diana up and running on Ubuntu from a set of Debian packages. It is assumed that you will be using the version of Ubuntu that the packages were developed for. Using packages with a later version of Ubuntu is slightly more complicated; see the Installation Notes page for details.

Installing Packages

Obtain a set of release packages for the current release of Diana. At the time of writing, this is Diana 3.25 but check the main page for a later release.

You need the .deb files for diana, libfelt and libfimex. Download these to a suitable location on your system. In a terminal, type the following to install them:

sudo dpkg -i libfelt-0.28-0_0.28-2_i386.deb libfimex-0.28-0_0.28-2_i386.deb diana_3.25.0-ubuntu3_i386.deb

Installing Data Files

From the same page as the packages, download the maps and demo data archives, diana_maps.tar.gz and diana_demodata.tar.gz respectively.

Choose a suitable location for installation. The default configuration file specifies /usr/share/diana as the directory to contain the maps and demodata directories supplied by the archives, so you may want to unpack the archives in that directory.

cd /usr/share/diana
tar zxf /path/to/diana_maps.tar.gz
tar zxf /path/to/diana_demodata.tar.gz

Alternatively, you can unpack the archives in another directory and modify Diana's configuration file to refer to their locations.

Configuring Diana

Diana expects to find a diana.setup file in various locations:

The current directory.

$HOME/.diana/diana.setup or equivalent

/etc/diana/diana.setup-COMMON

Possibly the easiest way to arrange this is to run Diana without a diana.setup file then immediately quit. This will cause the .diana directory to be created in the user's home directory. Then copy the /etc/diana/diana.setup file into that directory for further configuration.

If you installed the maps and demo data in a location other than the default, you will need to change the OPDATA and MAPDIR lines in the diana.setup file. For example, if these resources were unpacked in the /data/diana directory, these lines need to be changed to read:

OPDATA = /data/diana/demodata
MAPDIR = /data/diana/maps

Running Diana

Run Diana using either the diana script or the diana.bin executable. The diana script will try to send debug information back to the e-mail address for bug reports. If you want to avoid this, run the diana.bin executable instead.

If you have created a diana.setup file in a location other than one of those mentioned above then you need to pass an option on the command line to specify where it is.

diana -s /path/to/diana.setup

The path specified must be an absolute path.