Table of Contents

๐Ÿ” How to Get Access to the Cluster

To gain access to the cluster, follow the steps below to generate an SSH key and send it to the administrators.

๐Ÿ–ฅ๏ธ Step 1: Generate an SSH Key Pair

๐Ÿ”ท Linux / macOS

Open your terminal.

Run the following command:

ssh-keygen -t ecdsa -b 521  -C "your_email@example.com"
#Press Enter to accept the default file location (~/.ssh/id_ecdsa).
#(Optional) Set a passphrase for added security.

This will generate:

~/.ssh/id_ecdsa (your private key)

~/.ssh/id_ecdsa.pub (your public key)

๐ŸŸฆ Windows (using PowerShell or Git Bash)

Option 1: Git Bash (Recommended) Install Git for Windows if you donโ€™t have it.

Open Git Bash and run:

ssh-keygen -t ecdsa -b 521  -C "your_email@example.com"
#Accept the default location (/c/Users/YourName/.ssh/id_ecdsa) and set a passphrase if desired.
#(Optional) Set a passphrase for added security.

Option 2: PowerShell (with OpenSSH) Open PowerShell (Run as Administrator).

Run:

ssh-keygen -t ecdsa -b 521 -C "your_email@example.com"
# Press Enter to use the default save path (C:\Users\YourName\.ssh\id_ecdsa).

</code>

๐Ÿ“ค Step 2: Send Your Public Key

Find your public key:

Linux/macOS: ~/.ssh/id_ecdsa.pub

Windows: C:\Users\YourName\.ssh\id_ecdsa.pub (or in Git Bash: ~/.ssh/id_ecdsa.pub)

Send it via email to: ๐Ÿ“ง admin@unite.cluster

โœ… Step 3: Wait for Confirmation

The administrators will create your cluster account and add your SSH key. Youโ€™ll receive login details once setup is complete.

๐Ÿ”Œ Step 4: Connect to the Cluster

After youโ€™re granted access, connect to the cluster with:

  1. Click โ€œSessionโ€ in the top-left corner.
  2. In the Session settings window, select SSH.
  3. In the Remote host field, enter the cluster address (e.g., storage1.unite.uni-sofia.bg).
  4. In the Specify username field, enter your cluster username.
  5. Under the โ€œAdvanced SSH settingsโ€ tab, click โ€œUse private keyโ€ and browse for the private key file you saved earlier (e.g., id_ecdsa).
  6. Click โ€œOKโ€ to save the session.
        Host unite.uni-sofia.bg
        HostName storage2.unite.uni-sofia.bg
        User <your_username>
        IdentityFile ~/.ssh/id_unite