Differences

This shows you the differences between two versions of the page.

--- diana:gettingstarted [2011-10-07 10:44:45]
davidb [Getting Started]
+++ — (current)
@@ Line 1: / Line 1: @@
-====== 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
-[[InstallationNotes|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|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:
-<code>
-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
-</code>
-===== 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.
-<code>
-cd /usr/share/diana
-tar zxf /path/to/diana_maps.tar.gz
-tar zxf /path/to/diana_demodata.tar.gz
-</code>
-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:
-<code>
-OPDATA    = /data/diana/demodata
-MAPDIR    = /data/diana/maps
-</code>
-===== 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.
-<code>
-diana -s /path/to/diana.setup
-</code>
-The path specified must be an absolute path.