diff --git a/_data/sidebars/merlin7_sidebar.yml b/_data/sidebars/merlin7_sidebar.yml index 17e750d..5c965e8 100644 --- a/_data/sidebars/merlin7_sidebar.yml +++ b/_data/sidebars/merlin7_sidebar.yml @@ -54,5 +54,7 @@ entries: url: /merlin7/slurm-examples.html - title: Software Support folderitems: + - title: ANSYS + url: /merlin7/ansys.html - title: ANSYS RSM url: /merlin7/ansys-rsm.html diff --git a/pages/merlin7/05-Software-Support/ansys.md b/pages/merlin7/05-Software-Support/ansys.md new file mode 100644 index 0000000..d2c883d --- /dev/null +++ b/pages/merlin7/05-Software-Support/ansys.md @@ -0,0 +1,143 @@ +--- +title: ANSYS +#tags: +keywords: software, ansys, slurm, interactive, rsm, pmodules, overlay, overlays +last_updated: 23 August 2024 +summary: "This document describes how to load and use ANSYS in the Merlin7 cluster" +sidebar: merlin7_sidebar +permalink: /merlin7/ansys.html +--- + +This document describes generic information of how to load and run ANSYS software in the Merlin cluster + +## ANSYS software in Pmodules + +The ANSYS software can be loaded through **[PModules](/merlin7/using-modules.html)**. + +The default ANSYS versions are loaded from the central PModules repository. + +However, we provide local installations on Merlin7 which are needed mainly for some ANSYS packages, like Ansys RSM. +Due to this, and also to improve the interactive experience of the user, ANSYS has been also installed in the +Merlin high performance storage and we have made it available from Pmodules. + +### Loading Merlin7 ANSYS + +For loading the Merlin7 ANSYS software, one needs to run Pmodules v1.1.22 or newer, and then use a specific repository +(called **`merlin`**) which is **only available from the Merlin7 cluster**: + +```bash +module purge +module load Pmodules/1.1.22 +module use merlin +module use unstable +module use /etc/cscs-modules/ +module load cray +module search ANSYS + +# Load the proper ANSYS version, in example for 2022R2 +module load ANSYS/2022R2 +``` +Once `merlin` is invoked, it will disable central ANSYS installations with the same version, which will be replaced +by the local ones in Merlin. Releases from the central Pmodules repository which have not a local installation will remain +visible. For each ANSYS release, one can identify where it is installed by searching ANSYS in PModules with the `--verbose` +option. This will show the location of the different ANSYS releases as follows: +* For ANSYS releases installed in the central repositories, the path starts with `/opt/psi` +* For ANSYS releases installed in the Merlin7 repository (and/or overwritting the central ones), the path starts with `/data/software/pmodules` + +**We strongly recommend only using ANSYS/2022R2 or superior**. + +
+[Example] Loading ANSYS from the Merlin7 PModules repository +
+🔥 [caubet_m@login001:~]# module purge                                              
+🔥 [caubet_m@login001:~]# module load Pmodules/1.1.22                               
+module load: unstable module has been loaded -- Pmodules/1.1.22                                                                                                         
+
+🔥 [caubet_m@login001:~]# module use merlin                                         
+🔥 [caubet_m@login001:~]# module use unstable                                                                                                                           
+🔥 [caubet_m@login001:~]# module use /etc/cscs-modules/                             
+🔥 [caubet_m@login001:~]# module load cray                                          
+                                                                                    
+Activating Modules:                                                                 
+  1) cce/17.0.0                                                                     
+
+🔥 [caubet_m@login001:~]# module load ANSYS/2022R2                                                                                                                      
+module load: unstable module has been loaded -- ANSYS/2022R2          
+
+🔥 [caubet_m@login001:~]# module search ANSYS --verbose
+ANSYS/2019R3:
+  release stage: stable
+  group:         Tools
+  overlay:       base
+  modulefile:    /opt/psi/Tools/modulefiles/ANSYS/2019R3
+  dependencies:  (none)
+ANSYS/2020R1:
+  release stage: stable
+  group:         Tools
+  overlay:       base
+  modulefile:    /opt/psi/Tools/modulefiles/ANSYS/2020R1
+  dependencies:  (none)
+ANSYS/2020R1-1:
+  release stage: stable
+  group:         Tools
+  overlay:       base
+  modulefile:    /opt/psi/Tools/modulefiles/ANSYS/2020R1-1
+  dependencies:  (none)
+ANSYS/2020R2:
+  release stage: unstable
+  group:         Tools
+  overlay:       base
+  modulefile:    /opt/psi/Tools/modulefiles/ANSYS/2020R2
+  dependencies:  (none)
+ANSYS/2021R1:
+  release stage: unstable
+  group:         Tools
+  overlay:       base
+  modulefile:    /opt/psi/Tools/modulefiles/ANSYS/2021R1
+  dependencies:  (none)
+ANSYS/2022R2:
+  release stage: unstable
+  group:         Tools
+  overlay:       merlin
+  modulefile:    /data/software/pmodules/Tools/modulefiles/ANSYS/2022R2
+  dependencies:  (none)
+ANSYS/2023R2:
+  release stage: unstable
+  group:         Tools
+  overlay:       merlin
+  modulefile:    /data/software/pmodules/Tools/modulefiles/ANSYS/2023R2
+  dependencies:  (none)
+ANSYS/2024R1:
+  release stage: unstable
+  group:         Tools
+  overlay:       merlin
+  modulefile:    /data/software/pmodules/Tools/modulefiles/ANSYS/2024R1
+  dependencies:  (none)
+
+
+ + +{{site.data.alerts.tip}} Please only use Merlin7 ANSYS installations from `merlin` in the Merlin cluster. +Also, please always run ANSYS/2022R2 or superior. +{{site.data.alerts.end}} + +## ANSYS Documentation by product + +### ANSYS RSM + +**ANSYS Remote Solve Manager (RSM)** is used by ANSYS Workbench to submit computational jobs to HPC clusters directly from Workbench on your desktop. +Therefore, PSI workstations with direct access to Merlin can submit jobs by using RSM. + +For further information, please visit the **[ANSYS RSM](/merlin7/ansys-rsm.html)** section. + +### ANSYS Fluent + +For further information, please visit the **[ANSYS RSM](/merlin7/ansys-fluent.html)** section. + +### ANSYS CFX + +For further information, please visit the **[ANSYS RSM](/merlin7/ansys-cfx.html)** section. + +### ANSYS MAPDL + +For further information, please visit the **[ANSYS RSM](/merlin7/ansys-mapdl.html)** section.