Skip to content

Commit de32200

Browse files
authored
Merge branch 'main' into wave_wcag_edits
2 parents b606459 + 1ad4eb1 commit de32200

31 files changed

+7770
-7647
lines changed

.github/workflows/auto_merge.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ jobs:
1111
automerge:
1212
runs-on: ubuntu-24.04
1313
steps:
14-
- uses: actions/checkout@v4
14+
- uses: actions/checkout@v6
1515
with:
1616
fetch-depth: 0
1717
- run: |

.github/workflows/checks.yml

Lines changed: 10 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -42,22 +42,17 @@ jobs:
4242
runs-on: ubuntu-24.04
4343
steps:
4444
- name: Checkout Repo
45-
uses: actions/checkout@v4
45+
uses: actions/checkout@v6
4646
with:
4747
fetch-depth: 0
48-
- name: Get changed files
49-
id: get-changed-files
50-
uses: tj-actions/changed-files@v40
51-
with:
52-
files: |
53-
docs/**/*.md
5448
- name: Push Changed files to output
5549
if: inputs.fileList == ''
5650
id: diff
5751
run: |
52+
changed_files="$(git diff --name-only origin/${{ github.base_ref }}...HEAD | grep -E '^docs/.*\.md$' | tr '\n' ' ')"
5853
echo "::info::Workflow triggered by PR"
59-
echo "Changed files: '${{steps.get-changed-files.outputs.all_changed_files}}'"
60-
echo "filelist=${{steps.get-changed-files.outputs.all_changed_files}}" >> $GITHUB_OUTPUT
54+
echo "Changed files: '${changed_files}'"
55+
echo "filelist=${changed_files}" >> $GITHUB_OUTPUT
6156
outputs:
6257
filelist: ${{steps.diff.outputs.filelist || inputs.fileList}}
6358
spellcheck:
@@ -71,7 +66,7 @@ jobs:
7166
run: exit 0
7267
- if: ${{needs.get.outputs.filelist}}
7368
name: Check out repo.
74-
uses: actions/checkout@v4
69+
uses: actions/checkout@v6
7570
- if: ${{needs.get.outputs.filelist}}
7671
name: Install dependencies
7772
run: |
@@ -94,7 +89,7 @@ jobs:
9489
run: exit 0
9590
- if: ${{needs.get.outputs.filelist}}
9691
name: Check out repo.
97-
uses: actions/checkout@v4
92+
uses: actions/checkout@v6
9893
- if: ${{needs.get.outputs.filelist}}
9994
name: Install dependencies
10095
run: pip3 install $(grep ^proselint requirements.txt)
@@ -114,7 +109,7 @@ jobs:
114109
run: exit 0
115110
- if: ${{needs.get.outputs.filelist}}
116111
name: Check out repo.
117-
uses: actions/checkout@v4
112+
uses: actions/checkout@v6
118113
- if: ${{needs.get.outputs.filelist}}
119114
name: Install dependencies
120115
run: npm install -g markdownlint-cli
@@ -135,7 +130,7 @@ jobs:
135130
run: exit 0
136131
- if: ${{needs.get.outputs.filelist}}
137132
name: Check out repo.
138-
uses: actions/checkout@v4
133+
uses: actions/checkout@v6
139134
- if: ${{needs.get.outputs.filelist}}
140135
name: Check markdown meta.
141136
run: |
@@ -153,7 +148,7 @@ jobs:
153148
run: exit 0
154149
- if: ${{needs.get.outputs.filelist}}
155150
name: Check out repo.
156-
uses: actions/checkout@v4
151+
uses: actions/checkout@v6
157152
- if: ${{needs.get.outputs.filelist}}
158153
name: Check markdown meta.
159154
run: |
@@ -165,7 +160,7 @@ jobs:
165160
runs-on: ubuntu-24.04
166161
needs: get
167162
steps:
168-
- uses: actions/checkout@v4
163+
- uses: actions/checkout@v6
169164
with:
170165
fetch-depth: 0
171166
- run: pip3 install -r requirements.txt

.github/workflows/deploy.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ jobs:
2525
sudo apt-get install -y libxml2-dev libxslt-dev python3-dev
2626
shell: bash
2727
- name: Checkout repository
28-
uses: actions/checkout@v4
28+
uses: actions/checkout@v6
2929
with:
3030
fetch-depth: 0
3131
sparse-checkout: |

