We're here if you need help
Installing and removing VNC 5.x¶
These instructions explain how to install VNC 5.x on ancilliary AIX computers.
VNC Connect (version 6) is not available for AIX.
Upgrading to VNC 5.x¶
If you are upgrading from an earlier version of VNC 5.x, installation should be seamless. You do not need to stop VNC Server, and any configuration changes you have made will be preserved. You are informed if you are required to apply a new license key.
You cannot upgrade from VNC Enterprise Edition 4.x. You must first remove it. To do this:
If you have a valid support and upgrades contract, preserve your license key by copying
/etc/vnc/licensekeyto a safe location. If you do not have a valid support and upgrades contract, you need take no action; you will need to obtain a new license key anyway.
To find out whether you have a valid support and upgrades contract, run the command
vnclicense -list. A contract is typically valid for one year from the date of issue of the license key, so in the following example until 18th November 2016:
1 10 desktops 2016/11/18 [full]
Uninstall VNC Enterprise Edition by deleting programs from the directory in which they are installed (by default,
/usr/local/bin). For a full list of programs, examine the original installation script.
Installing VNC 5.x¶
Follow these instructions to install VNC Server and VNC Viewer using a configurable script.
Licensing VNC Server¶
VNC Server must be licensed or remote access will not be available. If you do not know your license key, contact Support.
VNC Viewer does not require a license key.
Reinstating a valid VNC Enterprise Edition license key¶
To do this, copy a preserved license key file back to
At the command line¶
Run the following command as a user with administrative privileges:
/usr/local/bin/vnclicense -add KEY
Setting up the environment for VNC Server¶
By default, programs are installed in
/usr/local/bin. To configure paths for all users, and to provide access to the reference documentation, add the following to
VNC Server in Service Mode¶
If you are using dtlogin (other display managers may be affected), VNC Viewer users cannot connect when the computer is at the login screen. Uncomment (or add)
the following command to
If you are using CDE (other desktop environments may be affected), the VNC Server user interface (a status dialog and icon) may not
be shown. Run the following command as the desktop owner (not as root), or add it to a user’s
.xstartup or equivalent file:
Starting VNC Server¶
Removing VNC 5.x¶
Delete programs from the directory in which they are installed (by default,
/usr/local/bin). For a full list of programs, examine the
installation script (or alternatively the contents of the download tarball).
To completely remove (benign) configuration and other files or settings that may remain, follow these instructions.