Actions

Difference between revisions of "Linux-Build"

From Lrose Wiki

 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
== How to install LROSE source on Linux? ==
+
=== '''Overview''' ===
 
For most common LINUX systems, you can install lrose from the packages on this page.
 
For most common LINUX systems, you can install lrose from the packages on this page.
  
 
For some of the versions of LINUX, we are still having problems with the Qt5-based applications. These problems include both compile errors, and run-time errors related to problems with dynamically-linked libraries. We are working to identify the cause of the problems. In the meantime, we have documented which applications are available on each OS version.
 
For some of the versions of LINUX, we are still having problems with the Qt5-based applications. These problems include both compile errors, and run-time errors related to problems with dynamically-linked libraries. We are working to identify the cause of the problems. In the meantime, we have documented which applications are available on each OS version.
  
{| class="wikitable"
+
{| class="wikitable"
|- style="text-align:center;"
+
! OS-version !! fractl !! vortrac !! samurai !! HawkEye !! CIDD available?
! OS-version
 
! fractl
 
! vortrac
 
! samurai
 
! HawkEye
 
! CIDD available?
 
 
|-
 
|-
| CENTOS 6
+
| CENTOS 7 || Yes || Yes || Yes || Yes || Yes
| No
 
| No
 
| No
 
| Yes
 
| No
 
 
|-
 
|-
| CENTOS 7
+
| CENTOS 8 || Yes || Yes || Yes || Yes || Yes
| Yes
 
| Yes
 
| Yes
 
| Yes
 
| Yes
 
 
|-
 
|-
| CENTOS 8
+
| CENTOS stream (latest) || Yes || Yes || Yes || Yes || Yes
| Yes
 
| Yes
 
| Yes
 
| Yes
 
| Yes
 
 
|-
 
|-
| Fedora 29
+
| Fedora 31 || Yes || Yes || Yes || Yes || Yes
| Yes
 
| No
 
| Yes
 
| No
 
| Yes
 
 
|-
 
|-
| Fedora 30
+
| Fedora 32 || Yes || Yes || Yes || Yes || Yes
| Yes
 
| No
 
| Yes
 
| No
 
| Yes
 
 
|-
 
|-
| Fedora 31
+
| Fedora 33 || Yes || Yes || Yes || Yes || Yes
| Yes
 
| No
 
| Yes
 
| No
 
| Yes
 
 
|-
 
|-
| Debian 9
+
| Debian 9 || Yes || Yes || Yes || Yes || Yes
| Yes
 
| Yes
 
| Yes
 
| No
 
| Yes
 
 
|-
 
|-
| Debian 10
+
| Debian 10 || Yes || Yes || Yes || Yes || Yes
| Yes
 
| Yes
 
| Yes
 
| No
 
| Yes
 
 
|-
 
|-
| Ubuntu 16.04
+
| Ubuntu 16.04 || Yes || Yes || Yes || Yes || Yes
| Yes
 
| Yes
 
| Yes
 
| Yes
 
| Yes
 
 
|-
 
|-
| Ubuntu 18.04
+
| Ubuntu 18.04 || Yes || Yes || Yes || Yes || Yes
| Yes
 
| Yes
 
| Yes
 
| Yes
 
| Yes
 
 
|-
 
|-
| Suse leap
+
| Ubuntu 20.04 || Yes || Yes || Yes || Yes || Yes
| Yes
 
| Yes
 
| Yes
 
| Yes
 
| Yes
 
 
|-
 
|-
| Suse latest
+
| Suse leap || Yes || Yes || Yes || Yes || Yes
| Yes
+
|-
| Yes
+
| Suse latest || Yes || Yes || Yes || Yes || Yes
| Yes
+
|-
| Yes
+
| Oracle 8 (latest) || No || No || No || Yes || Yes
| Yes
 
 
|}
 
|}
  
 
+
=== '''Prerequesites''' ===
 
+
1. Most good, up-to-date LINUX distributions should work.
1. Prepare:
 
Most good, up-to-date LINUX distributions should work.
 
  
 
Recommended distributions are:
 
Recommended distributions are:
Line 116: Line 52:
  
  
2. Download the source tar file for Linux from: '''[https://github.com/NCAR/lrose-core/releases/tag/lrose-core-20200701 Release]'''
+
2. Download the source tar file for Linux from: '''[https://github.com/NCAR/lrose-core/releases/download/lrose-core-20210216/lrose-core-20210216.src.tgz Release]'''
 +
 
 
A typical source release would be:
 
A typical source release would be:
  
