* Obtaining and Installing VirtualGL

	!!! VirtualGL must be installed on any machine that will act as a VirtualGL
	server or as a client for the [[overview.txt#VGL_Transport][VGL Transport]].
	It is not necessary to install VirtualGL on the client machine if using VNC
	or another type of X proxy.

** Installing VirtualGL on Linux

	1. Download the appropriate VirtualGL binary package for your system from the
		[[http://sourceforge.net/projects/virtualgl/files/VirtualGL/][Files area]]
		of the [[http://sourceforge.net/projects/virtualgl][VirtualGL SourceForge project page]].
		Packages are provided for Linux distributions in the
		[[http://www.redhat.com/][Red Hat]],
		[[http://www.novell.com/linux/][SuSE]], or
		[[http://www.debian.org/][Debian]] families that contain GLIBC 2.3.2
		or later (including [[http://fedoraproject.org/][Fedora]],
		[[http://www.centos.org/][CentOS]] 3 or later,
		[[http://www.oracle.com/us/technologies/linux/][Oracle Linux]],
		and [[http://www.ubuntu.com/][Ubuntu Linux]] v6.0 or later.)
		{nl}
		!!! If you wish to run both 32-bit and 64-bit OpenGL applications using
		VirtualGL on 64-bit Linux systems, you will need to install both the i386
		and x86_64 VirtualGL RPMs or both the "virtualgl" and "virtualgl32" amd64
		DEBs.  (The virtualgl32 DEB is a supplementary package that contains only
		the 32-bit server components.)

	2. Log in as root, cd to the directory where you downloaded the binary
		package, and issue the following commands:

		RPM-based systems :: {:}
		#Verb <<---
		rpm -e VirtualGL
		rpm -i VirtualGL*.rpm
		---

		Debian-based systems :: {:}
		#Verb <<---
		dpkg -r virtualgl
		dpkg -i virtualgl*.deb
		---

** Installing the VirtualGL Client on OS X

	#. Download the VirtualGL Mac disk image
		(''VirtualGL-''__''{version}''__''.dmg'') from the
		[[http://sourceforge.net/projects/virtualgl/files/VirtualGL/][Files area]]
		of the [[http://sourceforge.net/projects/virtualgl][VirtualGL SourceForge project page]].

	#. Open the disk image, then open ''VirtualGL-''__''{version}''__''.pkg'' inside the
		disk image.  Follow the instructions to install the Mac client.

** Installing the VirtualGL Client on Windows (Exceed)

	#. Download the VirtualGL Client for Exceed installer package
		(''VirtualGL[64]-''__''{version}''__''-exceed.exe'') from the
		[[http://sourceforge.net/projects/virtualgl/files/VirtualGL/][Files area]]
		of the [[http://sourceforge.net/projects/virtualgl][VirtualGL SourceForge project page]].

	#. Run the installer.  The installation of the VirtualGL Client should be
		self-explanatory.  The only configuration option is the directory into
		which you want the files to be installed.

 !!! NOTE: The VirtualGL Client for Exceed installer does not remove any
 previous versions of the VirtualGL Client that may be installed on your machine.  If
 you wish, you can remove these older versions manually by using the "Add or
 Remove Programs" applet in the Control Panel (or the "Programs and Features"
 applet if you are running Windows Vista.)

** Installing the VirtualGL Client on Windows (Cygwin/X)

	#. Make sure that the following Cygwin packages are installed:{nl}{nl}
		libGL{nl}
		libGLU{nl}
		libstdc++{nl}
		libX11{nl}
		libXext{nl}
		openssh{nl}
		xorg-xserver{nl}
		xauth{nl}

	#. Download the VirtualGL Cygwin package
		(''VirtualGL-''__''{version}''__''-cygwin.tar.bz2'') from the
		[[http://sourceforge.net/projects/virtualgl/files/VirtualGL/][Files area]]
		of the [[http://sourceforge.net/projects/virtualgl][VirtualGL SourceForge project page]].

	#. Run the Cygwin Setup application (the same application you used to install
		Cygwin.)

	#. On the "Choose a Download Source" page, select "Install from Local
		Directory".

	#. On the "Select Root Install Directory" page, use the same options that you
		used when installing Cygwin.

	#. On the "Select Local Package Directory" page, enter the directory
		containing the VirtualGL Cygwin package.

	#. On the "Select Packages" page, change "View" to "Partial" and verify
		that the VirtualGL package with the correct version is selected for
		install.  Click "Next>" to install.

** Installing VirtualGL from Source

If you are using a platform for which there is not a pre-built VirtualGL binary
package available, then download the VirtualGL source tarball
(''VirtualGL-''__''{version}''__''.tar.gz'') from the 
[[http://sourceforge.net/projects/virtualgl/files/VirtualGL/][Files area]]
of the [[http://sourceforge.net/projects/virtualgl][VirtualGL SourceForge project page]],
uncompress it, ''cd VirtualGL-''__''{version}''__, and read the contents of
''BUILDING.txt'' for further instructions on how to build and install VirtualGL
from source.

** Uninstalling VirtualGL

*** Linux
#OPT: noList! plain!

As root, issue one of the following commands:

	RPM-based systems :: {:}
	#Verb: <<---
	rpm -e VirtualGL
	---

	Debian-based systems :: {:}
	#Verb: <<---
	dpkg -r virtualgl
	---

*** OS X
#OPT: noList! plain!

Use the "Uninstall VirtualGL" application provided in the VirtualGL disk image,
or issue the following command from the Terminal:

#Verb: <<---
sudo /opt/VirtualGL/bin/uninstall
---

*** Windows (Exceed)
#OPT: noList! plain!

Use the "Programs and Features" applet in the Control Panel (or the
"Add or Remove Programs" applet if you are running Windows XP), or
select "Uninstall VirtualGL Client" in the "VirtualGL Client" Start Menu group.

*** Windows (Cygwin/X)
#OPT: noList! plain!

	#. Run the Cygwin Setup application (the same application you used to install
		Cygwin.)

	#. On the "Choose a Download Source" page, select "Install from Local
		Directory".

	#. On the "Select Root Install Directory" page, use the same options that you
		used when installing Cygwin.

	#. On the "Select Local Package Directory" page, enter the directory
		containing the VirtualGL Cygwin package.

	#. On the "Select Packages" page, change "View" to "Full", find the
		"VirtualGL" package in the list, and change its status from "Keep" to
		"Uninstall".  Click "Next>" to uninstall.
