Each OS Has A Different Setup
NOTE: Wireless connections for SSH connections must use the UARK Wi-Fi network. The UARK Guest Wi-Fi will not work!
- First, check which version of Mac OS X you are using.
(Apple menu at top left. Choose About this Mac)
- If you are running OS X 10.8 or newer, you will need to install X11 support by downloading and installing XQuartz. As you will see from the XQuartz web page, most earlier versions of OS X already have the X11 support installed.
- Once XQuartz is installed, to insure settings are in place, log out and log in again (or restart).
- Open a terminal as you would normally, then type your ssh command to ssh to turing, but add the -X option, per this example (You may also try -Y instead if you are experiencing errors):
ssh -X firstname.lastname@example.org
(with your own username, of course, ahead of the @ symbol)
- Once logged into Turing, type the command gedit to start this editor.
Tip: if you type the command followed by an ampersand (e.g., gedit & or firefox &) you will not only start the program, you’ll also get your prompt back for use for shell commands.
NOTE: Acxiom lab machines are already have the software, but you do need to follow setup steps.
For basic command line access, only a secure shell client is needed. The two choices supported on our campus are: PuTTY and SSH.COM’s sshwinsecureshell client). To use graphical programs using X forwarding, you must also install an X server program.
- PuTTY download here
- PuTTY User Documentation here
- SSH.COM’ssshwinsecureshell can be downloaded here:
- The X server application is called Xming can be found here.
(Xming information page – here. )
Setup SSH Client
- After installing PuTTY, run the program. You will presented with a screen similar to the one above.
- Type “turing.csce.uark.edu” in the “Host Name (or IP Address) box and leave the port as 22
- Navigate to Connection->Data->X11 to enable X11 forwarding
- Navigate back to the main page and type in a name for this configuration (“Turing” works fine) and click save.
- Click Open, the program may ask you to save an RSA key, just click yes or continue.
SSH Secure Shell Client:
After installing the SSH Secure Shell program downloaded in #1 above, …
- Start the SSH Client (Secure Shell)
- Choose ‘Edit’>’Settings’.
- On the left bar, choose ‘Tunneling’. Check the box for ‘X11 tunneling’
- Click ‘Quick Connect’, and choose yes when the dialog appears asking if you want to save the changed settings. Meanwhile…
If you need more details, look at the section about “Windows Installers” at the link here: http://www.straightrunning.com/XmingNotes/#head-13
How to Use X-forwarding with Xming
- SSH to Turing and login as usual, then try a graphical program like xclock to test that xming is running. Just type xclock at the prompt and press enter. If a graphical clock pops up on your screen, you’re good to go! If not, and you get a “can’t open display” then Xming may not be running. From your start menu or desktop icon run Xming, then re-start the Secure Shell session.
Note: When you startup Xming nothing seems to happen, but the XWindows service or process will have started in the background. When you close the xclock graphical program, you’ll be returned to your turing prompt. You can also run graphical programs in the background like such:
- gedit &
- netbeans &
- Open a terminal, type:
ssh -X email@example.com
where username is your own actual UARK username.
- Type in your password when prompted, and you’re good to go.
- Try it out with programs like xclock, netbeans, eclipse, etc.
TIP: Put a space and then an ampersand (one of these &) after your command, e.g.,
xclock & and you get to keep an active shell prompt in your terminal.