Installing Proteus on WSL

Windows Subsystem for Linux (WSL) allows windows users to run in a Linux-compatible interface. Many different Linux distributions can be obtained in the Microsoft store for use as a subsystem on Windows. Only the Ubuntu 16.04 and 18.04 WSL distributions have been validated at this time.

• Install the distribution from the Microsoft store.
• Update the Linux package list. sudo apt-get update
• Install a complete compiler set within the WSL environment: C, C++, and Fortran (i.e. gcc, g++, and gfortran). sudo apt-get install gcc g++ gfortran
• Install Git and Make in the WSL environment. sudo apt-get install make git
• Install python. sudo apt-get install python2.7
• Set version 2.7 of python as the default. More info about setting the default version of python
• Obtain Proteus from Git (git clone https://github.com/erdc/proteus.git)
• Enter the Proteus directory and setup Proteus to build. make stack hashdist
• Add the stable Proteus build git branch. cd stack git checkout stable/proteus
• Add the faster and more stable stack caches. To do this from the main Proteus folder run the following command: hashdist/bin/hit remote add http://192.237.213.149/hashdist_src --objects="source"
• Build Proteus. make develop
• Add the export paths to your .bashrc file:

export PATH=$HOME/proteus/linux2/bin:${PATH}

export LD_LIBRARY_PATH=$HOME/proteus/linux2/lib:${PATH}

export LD_LIBRARY_PATH=$HOME/proteus/linux2/lib64:${PATH}

export CC=mpicc

export CXX=mpicxx

• Once Proteus is built add lfs and test the Proteus install.

sudo apt install git-lfs

git lfs fetch

git lfs checkout

make test