diana:autotools

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:autotools [2014-02-26 13:24:11]
davidb [Fedora 20] 		diana:autotools [2022-05-31 09:29:31] (current)
Line 1: Line 1:
 ====== Building Metlibs and Diana with Autotools ====== ====== Building Metlibs and Diana with Autotools ======
  
-**Warning:** //This page is currently being revised. Details may be incorrect and are subject to change.//+**OUTDATED:** //This page is no longer up to date, diana and metlibs are now built using cmake.// 
 + 
 +This document describes how to build the Diana application and its main dependencies (Fimex and Metlibs) from source code, focusing on Ubuntu 12.04 (Precise) and Fedora 20. We provide commands to install further dependencies as they are needed, but this assumes that previous steps have been followed. For example, we list the common dependencies between Metlibs and Fimex as Fimex dependencies. 
 +===== General Prerequisites ===== 
 + 
 +This section describes the basic set of packages that will be required to build the software. 
 +==== Ubuntu 12.04 (Precise) ==== 
 + 
 +On a clean stock Ubuntu Precise (12.04) install, you will first need to install build tools: 
 + 
 +<code> 
 +sudo apt-get install build-essential autoconf automake libtool subversion \ 
 +                     gfortran flex bison 
 +</code> 
 + 
 +==== Fedora 20 ==== 
 + 
 +On Fedora 20, this command has been found to install a reasonable base set of tools: 
 + 
 +<code> 
 +sudo yum install gcc-c++ make wget tar subversion autoconf automake \ 
 +                 findutils libtool flex bison autoconf-archive \ 
 +                 gcc-gfortran file 
 +</code>
  
 ===== Obtaining the source code ===== ===== Obtaining the source code =====
  
-Obtain the latest source code from the subversion repositories:+Obtain the latest source code from the source code repositories. Currently, fimex, metlibs and Diana are held in git repositories:
  
 **fimex:** **fimex:**
 <code> <code>
-svn co https://svn.met.no/fimex/tags/version0_51 fimex+git clone https://github.com/metno/fimex.git
 </code> </code>
  
 **metlibs:** **metlibs:**
 <code> <code>
-svn co https://svn.met.no/metlibs/common +git clone https://github.com/metno/metlibs-milogger.git 
-svn co https://svn.met.no/metlibs/diana-support +git clone https://github.com/metno/metlibs-puctools.git 
-svn co https://svn.met.no/metlibs/gl-support +git clone https://github.com/metno/metlibs-putools.git 
-svn co https://svn.met.no/metlibs/tseries-support +git clone https://github.com/metno/metlibs-pudatatypes.git 
-svn co https://svn.met.no/metlibs/qt-utilities+git clone https://github.com/metno/metlibs-qutilities.git 
 +git clone https://github.com/metno/metlibs-coserver.git
 </code> </code>
  
 **Diana:** **Diana:**
 <code> <code>
-svn co https://svn.met.no/diana/trunk diana+git clone https://github.com/metno/diana.git
 </code> </code>
  
-===== Prerequisites =====+===== Fimex =====
  
 ==== Ubuntu 12.04 (Precise) ==== ==== Ubuntu 12.04 (Precise) ====
  
-On a clean stock Ubuntu Precise (12.04) install, you will first need to install build tools: +Install the dependencies using the following command:
- +
-  * ''build-essential'' +
-  * ''autoconf'' +
-  * ''automake'' +
-  * ''libtool'' +
-  * ''subversion''+
  
 <code> <code>
-sudo apt-get install build-essential autoconf automake libtool subversion gfortran+sudo apt-get install libxml2-dev libproj-dev libudunits2-dev \ 
 +                     libnetcdf-dev libgrib-api-dev libjasper-dev libpng12-dev \ 
 +                     libjpeg-dev libpq-dev liblog4cpp5-dev \ 
 +                     libboost-filesystem-dev libboost-system-dev \ 
 +                     libboost-iostreams-dev libboost-program-options-dev \ 
 +                     libboost-regex-dev libboost-test-dev \ 
 +                     libboost-date-time-dev
 </code> </code>
  
 ==== Fedora 20 ==== ==== Fedora 20 ====
  
-On Fedora 20, this command has been found to install a reasonable base set of tools:+Install the dependencies using the following command:
  
 <code> <code>
-sudo yum -y install gcc-c++ make wget tar subversion automake findutils libtool +sudo yum install boost-devel libxml2-devel udunits2-devel \ 
-</code> +                 netcdf-devel grib_api-devel jasper-devel libpng-devel \ 
- +                 libjpeg-turbo-devel libpqxx-devel log4cpp-devel \ 
-===== Fimex ===== +                 proj-devel udunits-devel
- +
-<code> +
-sudo yum -y install udunits2-devel boost-devel proj-devel udunits-devel libxml2-devel netcdf-devel+
 </code> </code>
  
Line 64: Line 85:
 **Without optional libraries:** **Without optional libraries:**
 <code> <code>
