This is an old revision of the document!
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.