VNC Upgrade Guide
VNC Upgrade Guide
VNC Upgrade Guide
Version 5.0
June 2012
Trademarks
VNC is a registered trademark of RealVNC Ltd. in the U.S. and in other countries. Other trademarks are the
property of their respective owners.
Protected by UK patent 2481870.
Copyright
Copyright RealVNC Limited, 2002-2012. All rights reserved.
No part of this documentation may be reproduced in any form or by any means or be used to make any
derivative work (including translation, transformation or adaptation) without explicit written consent of
RealVNC.
Confidentiality
All information contained in this document is provided in commercial confidence for the sole purpose of use
by an authorized user in conjunction with RealVNC products. The pages of this document shall not be
copied, published, or disclosed wholly or in part to any party without RealVNCs prior permission in writing,
and shall be held in safe custody. These obligations shall not apply to information which is published or
becomes known legitimately from some source other than RealVNC.
Contact
RealVNC Limited
Betjeman House
104 Hills Road
Cambridge
CB2 1LQ
United Kingdom
www.realvnc.com
Contents
Chapter 1:
Chapter 2:
Chapter 3:
Introduction
10
13
15
16
1
Introduction
This Guide explains how to upgrade a computer running VNC Enterprise Edition 4.x or VNC Personal
Edition 4.x to VNC 5.0.
Note: We recommend you do not upgrade a computer running VNC Open (formerly VNC Free Edition). For
best results, remove it before installing VNC 5.0.
This Guide also explains how to upgrade a computer on which VNC Viewer 4.x is installed to VNC Viewer
5.0.
Contents
Whats new in this release
Chapter 1: Introduction
Purchase VNC Server (Enterprise) to take advantage of all RealVNC remote control features. A thirty day
trial is available.
Purchase VNC Server (Personal) to take advantage of most RealVNC remote control features. A thirty
day trial is available.
For more information on RealVNC remote control features, and other terms and conditions, visit
www.realvnc.com/products/vnc/.
Note: VNC Viewer does not require a license key.
Many VNC Server and VNC Viewer names (components, services, and settings) have changed. If you script
or integrate either product, examine this Guide for details.
2
Upgrading VNC Server
This chapter explains how to upgrade VNC Server 4.x (installed as part of VNC Enterprise Edition or VNC
Personal Edition) to VNC Server 5.0 (installed as part of VNC).
Contents
Licensing VNC Server
10
13
If your VNC Enterprise Edition or VNC Personal Edition support and upgrades contract is valid, you need
take no action:
VNC Enterprise Edition automatically upgrades to VNC Server (Enterprise).
VNC Personal Edition automatically upgrades to VNC Server (Personal).
To see whether you have a valid support and upgrades contract:
Under Windows or Mac OS X, just start the installer (if no warning appears, your support and
upgrades contract is valid).
Under UNIX/Linux, run the command vnclicense list from the directory in which VNC
programs are installed. A support and upgrades contract is valid for one year from the date of issue
of the license key, for example in the following case until 17th November 2012:
1
10 desktops
2011/11/18
[full]
If your VNC Enterprise Edition or VNC Personal Edition support and upgrades contract has expired, you
can upgrade but VNC Server will only work for seven days. During this period, you must obtain a new
license key; if you do not, connections will be prohibited. You can either:
Renew your support and upgrades contract in order to obtain a new license key. To apply it, follow
the instructions in the Licensing VNC Server section of the appropriate installation instructions at
www.realvnc.com/products/vnc/documentation/latest/installing-removing/.
Downgrade to VNC Server (Free). Note if you do this you will lose RealVNC remote control features
such as encryption, system authentication, file transfer, printing, and chat.
If you are currently engaged in a trial of VNC Enterprise Edition, you can upgrade to VNC Server
(Enterprise) for the outstanding remainder. At the end of the trial, you must either purchase VNC Server
(Enterprise), or downgrade to VNC Server (Free). You have seven days in which to make this decision,
after which connections will be prohibited.
If you are currently engaged in a trial of VNC Personal Edition, you can upgrade to VNC Server
(Personal) for the outstanding remainder. At the end of the trial, you must either purchase VNC Server
(Personal), upgrade to VNC Server (Enterprise), or downgrade to VNC Server (Free). You have seven
days in which to make this decision, after which connections will be prohibited.
If VNC Server 4.x is currently running in Service Mode, it is stopped. Any users are temporarily
disconnected. Users can immediately reconnect to VNC Server 5.0 in Service Mode (or are
automatically reconnected if using VNC Viewer 5.0).
If VNC Server 4.x is currently running in User Mode, it is not stopped, and users are not disconnected.
VNC Server 5.0 is not started in User Mode. Existing connections are maintained until explicitly stopped
or the computer user logs out.
If VNC Enterprise Edition or VNC Personal Edition is detected, all programs and the containing folder are
deleted. An exception is if VNC Server 4.x is currently running in User Mode, in which case the
appropriate executables are not deleted until the next time the computer is restarted.
When VNC Server is started for the first time (note this may happen automatically), registry settings, identity
keys, and valid license keys are migrated. The originals are preserved.
Name changes
The default installation directory has changed:
Original location
New location
C:\Program Files\RealVNC\VNC4
Original name
New name
Executable
winvnc4.exe
vncserver.exe
Service
WinVNC4
vncserver
Original name
New name
HKEY_LOCAL_MACHINE/
Software/RealVNC/WinVNC4
HKEY_LOCAL_MACHINE/
Software/RealVNC/vncserver
HKEY_CURRENT_USER/
Software/RealVNC/WinVNC4
HKEY_CURRENT_USER/
Software/RealVNC/vncserver
Original name
New name
License key
WinVNC4_License
vncserver_license
VNC Server is not automatically started in either User Mode or Virtual Mode. You must start VNC Server
manually. (For information on Service Mode, see Starting VNC Server in Service Mode on page11.)
If VNC Server 4.x is currently running in User Mode, it is not stopped, and users are not disconnected.
All connections are maintained until explicitly stopped or the computer user logs out.
If VNC Server 4.x is currently running in Virtual Mode, it is not stopped, and users are not disconnected.
All connections are maintained until explicitly stopped or the computer is restarted.
10
When you start VNC Server for the first time, configuration settings, identity keys, and valid license keys are
migrated. The originals are preserved.
Note: If you perform other package management operations on RPM-based platforms at the same time,
any changes made by these operations to the shared PAM configuration file /etc/pam.conf will be lost
(this is likely to be used for single sign-on authentication by older systems only). To restore them, merge the
backup file /etc/pam.conf.vnc-E-upgrade back in afterwards.
Name changes
The following names have changed:
VNC Server binary...
Original name
New name
User Mode
x0vncserver
vncserver-x11
Virtual Mode
vncserver
vncserver-virtual
Original name
New name
Debian-compatible
vnc-e
realvnc-vnc-server
Red Hat-compatible
vnc-E
realvnc-vnc-server
Solaris
vnc-E
RVNCsrv
HP-UX
vnc-E
realvnc-vnc-server
Note: This may affect the command you use to uninstall VNC Server.
11
In VNC Server 5.0, an inetd service will not work. Instead, you can run a new daemon, vncservervirtuald, which listens on port 5999 by default. See the vncserver-virtuald man page (available at
www.realvnc.com/products/vnc/documentation/latest/misc/reference/vncserver-virtuald) for more
information.
12
If VNC Server 4.x is currently running in Service Mode, it is stopped. Any users are temporarily
disconnected. Users can immediately reconnect to VNC Server 5.0 in Service Mode (or are
automatically reconnected if using VNC Viewer 5.0).
If VNC Server 4.x is currently running in User Mode, it is not stopped, and users are not disconnected.
VNC Server 5.0 is not started in User Mode. Existing connections are maintained until explicitly stopped
or the computer user logs out.
When VNC Server is started for the first time (note this may happen automatically), configuration settings,
identity keys, and valid license keys are migrated. The originals are preserved.
Name changes
The following names have changed:
VNC Server...
Original name
New name
Binary
macvnc
vncserver
Helper
macvnc-root
vncserver-root
Uninstaller
Uninstall VNC.app
13
14
3
Upgrading VNC Viewer
This chapter explains how to upgrade VNC Viewer 4.x (installed as part of VNC Enterprise Edition or VNC
Personal Edition) to VNC Viewer 5.0 (installed as part of VNC).
Note: Standalone VNC Viewer 4.x is not installable software and is therefore not upgraded. Version 5.0 of
this product is freely available to download from www.realvnc.com/download/viewer/.
Contents
Installing VNC Viewer 5.0
16
15
Under Windows and Mac OS X, make sure the VNC Viewer component is selected on the appropriate
installer page.
If VNC Viewer 4.x is running, it is not stopped. Remote control sessions are maintained until explicitly
stopped or the computer user logs out.
Note: Under Mac OS X, to start VNC Viewer 5.0 while VNC Viewer 4.x is running, choose New from the
Window menu.
If VNC Viewer 4.x is detected, it is deleted under UNIX/Linux and Mac OS X. Under Windows, it is not
deleted.
It is not necessary to apply a license key to VNC Viewer. To see how to establish a connection, start with
www.realvnc.com/products/vnc/documentation/.
Name changes
The changes in this section only apply under Windows. There are no equivalent changes under UNIX/Linux
or Mac OS X.
The default installation directory has changed:
Original location
New location
C:\Program Files\RealVNC\VNC4
Original name
New name
VNC Viewer
HKEY_CURRENT_USER/
Software/RealVNC/VNCViewer4
HKEY_CURRENT_USER/
Software/RealVNC/vncviewer
When you start VNC Viewer for the first time, registry settings and identity keys are migrated. The originals
are preserved.
16