Help Desk Central Texas A&M University primary mark

Connecting to the VOAL from Linux

Document ID 1254


This document discuss how to connect to the TAMU Virtual Open Access Lab with the Linux operating system.


1. Download the from

2. Change directories to the directory the file was downloaded into and unzip it.

~/vWorkspace$ unzip

3. Run the prerequisite check.

Note: This will run the prerequisite check and determine whether or not you have all the packages necessary to utilize the program correctly. The file will also attempt to install any missing packages.

~/vWorkspace$ sudo sh

4. If the script is unable to install the files, install them manually by copying and pasting the following into the terminal:

sudo apt-get install gcc g++ linux-headers-generic tofrodos libpng12-0 libpopt0 libboost-thread1.42.0 libao4 libjpeg62 libasound2 libmpg123-0 libgtk2.0-0 libspeex1 gstreamer-tools gstreamer0.10-alsa gstreamer0.10-ffmpeg gstreamer0.10-nice gstreamer0.10-plugins-bad gstreamer0.10-plugins-base gstreamer0.10-plugins-base-apps gstreamer0.10-plugins-good gstreamer0.10-plugins-ugly gstreamer0.10-pulseaudio gstreamer0.10-tools gstreamer0.10-x libgstreamer-plugins-base0.10-0 libgstreamer-plugins-base0.10-dev libgstreamer0.10-0 libgstreamer0.10-dev libgstreamermm-0.10-2 libgstreamermm-0.10-dev libpng12-dev libpopt-dev libboost-dev libboost-thread1.42-dev libao-dev libasound2-dev libmpg123-dev libxext-dev libgtk2.0-dev flashplugin-nonfree libxt-dev libspeex-dev libgstreamer-plugins-base0.10-dev libgstreamer0.10-dev libgstreamer0.10-dev libboost-thread-dev libboost-regex1.42.0 autoconf libboost-regex-dev libboost-date-time-dev libasio-dev libjpeg62-dev libqt4-dev

5. Run the check again to ensure that all the packages are installed correctly and can be located. The output from a successful run of the shell script should look like this:

Beginning qrdesktop prerequisites checker
Performing Pre-requisite checks...
Checking for core libraries:
checking for g++... -e OK
checking for libstdc++6*... -e OK
checking for libpng12... -e OK
checking for libpopt*... -e OK
checking for openssl... -e OK
checking for libboost-thread1.34*... not installed... try to install? (y/n): y
ERROR: package libboost-thread1.34* is not found, try to install it manually
checking for libboost-regex*... -e OK
checking for libboost-date-time*... -e OK
checking for libx11-*... -e OK
checking for tofrodos... -e OK
checking for autoconf... -e OK
checking for libjpeg62... -e OK
checking for libao*... -e OK
checking for libasound2... -e OK
checking for libmpg123*... -e OK
checking for xdg-utils... -e OK
Absent packages: libboost-thread1.34*
Checking core development libraries
checking for libstdc++6*-dev... -e OK
checking for libpng12-dev... -e OK
checking for libpopt*-dev... -e OK
checking for openssl... -e OK
checking for libboost-dev... -e OK
checking for libboost-thread-dev... -e OK
checking for libboost-regex-dev... -e OK
checking for libboost-date-time-dev... -e OK
checking for libx11-dev... -e OK
checking for libasio-dev... -e OK
checking for tofrodos... -e OK
checking for autoconf... -e OK
checking for libjpeg62-dev... -e OK
checking for libao-dev... -e OK
checking for libasound2-dev... -e OK
checking for libmpg123-dev... -e OK
Done checking development packages
All core libraries available. Core components can be installed
checking for GStreamer...
checking for libgstreamer0.10-0... -e OK
checking for gstreamer0.10-x... -e OK
checking for gstreamer0.10-plugins-base... -e OK
checking for gstreamer0.10-tools... -e OK
checking for gstreamer0.10-plugins-good... -e OK
checking for libgstreamer0.10-dev... -e OK
checking for libgstreamer-plugins-base0.10-dev... -e OK
checking for libxext-dev... -e OK
checking for GStreamer plugins...
Warning: GStreamer Win32 codecs is absent - WMA9 Pro, Voice and Loseless streams will not play
checking for Flash MMR development libs...
checking for libgtk2.0-dev... -e OK
checking for flashplugin-nonfree*... -e OK
checking for libxt-dev... -e OK
checking for audio development libs...
checking for libspeex-dev... -e OK
checking for USB development libs...
checking for linux-headers-2.6.35-28-generic-pae... -e OK
checking for QT libraries
grep: /etc/redhat-release: No such file or directory
checking for libqt4-dev... -e OK
checking for libqt*gui*... -e OK
checking for libqt*core*... -e OK
Prerequisites checks done

