Repast HPC Quick Start

Setup

1. Download RepastHPC: Git repository for Repast HPC
2. Untar the repast_hpc-x.x.x.tgz file you downloaded.

3. Follow INSTALL.txt instruction “Requirement #3” on line 140.

   • To navigate to the MANUAL_INSTALL directory in the terminal type:

   • cd Downloads/repast_hpc-2.2.0/MANUAL_INSTALL

   • type ./install.sh curl (per instructions)

4. Follow INSTALL.txt instructions for installing mpich (Requirement #4)

   • type ./install.sh mpich

   • type export PATH=$HOME/sfw/MPICH/bin:$PATH

5. NOW edit PROFILE and BASHRC FILE TO TELL repast where to look for MPICXX.

• Type nano ~/.bashrc

• Scroll to the bottom of the .bashrc script and type: export PATH=$HOME/sfw/MPICH/bin:$PATH Then, Ctrl-X to exit, Yes, Enter to save.

• Type nano ~/.profile

• Scroll to the bottom of the .profile and add these two lines, Ctrl-X to exit, Yes, Enter to save.

  • export PATH=”$HOME/sfw/MPICH/bin:$PATH”

  • export “LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/$HOME/sfw/Boost/Boost_1.61/lib/:/$HOME/sfw/repast_hpc-2.2.0/lib/“

6. Install zlib by typing:

   • sudo apt-get install zlib1g-dev

   • You’ll know it installed correctly if the last thing you see is:

     Setting up zlib1g-dev:amd64 (1:1.2.8dfsg-2ubuntu4.1) (or something similar that doesn’t have the word “error” in it)

7. Install NetCDF per INSTALL.txt document Requirement #5 line 196

   • Type ./install.sh netcdf

   • You’ll know it installed correctly when you see a text box that says:

     “Congratulations! You have successfully installed netCDF”

8. Install Boost per INSTALL.txt document Requirement #6 line 215

   • Type ./install.sh boost

   • Ignore instructions on lines 229-230. The MPICXX should be set up correctly.

   • You’ll know it’s fine if you see:

     common.copy home/your_username/sfw/Boost/Boost_1.61/lib/libboost_wserialization-mt.a …updated 153 targets… (or something like this that doesn’t say “error”)

9. Install RepastHPC

   • Type ./install.sh rhpc (make sure you’re in the MANUAL_INSTALL directory)

   • If you get can’t find MPICXX or can’t find Boost errors, you need to go back and make sure that step 8 is right. You have to edit your .bashrc file to tell repast where to look for mpicxx (before installing boost).

   • You’ll know it’s installed correctly if you see

     ‘src/zombie/config.props’ -> ‘/home/your_username/sfw/repast_hpc-2.2.0/bin/zombie/config.props’

10. Prepare to run the zombie model

    • Navigate to the folder “REPAST_INSTALL_DIR/bin/zombie” by typing:
      • cd ~/sfw/repast_hpc-2.2.0/bin/zombie

11. Run the zombie model by typing:

    • mpirun -n 4 ./zombie_model config.props model.props

    • It should tick through.