To logon to the NeSI HPCs, you must:
- Have terminal software (see Prerequisites) on your PC.
- Have a NeSI Account. (If you don't have one, please visit: create an account)
- Be a member of a current NeSI research project on the platform you wish to log on to. If you are not a member of a NeSI project team, you can ask to join an existing project team or apply for a new NeSI Project.
Basic logon procedure for testing
First, connect to NeSI’s lander node by typing:
ssh -Y <username>@lander02.nesi.org.nz
inside your terminal program, where
<username> is your NeSI account username. You will see the following prompt:
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.
ssh -Y login.mahuika.nesi.org.nz
You will be prompted for your two authentication factors again. 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.
ssh -Y login.maui.nesi.org.nz
You will need to log in to Māui using your password and the second factor from Google Authenticator, 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.
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.
ssh -Y <username>@login.mahuika.nesi.org.nz
ssh -Y <username>@login.maui.nesi.org.nz
The authentication factors then required are the same as described above, without the lander step.