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 then continue reading the Installing Data Files section.

To build a batch version of Diana for headless systems, install bdiana according to the instructions on the Batch Diana on Headless Systems page then continue reading the Installing Data Files section.

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.

Testing

It is useful to test that the basic installation works correctly, particularly on headless systems that only allow bdiana to run. Copy the following text into a file called test.input:

buffersize=800x800
output=PNG
filename=test.png
PLOT
MAP backcolour=117:199:242 map=Gshhs-Auto contour=on cont.colour=black cont.linewidth=1 cont.linetype=solid cont.zorder=1 land=on land.colour=240:158:92
AREA proj4string="+proj=ortho +lat_0=60" rectangle=-1500000.000000:1500000.000000:-1250000.000000:1750000.000000
ENDPLOT

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.