diff --git a/README.md b/README.md index 9468f0c33eeceeaca076c0bb505f5c7ca2f0187f..e793d6c39308bde00a39ffb09c600912c4642104 100644 --- a/README.md +++ b/README.md @@ -1,44 +1,40 @@ -# PDC Summer School 2021: General Instructions for the MPI Labs +# PDC Summer School 2022: General Instructions for the MPI Labs ## Where to run -The exercises will be run on PDC's cluster [Tegner](https://www.pdc.kth.se/hpc-services/computing-systems/tegner-1.737437): +The exercises will be run on PDC's supercomputer [Dardel](https://www.pdc.kth.se/hpc-services/computing-systems/dardel-1.1043529): ``` -tegner.pdc.kth.se +dardel.pdc.kth.se ``` ## How to login To access PDC's systems you need an account at PDC. Check the [instructions for obtaining an account](https://www.pdc.kth.se/support/documents/getting_access/get_access.html#apply-via-pdc-webpage). -Once you have an account, you can follow the [instructions on how to connect from various operating systems](https://www.pdc.kth.se/support/documents/login/login.html). +Once you have an account, you can follow the Quick Start for Dardel instructions for [how to log in](https://www.pdc.kth.se/support/documents/basics/quickstartdardel.html#how-to-log-in). -Related to the Kerberos-based authentication environment, please check the [Kerberos commands documentation](https://www.pdc.kth.se/support/documents/login/login.html#general-information-about-kerberos) +## More about the environment on Dardel -## More about the environment on Tegner +Software, which is not available by default, needs to be loaded as a [module](https://www.pdc.kth.se/support/documents/basics/quickstartdardel.html#the-lmod-module-system) at login. Use ``ml avail`` to get a list of available modules. Many software modules become available after loading the latest PDC module using ``ml PDC``. -Software, which is not available by default, needs to be loaded as a [module](https://www.pdc.kth.se/support/documents/run_jobs/job_scheduling.html#accessing-software) at login. Use ``module avail`` to get a list of available modules. The following modules are of interest for this lab exercises: +To setup the development environment see: [Compilers and Libraries on Dardel](https://www.pdc.kth.se/support/documents/software_development/development_dardel.html). -- Different versions of OpenMPI based on different versions of the GNU compiler suite (``openmpi/*``) +The home directories on Dardel are provided through a Lustre service. See the page [Data Management](https://www.pdc.kth.se/support/documents/data_management/data_management.html) for more information. -For more information see the [software development documentation page](https://www.pdc.kth.se/support/documents/software_development/development.html). +To use the Dardel compute nodes you have to use the resource manager as described here: [How to Run jobs](https://www.pdc.kth.se/support/documents/run_jobs/job_scheduling.html). -Home directories are provided through an OpenAFS services. See the [AFS data management page](https://www.pdc.kth.se/support/documents/data_management/afs.html) for more information. +## Compiling MPI programs on Dardel -To use the Tegner compute nodes you have to submit [SLURM batch jobs](https://www.pdc.kth.se/support/documents/run_jobs/queueing_jobs.html) or run [SLURM interactive jobs](https://www.pdc.kth.se/support/documents/run_jobs/run_interactively.html). - - -## Compiling MPI programs on Tegner - -The following shell commands show a simple example on how to compile an MPI program using Fortran, C or C++: +The following shell commands show a simple example on how to compile an MPI program using the GNU compilers: ``` -module load gcc/8.2.0 -module load openmpi/4.0-gcc-8.2 -mpif90 my_prog.f90 -mpicc my_prog.c -mpicxx my_prog.cc +ml PDC +ml cpe/21.11 +ml PrgEnv-gnu +cc my_prog.c +CC my_prog.cpp +ftn my_prog.f90 ``` ## Running MPI programs @@ -46,18 +42,19 @@ mpicxx my_prog.cc First it is necessary to book a node for interactive use: ``` -salloc -A <allocation-name> -N 1 -t 1:0:0 +salloc -A <allocation-name> -p main -N 1 -t 1:0:0 ``` -You might also need to specify a reservation by adding the flag `--reservation=<name-of-reservation>`. +You might also need to specify a **reservation** by adding the flag `--reservation=<name-of-reservation>`. +For the 2022 PDC Summer School the reservation name is ``summer-<date>``, where ``date`` is to be provided in the format ``YYYY-MM-DD``, e.g. ``summer-2022-08-16``. Then the mpirun command is used to launch an MPI application: ``` -mpirun -n 24 ./example.x +mpirun -n 128 ./example.x ``` -In this example we will start 24 MPI tasks (there are 24 cores per node on the Tegner Thin nodes). +In this example we will start 128 MPI tasks (there are 128 cores per node on all Dardel compute nodes). ## MPI Exercises diff --git a/lab1/README.md b/lab1/README.md index ed14cd220413d9399846c0c55bcee46aa405891e..45255164eccdedb7e8284747dc63ddbd4679d722 100644 --- a/lab1/README.md +++ b/lab1/README.md @@ -1,4 +1,4 @@ -# PDC Summer School 2021: MPI Lab 1 +# PDC Summer School 2022: MPI Lab 1 ## Introduction diff --git a/lab2/README.md b/lab2/README.md index 8bbe1c71f9923bc7d1605c489926908469240989..38fe9094125bc40867b9e24fc73d908607c0f65d 100644 --- a/lab2/README.md +++ b/lab2/README.md @@ -1,4 +1,4 @@ -# PDC Summer School 2021: MPI Lab 2 +# PDC Summer School 2022: MPI Lab 2 ## Introduction @@ -64,4 +64,4 @@ Compare the different results and reason about the observed values. ## Acknowledgment -The examples in this lab are provided for educational purposes by [National Center for Supercomputing Applications](http://www.ncsa.illinois.edu/), (in particular their [Cyberinfrastructure Tutor](http://www.citutor.org/)), [Lawrence Livermore National Laboratory](https://computing.llnl.gov/) and [Argonne National Laboratory](http://www.mcs.anl.gov/). Much of the LLNL MPI materials comes from the [Cornell Theory Center](http://www.cac.cornell.edu/). We would like to thank them for allowing us to develop the material for machines at PDC. You might find other useful educational materials at these sites. \ No newline at end of file +The examples in this lab are provided for educational purposes by [National Center for Supercomputing Applications](http://www.ncsa.illinois.edu/), (in particular their [Cyberinfrastructure Tutor](http://www.citutor.org/)), [Lawrence Livermore National Laboratory](https://computing.llnl.gov/) and [Argonne National Laboratory](http://www.mcs.anl.gov/). Much of the LLNL MPI materials comes from the [Cornell Theory Center](http://www.cac.cornell.edu/). We would like to thank them for allowing us to develop the material for machines at PDC. You might find other useful educational materials at these sites.