-sudo apt-get install flex bison ftgl-dev libhdf4g-dev libtiff4-dev libqt4-dev proj \ +sudo apt-get install ftgl-dev libhdf4g-dev libtiff4-dev libqt4-dev proj \ 
-                     libboost-dev libboost-date-time-dev libboost-serialization-dev \ +                     libmysqlclient-dev liblog4cpp5-dev libcurl4-gnutls-dev \ 
-                     libboost-thread-dev libmysqlclient-dev liblog4cpp5-dev libcurl4-gnutls-dev+                     libgeotiff-dev libboost-thread-dev
 </code> </code>
  
 **With optional libraries:** **With optional libraries:**
 <code> <code>
-sudo apt-get install flex bison ftgl-dev libhdf4g-dev libhdf5-serial-dev libtiff4-dev \ +sudo apt-get install ftgl-dev libhdf4g-dev libhdf5-serial-dev libtiff4-dev \ 
-                     libqt4-dev proj libboost-dev libboost-date-time-dev \ +                     libqt4-dev proj libmysqlclient-dev libpqxx-dev \ 
-                     libboost-serialization-dev libboost-thread-dev libgeotiff-dev \ +                     libomniorb4-dev omniidl4 libldap2-dev liblog4cpp5-dev \ 
-                     libfimex-dev libmysqlclient-dev libpqxx-dev \ +                     libcurl4-gnutls-dev libgeotiff-dev libboost-thread-dev
-                     libomniorb4-dev omniidl4 libldap2-dev liblog4cpp5-dev libcurl4-gnutls-dev+
 </code> </code>
  
Line 81: Line 101:
  
 <code> <code>
-sudo yum -y install log4cpp +sudo yum install ftgl-devel libgeotiff-devel mesa-libGL-devel mesa-libGLU-devel \ 
 +                 qt-devel
 </code> </code>
  
 ===== Diana ===== ===== Diana =====
  
-  * ''libshp-dev'' +Diana can be configured to be used for creating animations. If this is desired then libavformat and its development headers need to be installed. On Ubuntu 12.04, a package exists for the optional EMOSLIB dependency, required to support viewing of observation files. However, it is not available for every distribution. 
-  * ''libavformat-dev'' (Optional) + 
-  * libxt-dev+==== Ubuntu 12.04 (Precise) ====
  
-**Without optional libraries:** 
 <code> <code>
-sudo apt-get install libshp-dev libxt-dev+sudo apt-get install libemos-dev libgrib-api-dev libshp-dev libxt-dev
 </code> </code>
  
