From Documentation
Revision as of 14:32, 22 November 2019 by Ppomorsk (Talk | contribs) (MobaXterm (Windows))

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Visualization Stations

SHARCNET also has a collection of remote-desktop machines running CentOS and Fedora. These can be used to run a variety of pre- and post-processing packages that are not a good fit for the cluster environment. They are accessed over the network via VNC. Sessions are not persistent. When you logout or get disconnected, they end.

When switching between CentOS and Fedora environments you need to reset your configuration files because versions of several programs coniguration files differ and may become confused when the environment changes. For instance if the Application Menu pulldown is missing from the vdi-centos6 desktop after running a fedora23 desktop. To fix this problem run the following command on any of the clusters:

rm -fr ~/.config ~/.local ~/.cache ~/.gconf ~/.gnome2

The clipboard is only shared if you are running a VNC client that supports this (TigerVNC). The program that handles this on the remote end is called vncconfig. It is automatically started in -nowin mode. To change the options you will have to kill it and then restart it in none -nowin mode

killall vncconfig

Web Browser (noVNC)

noVNC is a HTML5 based VNC client that runs inside a web browser. It enables connecting to any sharcnet visualization workstation remotely from any modern browser (one that supports HTML5). To do so simply goto the sharcnet systems page, then scroll down to the Visualization Systems table, next locate the machine you want to connect with such as vdi-centos6 and lastly click the BLUE terminal icon beside it. The remote desktop login screen should appear in your browser. If however the chosen viz machine is under heavy load, you may receive a timeout message instead of connecting successfully and should consider trying later or connecting to a different machine. It maybe necessary to try 3x before a successful connection is established. The local VNC client approach does not have this issue.

WARNING! It is not possible to copy/paste text between your workstation desktop and a web browser noVNC session. A workaround is to copy/paste the text into a file located on a global shared filesystem such as home of the noVNC session - then from your workstation desktop connect to a sharcnet system and copy/paste from the remote file to your desktop. A better solution is instead of using no VNC connect instead using a local VNC client as described below where copy/paste actions to the desktop are natively supported.

Local Client (VNC)

The local client provides a slightly faster solution that may integrate better with your system (e.g., pass through certain keystrokes that would otherwise be captured by your browser and do full screen mode better). While any vencrypt enabled VNC viewer should work, we have experienced difficulties with many of them and therefore recommend the following three.

Also note that connecting to the visualization stations via the local clients should be done to the <station> address (e.g., and not that standard <station> address or else your client will not be able to properly verify the authenticity of the remote machine.

TigerVNC Installation

Tigervnc clients for various compute architectures can be downloaded from
To remain compatible with the systems you are connecting to. it is strongly recommended to update to the latest version periodically.

Windows and MacOS Installations

Download either the TigerVNC dmg file for MacOS or the vncviewer exe file for Windows from

Fedora Linux Installation

For Fedora, the tigervnc client is available in the default packages

sudo yum install tigervnc

In order to have TigerVNC validate encryption certificates used with our systems, you will need to create a symlink in ~/.vnc:

rm -fr ~/.vnc
mkdir -p ~/.vnc
ln -s /etc/pki/tls/certs/ca-bundle.crt ~/.vnc/x509_ca.pem

NOTE: Removing ~/.vnc resets the TigerVNC configuration and may be required for this to work.

Ubuntu and Debian Linux Installations

For newer Ubuntu/Debian:

sudo apt-get install tigervnc-viewer

In order to have TigerVNC validate encryption certificates used with our systems, you will need to create a symlink in ~/.vnc:

rm -fr ~/.vnc
mkdir -p ~/.vnc
ln -s /etc/ssl/certs/ca-certificates.crt ~/.vnc/x509_ca.pem

NOTE: Removing ~/.vnc resets the TigerVNC configuration and may be required for this to work.

Gentoo Linux Installation

To install TigerVNC emerge tigervnc after setting any desired USE flags:

emerge -av net-misc/tigervnc

In order to have TigerVNC validate encryption certificates used with our systems, you will need to create a symlink in ~/.vnc:

cd ~/.vnc
ln -s /etc/ssl/certs/ca-certificates.crt x509_ca.pem


Once tigervnc is installed on your computer, connect to a SHARCNET viz station by simply clicking the TigerVNC Viewer application menu entry located typically under Applications->Internet. Once the Connection Details popup appears type in the VNC server: field. The hostname should be saved for next time but if not click the "Save As" button in the popup preferences and save it as a loadable configuration for the next time you start the viewer. If you cannot locate tigerVNC Viewer in your application menu on linux try opening a terminal and running the following command:


where vdi-centos6 could be replaced with viz10-uwo, viz11-uwo, vdi-fedora23 etc.

Re-Sizing the Display

To put the vncviewer client window into full screen mode, there are three options to try:

1) Click the maximize/minimize button in the upper right hand corner of the client
2) Press the F8 key to open a popup window and tick/untick the Full screen check box
3) If neither 2 or 3 work run the snxrandr command and specify a setting such as 1280x800

gvncviewer (older Ubuntu/Debian)

Older Ubuntu and Debian do not package tigervnc by default, so we instead recommend installing the gvncviewer application

