...
- Open the zip file in your file browser
- Drag the teleport folder inside the file and drop into the directory of your choice (the main directory for your user, for example)
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
Once every 12 hours, you will need to refresh your tokens with the tsh command. SSH connections may remain active for longer than 12 hours, but new connections will require re-authentication.
...
| Info |
|---|
The following commands need to be run on a Windows Terminal or Powershell |
...
|
Your default web browser will open. You should login with your email address, ECMWF password, and then the code from your Time-based One-Time-Password (TOTP) device or the 8-digit one-time passcode from your ActivIdentity (HID) security token if you have not configured your TOTP yet.
| Info | ||
|---|---|---|
| ||
If you're already logged in to the ECMWF website, or have recently logged in to this service, the password prompt might be skipped. |
| Info | ||
|---|---|---|
| ||
If your computer does not have a browser or cannot display one, you may use the Teleport SSH access - Browserless Login Python Module for the authentication. |
If the process is successful, you will see an output such as:
| No Format |
|---|
> 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 4h37m0s]
Extensions: permit-X11-forwarding, permit-agent-forwarding, permit-port-forwarding, permit-pty |
...
| title | Subsequent logins |
|---|
| Multiexcerpt include | ||||
|---|---|---|---|---|
|
Once you have logged int at least once, tsh will save your proxy settings so you can skip the extra argument next time:
...
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 | ||||||
|---|---|---|---|---|---|---|
|
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, open your Windows terminal or Powershell. You then 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 |
| Info |
|---|
The following commands need to be run on a Windows Terminal or Powershell |
| Multiexcerpt include | ||||
|---|---|---|---|---|
|
Troubleshooting
| Multiexcerpt include | ||||
|---|---|---|---|---|
|