Skip to content

installationLinux

Paul Talbot edited this page Apr 22, 2019 · 30 revisions

Installation of RAVEN libraries

The process for installing RAVEN Python libraries is detailed at the link below. This works on any system that can build conda; more details on alternatives are also found there.

Install RAVEN Libraries

Installation of other RAVEN dependencies

In addition, RAVEN requires git and g++:

  • apt-get (Ubuntu) or dnf (Fedora)
sudo apt-get install libtool git python3-dev swig g++
dnf install swig libtool gcc-c++ redhat-rpm-config python3-devel

Optionally, if you want to be able to edit and rebuild the manual, you can install TEX Live and its related packages:

[~/projects]> sudo apt-get install texlive-latex-base \
texlive-extra-utils texlive-latex-extra texlive-math-extra

Clone RAVEN

Open a terminal window and cd into the folder where you want to install RAVEN (e.g., projects)

[~]> mkdir projects
[~]> cd projects
[~/projects]> git clone https://github.com/idaholab/raven.git
[~/projects]> cd raven

Clone RAVEN Plugins

In case you have access to any RAVEN plugins' repository (e.g. CashFlow), you can clone that repository to be functional with RAVEN (as submodule).

[~]> cd projects/raven
[~/projects/raven]> git submodule update --init **pluginName**

The result of the command is as follows:

Submodule 'pluginName' (https://github.com/idaholab/pluginName.git) registered for path 'pluginName'
Cloning into '/home/USER/projects/test/raven/plugins/pluginName'...
Submodule path 'pluginName': checked out '786576deef33a317e654558f39f5f45617c7442b'

Compiling RAVEN

[~/projects/raven]> ./build_raven 

In case the RAVEN libraries have been installed without the conda installation package, In the event libraries have not been installed through conda (see Installing RAVEN Libraries ), RAVEN needs to be built with the following option:

[~/projects/raven]> ./build_raven --skip-conda

Test RAVEN installation

[~/projects/raven]> ./run_tests -j2

A large number of tests are run in order to check that the installation step has been successful. At the end, a screen output is generated similar to the one below, although the number of tests will not be the same:

383 passed, 19 skipped, 0 pending, 0 failed

Update RAVEN

[~/projects]> cd raven
[~/projects/raven]> git pull
[~/projects/raven]> scripts/establish_conda_env.sh
[~/projects/raven]> ./build_raven
[~/projects/raven]> ./run_tests -j2