From 1dabe854af33ef707e1d4dd6dc6cccdf613edadc Mon Sep 17 00:00:00 2001
From: sjanoriy-epcc <152512070+sjanoriy-epcc@users.noreply.github.com>
Date: Thu, 30 Nov 2023 14:53:52 +0000
Subject: [PATCH 1/2] updated port number for ssh tunnel

Updated port number to 443 for creating the tunnel.
Replaced 80 -> 443
---
 docs/tursa-user-guide/data.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/tursa-user-guide/data.md b/docs/tursa-user-guide/data.md
index 81c5a38..4e2f354 100644
--- a/docs/tursa-user-guide/data.md
+++ b/docs/tursa-user-guide/data.md
@@ -99,13 +99,13 @@ in a web browser on your local system by setting up an SSH tunnel to the
 Tursa login nodes.
 
 You do this by logging into Tursa in the usual way (with your SSH key and password)
-and adding the `-L 9080:10.144.12.95:80` option to the `ssh` command.
+and adding the `-L 9080:10.144.12.95:443` option to the `ssh` command.
 
 For example, if your username is `dc-user1`, you would setup the tunnel
 by logging into Tursa with (assuming your SSH key is in the default location):
 
 ```
-ssh -L 9080:10.144.12.95:80 dc-user1@tursa.dirac.ed.ac.uk
+ssh -L 9080:10.144.12.95:443 dc-user1@tursa.dirac.ed.ac.uk
 ```
 
 Enter your SSH key passphrase and password in the usual way.

From 8f87e74af6f6c7ffbbcee6a234ceebc2d2daf364 Mon Sep 17 00:00:00 2001
From: Andy Turner <a.turner@epcc.ed.ac.uk>
Date: Thu, 30 Nov 2023 15:38:39 +0000
Subject: [PATCH 2/2] Adds nvhpc and cmake

---
 docs/tursa-user-guide/sw-environment.md | 62 ++++++++++++++++++++++---
 1 file changed, 56 insertions(+), 6 deletions(-)

diff --git a/docs/tursa-user-guide/sw-environment.md b/docs/tursa-user-guide/sw-environment.md
index 3354b5b..b076ce5 100644
--- a/docs/tursa-user-guide/sw-environment.md
+++ b/docs/tursa-user-guide/sw-environment.md
@@ -12,7 +12,7 @@ which software and versions are available to you.
 By default, all users on Tursa start with the default software
 environment loaded.
 
-Software modules on Tursa are provided by both ATOS and by EPCC.
+Software modules on Tursa are provided by both Eviden and by EPCC.
 
 In this section, we provide:
 
@@ -281,13 +281,14 @@ unset OMP_NUM_THREADS
 
 ## Compiler environment
 
-The system supports the following compilers and MPI library:
+The system supports two different primary compiler environments:
 
-- GCC 9.3.0
-- CUDA 11.4
-- OpenMPI 4.1.1
+* GCC toolchain: GCC, CUDA 11.4, OpenMPI 4.1.1
+* NVHPC toolchain: NVHPC 21.7, OpenMPI 4.1.1
 
-To compile on the system, you would typically load the required modules:
+### GCC toolchain
+
+To compile on the system for GPU nodes using the GCC toolchain, you would typically load the required modules:
 
 ```
 [dc-user1@tursa-login1 ~]$ module load gcc/9.3.0
@@ -308,4 +309,53 @@ scripts are available:
 You can find more information on these scripts in the
 [OpenMPI documentation](https://www.open-mpi.org/doc/v4.1/).
 
+### NVHPC toolchain
+
+To compile on the system for GPU nodes using the GCC toolchain, you would typically load the required modules:
 
+```
+[dc-user1@tursa-login1 ~]$ module load /home/y07/shared/tursa-modules/setup-env
+[dc-user1@tursa-login1 ~]$ module load gcc/9.3.0
+[dc-user1@tursa-login1 ~]$ module load nvhpc/21.7-nompi
+[dc-user1@tursa-login1 ~]$ module load openmpi/4.1.1-cuda11.4
+[dc-user1@tursa-login1 ~]$ module list
+Currently Loaded Modulefiles:
+ 1) /mnt/lustre/tursafs1/home/y07/shared/tursa-modules/setup-env   2) nvhpc/21.7-nompi
+ 3) ucx/1.12.0-cuda11.4   4) openmpi/4.1.1-cuda11.4    5) gcc/9.3.0
+```
+
+Once you have loaded the modules, the standard OpenMPI compiler wrapper
+scripts are available:
+
+- `mpicc`
+- `mpicxx`
+- `mpif90`
+
+and the NVIDIA compilers are available as:
+
+- `nvcc`
+- `nvc++`
+- `nvfortran`
+
+!!! tip
+    Both the NVIDIA compilers and the MPI compiler wrapper scripts will use the GCC
+    compilers directly in the default configuration - this is often what you want. If
+    you want the compiler wrappers to call the NVIDIA compilers themselves rather than 
+    GCC directly, you would use:
+
+    ```
+    export OMPI_CC=nvcc
+    export OMPI_CXX=nvc++
+    export OMPI_FC=nvfortran
+    ```
+
+## Other build tools
+
+### cmake
+
+CMake is available by using the commands:
+
+```
+[dc-user1@tursa-login1 ~]$ module load /home/y07/shared/tursa-modules/setup-env
+[dc-user1@tursa-login1 ~]$ module load cmake
+```