-**With optional libraries:**+==== Fedora 20 ==== 
 + 
 +For observation buffer support in Diana, install EMOSLIB [[https://software.ecmwf.int/wiki/display/EMOS/Emoslib|from source]]. 
 <code> <code>
-sudo apt-get install libshp-dev libavformat-dev libxt-dev+sudo yum install grib_api-devel shapelib-devel
 </code> </code>
  
-For observation buffer support in Diana: +===== Installing Fimex =====
-  * ''EMOSLIB'' (no package; install manually [[http://www.ecmwf.int/products/data/software/interpolation.html|from source]])+
  
-For GRIB support in Metlibs and Diana: +Enter the ''fimex'' directory and configure the library with the following command:
-  * ''GRIB API'' (no package; install manually [[http://www.ecmwf.int/products/data/software/download/grib_api.html|from source]])+
  
-For fimex support in Metlibs and Diana: +<code> 
-  * ''libfimex-dev'' (no package; install manually [[https://wiki.met.no/fimex/start|from source]])+./configure 
 +</code>
  
-Except for those marked with (*), ''configure'' will terminate with an error message if any required package is absent.+If you want to install the library in an alternative location, specify it using the <nowiki>--prefix</nowiki> 
 +option; for example, use the following command to specify a directory inside the user's home directory:
  
 +<code>
 +./configure --prefix=$HOME/diana
 +</code>
  
-===== Installation ======+Build and install the library with the following commands:
  
-==== Metlibs ====+<code> 
 +make 
 +make install 
 +</code> 
 + 
 +You may need root privileges to install the library unless you specified a 
 +prefix in the configuration step. 
 +===== Installing Metlibs ======
  
-Enter the subdirectories for each of the metlibs modules, configuring, building and installing them in the order shown below. Note that, by default, the libraries will be installed under ''/usr/local'' unless you specify a prefix to the configure script.+Enter the subdirectories for each of the metlibs modules, configuring, building and installing them using the scripts listed below. Note that, by default, the libraries will be installed under ''/usr/local'' unless you specify a prefix to the configure script, such as <nowiki>--prefix=$HOME/diana</nowiki> to install the libraries in the ''diana'' directory inside the user's home directory.
  
 <code> <code>
Line 124: Line 157:
  
 THIS_DIR=`pwd` THIS_DIR=`pwd`
 +# uncomment next line on Fedora
 +#PREFIX="--prefix=/usr/local"
 +SUDO=sudo
  
-cd $THIS_DIR/common/miLogger/trunk +for l in milogger puctools putools pudatatypes qutilities coserver; do 
-./autogen.sh && ./configure --prefix=/usr/local && make +  cd "$THIS_DIR/metlibs-$l" 
-sudo make install+  ./autogen.sh && ./configure $PREFIX && make 
 +  $SUDO make install 
 +done 
 +</code>
  
-cd $THIS_DIR/common/puCtools/trunk +===== Installing Diana =====
-./autogen.sh && ./configure --prefix=/usr/local && make +
-sudo make install+
  
-cd $THIS_DIR/common/puTools/trunk +**Note:** By default, support for observation buffers is conditionally enabled and video export is enabled. To disable video support, append the <nowiki>--disable-video-support</nowiki> option to the command line you use to configure the build.
-./autogen.sh && ./configure --prefix=/usr/local && make +
-sudo make install+
  
-cd $THIS_DIR/tseries-support/puDatatypes/trunk +==== Ubuntu 12.04 (Precise) ====
-./autogen.sh && ./configure --prefix=/usr/local && make +
-sudo make install+
  
-cd $THIS_DIR/diana-support/diField/trunk +Enter the ''diana'' directory. If you have root privileges on your system, configure the library by running the configure script:
-./autogen.sh && ./configure --prefix=/usr/local --with-boost-libdir=/usr/lib64 && make +
-sudo make install +
- +
-cd $THIS_DIR/diana-support/miRaster/trunk +
-./autogen.sh && ./configure --prefix=/usr/local && make +
-sudo make install +
- +
-cd $THIS_DIR/gl-support/glp/trunk +
-./autogen.sh && ./configure --prefix=/usr/local && make +
-sudo make install +
- +
-cd $THIS_DIR/gl-support/miFTGL/trunk +
-./autogen.sh && ./configure --prefix=/usr/local && make +
-sudo make install +
- +
-cd $THIS_DIR/gl-support/glText/trunk +
-./autogen.sh && ./configure --prefix=/usr/local && make +
-sudo make install +
- +
-cd $THIS_DIR/qt-utilities/qUtilities/trunk +
-./autogen.sh && ./configure --prefix=/usr/local && make +
-sudo make install +
- +
-cd $THIS_DIR/qt-utilities/coserver/trunk +
-./autogen.sh && ./configure --prefix=/usr/local && make +
-sudo make install +
-</code> +
- +
-Otherwise, to configure the library for installation in a directory where you +
-have permission to write files, run the ''configure'' script in the following +
-way:+
  
 <code> <code>
-./configure --enable-xfonts --enable-allprofet --with-fimex --prefix=$HOME/diana+./autogen.sh 
 +./configure --enable-xlib --enable-geotiff
 </code> </code>
  
-where, in this example, we used ''$HOME/diana'' to specify a directory called +To configure the library for installation in a directory where you have permission to write files (for example, $HOME/diana for a directory in the user's home directory), use the <nowiki>--prefix</nowiki> option to specify the installation directory:
-''diana'' in the user's home directory. +
- +
-Build and install the library with the following commands:+
  
 <code> <code>
-make +./autogen.sh 
-make install+./configure --enable-xlib --enable-geotiff --prefix=$HOME/diana
 </code> </code>
  
-You may need root privileges to install the library unless you specified a +==== Fedora 20 ====
-prefix in the configuration step. +
-==== Diana ====+
  
-By default, support for ''profet'' and observation buffers is disabled, while video export is enabled. +Enter the ''diana'' directory. If you have root privileges on your system, configure the library by running the configure script:
- +
-Unpack the diana archive and enter the directory containing the source files. If you have root privileges on your system, configure the library by running the configure script:+
  
 <code> <code>
-./configure --enable-xlib --enable-geotiff+./autogen.sh 
 +./configure --enable-xlib --enable-geotiff --prefix=/usr/local \ 
 +            --with-png-libdir=/usr/lib64 --enable-vcross-v2 --with-udunits2-includedir=/usr/include/udunits2
 </code> </code>
  
-Otherwise, to configure the library for installation in a directory where you have permission to write files (for example, $HOME/diana for a directory in the user's home directory), run the configure script in the following way:+To configure the library for installation in a directory where you have permission to write files (for example, $HOME/diana for a directory in the user's home directory), use the <nowiki>--prefix</nowiki> option to specify the installation directory:
  
 <code> <code>
-./configure --enable-xlib --enable-geotiff --prefix=$HOME/diana+./autogen.sh 
 +./configure --enable-xlib --enable-geotiff --prefix=$HOME/diana \ 
 +            --with-png-libdir=/usr/lib64 --enable-vcross-v2 --with-udunits2-includedir=/usr/include/udunits2
 </code> </code>
 +
 +==== Building ====
  
 Build and install the application with the following commands: Build and install the application with the following commands:
Line 215: Line 217:
 You may need root privileges to install the application unless you specified a prefix in the configuration step. You may need root privileges to install the application unless you specified a prefix in the configuration step.
  
 +If you want to use the video export function, you have to install the ''avconv'' utility.
 +
 +  * Ubuntu/Debian: ''sudo apt-get install libav-tools''
 +
 +===== Next Steps =====
 +
 +See the [[gettingstarted#installing_data_files|Installing Data Files]] section of the [[gettingstarted|Getting Started]] document for instructions about configuring and running Diana.
  • diana/autotools.1393421051.txt.gz
  • Last modified: 2022-05-31 09:23:13
  • (external edit)