"SSH - Mocha X" Configuration Guide


Using SSH-Xwin32 to open up GUI application remotely on Windows computer

You can connect to ECE servers using SSH client. Click on Putty or Secure Shell Client to download the free SSH client. Install any one of this client on your computer. If you install the Putty client, you will see the configuration dialog as it appears on Fig. 1 and If you install the Secure Shell Client, you will see the configuration dialog as it appears on Fig. 2.


Fig. 1 [Putty Configuration]                                                                                                   Fig. 2 [Secure Shell Client Configuration]

Click on Open or Connect depending on software installed on your computer. Enter the loginid (username) and/or password as it require by the software. Once you login successfully, you will see the login prompt as shown below.


You can login to ECE servers vulcan.ece.iit.edu, mercury.ece.iit.edu or jupiter.ece.iit.edu from IIT network as well as from Non-IIT network.

If you cannot login to the servers directly, please email me your dsl service provider name or your public ip address (sbcglobal.net or 216.47.xxx.xxx). If you are using wireless router at home, wireless router assigns private ip addresses to your computer which is generally (192.168.xxx.xxx, 172.168.xxx.xxx). You will have to find out about your public ip address and then you have to submit that to me.

Now, after you get the connection to one of the ece server using "ssh", follow this steps.

Certain application require you to source a script to configure the environment variables. If you have been told to do that by your TA or Professor, source that file before executing your application. For example to run cadence, run the following command "username@hostname:~% source /import/app1/scripts/cadence.ic51.cshrc " . For example,

Now, find out your public ip address from the SSH terminal window using the command "who am i"

Here, iq9 is the dns name of the system from which I am logged in. If you are logged in from the x.x.x.x.sbcglobal.net, it will appear it here. Use this ip address in setenv DISPLAY command.

Now, run the setenv command to forward the GUI display from the unix server to your own computer.

username@hostname:~% setenv DISPLAY ipaddress:0.0

                                                                    (where ipaddress is the IP address shows up when you type "who am i" on ssh terminal window)

Download and Install the MochaX software to your computer from http://www.ece.iit.edu/ecesysdocs/mx11.exe. Mocha X is a freeware and there is no limitation like Xwin.

Open up the mxserver window by clicking on Start -> All Programs (or Program Files) -> Mocha X Server -> mxserver. It will open up the X11 icon on your windows taskbar.

Leave it running like that in the taskbar.

Now go back to the ssh window where you logged into the ECE workstation and run the command to open up GUI on your computer.

If you are using firewall or router at home, please Read "Having a problems opening GUI application to remote computer or workstation".


Having a problem opening GUI application on your remote computer or workstation

         1) Using Firewall at HOME

Check and make sure the settings that you setup on your workstation is correct as explained.

Are you running any firewall on your machine such as (windows firewall, norton firewall, zonealarm,,.....)? If you do either you have to shutdown this firewall or you have to open up the port 6000.

X-Win32 uses port 6000 for its transfers.

If you have Linux workstation run the ipchains L and make sure that the IIT computers are allowed to talk to your workstation and you should allow the port number 6000 for data transfers.

If you have windows workstation then open up your firewall software and make sure that the IIT computers are allowed to talk to your workstation on port number 6000.

Login to vulcan.ece.iit.edu and test the following commands at the login prompt.

ssh vulcan.ece.iit.edu

telnet ipaddress 6000

where ipaddress = your workstation ip address retrieved by typing the ipconfig on windows and ifconfig a on linux or by typing the who at the linux prompt.

If you get the connection refused or timed out then email us the error message. If you are get connected then type control+] to exit.

If you get the connection timed out then the IIT computers cannot talk to the your computer. You may have to reconfigure your firewall to allow the IIT computers to talk to your workstation.

If you get connected to the hawk then ssh to one of the ECE workstation and set the display environment variable and run the xcalc to test.

If you receive any error message then email us the error message.


          2) Using Router at HOME

If you are using any kind of router at home, for example, if you have cable modem or DSL with a computer behind a router with the private ip address, then there are a few extra things you have to take in to consideration.

Port 6000. X-Win32 uses port 6000 for its transfers.  Therefore, you will have to enable port forwarding on your router to send all packets to port 6000 to your computer. Different routers has different configuration menu.  For Linksys router, for example, you go to address: then click Advanced, then Forwarding, then forward port 6000 to your computer private ip address which is in this example.

This is the example of Wireless-G Broadband Router Configuration page of Cisco Systems. In this example, the starting and ending point is 6000 as the Xwin requires a communication on port 6000 and both the protocols are selected and the ip address behind the computer is (which is different for all users) and you need to select the enable option to allow the port forwarding to your computer.

Next, You need to find out the router ip address as when you make a talk to outside world from your computer, it sees the public ip address assigned to your router. You can find out the public ip address from the router configuration page. Next, you will have to set your DISPLAY environment variable on Unix to point to your home router IP address.