Standard Terminal Setup

Prerequisite

• Have an active account and project.
• Set up your Linux Password.
• Set up Second Factor Authentication.
• Using standard Linux/Mac terminal or Windows Subsystem for Linux with Ubuntu terminal.

First time setup

The login process can be simplified significantly with a few easy configurations.

1. In a new local terminal run; mkdir -p ~/.ssh/sockets this will create a hidden file in your home directory to store socket configurations.

2. Open your ssh config file with  nano ~/.ssh/config and add the following (replacing username with your username):

   Host mahuika
      User username
      Hostname login.mahuika.nesi.org.nz
      ProxyCommand ssh -W %h:%p lander
      ForwardX11 yes
      ForwardX11Trusted yes
      ServerAliveInterval 300
      ServerAliveCountMax 2
   
   Host maui
      User username
      Hostname login.maui.nesi.org.nz
      ProxyCommand ssh -W %h:%p lander
      ForwardX11 yes
      ForwardX11Trusted yes
      ServerAliveInterval 300
      ServerAliveCountMax 2
   
   Host lander
      User username
      HostName lander.nesi.org.nz
      ForwardX11 yes
      ForwardX11Trusted yes
      ServerAliveInterval 300
      ServerAliveCountMax 2
   
   Host *
       ControlMaster auto
       ControlPath ~/.ssh/sockets/ssh_mux_%h_%p_%r
       ControlPersist 1
   

   Close and save with ctrl x, y, Enter

3. Ensure the permissions are correct by running chmod 600 ~/.ssh/config.

Usage

Assuming you have followed the setup above you will be able to connect to the clusters directly using;

ssh mahuika

or

ssh maui

Subsequent local terminals opened will be able to scp files without having to re-enter authentication e.g.

scp <path/filename> mahuika:~/

(For more info visit data transfer.

What Next?

• Moving files to/from a cluster.
• Setting up an X-Server (optional).