Differences
This shows you the differences between two versions of the page.
diana:gettingstarted [2011-10-07 10:44:45] davidb [Getting Started] |
diana:gettingstarted [2022-05-31 09:29:31] |
||
---|---|---|---|
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; | ||
- | [[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: | ||
- | |||
- | < | ||
- | 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, | ||
- | '' | ||
- | |||
- | Choose a suitable location for installation. The default configuration file | ||
- | specifies ''/ | ||
- | '' | ||
- | the archives in that directory. | ||
- | |||
- | < | ||
- | cd / | ||
- | tar zxf / | ||
- | tar zxf / | ||
- | </ | ||
- | |||
- | Alternatively, | ||
- | Diana' | ||
- | |||
- | ===== Configuring Diana ===== | ||
- | |||
- | Diana expects to find a '' | ||
- | |||
- | * The current directory. | ||
- | * '' | ||
- | * ''/ | ||
- | |||
- | Possibly the easiest way to arrange this is to run Diana without a '' | ||
- | file then immediately quit. This will cause the '' | ||
- | in the user's home directory. Then copy the ''/ | ||
- | 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 '' | ||
- | file. For example, if these resources were unpacked in the ''/ | ||
- | directory, these lines need to be changed to read: | ||
- | |||
- | < | ||
- | OPDATA | ||
- | MAPDIR | ||
- | </ | ||
- | |||
- | ===== Running Diana ===== | ||
- | |||
- | Run Diana using either the '' | ||
- | The '' | ||
- | address for bug reports. If you want to avoid this, run the '' | ||
- | executable instead. | ||
- | |||
- | If you have created a '' | ||
- | those mentioned above then you need to pass an option on the command line | ||
- | to specify where it is. | ||
- | |||
- | < | ||
- | diana -s / | ||
- | </ | ||
- | |||
- | The path specified must be an absolute path. |