There are a few steps to setup for the workshop. We strongly recommedn that you complete these before the worksop starts. If you run into problems, please contact the workshop leader at the e-mail address on the home page. We will also provide installation and setup help at the workshop if required, but you will get more out of the training if you can complete them ahead of time.
There are three steps to the setup:
- Ensure your laptop has the bash shell installed
- Ensure that your bash shell is equipped with an SSH client
- Setup an account on the HPC system, Cirrus, that we will be using for the workshop
These steps are described in more detail below.
bash Shell
To participate in an HPC Carpentry workshop, you will need access to a bash shell. Please make sure to install everything (or at least to download the installers) before the start of your workshop. In addition, you will need an up-to-date web browser.
We maintain a list of common issues that occur during installation as a reference for instructors that may be useful on the Configuration Problems and Solutions wiki page.
Windows
- Download the Git for Windows installer
- Run the installer and follow the steps below: a. Click on “Next”. b. Click on “Next”. c. Keep “Use Git from the Windows Command Prompt” selected and click on “Next”. If you forgot to do this programs that you need for the workshop will not work properly. If this happens rerun the installer and select the appropriate option. dlick on “Next”. d. Keep “Checkout Windows-style, commit Unix-style line endings” selected and click on “Next”. e. Keep “Use Windows’ default console window” selected and click on “Next”. f. Click on “Install”. g. Click on “Finish”.
- If your “HOME” environment variable is not set (or you don’t know what this is):
a. Open command prompt (Open Start Menu then type cmd and press [Enter])
b. Type the following line into the command prompt window exactly as shown:
setx HOME "%USERPROFILE%c. Press[Enter], you should seeSUCCESS: Specified value was saved.d. Quit command prompt by typing exit then pressing[Enter]
This will provide you with bash (and SSH) in the Git Bash program.
MacOS
The default shell in all versions of Mac OS X is Bash, so no need to install anything. You access Bash from the Terminal (found in /Applications/Utilities). You may want to keep Terminal in your dock for this workshop.
Linux
The default shell is usually Bash, but if your machine is set up differently you can run it by opening a terminal and typing bash. There is no need to install anything.
SSH
All students should have an SSH client installed. SSH is a tool that allows us to connect to and use a remote computer as our own. Please follow the directions below to install an SSH client for your system.
Windows
You should have SSH available in Git Bash after you installed it according to the instructions above.
An alternative is to install MobaXterm from http://mobaxterm.mobatek.net. You will want to get the Home edition (Installer edition). However, if Git Bash works, you do not need this.
macOS
macOS comes with SSH pre-installed, so you should not need to install anything.
Linux
Linux users do not need to install anything, you should be set!
Account on Cirrus
Please sign up for your account on our HPC machine, Cirrus, which will be available to you for the duration of the course and for a few weeks afterwards, to allow you to complete the practical exercises and put some of what you have learned into practice.
To sign up, you must first register for an account on SAFE (our service administration web application): https://tier2-safe.readthedocs.io/en/latest/safe-guide-users.html
and then request your Cirrus machine account under project tc007: https://tier2-safe.readthedocs.io/en/latest/safe-guide-users.html#tier-2-facilities-accounts-passwords