Versions Compared

Version Old Version 33 New Version Current
Changes made by

Whinnery, Daniel E

Albers, Michael W

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This guide details how to connect to batch via SSH from a windows or mac machine. batch is only accessible from within the University at Albany network. To connect from an external network, you must use the VPN. Please read more at the Remote Access page.

To spawn a terminal session, you can use PuTTY and VcXsrv on Windows. On mac, you can use your terminal with XQuartz for X11 Forwarding and a terminal session. More details below. 

...

Expand
titleVcXsrv instructions

X11 is a communication protocol for "forwarding" graphics from one machine to another. In order to display graphics or run programs interactively with PuTTY, VcXsrv must be running as well. To start using VcXsrv

  1. Download and install VcXsrv

  2. From the start menu, search for XLaunch

Image Removed
  1. Image Added

  2. Select the configuration options that you would like, here we use "Multiple windows", "Start no client", and the default "Extra settings" parameters

Image RemovedImage RemovedImage Removed
  1. Image AddedImage AddedImage Added

  2. After clicking finish, you will see the XLaunch logo in the Task bar (note that you may have to expand it)

    Image Modified

  3. Now, you are all set for PuTTY with X11 fowarding

PuTTY

Expand
titlePuTTY instructions

PuTTY is an SSH and telnet client, developed originally by Simon Tatham for the Windows platform. PuTTY is open source software that is available with source code and is developed and supported by a group of volunteers. It can be downloaded here and is commonly used alongside VcXsrv for X11 Forwarding.

Info

Note that while connected via SSH and PuTTY, if your internet connection is interrupted, all running code will be exited. To avoid this, we recommend using Screen or Tmux to "detatch" terminal sessions. For more information, please see How-to: Using screen or tmux to preserve a Linux terminal session

  1. Download and install PuTTY (https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html)

  2. Make sure you have XLaunch running (see above)

  3. Find PuTTY in the start menu, and start the application
    Image Modified

  4. For host name, you make connect to a number of resources (e.g., head.its.albany.edu, headnode7.arcc.albany.edu, lmm.its.albany.edu), here we will connect to the headnode head.its.albany.edu

    1. Enter head.its.albany.edu and port 22 as shown below

Image Removed
    1. Image Added

    2. Next click on Connection -> Data and enter your netid in the "Auto-login username" field

Image Removed
    1. Image Added

    2. Next click on Connection -> SSH -> X11  on the left side, and check "Enable X11 forwarding", this will allow graphics to forward to your screen

Image Removed
    1. Image Added

    2. Finally, go back to "Session" and enter a session name and hit "Save". This will store these properties so that you can use them again by selecting the session and clicking "Load".

Image Removed
    1. Image Added

  2. Finally, click open on the bottom right and click Yes when prompted by the PuTTY Security Alert

Image Removed
  1. Image Added

  2. Enter your password when prompted. You will not see your password appear on the screen, but it is being typed!

Image Removed
  1. Image Added

  2. When successfully connected, you will see a terminal display something that looks similar to

Image Removed
  1. Image Added

  2. Now you are all set! To test if X Forwarding is working correctly,enter in the command line: xeyes and you should see the following window pop up

    Image Modified

  3. If you are having trouble, please contact askIT@albany.edu

Windows Subsystem for Linux

...

Expand
titleXQuartz instructions

X11 is a communication protocol for "forwarding" graphics from one machine to another. In order to display graphics or run programs interactively with the Terminal, XQuartz must be installed. To download and install XQuartz, please click here

Terminal

Expand
titleTerminal instructions

To SSH to any of our resources (e.g., head.its.albany.edu, headnode7.arcc.albany.edu, lmm.rit.albany.edu), you can use the terminal in Mac. Here, we will connect to head.its.albany.edu.

  1. Install XQuartz if you have not yet done so.

  2. Right click on XQuartz in the toolbar.  Select Applications → Terminal

  3. Enter into the terminal: ssh

-Y

  1. [

netid

  1. netID]@head.its.albany.edu  

    1. NOTE: Use the -Y option

is required in order for your X11 applications to work

    1. , if you need X forwarding. The first two characters of the netID is in lowercase.

  2. Enter your password when prompted. You will not see your password appear on the screen, but it is being typed!

  3. Type y when prompted by the security alert (you may not see this alert)

  4. After you are successfully logged into the ssh session, you will need to enter the following command:

  touch

  1.   touch .Xauthority

    1. NOTES:

      1. you only need to do this if the file does not already exist. 

      2. there is a "." at the beginning of the filename ".Xauthority"

  2. Now you are all set! To test if X Forwarding is working correctly, enter in the command line: xeyes

    1. you should see a window with eyes pop up

  3. If you are having trouble, please contact askIT@albany.edu

SSH Config

Alternatively, the ssh config file can be updated with the set of statements below on Windows or Mac. This will allow you to use a shorter ssh command at the terminal as ssh netID@hostname

On Windows and Mac workstations, the ssh config file can be optionally updated with:

Code Block
Host servername1 servername2...
Port 22

On Windows, the ssh config file is located at C:\Users\<netID>\.ssh

On a Mac, the ssh config file is at ~/.ssh

Include Page
Footer
Footer