Skip to main content

Remote Visualization Session

MCMeSU offers nodes equipped with GPUs (gpu partition) that can be used to remotely visualize your jobs data.
As the execution and the rendering of your application is done on MCMeSU, you do not need to download your data or use a powerful computer to perform visualization tasks.

Pre-requisite​

In order to connect to a visualization running on MCMeSU, the TurboVNC software must be installed on your local computer. It is available on Linux, Windows and MacOS. While other VNC protocol implementations exist (TightVNC, RealVNC, etc.), only TurboVNC provides the features required to connect to MCMeSU. If you already have an other VNC implementation installed, you should still install TurboVNC.

In order to install TurboVNC, please refer to the official documentation.

Starting a new session​

When logged in on MCMeSU, you can start a new session by using the command visu-start-session :

[user@mc-login1 ~]$ visu-start-session

Visualization job 12345 submitted

Please wait while session is starting ...

Session is now running, use the following information to connect with TurboVNC

Address: xxxxx.mesu.sorbonne-universite.fr:1

Session password: pksfpz

You may stop the session using 'visu-stop-session'.

Behind the scenes, the visu-start-session command submits a job to the gpu partition of MCMeSU. You can check that your session is running by using regular jobs monitoring commands :

[user@mc-login1 ~]$ myqueue
JOBID PART NAME USER ST TIME NODES CPUS NODELIST(REASON)
12345 gpu visu user R 0:00:07 1 16 xxxxxx

Connecting to a session​

Once your session has started on MCMeSU, open TurboVNC on your local computer.
TurboVNC will expect you to provide the session address and the session password.
Use the information output by the visu-start-session command.

start turbovnc

The visualization session script generates a random password that will allow you to connect.

password turbovnc

Once connected and authenticated, TurboVNC will then open a window with a desktop running on one of MCMeSU GPU (or visualization) node :

connected turbovnc

Note that visualization are capped to a 24 hours walltime.

Applications​

The desktop environment is based on Fluxbox. Other environments such as Gnome or KDE are not available.

On the desktop, shortcuts are provided to open a terminal, a text editor, a file browser and image viewer.
You can also open these applications by using the desktop menu (right-click on the background).

Behind the scenes, your session is wrapped by VirtualGL. Thus, you have access to the GPU 3D acceleration without having to perform any additional command or configuration.

To start your graphical application, simply open a terminal, load the required environment modules and call it.

Troubleshooting​

Library loading error​

If you encounter an error when starting your application, please use the following command and try again :

$ unset LD_PRELOAD

Note that this command disables VirtualGL pre-loading and might break 3D acceleration in some rare cases.

Changing keyboard mapping​

By default, keyboard input is mapped to French azerty.

In order to load a different mapping, please use the setxkbmap command followed by the country code.

For example, for a US qwerty mapping, use :

$ setxkbmap us

If you have keyboard that is not a regular PC keyboard, you may also change the keyboard model.

For example, for an Apple MacBook, you may try one of the following commands :

$ setxkbmap -model macbook78
$ setxkbmap -model macbook79
$ setxkbmap -model apple

The default keyboard model is pc105.

Extensive list of keyboard mappings and models can be found in the /usr/share/X11/xkb/rules/base.lst file.

Terminating a session​

When you are done with your session, you can close either by exiting the window manager :

connected turbovnc

Or by calling the visu-stop-session command from a MCMeSU login node :

[user@mc-login1 ~]$ visu-stop-session

Visualization job 12345 terminated