Accessing Cluster

1. Create SSH key pair

If you have already created an SSH key pair before you can skip this part.

For all Operating Systems, you can open a terminal and use the following command to generate an ed25519-based key:

ssh-keygen -t ed25519

You will have the option to select the file name and location to save the keys. You can choose the default options. In this step, you also need to define your password.

2. Register public SSH key on Portal

Before connecting to the machines, users need to register their public SSH keys on the portal.

DeucalionMN5

After receiving your Deucalion credentials via e-mail, you should register your public SSH key on the portal.

Go to Deucalion User Portal settings
On the Security tab click on Upload SSH Key
Paste your public key and give it a name.

(Optional) You can also register a TOTP token to use Open OnDemand — a web interface for accessing Deucalion at login.deucalion.macc.fccn.pt.

After receiving your MN5 credentials via e-mail, you should register your public SSH key on the portal.

Go to the SSH Keys page on the BSC Accounts Portal
Click on Add New SSH Key and upload your public key

Info

The BSC web portal does not upload the keys automatically. Keys are added after human verification, during working hours (Monday-Friday 7h-18h CET/CEST).

3. Connect to the Cluster

Follow the instructions below to connect to Deucalion or Mare Nostrum 5.

Deucalion

Linux/MacOSWindows (powershell)Windows (PuTTY)

Connect via SSH:

ssh <username>@login.deucalion.macc.fccn.pt

Note

You can specify the path to a specific private key, in case you have more than one.

ssh -i <path-to-private-key> <username>@login.deucalion.macc.fccn.pt

Tip: Simplify login

Alternatively, to simplify the login, define a shorter alias. Open a terminal:

cd ~/.ssh
ls

Inside your config file, define the host:

Host deucalion
    Hostname login.deucalion.macc.fccn.pt
    User <username>
    ForwardAgent no
    IdentityFile ~/.ssh/id_ed25519

Connect via:

ssh deucalion

Connect via SSH:

ssh -i <path-to-private-key> -o Ciphers=aes256-gcm@openssh.com -o MACs=hmac-sha2-512-etm@openssh.com <username>@login.deucalion.macc.fccn.pt

Tip: Simplify login

Alternatively, to simplify the login, define a shorter alias. Open a terminal:

cd ~/.ssh
ls

Inside your config file, define the host:

Host deucalion
    Hostname login.deucalion.macc.fccn.pt
    User <username>
    ForwardAgent no
    IdentityFile ~/.ssh/id_ed25519
    Ciphers aes256-gcm@openssh.com
    MACs hmac-sha2-512-etm@openssh.com

Connect via:

ssh deucalion

Open PuTTY
Specify the Host Name (login.deucalion.macc.fccn.pt)
In the Connection > Data tab type your username in the auto-login username field
In the SSH > Auth > Credentials tab go to the private key file for authentication field, click browse and select your private SSH key
Done. Click on Open to connect to Deucalion

Mare Nostrum 5 (MN5)

Linux/MacOSWindows (PuTTY)

Connect via SSH:

Connect to the General Purpose Partition (GPP)
```
ssh {username}@glogin1.bsc.es
```
Connect to the Accelerated Partition (ACC)
```
ssh {username}@alogin1.bsc.es
```

You can also define a shorter alias for these login accesses, similarly to what was described for Deucalion.

Open PuTTY
Specify the Host Name (e.g. glogin1.bsc.es, alogin1.bsc.es depending on the partition)
In the Connection > Data tab type your username in the auto-login username field
In the SSH > Auth > Credentials tab go to the private key file for authentication field, click browse and select your private SSH key
Done. Click on Open to connect to MN5

Mare Nostrum 5 Partitions

Mare Nostrum 5 currently has two main partitions:

GPP: MN5's CPU parition.
ACC: MN5's GPU partition.

For more information check MN5's System Overview.