OPAL++ - Install Newest Version

This guide explains briefly how to use the latest version of OPAL++ on the available clusters.

Current version: (Q4/2018)

System requirements

OPAL2 runs on Windows, or on a Red Hat Linux-based distribution (RHEL, CentOS, Scientific Linux), with kernel 2.6.18+. It will not run on Ubuntu derivatives.

Requirements to follow this guide

  • Account on the PC-Cluster
    or a colleague willing to help
  • Active Opal++ license
    Ask Dr. Janiga if you need one.
  • Working SSH connections to the PC-Cluster, and optionally Neumann. See Remote Connection Guide.
  • Some understanding of using a command-line interface. See UNIX tutorial.


  1. Download the latest distribution of OPAL from this PC-Cluster directory:
  2. Put the Distro.tar.gz in your home directory (or directory of choice)
    working on the PC-Cluster you can run:
     cp /global/shared/INSTALLATION/OPAL2/Distro.tar.gz ~
  3. Change into the directory of the tar-file and extract it with:
    tar -xzf Distro.tar.gz
  4. Rename the new directory Distro to OPAL2. If you have a previous version of OPAL move the old version to a backup location, such as OPAL2_old.
    mv Distro OPAL2
  5. Copy the OPAL license file into the newly created OPAL2/bin/ directory.
    Usually it's named opal2_lic.key. It might be located in OPAL2_old now.
    cp <keyLocation>/opal2_lic.key <opalLocation>/OPAL2/bin/

    Replace the values in chevrons (<,>) with the respective paths.

  6. Create a settings file pointing to the OPAL2_TEMP directory. It should be located in the bin directory where the OPAL2 executable is located:
    echo "SETTINGS.TEMPORARY={/scratch/tmp/<yourScratchDirectory>/OPAL2_TEMP/}" > OPAL2/bin/opal2_settings.ini

    Replace <yourScratchDirectory> with your own directory. Check carefully that the path you specify exists, and that you have write access to it: otherwise, OPAL will fail silently.

  7. Go back to your home directory and open the file .bashrc
  8. Add (or replace) these lines with the correct directory:
    export OPAL_PREFIX=<opalLocation>/OPAL2/openmpi/
    export PATH=$PATH:<opalLocation>/OPAL2/openmpi/bin

    Replace <opalLocation> with the absolute path to the respective directory. For example:

    export OPAL_PREFIX=/home/seengel/OPAL2/openmpi/
    export PATH=$PATH:/home/seengel/OPAL2/openmpi/bin
  9. Make sure the above lines are not existing twice in .bashrc
  10. Save and close the .bashrc
  11. Reload the .bashrc in your terminal. This has to be done for each open terminal. New terminals will load the new bashrc automatically.
    source ~/.bashrc
  12. Now test whether it's working correctly:
    1. Book a computer
      • On Neumann:
        srun -p short -N 1 -t 1:00:00 --pty /bin/bash
      • On the PC-Cluster, log into a workstation:
        ssh ws05
    2. Open an interactive opal session:
      mpirun -np 1 <opalLocation>/OPAL2/bin/OPAL2 -opal2.mode=INTERACTIVE

      Make sure to replace <opalLocation with the correct directory, such as home(~).

    3. Receive this output, and type EXIT in the prompt and press Enter:
       ..............Welcome to OPAL++!.................
      OPAL++ - OPtimization Algorithms Library
      Developed by Otto von Guericke Universitat, ISUT/LSS
      Version:; Build: Jul  6 2018 , 19:49:13
      Copyright (C) 2012-2018
      The current software is licensed to OvGU/ISUT/LSS/you
         Date of validity: 17.01.2018 - 15.01.2019
      <*> Entering interactive mode...
    4. If you received this output, then your are good to go!

If you couldn't resolve possible errors, ask Dr. Janiga or Sebastian for help.

guide/opal/install_newest_version.txt · Last modified: 2019/11/29 16:17 by seengel
Back to top
CC Attribution-Share Alike 3.0 Unported
chimeric.de = chi`s home Valid CSS Driven by DokuWiki do yourself a favour and use a real browser - get firefox!! Recent changes RSS feed Valid XHTML 1.0