Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Teleport 17

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.

Multiexcerpt include
MultiExcerptNamecurrent-teleport-services
PageWithExcerptTeleport SSH Access

Table of Contents

Table of Contents
maxLevel1
excludeTable of Contents

HTML
<script src="https://sites.ecmwf.int/public/sharebox/confluence-tabs-sync.js"></script>
<script src="https://sites.ecmwf.int/public/sharebox/fetch-teleport-versions.js"></script>

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.

Tabs Container
directionhorizontal
Tabs Page
titleLatest - jump-17.ecmwf.int
Note
titleBrew installation broken

The video shows installation of tsh client through Homebrew, but that strategy no longer works. Please follow instructions below to install it instead.

If you had already installed it through Homebrew, you must uninstall it before you install it with the official package.

Multimedia
namemac_teleport_setup.mp4

Tabs Page
titleLegacy - jump.ecmwf.int
Note
titleBrew installation broken

The video shows installation of tsh client through Homebrew, but that strategy no longer works. Please follow instructions below to install it instead.

If you had already installed it through Homebrew, you must uninstall it before you install it with the official package.

Multimedia
namemac_teleport_setup.mp4


Installing the tsh client

...

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

Tabs Container
directionhorizontal
Tabs Page
titleLatest - jump-17.ecmwf.int
HTML
<div class="preformatted panel conf-macro output-block" style="border-width: 1px;" data-hasbody="true" data-macro-name="noformat
">
<div class="preformattedContent panelContent">
<pre data-bidi-marker="true" id="teleport17-version">TELEPORT_VERSION=17.0.0
curl -O https://cdn.teleport.dev/teleport-${TELEPORT_VERSION}.pkg
sudo installer -pkg teleport-${TELEPORT_VERSION}.pkg -target /</pre>
</div>
</div>
Tabs Page
titleLegacy - jump.ecmwf.int
HTML
<div class="preformatted panel conf-macro output-block" style="border-width: 1px;" data-hasbody="true" data-macro-name="noformat">
<div class="preformattedContent panelContent">
<pre data-bidi-marker="true" id="teleport13-version">TELEPORT
TELEPORT
_VERSION=13.
4
0.
26
0
curl -O https://cdn.teleport.dev/teleport-${TELEPORT_VERSION}.pkg
sudo installer -pkg teleport-${TELEPORT_VERSION}.pkg -target /</pre>
</div>
</div>

Multiexcerpt include
MultiExcerptNametsh_version_compatibility
PageWithExcerptTeleport SSH Access - Linux configuration

Authenticating yourself

Multiexcerpt include
MultiExcerptNamestandard_tsh_auth
PageWithExcerptTeleport SSH Access - Linux configuration

...

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.

Multiexcerpt include
MultiExcerptNamessh_config
PageWithExcerptTeleport SSH Access - Linux configuration

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:

No Format
% ssh hpc-login

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

No Format
% ssh ecs-login

Multiexcerpt include
MultiExcerptNamessh_standard_connection
PageWithExcerptTeleport SSH Access - Linux configuration
Visit our HPCF User Guide for further information.

Optional: Automating the authentication step

Multiexcerpt include
MultiExcerptNameauto_tsh_login
PageWithExcerptTeleport SSH Access - Linux configuration

Multiexcerpt include
MultiExcerptNamevscode_local_server
PageWithExcerptTeleport SSH Access - Linux configuration

...

Multiexcerpt include
MultiExcerptNamereport_problem
PageWithExcerptTeleport SSH Access - Linux configuration - jump-17