- Have an active account and project.
- Set up your NeSI Account Password.
- Set up Two-Factor Authentication.
Before you can start submitting work you will need some way of connecting to the NeSI clusters.
This is done by establishing an SSH (Secure SHell) connection, giving you access to a command line interface (bash) on the cluster. In order to set up such a connection, you will need a suitable Terminal (or equivalent application). The correct option for you depends on your operating system and level of experience.
JupyterHub is a service providing access to Jupyter Notebooks on NeSI. A terminal similar to the other setups describe below can be accessed through the Jupyter Launcher.
- More info on Jupyter Terminal
- Visit jupyter.nesi.org.nz.
Linux or Mac OS
On MacOS or Linux you will already have a terminal emulator installed, usually called, "Terminal." To find it, simply search for "terminal".
Congratulations! You are ready to move to the next step.
- Setting up your Default Terminal
As Windows is not a "Unix-Like" operating system, getting access to a functional terminal requires some additional steps. There are several different options, listed in order of preference.
Ubuntu Terminal (Windows 10)
The Ubuntu Terminal and Windows Subsystem for Linux require administrative privileges to enable and install them. If your institution has not given you such privileges, consider using another option such as MobaXTerm Portable Edition (see below).
This is the most functional replication of a Unix terminal available on Windows, and allows users to follow the same set of instructions given to Mac/Linux users. It may be necessary to enable Windows Subsystem for Linux (WSL) first.
- Enabling WSL
- Setting up the Ubuntu Terminal
- Setting up X-Forwarding
In addition to being a terminal emulator, MobaXterm also includes several useful features like multiplexing, X11 forwarding and a file transfer GUI.
MobaXterm can be downloaded from here. The portable edition will allow you to use MobaXterm without needing administrator privileges, however it introduces several bugs so we highly recommend using the installer edition if you have administrator privileges on your workstation or if your institution's IT team supports MobaXTerm.
- Setting up MobaXterm
Using a Virtual Machine
In order to avoid the problems of using a Windows environment, it may be advisable to install a Linux Virtual machine. This may be advantageous in other ways as many elements of scientific computing require a Linux environment, also it can provide a more user friendly place to become familiar with command line use.
There are multiple free options when it comes to VM software. We recommend Oracle VirtualBox.
Further instructions on how to set up a virtual machine can be found here.
Once you have a working VM you may continue following the instructions as given for Linux/MacOS.
- Setting up a Virtual Machine
WinSCP has some advantages over MobaXterm (customisable, cleaner interface, open source), and some disadvantages (no built in X-server, additional authentication step). However, WinSCP setup is more involved than with MobaXterm, therefore we do not recommend it for new users.
- Setting up WinSCP
If you are using Git for version control you may already have Git Bash installed. If not it can be downloaded from here.
Git Bash is perfectly adequate for testing your login or setting up your password, but lacks many of the features of MobaXterm or a native Unix-Like terminal. Therefore we do not recommend it as your primary terminal.
All Windows computers have PowerShell installed, however it will only be useful to you if Windows Subsystem for Linux (WSL) is also enabled, instructions here.
Like Git Bash, PowerShell is perfectly adequate for testing your login or setting up your password, but lacks many of the features of MobaXterm or a native Unix-Like terminal. Therefore we do not recommend it as your primary terminal.