Versions Compared

Old Version 8

changes.mady.by.user Xavier Abellan

Saved on

compared with

New Version 9

changes.mady.by.user Xavier Abellan

Saved on

Key

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

These are the instructions on how to install and configure your Teleport SSH access on the native Windows Terminal or Powershell to connect to ECMWF services such as the Atos HPCF and ECGATE services.

Info

Check the following pages if you are using another Windows method:

Teleport SSH Access - Windows Subsystem for Linux (WSL)

Teleport SSH Access - Windows MobaXterm configuration

Teleport SSH Access - Windows Cygwin configuration

Table of Contents

Table of Contents
excludeTable of Contents

Demo

Here is a demonstration on how to set up Teleport to connect to our our Atos HPCF from your terminal on a Windows 10 or 11. You can find the step by step guide described below.

View file
nameplaceholder_windows.mov
height250


Installing the tsh client

The tsh application is required to perform user authentication.

tsh is open source, very portable, and has minimal dependencies.

Go to the Teleport website and make sure you download the "tsh client" instead of "Teleport Connect" for Windows.

You will need to extract the zip file and put the "tsh.exe" executable somewhere in your PATH. The easiest way to do this is to:

  1. Open the zip file in your file browser
  2. Drag the teleport folder inside the file and drop into the directory of your choice (the main directory for your user, for example)

  3. Open a Powershell and add to the PATH variable the location of the teleport directory. For example, if you dropped it on your main user directory (C:\Users\yourusername):

    No Format
    setx PATH "%USERPROFILE%\teleport;%PATH%"


Authenticating yourself

Info

The following commands need to be run on a Windows Terminal or Powershell

Multiexcerpt include
MultiExcerptNamestandard_tsh_auth
PageWithExcerptTeleport SSH Access - Linux configuration

Setup your SSH config

We strongly recommend setting up all the SSH options needed for the connection instead of passing them on the command line.

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. You should replace ecmwfusername by your registered ECMWF user and user.address@somewhere.com by your registered email address at ECMWF.

    Multiexcerpt include
    MultiExcerptNamessh_config
    PageWithExcerptTeleport SSH Access - Linux configuration

  5. 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

Info

The following commands need to be run on a Windows Terminal or Powershell

Multiexcerpt include
MultiExcerptNamessh_standard_connection
PageWithExcerptTeleport SSH Access - Linux configuration

Troubleshooting

Multiexcerpt include
MultiExcerptNamereport_problem
PageWithExcerptTeleport SSH Access - Linux configuration