Skip to content

installationWindowsNew

Jump to bottom
Andrea Alfonsi - INL edited this page May 2, 2019 · 26 revisions

Installation of RAVEN libraries

For Windows systems perform the following:

  • obtain the latest Git SCM for Windows installer from https://gitforwindows.org/ and install it. Install Git Bash and have the installer add Git Bash to your Windows PATH environment variables. The PATH can be updated in two different ways:

    • Automatic: Allow the Git SCM installer to update it for you: Image: Git SCM Path
    • Manually: Add the Git Bash in your PATH manually: Image: Add Git SCM Path

  • obtain the Microsoft's Visual Studio Community Edition from here. After downloading and running the Visual Studio installer, it will ask what features to install. For building RAVEN, "Desktop development with C++" is needed at a minimum. Installation of other Visual Studio features should be fine.

  • install Miniconda (you can install Miniconda from https://conda.io/miniconda.html) The PATH can be updated in two different ways:

    • Automatic: Allow the Conda installer to update it for you: Image: Conda Path
    • Manually: Add the Git Bash in your PATH manually: Image: Add Conda Path

  • open Windows Command Line (cmd.exe) and install raven libraries (release branch) Note that to install libraries, you need to clone the RAVEN repository (see below).

cd raven
 bash.exe scripts\establish_conda_env.sh --install

The establish_conda_env.sh process is maintained to provide the best libraries for each commit of RAVEN. In the event libraries cannot be installed through conda, see Installing RAVEN Libraries.

Clone RAVEN

Open the Windows Command Line (cmd.exe) and cd into the folder where you want to install RAVEN (e.g., projects)

C:\projects> cd projects
C:\projects]> git clone https://github.com/idaholab/raven.git
C:\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).

C:\> cd projects\raven
C:\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

C:\projects\raven> bash.exe 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:

C:\projects\raven> bash.exe build_raven --skip-conda

Test RAVEN installation

C:\projects\raven> bash.exe 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 (though the number of tests will not be the same):

383 passed, 19 skipped, 0 pending, 0 failed

Update RAVEN

C:\projects> cd raven
C:\projects\raven> git pull
C:\projects\raven> bash.exe scripts\establish_conda_env.sh
C:\projects\raven> bash.exe build_raven
C:\projects\raven> bash.exe run_tests -j2
Clone this wiki locally