|
|
|
# A user's guide to the Hydra remote visualization services
|
|
|
|
# A user's guide to the MPCDF remote visualization service
|
|
|
|
|
|
|
|
### MPCDF User accounts
|
|
|
|
## MPCDF User accounts
|
|
|
|
in order to get access to remote visualization facilities at the MPCDF
|
|
|
|
NOMAD members are invited to request an MPCDF account via [this link]:(https://www.mpcdf.mpg.de/secure/registrieren/antrag.php?deisa=0&inst=MFH&projekt=NOMAD%2FWP3&lang=en)
|
|
|
|
NOMAD members are invited to request an MPCDF account via [this link](https://www.mpcdf.mpg.de/secure/registrieren/antrag.php?deisa=0&inst=MFH&projekt=NOMAD%2FWP3&lang=en)
|
|
|
|
|
|
|
|
### Client software requirements
|
|
|
|
## Client software requirements
|
|
|
|
|
|
|
|
Visualization sessions on Hydra run on top of a VNC server to which the
|
|
|
|
user connects via the Internet. A VNC viewer and an SSH client are the
|
| ... | ... | @@ -14,38 +14,38 @@ side as well. |
|
|
|
|
|
|
|
Installation packages for all relevant operating systems can be
|
|
|
|
downloaded at
|
|
|
|
[http://sourceforge.net/projects/turbovnc/files/1.2.3/](http://sourceforge.net/projects/turbovnc/files/1.2.3/).\
|
|
|
|
[http://sourceforge.net/projects/turbovnc/files/1.2.3/](http://sourceforge.net/projects/turbovnc/files/1.2.3/).
|
|
|
|
Newer versions may work as well.
|
|
|
|
|
|
|
|
On Linux systems, TurboVNC requires libjpeg-turbo, available
|
|
|
|
at [http://sourceforge.net/projects/libjpeg-turbo/files/1.4.2/](http://sourceforge.net/projects/libjpeg-turbo/files/1.4.2/).
|
|
|
|
|
|
|
|
In addition, the packages are available on Hydra at\
|
|
|
|
In addition, the packages are available on Hydra at
|
|
|
|
/u/system/SLES11/soft/remotevis/packages/client/.
|
|
|
|
|
|
|
|
In particular, the software recommendations for popular operating
|
|
|
|
systems are:
|
|
|
|
|
|
|
|
Linux and Mac clients
|
|
|
|
---------------------
|
|
|
|
### Linux and Mac clients
|
|
|
|
|
|
|
|
- TurboVNC\
|
|
|
|
|
|
|
|
* TurboVNC
|
|
|
|
Make sure to add /opt/TurboVNC/bin to your PATH environment
|
|
|
|
variable.
|
|
|
|
- libjpeg-turbo
|
|
|
|
- SSH client (comes with your operating system, typically)
|
|
|
|
* libjpeg-turbo
|
|
|
|
* SSH client (comes with your operating system, typically)
|
|
|
|
|
|
|
|
### Windows clients
|
|
|
|
|
|
|
|
Windows clients
|
|
|
|
---------------
|
|
|
|
|
|
|
|
- TurboVNC
|
|
|
|
- SSH client. The PuTTY SSH client is recommended. It can be
|
|
|
|
* TurboVNC
|
|
|
|
* SSH client. The PuTTY SSH client is recommended. It can be
|
|
|
|
downloaded
|
|
|
|
at [http://www.chiark.greenend.org.uk/\~sgtatham/putty/download.html](http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html).
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### How to launch a remote visualization session on Hydra
|
|
|
|
## How to launch a remote visualization session on Hydra
|
|
|
|
|
|
|
|
Log in to Hydra and load the environment module "remotevis":
|
|
|
|
|
| ... | ... | @@ -75,7 +75,7 @@ email with information on how to connect to the VNC session. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### How to connect to a remote visualization session on Hydra {#how-to-connect-to-a-remote-visualization-session-running-on-hydra}
|
|
|
|
## How to connect to a remote visualization session on Hydra {#how-to-connect-to-a-remote-visualization-session-running-on-hydra}
|
|
|
|
|
|
|
|
When a remote visualization session is starting, the system sends a
|
|
|
|
notification email with information on how to connect. The default email
|
| ... | ... | @@ -83,11 +83,11 @@ address is \$USER@rzg.mpg.de. The email address can be changed by |
|
|
|
setting the VIZ\_MAILTO environment variable in the LoadLeveler submit
|
|
|
|
script.
|
|
|
|
|
|
|
|
In addition, the notification email is saved to a text file at\
|
|
|
|
In addition, the notification email is saved to a text file at
|
|
|
|
\$HOME/remotevis/notification.txt.
|
|
|
|
|
|
|
|
Linux clients {#linux-client}
|
|
|
|
-------------
|
|
|
|
### Linux clients {#linux-client}
|
|
|
|
|
|
|
|
|
|
|
|
For Linux clients, the TurboVNC viewer command line is explicitly given
|
|
|
|
in the email. It looks as follows:
|
| ... | ... | @@ -106,8 +106,9 @@ The second password prompt is issued by the VNC server on Hydra. Enter |
|
|
|
your VNC password (that was entered initially during the
|
|
|
|
`setup_remotevis` step).
|
|
|
|
|
|
|
|
Mac clients {#mac-client}
|
|
|
|
-----------
|
|
|
|
|
|
|
|
### Mac clients {#mac-client}
|
|
|
|
|
|
|
|
|
|
|
|
Unlike on Linux, the Mac vncviewer executable does not directly support
|
|
|
|
establishing an SSH tunnel using the "-via" option. Therefore it is
|
| ... | ... | @@ -131,8 +132,8 @@ relay port as follows: |
|
|
|
Enter your VNC password (that was entered initially during the
|
|
|
|
`setup_remotevis` step).
|
|
|
|
|
|
|
|
Windows clients {#windows-client}
|
|
|
|
---------------
|
|
|
|
### Windows clients {#windows-client}
|
|
|
|
|
|
|
|
|
|
|
|
Unlike on Linux, the Windows vncviewer executable does not directly
|
|
|
|
support establishing an SSH tunnel using the "-via" option. Therefore it
|
| ... | ... | @@ -169,7 +170,7 @@ popup window will notify you five minutes in advance. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Applications
|
|
|
|
## Applications
|
|
|
|
|
|
|
|
When the remotevis module is loaded, the module environment is extended
|
|
|
|
with a new section labeled "visualization". This is the case in a
|
| ... | ... | @@ -188,8 +189,8 @@ The [software |
|
|
|
page](http://www.mpcdf.mpg.de/services/visualization/hydra_vis/hydra_vis_software)
|
|
|
|
provides an overview on the available visualization applications.
|
|
|
|
|
|
|
|
Interactive data analysis and visualization
|
|
|
|
-------------------------------------------
|
|
|
|
### Interactive data analysis and visualization
|
|
|
|
|
|
|
|
|
|
|
|
For interactive data analysis and visualization, the open source
|
|
|
|
packages VisIt and ParaView have proven useful. Both are available via
|
| ... | ... | @@ -197,20 +198,20 @@ environment modules. More details and basic instructions are available |
|
|
|
on the [software
|
|
|
|
page](http://www.mpcdf.mpg.de/services/visualization/hydra_vis/hydra_vis_software).
|
|
|
|
|
|
|
|
Handling of image files
|
|
|
|
-----------------------
|
|
|
|
### Handling of image files
|
|
|
|
|
|
|
|
|
|
|
|
Typically, visualization applications will output a (large) number of
|
|
|
|
image files, e.g. in PNG format. The following applications are
|
|
|
|
available on the visualization nodes either directly or via an
|
|
|
|
environment module and are useful to handle image files.
|
|
|
|
|
|
|
|
- Nautilus, the GNOME file explorer. Select "Icon view" to get a
|
|
|
|
* Nautilus, the GNOME file explorer. Select "Icon view" to get a
|
|
|
|
preview of image files in a folder.
|
|
|
|
- Eye of GNOME, the GNOME image viewer. Double-click a file in
|
|
|
|
* Eye of GNOME, the GNOME image viewer. Double-click a file in
|
|
|
|
Nautilus, or use `eog` from the command line.
|
|
|
|
- ImageMagick, a collection of command-line open-source image
|
|
|
|
* ImageMagick, a collection of command-line open-source image
|
|
|
|
manipulation tools
|
|
|
|
- ffmpeg, a command-line based video encoding suite. A usage example
|
|
|
|
* ffmpeg, a command-line based video encoding suite. A usage example
|
|
|
|
of creating an MP4 movie from a sequence of image files is given
|
|
|
|
at: [https://trac.ffmpeg.org/wiki/Create%20a%20video%20slideshow%20from%20images](https://trac.ffmpeg.org/wiki/Create%20a%20video%20slideshow%20from%20images) |
