The candi.sh shell script downloads, configures, builds, and installs deal.II with common dependencies on linux-based systems.

The following commands download the current stable version of the installer and then install the latest deal.II release and common dependencies:

  git clone https://github.com/dealii/candi.git
  cd candi
  ./candi.sh

Follow the instructions on the screen (you can abort the process by pressing < CTRL > + C)

  module load mpi/openmpi-`uname -i`
  ./candi.sh

  ./candi.sh

  ./candi.sh

Since the Creators Update in fall 2017 (Windows 10 (1709)) the Windows Subsystem for Linux (WSL) is an official part.

For a detailed instruction how to install WSL, the new WSL 2 and a recent Ubuntu distribution on Windows 10 you can follow the Microsoft Documentation.

Within the Ubuntu terminal application, upgrade Ubuntu first, then clone this repository and run candi

  sudo apt-get update
  sudo apt-get upgrade
  git clone https://github.com/dealii/candi.git
  cd candi
  ./candi.sh

  ./candi.sh --platform=./deal.II-toolchain/platforms/supported/linux_cluster.platform

Note that you probably also want to change the prefix path, or the path to BLAS and LAPACK in the configuration file (see documentation below).

  wget https://github.com/dealii/candi/archive/master.tar.gz
  tar -xzf master.tar.gz
  cd candi-master
  ./candi.sh

Note that in this case you will need to activate the installation of git by uncommenting the line #PACKAGES="${PACKAGES} once:git" in candi.cfg.

You can get a list of all command line options by running

  ./candi.sh -h
  ./candi.sh --help

You can combine the command line options given below.

  ./candi.sh -p "/path/to/install/dir"
  ./candi.sh -p="/path/to/install/dir"
  ./candi.sh --prefix="/path/to/install/dir"

  ./candi.sh -j<N>
  ./candi.sh -j <N>
  ./candi.sh --jobs=<N>

• Example: to use 2 build processes type ./candi.sh -j 2.
• Be careful with this option! You need to have enough system memory (e.g. at least 8GB for 2 or more processes).

  ./candi.sh -pf=./deal.II-toolchain/platforms/...
  ./candi.sh --platform=./deal.II-toolchain/platforms/...

If your platform is not detected automatically you can specify it with this option manually. As shown above, this option is used to install deal.II via candi on linux clusters, for example. For a complete list of supported platforms see deal.II-toolchain/platforms.

  ./candi.sh -y
  ./candi.sh --yes
  ./candi.sh --assume-yes

With this option you skip the user interaction. This might be useful if you submit the installation to the queueing system of a cluster.

If you want to change the set of packages to be installed, you can enable or disable a package in the configuration file candi.cfg. This file is a simple text file and can be changed with any text editor.

Currently, we provide the packages

• trilinos
• petsc, slepc
• superlu_dist (to be used with trilinos)
• p4est
• hdf5
• opencascade

and others. For a complete list see deal.II-toolchain/packages.

There are several options within the configuration file, for example:

• Remove existing build directories to use always a fresh setup

  CLEAN_BUILD={ON|OFF}

• Enable native compiler optimizations like -march=native

  NATIVE_OPTIMIZATIONS={ON|OFF}

• Enable the build of the deal.II examples

  BUILD_EXAMPLES={ON|OFF}

and more.

Furthermore you can specify the install directory and other internal directories, where the source and build files are stored:

• The DOWNLOAD_PATH folder (can be safely removed after installation)
• The UNPACK_PATH folder of the downloaded packages (can be safely removed after installation)
• The BUILD_PATH folder (can be safely removed after installation)
• The INSTALL_PATH destination folder

If you prefer to install only a single package, you can do so by

  ./candi.sh --packages="dealii"

for instance, or a set of packages by

  ./candi.sh --packages="opencascade petsc"

Our installer provides a software developer mode by setting DEVELOPER_MODE=ON within candi.cfg.

More precisely, the developer mode skips the package fetch and unpack, everything else (package configuration, building and installation) is done as before.

Note that you need to have a previous run of candi and you must not remove the UNPACK_PATH directory. Then you can modify source files in UNPACK_PATH of a package and run candi again.