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 12.04 (Precise) from a set of Debian packages. It is assumed that you will be using the version of Ubuntu that the packages were developed for. To build Diana for other distributions, see the Building Metlibs and Diana with Autotools page for an installation guide.
Installing Packages
Obtain a set of release packages for the current release of Diana. These are available via a link in the News section on the main page.
You need to install Fimex and the .deb
package files for Diana as described on that page. Download the package files to a suitable location on your system. In a terminal, type the following to install them, using the appropriate versions of the files for the current version:
sudo dpkg -i diana-3.33_3.33.0-1_amd64.deb diana-3.33-common_3.33.0-1_all.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.