NeSI OnDemand how-to guide

Warning

NeSI OnDemand is in development and accessible to early access users only. If you are interested in helping us test it please contact us.

How to log in

Go to NeSI OnDemand (Early test instance URL: https://163-7-144-39.sslip.io/). It will automatically take you to the Tuakiri login screen.

Select your affiliated institution, and log in using your institutional account. Example below shows the University of Auckland login screen.

After logging in, you will be asked to set up your OTP (one-time password) for NeSI. This is an OTP in addition to your institutional 2FA. We are currently enforcing an additional layer of OTP to make sure our system is secure, as the institutions federated by Tuakiri all have different security policies. We aim to improve this step as we iterate, so that you won’t be asked for the two different OTPs every time you try to log in.

Scan the barcode with your preferred authenticator app (e.g. Google Authenticator), and enter the one-time code (6 digit number) along with a device name (e.g. my mobile) and Submit and you are good to go.

Once you have already set up NeSI OTP, you will be shown the following screen instead of the one above, where you can enter the 6 digit number from your authenticator app.

After successfully logging in, you will be presented with the following NeSI OnDemand screen.

How to launch JupyterLab / RStudio

From the home screen, you can click on the app you would like to launch, e.g. JupyterLab, and you will be taken to the following screen.

You can select the number of cores and memory needed and click on Launch to start the application. Currently our system is reserved with limited number of virtual CPUs and RAM, so selecting a value too high on the number will result in a failure message. On successful launch, you will see a screen similar to below:

Once the session is ready, you will see a button labeled Connect to Jupyter (or other app of your choice), which upon clicking will take you to the JupyterLab in this example as seen below:

How to access your project directory

For this test release, you will be presented only with our ephemeral storage, and access to the research files you have in Mahuika/Maui will be linked in a future release.

OTP token reset process (lost OTP device)

Please contact support@nesi.org.nz with NeSI OnDemand as a part of the subject line and we will get back to you ASAP.