<?php
include_once(($_SERVER['DOCUMENT_ROOT']) . "/include/header.inc");
include_once(($_SERVER['DOCUMENT_ROOT']) . "/include/footer.inc");

startPage("Using X11 Applications From A PC");
?>
  
In order to run graphical Linux and Unix applications from home, you
need to have a working X11 server installed on your PC.&nbsp; Linux
and Mac OSX both include an X11 server, Windows does not.&nbsp;
However, a previously commercial X11 server, X-Deep/32, has recently
been released as Freeware.&nbsp; Using it along with Putty, one can
successfully using X11 applications from home or residence.<br>
<br>
The following instructions detail how one can install and use the
X-Deep/32 X server.&nbsp; If you have any questions, please direct
them to <a href="mailto:linux@caslab.queensu.ca">linux@caslab.queensu.ca</a>.<br>
<br>
<h4>Step One:&nbsp; Download
and Install X-Deep/32</h4>
X-Deep/32 is available on CASLab <a
 href="/software/xdp40Full.exe">here.</a> It uses a standard
Windows installer, simply download it and double-click to
install.&nbsp; When installation is finished, launch the&nbsp; program
by clicking on&nbsp; the icon:<br>
<div style="text-align: center;"><img style="width: 80px; height: 82px;"
 alt="X Server Icon" src="0.png"><br>
</div>
<br>
<h4>Step Two: Configuring X-Deep/32</h4>
X-Deep/32 requires configuration before it is usable with CASLab.&nbsp;
Launching the application for the first time will bring up the following dialog:
<br />
<div style="text-align: center;"><img
 alt="Network Config Dialog" src="network_interface.png"><br>
</div>
<br />
Select the first option, make sure that that the bottom check boxes are both de-selected and click the "Select" button.
<p />
Now, click on the XServer taskbar item:
<br />
<div style="text-align: center;"><img
 style="width: 129px; height: 31px;"
 alt="X Server taskbar button" src="6.png"><br>
</div>
<br>
This will bring up the main X-Deep/32 window.  Select "Edit -&gt; X-Server Options"
<br>
<br>
<div style="text-align: center;"><img
 style="width: 474px; height: 270px;" alt="X-Server Options" src="1.png"><br>
</div>
<br>
Choose the "Window Modes" tab, then select "Multiple MS Window Mode"
and uncheck the&nbsp; "Display Root Window" option<br>
<br>
<div style="text-align: center;"><img
 style="width: 406px; height: 509px;" alt="Multi-window mode"
 src="2.png"><br>
</div>
<br>
Next, select the "XDMCP" tab and uncheck the "X-Deep/32 Local XDM
Chooser" option.<br>
<br>
<div style="text-align: center;"><img
 style="width: 402px; height: 508px;" alt="Disable XDM Chooser"
 src="4.png"><br>
</div>
<br>
Configuration changes are now complete.&nbsp; Click "OK."&nbsp;
X-Deep/32 will ask to restart the server.&nbsp; When running, a small
icon will be displayed in the taskbar:<br>
<br>
<div style="text-align: center;"><img
 style="width: 129px; height: 31px;"
 alt="X Server running in the background" src="6.png"><br>
</div>
<br>
<h4>Step Three:&nbsp; Configuring PuTTY</h4>
To run X11 applications remotely, you actually tunnel the X11 calls
through SSH using PuTTY.&nbsp; Be default, PuTTY does not allow X11
forwarding.&nbsp; We provide a suitable set of registry entries that
enable X11 forwarding for both Solaris (Zeus) and Linux.&nbsp; The
required files and information can be found<a
 href="/LabHelp/PuTTY/putty_config.php"> here.</a><br>
<br>
If you already have PuTTY installed, the following options need to be
changed.&nbsp; <span style="font-weight: bold;"><span
 style="font-style: italic;">Note:&nbsp; You do not need to do this
step if you install the registry information provided above.</span></span><br>
<br>
Under Connection -&gt; SSH -&gt; Tunnels, check the "Enable X11
forwarding" option and ensure that "X display location" is set to
localhost:0<br>
<br>
<div style="text-align: center;"><img
 style="width: 425px; height: 430px;" alt="Putty Configuration"
 src="7.png"><br>
</div>
<br>
<br>
<h4>Step Four:&nbsp; Testing PuTTY and X-Deep/32</h4>
With the X-Server running in the background, you should now be able to
launch PuTTY, connect to Linux or Unix and run X11 applications.&nbsp;
A good test would be to select the "Solaris (Zeus)" session in
putty.&nbsp; After logging in, type xterm at the prompt. <br>
<br>
If you see an error:<span style="font-family: monospace;">&nbsp; X
connection to localhost:10.0 broken (explicit kill or server shutdown).</span><br>
Check to make sure that the X-Server is running and that you correctly
enabled X11 forwarding in PuTTY.<br>
<br>
If all went well, you should see the following:<br>
<br>
<div style="text-align: center;"><img
 style="width: 618px; height: 458px;" alt="An X-Term!" src="8.png"><br>
</div>
<br>
Congratulations, you can now run remote X11 applications.&nbsp; This
means that Maple, Jape, NuSMV and more can all be run from the comfort
of your own home.<br>


<?php
endPage();
?>

