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 |
|---|
| MultiExcerptName | current-teleport-services |
|---|
| PageWithExcerpt | Teleport SSH Access |
|---|
|
Table of Contents
| Table of Contents |
|---|
| maxLevel | 1 |
|---|
| exclude | Table 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-class.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 |
|---|
|
| Tabs Page |
|---|
| title | Latest - jump-17.ecmwf.int |
|---|
| | Note |
|---|
| title | Brew 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 |
|---|
| name | mac-jump-17-setup.mp4 |
|---|
|
|
| Tabs Page |
|---|
| title | Legacy - jump.ecmwf.int |
|---|
| | Note |
|---|
| title | Brew 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 |
|---|
| name | mac_teleport_setup.mp4 |
|---|
|
|
|
Installing the tsh client
The tsh application is required to perform user authentication. tsh is open source, very portable, and has minimal dependencies.
| Tabs Container |
|---|
|
| Tabs Page |
|---|
| title | Latest - jump-17.ecmwf.int |
|---|
| Download the client for Mac from Teleport website. You can then run the installer and follow the instructions: | HTML |
|---|
<br/>
<a class="teleport17-version" href="https://cdn.teleport.dev/teleport-17.0.0.pkg">https://cdn.teleport.dev/teleport-17.0.0.pkg</a> |
You may also do it from the command line, as described in the official Teleport documentation: | 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" class="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 |
|---|
| title | Legacy - jump.ecmwf.int |
|---|
| Download the client for Mac from Teleport website. You can then run the installer and follow the instructions: | HTML |
|---|
<br/>
<a class="teleport13-version" href="https://cdn.teleport.dev/teleport-13.0.0.pkg">https://cdn.teleport.dev/teleport-13.0.0.pkg</a> |
You may also do it from the command line, as described in the official Teleport documentation: | 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" class="teleport13-version">TELEPORT_VERSION=13.0.0
curl -O https://cdn.teleport.dev/teleport-${TELEPORT_VERSION}.pkg
sudo installer -pkg teleport-${TELEPORT_VERSION}.pkg -target /</pre>
</div>
</div> |
|
|
| Multiexcerpt include |
|---|
| MultiExcerptName | tsh_version_compatibility |
|---|
| PageWithExcerpt | Teleport SSH Access - Linux configuration |
|---|
|
Authenticating yourself
| Multiexcerpt include |
|---|
| MultiExcerptName | standard_tsh_auth |
|---|
| PageWithExcerpt | Teleport SSH Access - Linux configuration |
|---|
|
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.
| Multiexcerpt include |
|---|
| MultiExcerptName | ssh_config |
|---|
| PageWithExcerpt | Teleport SSH Access - Linux configuration |
|---|
|
SSH connection
| Multiexcerpt include |
|---|
| MultiExcerptName | ssh_standard_connection |
|---|
| PageWithExcerpt | Teleport SSH Access - Linux configuration |
|---|
|
Optional: Automating the authentication step
| Multiexcerpt include |
|---|
| MultiExcerptName | auto_tsh_login |
|---|
| PageWithExcerpt | Teleport SSH Access - Linux configuration |
|---|
|
| Multiexcerpt include |
|---|
| MultiExcerptName | vscode_local_server |
|---|
| PageWithExcerpt | Teleport SSH Access - Linux configuration |
|---|
|
Alternative connection method with tsh
| Multiexcerpt include |
|---|
| MultiExcerptName | alternative-tsh-connection |
|---|
| PageWithExcerpt | Teleport SSH Access - Linux configuration |
|---|
|
Troubleshooting
| Multiexcerpt include |
|---|
| MultiExcerptName | report_problem |
|---|
| PageWithExcerpt | Teleport SSH Access - Linux configuration |
|---|
|