* Obtaining and Installing TurboVNC

** Installing TurboVNC on Linux

*** Font Dependencies
#OPT: noList! plain!

On some Linux distributions, most notably Fedora 10 and later, the basic X11
bitmap fonts are not installed by default.  Thus, it is necessary to install
the ''xorg-x11-fonts-misc'' package on these distributions prior to starting a
TurboVNC session for the first time.  Otherwise, TurboVNC will fail with the
following error:

	#Verb <<---
	Fatal server error:
	could not open default font 'fixed'
	---

*** Installing TurboVNC
#OPT: noList! plain!

	1. Download the appropriate TurboVNC binary package for your system from the
		[[http://sourceforge.net/projects/virtualgl/files/TurboVNC/][Files area]]
		of the [[http://sourceforge.net/projects/virtualgl][VirtualGL SourceForge project page]].
		{nl}

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

		RPM-based systems :: {:}
		#Verb <<---
		rpm -U turbovnc*.rpm
		---

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

** Installing TurboVNC on Solaris

	1. Download the TurboVNC Solaris package
		(''TurboVNC-''__''{version}''__''-solarisx86.pkg.bz2'' for 32-bit systems or
		''TurboVNC-''__''{version}''__''-solarisx64.pkg.bz2'' for 64-bit systems)
		from the
		[[http://sourceforge.net/projects/virtualgl/files/TurboVNC/][Files area]]
		of the [[http://sourceforge.net/projects/virtualgl][VirtualGL SourceForge project page]].
		{nl}

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

		If TurboVNC 0.6 or older is installed :: {:}
		#Verb: <<---
		pkgrm SUNWtvnc
		---

		If TurboVNC 1.0 or newer is installed :: {:}
		#Verb: <<---
		pkgrm TurboVNC
		---

	(answer "Y" when prompted.)

	#Verb: <<---
	bzip2 -d TurboVNC*.pkg.bz2
	pkgadd -d TurboVNC*.pkg
	---

	Select the ''TurboVNC'' package (usually option 1) from the menu.

** Installing the TurboVNC Viewer on OS X

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

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

** Installing the TurboVNC Viewer on Windows

	#. Download the TurboVNC Windows installer package
		(''TurboVNC-''__''{version}''__''.exe'' for 32-bit systems or
		''TurboVNC64-''__''{version}''__''.exe'' for 64-bit systems) from the
		[[http://sourceforge.net/projects/virtualgl/files/TurboVNC/][Files area]]
		of the [[http://sourceforge.net/projects/virtualgl][VirtualGL SourceForge project page]].

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

** Installing TurboVNC from Source

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

** Uninstalling TurboVNC

*** Linux
#OPT: noList! plain!

As root, issue one of the following commands:

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

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

*** Solaris
#OPT: noList! plain!

As root, issue the following command:

#Verb: <<---
pkgrm TurboVNC
---

Answer "yes" when prompted.

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

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

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

*** Windows
#OPT: noList! plain!

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