# Remote visualization using VirtualGL

<br>
<hr style="margin-right: 0px; margin-bottom: 4px; margin-left: 0px; margin-top: -24px; border:2px solid  #d9d9d9 "></hr>
<hr style="margin: 4px 0px; border:1px solid  #d9d9d9 "></hr>

## Short guide

---

1. Run FortiVPN

2. From terminal give command:

		/opt/VirtualGL/bin/vglconnect -s Uni-ID@viz.hpc.taltech.ee

3. Run program needed by command:

		vglrun paraview

	or load program needed if program is not native.


<br>
<hr style="margin-right: 0px; margin-bottom: 4px; margin-left: 0px; margin-top: -24px; border:2px solid  #d9d9d9 "></hr>
<hr style="margin: 4px 0px; border:1px solid  #d9d9d9 "></hr>

## VirtualGL long version

---
VirtualGL is an open-source software package that redirects the 3D rendering commands from user computer to remote server and sends the rendered output back to user's computer. **Vis**-node has 2.5.2 version of VGL, but any recent VGL client version should work.

### Software recommended to use

<div class="simple1">
The client (your desktop) computer needs X11 (for Linux), Cygwin (for Windows), or XQuarts (for Mac) in addition to the VirtualGL software, to provide the abstract interface to managing a GUI:

-   Linux: 
    -   X11 is default, if you have a graphical desktop, you have X11
    -   download your VirtualGl package from <https://www.virtualgl.org/>
-   Windows:
    -   Cygwin <https://www.cygwin.com/>
    -   use the Cygwin installer to install Cygwin/x and VirtualGL
-   Mac: 
    -   XQuarts needs to be installed <https://www.xquartz.org/>
    -   download your VirtualGl package from <https://www.virtualgl.org/>
</div>
<br>

### Run VirtualGL

1. Open and run FortiVPN

	<div style="width:65%; height:!65%; margin-left: auto; margin-right: auto;"> 

	![vgl-1](vgl-1.png)

	</div>

2. From terminal give command:

		/opt/VirtualGL/bin/vglconnect -s Uni-ID@viz.hpc.taltech.ee

	***NB!*** _It is needed to specify path of VirtualGL._

	By default on 
	- **Linux** it is `vgl/opt/VirtualGL/bin/`
	- **Mac** it is `/opt/VirtualGL/bin/vglconnect`.

3. Will be done access to **viz**:

4. After the connection is established, run the desired program (if it is native) with the command:

		vglrun paraview

	If command is not native, then firstly corresponding environment should be loaded:

		module load viz-spack
		module load jmol

5. If XQuartz is install will appear paraview window:

	<div style="width:95%; height:!95%; margin-left: auto; margin-right: auto;"> 

	![vgl-2](vgl-2.png)

	</div>





If there is no native package for your Linux distribution, you can download the .deb and unpack it using `dpkg -x virtualgl...deb vgl`.