« Back to docs

Installing and removing VNC 5.x

These instructions explain how to install VNC 5.x on legacy AIX computers.

Note

VNC Connect (version 6+) is not available for AIX.

You will need a valid license key. You may have an historic VNC 5.x Personal or Enterprise key, but if not then you will need to purchase a new VNC Connect Enterprise subscription. A license key for VNC 5.x is made available from the Deployment page of your RealVNC account.

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:

  1. If you have a valid support and upgrades contract, preserve your license key by copying /etc/vnc/licensekey to 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]
    
  2. 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.

Downloading VNC 5.x

Download the VNC generic installer.

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 own an historic VNC 5.x license key but do not know it, contact Support.

Note

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 /etc/vnc.

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

Paths

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 /etc/profile:

PATH=$PATH:/usr/local/bin:/usr/openwin/bin
MANPATH=$MANPATH:/usr/local/man

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 /usr/dt/config/Xconfig:

Dtlogin*grabServer: False

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:

vncserver-x11 -serviceui

Starting VNC Server

To see how to start VNC Server in your choice of mode, consult the appropriate man page.

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).

Note

To completely remove (benign) configuration and other files or settings that may remain, follow these instructions.

×