X11

X11
Macintosh Windowing Application

Version	XQuartz 2.7.9
Download	Cannot download for 10.4-10.7 or greater - must have install disk for X11, but 10.6.3 and above can use XQuartz
Cost	Free
Manufacturer	Apple
Web Page	XQuartz
Pundit Updated	8/21/2017

X11, is a program provided with Macintosh computers that allows one total X Window System implementation for running X11-based applications. X11 runs seamlessly with Aqua, so you may run Macintosh applications side-by-side with Linux programs, allowing for convenient interaction between platforms. As of OS X 10.7 (Mountain Lion), X11 has been replaced with XQuartz. In the page below, note that references to X11 and XQuartz are thus interchangeable.

Usage at Duke

The majority of Duke students use X11 to remotely access Linux machines in order to use university owned programs such as MATLAB.

Installation

OS X 10.8 or later (and OS X 10.6.3 or later, really)

For OS X 10.8 and beyond, X11 does not exist. But have no fear, XQuartz is here. Or, rather, here. You will need to install XQuartz if you have OS X 10.6-10.7 and have not installed X11 or if you have OS X 10.8 or later.

OS X 10.5 through OS X 10.7

For Mac OS X 10.5 and later, X11 is pre-installed with the rest of the bundled Macintosh applications. But if for some reason you chose not to install X11 when installing the OS on your computer it can be found on your "Install Disc 1".

When you are prompted at the custom installation screen, check X11 under applications and click continue. Once the installation is finished, you may have to restart your computer. Now you are ready to use X11!

OS X 10.4

How to Install X11 off the install disc.

In Mac OS X 10.4, X11 is not pre-installed with the rest of the bundled Macintosh applications (iLife Suite, Mail, GarageBand, etc). You must install it yourself. In order to do this, insert your OS X Install Disc 1, and select Optional Installs. If you do not have the disk, ask OIT or neighbors on your hall.

Creating a Remote Connection

In order to connect to a computer remotely, simply start up X11 (which may need to be installed) or XQuartz (In 10.5, running these commands in Terminal will automatically open the X11 windowing system). Select Applications->Terminal The first time you want to connect, you will need to tell your computer that connections are OK, so type

xhost +

You should only need to type this once for your computer ever.

From that point on, to connect to a virtual Teer machine, type:

ssh -XY NetId@login-teer.oit.duke.edu 

where "NetId" is your Duke Net ID.

You should be prompted to answer yes or no to a question if it is the first time you are connecting to a computer, followed by your Net ID password. Then, you should be able to use the X11 terminal just like a Linux terminal. The "-X" is to override default ssh configurations that do not allow X11Forwarding. The "-Y" means you are initiating a trusted connection, which is necessary for using graphical applications (gimp, matlab, gnobots2, etc.). You may type exit at anytime or simply quit X11 to close the connection.

After you have done this once, all you have to type the next time you startup X11 is "!ssh", which will automatically remember the last address you connected to. If you need to try a different machine, you can use the up and down arrows on the keyboard to go through various old commands you typed in; find an old ssh command, edit it, and then hit return.

Troubleshooting

If you receive a message similar to the one below, you most likely logged in last year, and your "host key" file is outdated as Duke changed each computer's "RSA host key" since you last connected.

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@ WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED! @  
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
IT IS POSSIBLE THAT SOMEONE IS DOING SOMETHING NASTY!
Someone could be eavesdropping on you right now (man-in-the-middle attack)!
It is also possible that the RSA host key has just been changed.
The fingerprint for the RSA key sent by the remote host is
''a-bunch-or-numbers-and-letters-and-colons''.
Please contact your system administrator.
Add correct host key in /Users/USERNAME/.ssh/known_hosts to get rid of this message.
Offending key in /Users/USERNAME/.ssh/known_hosts:5
RSA host key for DukeComputerName.oit.duke.edu has changed and you have requested strict checking.
Host key verification failed.

To fix this, you only have to delete a file in your directory. This is somewhat tricky though, since it is in a hidden folder. The following process should fix the problem:

1. Make sure that you do not have an established remote connection. It should read something like res-IP-ADDRESS:~ USERNAME$ if you are on a wired connection on the Duke Campus.
2. Type cd ~/.ssh to switch into the hidden folder.
3. Type ls -a and there should be a file named known_hosts. If there isn't, you have a bigger problem-- Contact OIT for help.
4. If the file is listed, and it is the only file listed, type rm known_hosts, close the window, open a new one, and try connecting as stated above.

Disclaimer: This has not been verified by OIT. But, it has worked for multiple people, and if you follow the instructions you should not inflict damage on your computer.

Questions

Post your questions by editing the discussion page of this document, then scrolling to the bottom and adding an asterisk, your question, and your signature (with four tildes, i.e. ~~~~). Someone will be around to check the questions and hopefully post answers.