Note: The line: “Checking for libboost-thread1.34*... not installed... try to install? (y/n): y
ERROR: package libboost-thread1.34* is not found, try to install it manually ”

The shell script is unable to locate or install this package because libboost-thread1.34 is no longer available in most repositories as it has been superseded by more recent versions. We will have to create a workaround to get the "vWorkspace Connector" to run correctly.

6. The following commands will create a symbolic link necessary for "vWorkspace" to find the components it needs from the libboost package we were unable to install.

Note: These will need to be run as root user.

ln -sv /usr/lib/ /usr/lib/
ln -sv /usr/lib/ /usr/lib/

7. Next you will need to create a softlink to allow the USB Redirection kernel module's make file to find the necessary kernel headers.

ln -s <path to kernel headers> /usr/src/linux

Replacing <path to kernel headers> with the folder located in /usr/src/ that corresponds to the kernel you are currently using(uname -r)

8. Make the .bin file executable:

~/vWorkspace$ sudo chmod +x vWorkspaceConnectorForLinux-

9. You may now start the GUI vWorkspace Connector for Linux Setup by navigating into the unzipped folder and typing in the following:

~/vWorkspace$ sudo ./vWorkspaceConnectorForLinux-

10. Simply click through the setup to install the program and once the process has completed, the program can be opened by either clicking on the icon in applications menu or by entering AppPortal into the terminal.

Configuration of the vWorkspace Connector

1. In the vWorkspace AppPortal, select Manage Connections located under "Actions." Select Create new farm and click Next> and name the new connection VOAL [fig. 01]

Creating a New Farm Entry

[fig. 01 - Creating a New Farm Entry]

2. Select Allow me to manually specify all configuration parameters [fig. 02].

Configuration Source

[fig. 02 - Configuration Source]

3. For the "Location 1" entry, select HTTPS using TCP Port 443 and add as a connection broker [fig. 03].

Adding a Connection Broker

[fig. 03 - Adding a Connection Broker]

4. Select Location 1 and click on the box next to Enable RDP over SSL/TLS then enter as the "SSL Gateway Server" [fig. 04].

Firewall Settings

[fig. 04 - Firewall Settings]

5. Enter the following information [fig. 05]:

  • Username: Your NetID 

  • Password: Your NetID Password

  • Domain: TAMU.EDU


[fig. 05 - Credentials]

6. Modify the settings as you see fit [fig. 06].

Note: The options on the screen below are the options that will give you the best quality, but if you have a relatively limited internet connection, you may wish to change these settings.

Display Settings

[fig. 06 - Display Settings]

7. Modify the settings as you see fit but Disk Drives, Printers, and Clipboard are recommended [fig. 07].

Local Resources

[fig. 07 - Local Resources]

8. Similar to the "Display" settings, the options below are for an optimal user experience. Modify these settings to reflect local network limitations. Do select Persistent Bitmap Caching [fig. 08].

Configuring Connection Speed

[fig. 08 - Configuring Connection Speed]

9. Do not enable the Password Management feature and leave the field blank.

10. At this point, ignore the "Auto-Launch" setting. Click Finish.

11. Double click on the VOAL entry under "Farms," select Location 1 and click Connect.

12. In the "Applications" section, Go to 1_VOAL under "My Applications" to start the VOAL Session [fig. 09].


[fig. 09 - Applications]

13. This can be set to auto launch by clicking on Manage Connections, then Auto-Launch and moving 1_VOAL to the left [fig 10].

Configuring VOAL to Auto-Lanuch

[fig. 10 - Configuring VOAL to Auto-Launch]

If you have any further questions, please email or call us at 979.845.8300.

Document ID 1254
June 29, 2014
Jump to document:

Contact Us 24/7/365


In person: 8 a.m. to midnight at the Computing Services Center/Teague Building Room 1112 (view map)

Like us on Facebook Follow us on Twitter