windows

Prerequisites for MUMPS installation on Windows

We need the following tools before compiling MUMPS on Windows.

Windows Subsystem for Linux (WSL)

Directly building MUMPS on Windows can be very challenging. To overcome this issue, it is highly recommended to use Windows Subsystem for Linux (WSL) as a viable solution.

Please install WSL following the instruction here.

Compilers on WSL

The compilation of MUMPS requires both C and Fortran compilers. We recommend using Intel C compiler, Fortran compiler, and MPI library.. On WSL, we can download the Intel installer here. Make sure to use custom installation and choose the following: (a) Intel Inspector (b) Intel MPI Library (c) Intel oneAPI DPC++/C++ Compiler & Intel C++ Compiler Classic (d) Intel Fortran Compiler & Intel Fortran Compiler Classic

After installing the Intel compiler, we need to set the environment variables specific to these compilers. Run the following commands:

source opt/intel/oneapi/compiler/latest/env/vars.sh
source opt/intel/oneapi/mpi/latest/env/vars.sh

These commands will configure the necessary environment variables for the Intel compilers, and Intel MPI.

BLAS, LAPACK, and ScaLAPACK on WSL

MUMPS requires both BLAS, LAPACK, and ScaLAPACK libraries, which are standard libraries on a Linux cluster. These libraries are also included in many implementations, such as MKL and OpenBLAS.

In the example below, we use MKL. On WSL, please visit Intel oneAPI Math Kernel Library to install MKL. During the installation process, ensure that we select custom installation and choose only the Intel oneAPI Math Kernel Library. This will ensure the necessary libraries are properly installed for MUMPS to function correctly.

After installing the MKL, we can set the environment variable MKLROOT. Run the following commands:

source /opt/intel/oneapi/mkl/latest/env/vars.sh
echo $MKLROOT

In the provided Makefile.inc, we assume the MKL path has been exported to the environment called MKLROOT. At this point, MKLROOT is assigned and should be printed out.

Note that MUMPS supports shared memory, multithreaded parallelism through the use of multithreaded BLAS libraries. We provide Makefile.inc on Linux and they activate the OpenMP feature. We can use the environment variable OMP_NUM_THREADS to set the number of threads.