Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

To authenticate yourself, Open open a Windows Terminal or Powershell and run tsh, giving the location of our Teleport gateway:

...

You can find the right values for those two parameters in the output of the tsh command:

Excerpt
  1. Open the File Explorer and navigate to C:\Users\yourwindowsuser\
  2. If you have a directory called  ".ssh" directory, go inside. If not, you may create it with clicking on "New Folder"
  3. Inside the .ssh directory, check if there is a file called "config".
    1. If config exist, open it with your favourite editor, such as notepad or vscode.
    2. If config does not exist, you can open your favourite editor such as notepad or vscode to create the file and save it later
  4. Add the snipped below in the file you opened.

    Code Block
    languagetext
    titleSSH config snippet in ~/.ssh/config
    Host jump.ecmwf.int a?-* a??-* hpc-* hpc2020-* ecs-*
      User ecmwfusername 
      IdentityFile ~/.tsh/keys/jump.ecmwf.int/user.address@somewhere.com
      CertificateFile ~/.tsh/keys/jump.ecmwf.int/user.address@somewhere.com-ssh/jump.ecmwf.int-cert.pub
      HostKeyAlgorithms +ssh-rsa*,rsa-sha2-512
      PubkeyAcceptedKeyTypes +ssh-rsa*
      ServerAliveInterval 60
      TCPKeepAlive yes
    
    Host a?-* a??-* hpc-* hpc2020-* ecs-*
      ProxyJump jump.ecmwf.int

    You should replace ecmwfusername by your registered ECMWF user and user.address@somewhere.com by your registered email address at ECMWF.

    tip

    Multiexcerpt include
    MultiExcerptNamessh_config
    PageWithExcerptTeleport SSH Access - Linux configuration

titleNot sure about username and email?
Panel

% tsh login
> Profile URL: https://jump.ecmwf.int:443
Logged in as: user.address@somewhere.com
Cluster: jump.ecmwf.int
Roles:
Logins: ecmwfusername
Kubernetes: disabled
Valid until: 2022-12-13 20:54:18 +0000 GMT [valid for 3h56m0s]
Extensions: permit-X11-forwarding, permit-agent-forwarding, permit-port-forwarding, permit-pty  

Save the file. If you are creating the file from scratch, make sure you save it under C:\Users\yourwindowsuser\.ssh and with the name "config", including the double quotes. The file must not have any extension.

SSH connection

Once you have configured the appropriate settings, any SSH-based tools such as ssh, scp or rsync should work out of the box without any additional options.

...

Visit our HPCF User Guide for further information.

Troubleshooting

If you cannot connect via SSH and cannot manage to understand why, please raise an issue to our ECMWF Support portal and sending us the output of the commands:

No Format
tsh login
ssh -v ecs-login

Multiexcerpt include
MultiExcerptNamereport_problem
PageWithExcerptTeleport SSH Access - Linux configuration
You should also include information about your computer (Operating system and teleport version) to help us narrow down the problem.