Logging in to the HPCs

Requirements

Basic login

First, connect to NeSI’s lander node by typing:

ssh <username>@lander02.nesi.org.nz

inside your terminal program, where <username> is your NeSI account username. You will see the following prompt:

First Factor:

Enter your password, after which you will see:

Second Factor (optional):

Enter the 6-digit code from Google Authenticator (these rotate every 30 seconds and can only be used once).

You have now logged onto the lander node.

Next, to see your files, compile code, submit jobs to the scheduler and access your data, you will need to connect to one of the Māui or Mahuika login nodes.

For Mahuika:

ssh login.mahuika.nesi.org.nz

You will be prompted for your two authentication factors again, in the same way as when you logged into the lander node:

First Factor:

Enter your password, after which you will see:

Second Factor (optional):

Unlike when logging on to the lander node, the second factor at this step is in fact optional. We recommend that instead of entering a second factor you just press Enter to continue. However, if you do choose to enter a second factor token, you can't use the same six-digit code that you just used to log in to the lander node; instead, you must wait until Google Authenticator has refreshed the second factor token.

For Māui:

ssh login.maui.nesi.org.nz

Unlike on Mahuika, the password prompt on Māui just asks for a password:

Password:

You will need to log in to Māui using both your password and the Google Authenticator token, e.g. if your first factor (password) is "MySecret1Password" and the current second factor is "123456", then you will enter MySecret1Password123456. Note that you can't use the same six-digit code that you just used to log in to the lander node; instead, you must wait until Google Authenticator has refreshed the second factor token.

We plan to change this so that the second factor will not be required for this step in the future.

Recommended logon procedure

The login process can be simplified to just a single ssh command, jumping across the lander node on the way to either the Māui or Mahuika login nodes.  This is more convenient for login, and practically essential for using X11 GUI programs or transferring data over the ssh connection.  The authentication factors you will be required to enter are the same as described above. e.g. First Factor -> Second Factor -> First Factor -> Second Factor (optional).

Linux/Mac

Terminal Setup

Windows

MobaXterm Setup (Recommended)

WinSCP/PuTTY Setup

 

From the NIWA Network or VPN

If your local machine is inside the NIWA network then you can connect directly to one of the Māui or Mahuika login nodes without involving the lander node.

For Mahuika:

ssh <username>@login.mahuika.nesi.org.nz

For Māui:

ssh <username>@login.maui.nesi.org.nz

The authentication factors then required are the same as described above, without the lander step.

 

Labels: onboarding ssh howto access
Was this article helpful?
2 out of 2 found this helpful