.github/workflows/fetch_includes.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ jobs:
1414
runs-on: ubuntu-24.04
1515
steps:
1616
- name: Checkout
17-
uses: actions/checkout@v4
17+
uses: actions/checkout@v6
1818
with:
1919
fetch-depth: 0
2020
persist-credentials: true

docs/Announcements/Accessing_NeSI_Support_during_the_Easter_break.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ sources of self-service support:
1919

2020
- Changes to system status are reported via our [System Status page](https://status.nesi.org.nz/ "https://status.nesi.org.nz/").
2121
You can also subscribe for notifications of system updates and
22-
unplanned outages sent straight to your inbox. [Sign up here.](../Getting_Started/Getting_Help/System_status.md)
22+
unplanned outages sent straight to your inbox. [Sign up here.](../Getting_Started/System_status.md)
2323

2424
- [Consult our User Documentation](https://www.docs.nesi.org.nz) pages
2525
for instructions and guidelines for using the systems.

docs/Announcements/December_holiday_support_restrictions.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ END: 9:00am 5 January 2026
3030
</tr>
3131
<tr>
3232
<td>Email: <a href="../General/Announcements/support@nesi.org.nz">support@nesi.org.nz</a></td>
33-
<td>- <a href="../Getting_Started/Getting_Help/System_status.md">Sign up for system status updates</a> for advance warning of any system updates or unplanned outages.<br>- <a href="https://www.docs.nesi.org.nz">Consult our User Documentation</a> pages for instructions and guidelines for using the systems.<br>- <a href="https://www.youtube.com/playlist?list=PLvbRzoDQPkuGMWazx5LPA6y8Ji6tyl0Sp">Visit our YouTube channel</a>  for introductory training webinars.</td>
33+
<td>- <a href="../Getting_Started/System_status.md">Sign up for system status updates</a> for advance warning of any system updates or unplanned outages.<br>- <a href="https://www.docs.nesi.org.nz">Consult our User Documentation</a> pages for instructions and guidelines for using the systems.<br>- <a href="https://www.youtube.com/playlist?list=PLvbRzoDQPkuGMWazx5LPA6y8Ji6tyl0Sp">Visit our YouTube channel</a>  for introductory training webinars.</td>
3434
</tr>
3535
</tbody>
3636
</table>

docs/Announcements/Known_Issues_HPC3.md

Lines changed: 14 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -11,30 +11,31 @@ Below is a list issues that we're actively working on. We hope to have these res
1111

1212
For differences between the new platforms and Mahuika, see the more permanent [differences from Mahuika](../Getting_Started/FAQs/Mahuika_HPC3_Differences.md).
1313

14-
## Access
1514

16-
### OnDemand Apps
17-
* The resources dedicated to interactive work via a web browser are smaller, and so computations requiring large amounts of memory or many CPU cores are not yet supported.
15+
## OnDemand Apps
16+
* Firefox Browser will fail to render the _HPC Shell Access_ app correctly. Please switch to a Chrome or Safari browser until the vendor provides a fix.
1817

19-
* Slurm `sbatch` jobs can be submitted directly from your apps, such as the terminal in Jupyterlab, RSudio or code-server. However, interactive jobs (`srun` or `salloc`) can only run from the `Clusters > NeSI HPC SHell Access` dropdown menu which opens a standard terminal window in the browser. [Watch a demo here](https://youtu.be/bkq6tpRrAwc?si=kS2KBifnCf4d6tWz).
18+
* The resources dedicated to interactive work via a web browser are smaller, and so computations requiring large amounts of memory or many CPU cores are not yet supported.
2019

2120
* Missing user Namespaces in Kubernetes pods will interfere with most Apptainer operations. One can run `apptainer pull` command, `apptainer exec,run,shell` commands can not be executed.
2221

22+
## UCX ERROR
23+
Multi-node MPI jobs may fail on the four nodes mg[13-16] with errors like `UCX ERROR: no active messages transport`. If you encounter this, add the sbatch option `-x mg[13-16]` to avoid those nodes. Single-task jobs are not affected.
2324

24-
## Software
25-
As was already the case on the Milan nodes in Mahuika (where they had a Rocky 8 OS), some of our environment modules cause system software to stop working, e.g: load `module load Perl` and `svn` stops working. This is usually the case if they load `LegacySystem/7` as a dependency. The solutions are to ask us to re-build the problem environment module, or just don't have it loaded while doing other things.
26-
27-
**Delft3D_FM** wasn't working in Mahuika's Milan partition so probably needs rebuilding.
25+
## Core dump files
26+
Contrary to what is stated in [our documentation on core files](../Getting_Started/FAQs/What_is_a_core_file.md), these are not currently available, even if `ulimit -c unlimited` is set.
2827

29-
**MPI** software using 2020 or earlier toolchains eg intel-2020a, may not work correctly across nodes. Trying with more recent toolchains is recommended eg intel-2022a.
28+
## Software
29+
* FileSender - If you modify the `default_transfer_days_valid` parameter in your `~/.filesender/filesender.py.ini` to > 20 it will cause the transfer to fail with a 500 error code. Please do not modify this parameter.
3030

31-
Please let us know if you find any additional problems.
31+
* Legacy Code - Some of our environment modules cause system software to stop working, e.g: do `module load Perl/5.38.2-GCC-12.3.0` and find that `svn` stops working. This is usually the case if they load `LegacySystem/7` as a dependency. The solutions are to ask us to re-build the problem environment module, or just don't have it loaded while doing other things.
32+
33+
* MPI software using 2020 or earlier toolchains eg intel/2020a, may not work correctly across nodes. Trying with more recent toolchains is recommended.
3234

3335
## Slurm
3436

35-
### GPUs
37+
### Requesting GPUs
3638
If you request a GPU without specifying which *type* of GPU, you will get a random one. So please always specify a GPU type.
3739

3840
### BadConstraints
39-
This uninformative message can appear as a reason for a job pending in the `squeue` output when the job is submitted to both `milan` and `genoa` partitions (which is the default behaviour). It does not appear to reflect a real problem though, just a side-effect of the mechanism we are using to target jobs to the right-sized node(s).
40-
41+
This uninformative message can appear in the `squeue` output as the reason for a job pending. It does not always reflect a real problem though, just a side-effect of the mechanism we are using to target jobs to the right-sized node(s) together with a small bug in Slurm. If it causes your job to be put on hold (ie: its priority gets appears as zero in output from `squeue --me -S -p --Format=jobid:10,partition:13,reason:22,numnodes:.6,prioritylong:.6`) then please try `scontrol release <jobid>` or {% include "partials/support_request.html" %} if the issue persists.

docs/Getting_Started/.pages.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ nav:
44
- Projects
55
- Allocations
66
- Accessing_the_HPCs
7-
- Getting_Help
7+
- Getting_Help.md
88
- Cheat_Sheets
99
- "*"
1010
- my.nesi.org.nz: my-nesi-org-nz

docs/Getting_Started/Getting_Help/Consultancy.md renamed to docs/Getting_Started/Consultancy.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,17 +9,16 @@ Our Consultancy service provides scientific and HPC-focused
99
computational and data science support to research projects across a
1010
range of domains.
1111

12-
![Consultancy](../../assets/images/consultancy.png){ width=75% }
12+
![Consultancy](../assets/images/consultancy.png){ width=75% }
1313

1414
!!! success "Case studies"
1515
[See our case studies page for examples of projects our Consultancy service has supported](https://www.reannz.co.nz/case-studies).
1616

17-
1817
## Need support with your research project?
1918

2019
If you would like to learn more about our Consultancy service and how
2120
you can work with our Research Software Engineers on
22-
a project, please {% include "partials/support_request.html" %} to set up an
21+
a project, please {% include "partials/support_request.html" %} to set up an
2322
initial meeting. We can discuss your needs and complete a Consultancy
2423
application form together.
2524

docs/Getting_Started/Creating_an_Account.md

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,21 +2,20 @@
22
created_at: '2018-04-18T23:56:10Z'
33
tags:
44
- onboarding
5-
- howto
6-
- access
75
- mynesi
6+
description: How to create a REANNZ HPC account.
87
---
98

109

1110
!!! prerequisite
12-
Either an active login at a Tuakiri member institution, or
11+
Either an active login at a Tuakiri member institution, or
1312
[a Tuakiri Virtual Home account in respect of your current place of work or study](../Policy/Account_Requests_for_non_Tuakiri_Members.md).
1413

1514
1. Access [my.nesi.org.nz](https://my.nesi.org.nz) via your browser and
1615
log in with either your institutional credentials, or your Tuakiri
1716
Virtual Home account, whichever applies.
1817

19-
2. If this is your first time logging in to my.nesi and you do not have
18+
2. If this is your first time logging in to `my.nesi` and you do not have
2019
an entry in our database (you have not previously had a NeSI
2120
account) you will be asked to fill out some fields, such as your
2221
role at your institution and contact telephone number, and submit

0 commit comments

Comments
 (0)