apt-get install gvncviewer

The gvncviewer program will not prompt you for connecting to machines it cannot verify (it just quits), so it is necessary to provide it with a link to the system certificates

mkdir -p ~/.pki/CA
ln -s /etc/ssl/certs/ca-certificates.crt ~/.pki/CA/cacert.pem

Connecting to a viz stations is then done by running

gvncviewer <station>

where <station> is substituted with the appropriate viz station name.


Some software on SHARCNET system requires you to establish a graphical connection, so you can interact with it through a graphical user interface (GUI).

If such a graphical connection is not enabled, the program which requires it (in this example DDT), will generate an error message:

[ppomorsk@orc-login2:~] module load ddt
[ppomorsk@orc-login2:~] ddt
ddt: cannot connect to X server

Resolving this issue requires that a graphical connection is set up. There is a number of ways to do this.

SSH (Linux and Mac)

Add the -X (or for a very few applications the less secure -Y) flag to your ssh command to enable X11 forwarding (from the cluster to your computer)

ssh -X <user>@<cluster>

For MacOS you will also need to install the XQuartz X11 server to display the forwarded the graphics from the cluster. Further information to enable forwarding is explained here.

MobaXterm (Windows)

MobaXterm is a combined ssh, sftp, and built-in X11 server from Windows. It is available as a free download from A convenient tutorial on its use is given on that page. To enable a graphical connection, make sure the box "X11-Forwarding" is checked. Please note using MobaXterm will not provide a high performance graphics connection to visualization machine, thus it is not optimal to use in cases where refresh and response rates are an issue, such as performing interactive 3d modelling or meshing operations in a remotely run gui application. Powerful visualization machines usually run vnc servers, and so we recommend using tigervnc.

Xming Software (Windows)

Xming is an X11 server that can be run on your local Windows desktop computer - it will allow you to run graphical applications from remote Unix and Linux computers such as the SHARCNET clusters, when used in combination with an SSH client. Similar to MobaXterm, be aware that Xming will not provide a high performance graphics connection to sharcnet visualization machines such as vdi-centos6 or gra-vdi, for this we recommend using tigervnc. For example when performing heavy interactive 3d meshing tasks within a remotely run gui application.

Where to get Xming

Xming is available from, where a variety of versions can be downloaded. For a fee, you can download the latest version, or a slightly older, but still functional version is avaliable for free. Of the two free versions, one is the basic "Xming" server, and the second, "Xming-mesa", allows you to make use of 3D graphics if they are used by the remote application. This tutorial will work under the assumption that you have downloaded the free version, labeled "Xming-mesa", since it will do all of the work that the basic Xming program does, and in situations where a program requires 3D graphics support, it is better to have it already, rather than finding out when your program will not run.

How to Install and Use Xming

To install Xming, first download the Xming-mesa public domain from The Website, and run it. For the majority of the setup options, you should accept the default, and just click "Next >". When asked to Select Components, make sure "Normal PuTTY Link SSH client" is selected, and turn on all checkboxes, as below:


Once this has been completed, you can click "Next" until you reach the "Setup" window, and turn on the desktop icons for Xming and XLaunch if you wish. After this, click "Next" until done, and click the final "Install" button to complete the installation.

The first time you install Xming, you may also be asked for additional configuration options for the server. In each of these conditions, the default setting is the best choice for using Xming with the SHARCNET clusters.

Right after installation, the Xming server will already be running, but if you log out or reboot your computer, you will need to click the "Xming" icon to start it up again if you wish to use it. If you chose not to install the desktop icon, the server can also be found in the Programs menu under "Xming". To verify that Xming is installed, check the taskbar of your computer to see if the "X" logo is present, like this:


PuTTY SSH client

Next, if you do not already have a copy of the PuTTY SSH client, you can get one from here - download the putty.exe program file, and place it on your desktop for easy access, no installation is needed for this program. Once it is downloaded, run it, and you will be presented with the configuration screen. For this example, we will connect to the system, but the same instructions can be used for any of the clusters, simply by changing the Host Name you use.

In the first configuration screen, we need to do a few things. We enter our Host Name ( and a name for our session (Rainbow X11) and then click "Save" - we should then see what is shown below:


Next, click "X11" in the category menu on the left. (It should be near the bottom) and turn on the checkbox beside "Enable X11 forwarding", like this:


Last, return to the "Session" category at the very top of the menu on the left, and click the "Save" button again to save the X11 settings. Now the setup is complete, and you can click "Open" to log in. The next time you start PuTTY, all of the settings should be in place already if you double click the "Rainbow X11" entry in the Saved Sessions list. You can now log into the cluster using your regular SHARCNET username and password.

Now that everything is installed, the next time you come to your computer to use X11 programs on SHARCNET, you will only need to follow three steps:

  1. Start Xming (if the Xming logo is not in the tool tray, double click the Xming icon to start it.)
  2. Start PuTTY
  3. Double-click the session you wish to log into in PuTTY and log in with your username and password.

Once you are logged into the cluster, if you wish to test to verify that X11 is working, type the command "xlogo" and hit enter. A small window that looks like this should appear somewhere on your screen:


You can now run any program that requires X11 to function while on the clusters.