Access Keeling via ssh

Keeling is the CliMAS computing cluster that can be used for computing work. When connecting off campus, the VPN must be used. Information on the CISCO AnyConnect Virtual Private Network (VPN) is available here.

The hostname for Keeling is:

keeling.earth.illinois.edu

Connecting via ssh on MacOS of Linux with terminal

Using the terminal, you can connect to Keeling by:

ssh -Y netID@keeling.earth.illinois.edu

Connecting via ssh on Windows

PuTTY with X11 forwarding

  1. Download Xming here.

  2. Install Xming after the download is complete.

  3. Select install a PuTTy client or download Putty here.

  4. Start XLaunch.

  5. Select multiple windows option and continue to end

  6. After Xlaunch is open, launch PuTTY.

  7. In the hostname box enter netID@keeling.earth.illinois.edu

  8. On the left sidebar, click on SSH and then click on X11

  9. Click the checkbox Enable x11 forwarding.

    Hint

    You should save the settings so you don’t have always do these steps. This can be done by entering a name in the Saved Sessions box (such as keeling) and clicking Save. In the future, you can just select the profile (double click or select and click Load).

  10. Click Connect

  11. Enter your password to access Keeling.

Connecting via Visual Code Studio

Visual Studio Code, also commonly referred to as VS Code, is a source-code editor made by Microsoft and can be used on your local machine to connect to Keeling and edit code.

  1. Acquire the code from https://code.visualstudio.com/.

  2. Install Visual Studio Code.

  3. Open Visual Studio Code.

  4. You will need to get the ssh extension Remote-SSH. This can be aquired by clicking the gear in the bottom left corner (Settings) and finding and installing Remote-SSH.

  5. After installing the extension, in VS Code, select Remote-SSH: Connect to Host for the Command Palette (F1, ⇧⌘P). Enter the following:

    ssh <your netID>@keeling.earth.illinois.edu

  6. Enter your password to connect to Keeling.

Graphical display

In order to use a graphical display on Keeling, you must enable X Windows forwarding. On MacOS, this requires XQuartz - an open-source project to develop X Window System. Information regarding XQuartz can be found here. On Windows, you must install an X11 forwarding software such as Xming.

To enable X11 forwarding using Visual Studio Code:

  1. Click Configure SSH Hosts

  2. Under Host keeling.earth.illinois.edu, add the following:

ForwardX11 yes
ForwardX11Trusted yes

Todo

With the addition to the Remote X11 (SSH) extension, does this work for Windows?