These are the instructions on how to install and configure your Teleport SSH access on Mac to connect to ECMWF services such as the Atos HPCF and ECS services.

Table of Contents

Demo

Here is a demonstration on how to set up Teleport to connect to our our Atos HPCF from a Mac. You can find the step by step guide described below.

Installing the tsh client

The tsh application is required to perform user authentication. tsh is open source, very portable, and has minimal dependencies.

Download the client for Mac from Teleport website. You can then run the installer and follow the instructions.

You may also do it from the command line, as described in the official Teleport documentation:

TELEPORT_VERSION=13.4.26
curl -O https://cdn.teleport.dev/teleport-${TELEPORT_VERSION}.pkg
sudo installer -pkg teleport-${TELEPORT_VERSION}.pkg -target /

Authenticating yourself

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.

Edit the file ~/.ssh/config on your computer and add the snippet below. You may create it if it does not exist. You should replace ecmwfusername by your registered ECMWF user and user.address@somewhere.com by your registered email address at ECMWF.

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.

To test the connection you may ssh into hpc-login if you have access to ECMWF's HPCF:

% ssh hpc-login

Or alternatively, if you only have access to ECMWF ECS service:

% ssh ecs-login

Visit our HPCF User Guide for further information.

Optional: Automating the authentication step

Troubleshooting