From 0a15dd90b621feccab8f0d57d40749c83723c76a Mon Sep 17 00:00:00 2001 From: bktan8 Date: Tue, 5 May 2020 11:47:01 -0700 Subject: [PATCH] Simple HPC tutorial (#1121) Closes #1080 Signed-off-by: Bun K Tan --- source/_figures/hpc/hpc-01.png | Bin 0 -> 71780 bytes source/tutorials/hpc.rst | 736 +++++++++++++++++++++++++++++++++ 2 files changed, 736 insertions(+) create mode 100644 source/_figures/hpc/hpc-01.png create mode 100644 source/tutorials/hpc.rst diff --git a/source/_figures/hpc/hpc-01.png b/source/_figures/hpc/hpc-01.png new file mode 100644 index 0000000000000000000000000000000000000000..91d94556ab36e1a0c83cb7bf5efefc0288aaed07 GIT binary patch literal 71780 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 z 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 P0S ~/ssh_known_hosts + sudo cp -v ~/ssh_known_hosts /etc/ssh + rm ~/ssh_known_hosts + + #. Restart the SSH service. + + .. code-block:: bash + + sudo systemctl restart sshd + +#. On the controller node, SSH into each worker node without having to enter + a password. At the first-time connection to each host, you'll be asked to + add the unknown host to the :file:`$HOME/.ssh/known_hosts` file. Accept + the request. This is will make future SSH connections to each host be + non-interactive. + + .. code-block:: bash + + ssh + + .. note:: + + Setting up host-based authentication on + :abbr:`CSP (Cloud Service Provider)` environments such as Microsoft Azure + and Amazon AWS may require some tweaking on the worker nodes' SSH + configurations due to the CSP's virtual network setup. In general, + cloud VMs have a public and private DNS name. When SSH'ing from the + controller to a worker node, the SSH client may send the controller's + private DNS name, usually something with "internal" in the name, + as the `chost` instead of its public FQDN as expected in worker node's + :file:`/etc/hosts.equiv`, :file:`/root/.shosts`, and + :file:`/etc/ssh/ssh_known_hosts` files. If the above configurations + do not work, meaning you're asked to enter a password when + SSH'ing from the controller to a worker node, on a cloud VM, here are + some suggestions for debugging the problem: + + #. On the controller, try to identify the chost data sent by the SSH + client using :command:`ssh -vvv `. Look for `chost` + in the debug log. If the chost value is different than the controller's + FQDN listed in worker node's :file:`/etc/hosts.equiv`, + :file:`/root/.shosts`, and :file:`/etc/ssh/ssh_known_hosts` files, + then that is likely the cause of the problem. In some cases, chost + data may not be shown. If so, it's safe to assume that the SSH client + is using the controller's private DNS name as the chost. Proceed to + steps 2 and 3 below to fix the problem. + + #. Get the controller's private DNS name either by the above step or by + getting it from your system administrator. + + #. On the worker node, make these changes: + + #. Change the controller's FQDN in :file:`/etc/hosts.equiv`, + :file:`/root/.shosts`, and :file:`/etc/ssh/ssh_known_hosts` + to its private DNS name. + + #. Restart the SSH service on the worker node. + + #. Retest the connection from the controller node to the worker node. + If that still doesn't work, try the SSH directive + `HostbasedUsesNameFromPacketOnly yes` which tell the SSH service + to accept the supplied host name as is and not try to resolve it. + Also, set the directive `UseDNS` to `no` to disable host name lookup. +#. Verify you can issue a simple command over SSH without typing a password. + + a. Issue the :command:`hostname` command. + + .. code-block:: bash + + ssh hostname + + #. Issue the :command:`hostname` command with :command:`sudo`. + + .. code-block:: bash + + ssh sudo hostname + + In both cases, you should get a response with the worker node's hostname. + If the `sudo` version requires additional permission, grant the user + `NOPASSWD` privilege. For example: + + #. Edit the sudoer file. + + .. code-block:: bash + + sudo visudo + + #. Add the following: + + .. code-block:: console + + ALL=(ALL) NOPASSWD: ALL + +Create :file:`slurm.conf` configuration file +******************************************** + +On the controller, create a new :file:`slurm.conf` configuration file +that contains general settings, each node's hardware resource information, +grouping of nodes into different partitions, and scheduling settings for +each partition. This file will be copied to all worker nodes in the cluster. + +#. Create a base :file:`slurm.conf` configuration file. + + .. code-block:: bash + + sudo mkdir -p /etc/slurm + sudo cp -v /usr/share/defaults/slurm/slurm.conf /etc/slurm + +#. Add the controller information. + + a. :command:`sudoedit` the :file:`slurm.conf` file. Set the `ControlMachine` + value to the controller's resolvable hostname. + + For example: + + .. code-block:: console + + ControlMachine=hpc-controller + + .. note:: + + Assuming the controller's FQDN is resolvable, specifying the + controller's IP address with the `ControlAddr` key is optional. + However, it maybe helpful to add it. + + #. Save and exit. + +#. Add the worker nodes information. + + a. Create a file containing a list of the worker nodes. + + .. code-block:: bash + + cat > worker-nodes-list << EOF + hpc-worker1 + hpc-worker2 + hpc-worker3 + hpc-worker4 + EOF + + #. Using pdsh, get the hardware configuration of each node. + + .. code-block:: bash + + pdsh -w ^worker-nodes-list slurmd -C + + Example output: + + .. code-block:: console + + hpc-worker4: NodeName=hpc-worker4 CPUs=1 Boards=1 SocketsPerBoard=1 CoresPerSocket=1 ThreadsPerCore=1 RealMemory=1915 + hpc-worker4: UpTime=0-01:23:28 + hpc-worker3: NodeName=hpc-worker3 CPUs=1 Boards=1 SocketsPerBoard=1 CoresPerSocket=1 ThreadsPerCore=1 RealMemory=1663 + hpc-worker3: UpTime=0-01:33:41 + hpc-worker2: NodeName=hpc-worker2 CPUs=1 Boards=1 SocketsPerBoard=1 CoresPerSocket=1 ThreadsPerCore=1 RealMemory=721 + hpc-worker2: UpTime=0-01:34:56 + hpc-worker1: NodeName=hpc-worker1 CPUs=1 Boards=1 SocketsPerBoard=1 CoresPerSocket=1 ThreadsPerCore=1 RealMemory=721 + hpc-worker1: UpTime=0-01:39:21 + + #. :command:`sudoedit` the :file:`slurm.conf` file. Append each worker node + information, but without the `UpTime`, under the `COMPUTE NODES` section. + + .. tip:: + + It is strongly recommended to set the `RealMemory` value for each + worker node slightly below, say 90%, what was reported by + :command:`slurmd -C` + in case some memory gets use by some processes, which would + cause Slurm to make a node not available due to its memory + resource falling below the stated value in the configuration file. + + Here's an example with four worker nodes: + + .. code-block:: console + + # + # COMPUTE NODES (mode detailed values reported by "slurmd -C" on each node) + NodeName=hpc-worker1 CPUs=1 Boards=1 SocketsPerBoard=1 CoresPerSocket=1 ThreadsPerCore=1 RealMemory=648 + NodeName=hpc-worker2 CPUs=1 Boards=1 SocketsPerBoard=1 CoresPerSocket=1 ThreadsPerCore=1 RealMemory=648 + NodeName=hpc-worker3 CPUs=1 Boards=1 SocketsPerBoard=1 CoresPerSocket=1 ThreadsPerCore=1 RealMemory=1497 + NodeName=hpc-worker4 CPUs=1 Boards=1 SocketsPerBoard=1 CoresPerSocket=1 ThreadsPerCore=1 RealMemory=1723 + + #. Create partitions. + + A Slurm partition is basically the grouping of worker nodes. + Give each partition a name and decide which worker node(s) belong to + it. + + For example: + + .. code-block:: console + + PartitionName=workers Nodes=hpc-worker1, hpc-worker2, hpc-worker3, hpc-worker4 Default=YES MaxTime=INFINITE State=UP + PartitionName=debug Nodes=hpc-worker1, hpc-worker3 MaxTime=INFINITE State=UP + + #. Save and exit. + + #. Set the ownership of the :file:`slurm.conf` file to `slurm`. + + .. code-block:: bash + + sudo chown slurm: /etc/slurm/slurm.conf + +#. On the controller node, restart the Slurm controller service. + + .. code-block:: bash + + sudo systemctl restart slurmctld + +#. Verify the Slurm controller service restarted without any issues before + proceeding. + + .. code-block:: bash + + sudo systemctl status slurmctld + + + +Copy MUNGE key and :file:`slurm.conf` to all worker nodes +********************************************************* + +On the controller node, using pdsh, in conjunction with the list of +defined nodes in the :file:`slurm.conf`, copy it and the MUNGE key to +all worker nodes. + +#. On the controller node, copy the MUNGE key to all worker nodes and start the + MUNGE service. + + a. Create the :file:`/etc/munge/` directory on each node. + + .. code-block:: bash + + sudo pdsh -P workers mkdir /etc/munge + + #. Copy the MUNGE key over. + + .. code-block:: bash + + sudo pdcp -P workers /etc/munge/munge.key /etc/munge + + #. Set the ownership of the :file:`munge.key` file to `munge`. + + .. code-block:: bash + + sudo pdsh -P workers chown munge: /etc/munge/munge.key + + #. Start the MUNGE service and set it to start automatically on boot. + + .. code-block:: bash + + sudo pdsh -P workers systemctl enable munge --now + + #. Verify the MUNGE service is running. + + .. code-block:: bash + + sudo pdsh -P workers "systemctl status munge | grep Active" + + Example output: + + .. code-block:: console + + hpc-worker3: Active: active (running) since Wed 2020-04-15 19:47:58 UTC; 55s ago + hpc-worker4: Active: active (running) since Wed 2020-04-15 19:47:58 UTC; 55s ago + hpc-worker2: Active: active (running) since Wed 2020-04-15 19:47:59 UTC; 54s ago + hpc-worker1: Active: active (running) since Wed 2020-04-15 19:47:59 UTC; 54s ago + +#. On the controller node, copy the :file:`slurm.conf` file to all + worker nodes and start the slurmd service on them. + + a. Create the :file:`/etc/slurm/` directory on each worker node. + + .. code-block:: bash + + sudo pdsh -P workers mkdir /etc/slurm + + #. Copy the :file:`slurm.conf` file over. + + .. code-block:: bash + + sudo pdcp -P workers /etc/slurm/slurm.conf /etc/slurm + + #. Set the ownership of the :file:`slurm.conf` file to `slurm`. + + .. code-block:: bash + + sudo pdsh -P workers chown slurm: /etc/slurm/slurm.conf + + #. Start the Slurm service and set it automatically start on boot. + + .. code-block:: bash + + sudo pdsh -P workers systemctl enable slurmd --now + + #. Verify the slurmd service is running. + + .. code-block:: bash + + sudo pdsh -P workers systemctl status slurmd | grep Active + + Example output: + + .. code-block:: console + + hpc-worker3: Active: active (running) since Wed 2020-04-15 19:39:22 UTC; 1min 17s ago + hpc-worker4: Active: active (running) since Wed 2020-04-15 19:39:22 UTC; 1min 17s ago + hpc-worker2: Active: active (running) since Wed 2020-04-15 19:39:23 UTC; 1min 17s ago + hpc-worker1: Active: active (running) since Wed 2020-04-15 19:39:23 UTC; 1min 17s ago + +Verify controller can run jobs on all nodes +******************************************* + +#. Check the state of the worker nodes. + + .. code-block:: bash + + sinfo + + Example output: + + .. code-block:: console + + PARTITION AVAIL TIMELIMIT NODES STATE NODELIST + workers* up infinite 4 idle hpc-worker[1-4] + debug up infinite 2 idle hpc-worker[1,3] + + .. tip:: + + If the nodes are in a "down" state, put them in the "idle" state. + + For example: + + .. code-block:: bash + + sudo scontrol update nodename=hpc-worker[1-4] state=idle reason="" + + Additional `Slurm troubleshooting tips`_. + +#. And finally, verify Slurm can run jobs on all 4 worker nodes by issuing + a simple :command:`hostname` command. + + .. code-block:: bash + + srun -N4 -p workers hostname + + Example output: + + .. code-block:: console + + hpc-worker4 + hpc-worker3 + hpc-worker1 + hpc-worker2 + +Create and run example scripts +****************************** + +Example 1: Return the hostname of each worker and output to :file:`show-hostnames.out` +====================================================================================== + +#. On the controller node, create the Slurm :file:`show-hostnames.sh` script. + + .. code-block:: bash + + cat > show-hostnames.sh << EOF + #!/bin/bash + # + #SBATCH --job-name=show-hostnames + #SBATCH --output=show-hostnames.out + # + #SBATCH --ntasks=4 + #SBATCH --time=10:00 + #SBATCH --mem-per-cpu=100 + #SBATCH --ntasks-per-node=1 + + srun hostname + EOF + +#. Execute the script. + + .. code-block:: bash + + sbatch show-hostnames.sh + + The result will appear on the first node of the partition used. As no + partition was explicitly specified, it would be the default partition. + +#. View the result. + + .. code-block:: bash + + pdsh -w hpc-worker1 "cat show-hostnames.out" + + Example output: + + .. code-block:: console + + hpc-worker1: hpc-worker3 + hpc-worker1: hpc-worker4 + hpc-worker1: hpc-worker1 + hpc-worker1: hpc-worker2 + +Example 2: An MPI "Hello, World!" program +========================================= + +#. On the controller node, create the :file:`mpi-helloworld.c` program. + + .. code-block:: bash + + cat > mpi-helloworld.c << EOF + #include + #include + #include + + int main(int argc, char** argv) + { + // Init the MPI environment + MPI_Init(NULL, NULL); + + // Get the number of processes + int world_size; + MPI_Comm_size(MPI_COMM_WORLD, &world_size); + + // Get the rank of the process + int world_rank; + MPI_Comm_rank(MPI_COMM_WORLD, &world_rank); + + // Get the name of the processor + char processor_name[MPI_MAX_PROCESSOR_NAME]; + int name_len; + MPI_Get_processor_name(processor_name, &name_len); + + // Print a hello world message + printf("Hello, World! from from processor %s, rank %d out of %d processors\n", processor_name, world_rank, world_size); + + // Finalize the MPI environment + MPI_Finalize(); + } + EOF + +#. Add the `c-basic` and `devpkg-openmpi` bundles, which are needed to compile + it. + + .. code-block:: bash + + sudo swupd bundle-add c-basic devpkg-openmpi + +#. Compile it. + + .. code-block:: bash + + mpicc -o mpi-helloworld mpi-helloworld.c + +#. Copy the binary to all worker nodes. + + .. code-block:: bash + + pdcp -P workers ./mpi-helloworld $HOME + +#. Create a Slurm batch script to run it. + + .. code-block:: bash + + cat > mpi-helloworld.sh << EOF + #!/bin/sh + #SBATCH -o mpi-helloworld.out + #SBATCH --nodes=4 + #SBATCH --ntasks-per-node=1 + + srun ./mpi-helloworld + EOF + +#. Run the batch script. + + .. code-block:: bash + + sbatch mpi-helloworld.sh + +#. View the results on first worker node in the partition. + + .. code-block:: bash + + pdsh -w hpc-worker1 "cat mpi-helloworld.out" + + Example output: + + .. code-block:: console + + Hello, World! from from processor hpc-worker3, rank 2 out of 4 processors + Hello, World! from from processor hpc-worker4, rank 3 out of 4 processors + Hello, World! from from processor hpc-worker1, rank 0 out of 4 processors + Hello, World! from from processor hpc-worker2, rank 1 out of 4 processors + +.. _Slurm: + https://en.wikipedia.org/wiki/Slurm_Workload_Manager + +.. _MUNGE: + https://dun.github.io/munge/ + +.. _pdsh: + https://linux.die.net/man/1/pdsh + +.. _Slurm troubleshooting tips: + https://slurm.schedmd.com/troubleshoot.html