Added detailed guide on how to set up SSH for the HPC cluster

[niksirbi]

I added a detailed guide on how to SSH into the SWC's HPC cluster. I also included sections on how to configure the .ssh/config file and how to set up SSH key pair authentication. These set up steps should make future interactions with the cluster smoother and will aid remote development.

The text contains many Sphinx design elements and is not easily readable in raw markdown form. I suggest locally building the website to review the rendered result:

• Clone the repo and check out this branch
• Crate a new coding environment (conda or otherwise) and activate it
• Install all the build requirements via pip install -r docs/requirements.txt
• Build the website locally via sphinx-build docs/source docs/build (if you build multiple times, make sure to remove the old build via rm -rf docs/build)
• The rendered website is available at docs/build/index.html

As reviewers I'm tagging:

• @JoeZiminski because he is a Windows user and I'm not entirely sure this works on Windows
• @IgorTatarnikov because he is new at SWC and probably needs to do something like this anyway.

[niksirbi]

For my own reference do we have to be on the UCL/SWC VPN to access the HPC?

I think not? I suppose the bastion node is exposed to external networks, so since we SSH through that, VPN should be unnecessary. But I should test this when home.

But you definitely need VPN to map/mount SWC filesystems on your local computer.

[niksirbi]

Easy to follow and worked fine on macOS while connected to the UCL VPN.

Thank you @IgorTatarnikov !!

[adamltyson]

I think not? I suppose the bastion node is exposed to external networks, so since we SSH through that, VPN should be unnecessary. But I should test this when home.

Yeah, this works without VPN.

[niksirbi]

Hey @JoeZiminski thanks a lot for the Windows insight. I've added the dropdown at the top, giving Windows users two options:

1. Follow along with all commands with Git Bash
2. Use cmd, file browser, and notepad (with the caveats you mentioned)

Have another quick look and approve it if you are happy.

[JoeZiminski]

Looks great @niksirbi love the drop-down. Two small suggestions otherwise LGTM!

[niksirbi]

Thanks both @JoeZiminski and @IgorTatarnikov! I'm going to merge this now.