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. Click on the vWorkspace logo from the toolbar.

2. From the menu, click Add Farm.

3. From the Add Farm dialog box, select Click Here to Auto Configure.  The Auto Configure dialog box is displayed.

4. Configure the auto-configuration settings.

5. Set URL Protocol to HTTPS

6. Set URL String to

7. Set File Name to config.xml

8. Don't set Proxy Settings

9. Click Connect.

When asked for your username, password, and domain. Enter your NetID and Password and if not set already, set Domain to TAMU.EDU (domain must be in ALL caps).

You should then have to choose your location.  If you are off campus and not connected via VPN, select "Off Campus".  Else, you may select one of the other options.

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

Document ID 1254
September 19, 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