How to login to the Leonardo cluster¶
The Leonardo supercomputer is one of the fastest supercomputers in the world and one of the recent additions in the EuroHPC JU family. Login to Leonardo follows strict requirements to ensure security, safeguarding sensitive information and ensuring the integrity of its operations.
Here are the step-by-step procedures to get started.
- Registration at CINECA UserDB portal
- Association your account with an active project
- Request to access to CINECA HPC cluster
- Configuration of 2FA and OTP
- Install and configuration of smallstep client
- Managing password, 2FA and OTP
Step 1: Registration at CINECA UserDB portal¶
In order to have access on Leonardo, it is necessary to complete the registration procedure on CINECA UserDB portal.
- Click on the “Create a New User” button and filling in the required fields
- Uploading an ID card (passport for non-Italian) in the Documents for HPC tab, complete the information about your Institution and check your Personal Data.
- Your CINECA ID looks like YOUR.NAME_xxxxx [uid: xxxxx], in which xxxxx is a 5-digit string consising of numbers.
Step 2: Association your account with an active project¶
Send your id account at CINECA to the project leader and ask for an access to an existing project.
Step 3: Request to access CINECA HPC cluster¶
Once your username has been associated with an active account, you can request access to CINECA HPC clusters. Make sure following info are OK, see the figure below.
- Personal data
- Institution
- HPC DOCs
- Authorization
- Clicking the button Submit on your HPC Access page.
- Wait for several hours …
- Once approved your request, you will receive two emails
- one email with the username
- another with the link to a page showing how to:
- configure the two-factor authentication (2FA)
- configure the OTP
Step 4: Configuration of 2FA and OTP¶
Two-factor authentication (2FA) refers to an authentication method in which a user is granted access to the CINECA HPC systems only after successfully presenting two pieces of evidence (or factors).
Verifying your identity, using an independent second factor, prevents other users from logging in with your identity, even if they have the password.
Therefore, the two-factor authentication (2FA) adds a further level of security to the authentication for access to services based on the Identity Provider.
The detailed instcutions from CINECA's documentation for the configuration of 2FA and OTP are available here.
The last step, once you have successfully inserted the 6-digit code from FreeOPT/Goolge Authentiator, you will get the Recovery codes (shown below). Please save these codes somewhere by downloading, printing or copying in a text file.
Step 5: Install and configuration of the smallstep client¶
Once the 2FA will be enabled as the only method to authenticate on CINECA clusters, you will need to install and configure on your PC a program that allows you to authenticate via 2FA and to download locally the temporary certificate. The CINECA recommends the smallstep client.
Detailed instructions are available here.
IMPORTANT: users with Ubuntu operating systems (but may happen also for other Linux distributions) should not run the command “sudo apt install step” because this will install a different software that will give errors when following the below instructions.
Step 6: Managing password, 2FA and OTP¶
More details about change the password, recover one-time password generator, as well as renew the recovery codes are availalbe here.