diana:gettingstarted

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
diana:gettingstarted [2015-11-25 14:17:28]
davidb 		diana:gettingstarted [2022-05-31 09:29:31] (current)
Line 3: Line 3:
 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. 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 [[autotools|Building Metlibs and Diana with Autotools]] page for an installation guide then continue reading the [[#installing_data_files|Installing Data Files]] section.+To build Diana for other distributions, see the [[autotools|Building Metlibs and Diana with Autotools]] page for an installation guide then continue reading the [[Installing Data Files]] page.
  
-To build a batch version of Diana for headless systems, install ''bdiana'' according to the instructions on the [[batch_diana_on_headless_systems|Batch Diana on Headless Systems]] page then continue reading the [[#installing_data_files|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|Batch Diana on Headless Systems]] page then continue reading the [[Installing Data Files]] page.
  
 ===== Installing Packages ===== ===== Installing Packages =====
  
-Obtain a set of release packages for the current release of Diana. Follow the instructions on the [[Installing Diana from Launchpad]] page. +Obtain a set of release packages for the current release of Diana. Follow the instructions on the [[Installing Diana from Launchpad]] page to install and test the packages.
- +
-===== Installing Data Files ===== +
- +
-From the same page as the packages, download the maps and demo data archives, +
-[[ftp://ftp.met.no/projects/diana/diana_maps.tar.gz|diana_maps.tar.gz]] and [[ftp://ftp.met.no/projects/diana/diana_demodata.tar.gz|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 ===== ===== Configuring Diana =====
Line 37: Line 17:
   * The current directory.   * The current directory.
   * ''$HOME/.diana/diana.setup'' or equivalent   * ''$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'' +If you built and installed Diana 3.39 from source, or installed a package from Launchpad, there should also be a setup file in the following location: 
-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 +  * ''/etc/diana/3.39/diana.setup''
-that directory for further configuration.+
  
 If you installed the maps and demo data in a location other than the default, If you installed the maps and demo data in a location other than the default,
Line 54: Line 32:
 </code> </code>
  
-===== Testing =====+This means that you need to have a ''diana.setup'' file in a place where you can 
 +edit it. 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/3.39/diana.setup'' file 
 +(or the correct one for the version you are using) into that directory for further 
 +configuration. 
 + 
 +===== Testing with bdiana =====
  
 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'': 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'':
Line 72: Line 57:
  
 <code> <code>
-bdiana-3.35 -i test.input -s diana.setup+bdiana -i test.input -s diana.setup
 </code> </code>
  
 A file called ''test.png'' should be created that looks like the following image: A file called ''test.png'' should be created that looks like the following image:
  
-{{:test.png?|}}+{{diana:test.png?|}}
  
 If the file is not created or the image is blank, check the output from ''bdiana'' to determine whether the ''diana.setup'' file and map files were found correctly. If the file is not created or the image is blank, check the output from ''bdiana'' to determine whether the ''diana.setup'' file and map files were found correctly.
  
 +You can also find more input files to test in the [[https://github.com/metno/diana-extras|diana-extras]] repository on GitHub. The files can be found in the [[https://github.com/metno/diana-extras/tree/master/testfiles/input|testfiles/input]] directory.
 ===== Running Diana ===== ===== Running Diana =====
  
  • diana/gettingstarted.1448461048.txt.gz
  • Last modified: 2022-05-31 09:23:14
  • (external edit)