<code lang="bash"> lrose-core-20200701.src.tgz </code>
+
<code lang="bash"> lrose-core-20210216.src.tgz </code>
  
 
* Create a working directory for building the distribution:
 
* Create a working directory for building the distribution:
Line 129: Line 66:
 
* Untar
 
* Untar
  
<code lang="bash"> tar xvfz lrose-core-20200701.src.tgz </code>
+
<code lang="bash"> tar xvfz lrose-core-20210216.src.tgz </code>
  
 
The distribution will be unpacked into a subdirectory:
 
The distribution will be unpacked into a subdirectory:
  
<code lang="bash"> cd ~/lrose_build/lrose-core-20200701.src</code>
+
<code lang="bash"> cd ~/lrose_build/lrose-core-20210216.src</code>
 
 
  
3. Build
+
=== '''Build''' ===
  
 
* Run the build script:
 
* Run the build script:
Line 153: Line 89:
  
  
4. Verify
+
=== '''Verification''' ===
  
 
* Look in ~/lrose or /my/install/dir for
 
* Look in ~/lrose or /my/install/dir for
Line 173: Line 109:
  
  
5. Handling build errors
+
=== '''Errors tracking''' ===
  
 
If the build does not complete successfully, you will need to
 
If the build does not complete successfully, you will need to
Line 194: Line 130:
  
  
6. Update
+
=== '''Update a new version''' ===
  
 
To update, just repeat the procedure in sections 2, 3 and 4 above.
 
To update, just repeat the procedure in sections 2, 3 and 4 above.
  
 
The new version will be installed over the previous version.
 
The new version will be installed over the previous version.

Latest revision as of 21:38, 24 February 2021

Overview

For most common LINUX systems, you can install lrose from the packages on this page.

For some of the versions of LINUX, we are still having problems with the Qt5-based applications. These problems include both compile errors, and run-time errors related to problems with dynamically-linked libraries. We are working to identify the cause of the problems. In the meantime, we have documented which applications are available on each OS version.

OS-version fractl vortrac samurai HawkEye CIDD available?
CENTOS 7 Yes Yes Yes Yes Yes
CENTOS 8 Yes Yes Yes Yes Yes
CENTOS stream (latest) Yes Yes Yes Yes Yes
Fedora 31 Yes Yes Yes Yes Yes
Fedora 32 Yes Yes Yes Yes Yes
Fedora 33 Yes Yes Yes Yes Yes
Debian 9 Yes Yes Yes Yes Yes
Debian 10 Yes Yes Yes Yes Yes
Ubuntu 16.04 Yes Yes Yes Yes Yes
Ubuntu 18.04 Yes Yes Yes Yes Yes
Ubuntu 20.04 Yes Yes Yes Yes Yes
Suse leap Yes Yes Yes Yes Yes
Suse latest Yes Yes Yes Yes Yes
Oracle 8 (latest) No No No Yes Yes

Prerequesites

1. Most good, up-to-date LINUX distributions should work.

Recommended distributions are:

  • Debian
  • Ubuntu (based on Debian)
  • RedHat
  • Centos (based on RedHat)
  • Fedora (based on RedHat)

First, you will need to install the required packages.

See: LROSE package dependencies


2. Download the source tar file for Linux from: Release

A typical source release would be:

lrose-core-20210216.src.tgz

  • Create a working directory for building the distribution:

mkdir ~/lrose_build

cd ~/lrose_build

  • Untar

tar xvfz lrose-core-20210216.src.tgz

The distribution will be unpacked into a subdirectory:

cd ~/lrose_build/lrose-core-20210216.src

Build

  • Run the build script:

To see the usage:

./build_src_release.py --help

To build and install into the default directory: /usr/local/lrose

./build_src_release.py

Or set an install directory:

./build_src_release.py --prefix /my/install/dir


Verification

  • Look in ~/lrose or /my/install/dir for

include

lib

bin

  • Try the commands:

/usr/local/lrose/bin/RadxPrint -h

/usr/local/lrose/bin/RadxConvert -h

/usr/local/lrose/bin/Radx2Grid -h

/usr/local/lrose/bin/HawkEye


Errors tracking

If the build does not complete successfully, you will need to track down the errors.

The very first errors in the build are the most important.

If you get errors, go into the directory giving problems, and run the make as follows:

make |& less

and scroll down searching for error.

Alternatively, run

make >& make.log

and then inspect the make.log file, searching for error.


Update a new version

To update, just repeat the procedure in sections 2, 3 and 4 above.

The new version will be installed over the previous version.