• Documentation
  • »
  • User Guide

Contents

About This Guide

Chapter 1: Introduction

Principles of VNC remote control

Getting the computers ready to use

Connectivity and feature matrix

What to read next

Chapter 2: Getting Connected

Step 1: Ensure VNC Server is running on the host computer

Step 2: Start VNC Viewer on the client computer

Step 3: Identify VNC Server running on the host computer

Step 4: Request an encrypted connection

Step 5: Connect to VNC Server

Troubleshooting connection

Chapter 3: Using VNC Viewer

Starting VNC Viewer

Starting Listening VNC Viewer

Configuring VNC Viewer before you connect

Connecting to a host computer

The VNC Viewer user experience

Using the toolbar

Using the shortcut menu

Using the VNC Viewer - Options dialog

Managing the current connection

Changing appearance and behavior

Restricting access to features

Chapter 4: Connecting From A Web Browser

Connecting to a host computer

The VNC Viewer for Java user experience

Working with VNC Viewer for Java

Chapter 5: Exchanging Information

Printing host computer files to a local printer

Transfering files between client and host computers

Copying and pasting text between client and host computers

Communicating securely using chat

Chapter 6: Setting Up VNC Server

Licensing VNC Server

Starting VNC Server

Running multiple instances of VNC Server

Working with VNC Server

Configuring ports

Notifying when users connect

Preventing connections to VNC Server

Restricting functionality for connected users

Stopping VNC Server

Chapter 7: Making Connections Secure

Authenticating connections to VNC Server

Relaxing the authentication rules

Bypassing the authentication rules

Changing the encryption rules

Preventing particular connections to VNC Server

Restricting features for particular connected users

Uniquely identifying VNC Server

Protecting privacy

Appendix A: Saving Connections

Saving connections to VNC Address Book

Using VNC Address Book to connect

Managing connections using VNC Address Book

Saving connections to desktop icons

Previous Next Chapter 4, Connecting From A Web Browser

Connecting to a host computer

Connecting to a host computer is a two-stage process using VNC Viewer for Java:

1. Download VNC Viewer for Java from VNC Server (Enterprise) or VNC Server (Personal) running on the host computer you want to connect to. See Downloading VNC Viewer for Java.

2. Use the VNC Viewer for Java applet to connect to VNC Server. See Connecting to VNC Server.

Downloading VNC Viewer for Java

The first stage is to download VNC Viewer for Java to your web browser on demand. To do this:

1. Start a Java-enabled web browser on the client computer, for example the latest version of Internet Explorer, Firefox, Safari, or Chrome.

Note: For more information on Java, visit www.java.com. Note that Java (JRE or JDK) 5+ must be installed on the client computer.

2. In the address bar, enter http:// and the network address of the host computer, qualified by the port number on which VNC Server is listening for download requests, for example http://192.168.0.133:5800.

If you do not know a network address for the host computer and you do not have access to it, you will need to consult your system administrator or a host computer user. If you do have access to the host computer, and you are connecting within a private network, the information you need is displayed in the Get Started section of the VNC Server dialog. More on this dialog.

Note: If you are connecting over the Internet, you will probably need to enter the network address of a router instead. See Connecting over the Internet for more information.

By default, VNC Server listens for download requests on port 5800. If the download request fails, it may be because VNC Server is listening on a different port; see Qualifying a network address with a port number for more information. A download request may also fail if the host computer is protected by a router and/or a firewall and these devices have not been configured to allow access to VNC Server at the correct port. For more information on this, and connection issues in general, see Troubleshooting connection.

3. If this is the first time you have VNC Viewer for Java, you are prompted to trust it:

You can do this in complete confidence. However, you can choose not to trust VNC Viewer for Java and still connect, though note you cannot copy and paste text between applications in the normal way.

In the example above, click the Run button to trust VNC Viewer for Java, and Cancel to continue connecting without trusting it.

If VNC Viewer for Java successfully downloads, the VNC Viewer dialog opens:

(In this picture, the web browser is Firefox 8. Note that the web browser window must stay open while the connection is in progress.)

Connecting to VNC Server

The second stage is to use VNC Viewer for Java to connect to VNC Server. This is the same process as connecting from VNC Viewer.

The VNC Server dropdown on the VNC Viewer dialog displays the network address of the host computer, qualified by the port number on which VNC Server is listening for connection requests (in the example below, the digit 0 corresponds to the default port, 5900):

For more information on network addresses and port numbers, start with Step 3: Identify VNC Server running on the host computer.

To continue connecting:

1. From the Encryption dropdown, select an encryption option, or retain the default: Let VNC Server choose. For more information on this, see Step 4: Request an encrypted connection.

2. If you want to configure VNC Viewer for Java before you connect, click the Options button. For informa­tion on why you might want to do this, see Configuring VNC Viewer for Java before you connect.

3. Click the Connect button.

You may be asked to confirm a signature that uniquely identifies VNC Server, acknowledge the encryption status, and to authenticate. For more information on these issues, see Step 5: Connect to VNC Server.

If the connection is successful, VNC Viewer for Java displays the host computer’s desktop in a new window on the client computer. Carry on from The VNC Viewer for Java user experience.

If the connection fails for any reason, start with Troubleshooting connection.

Configuring VNC Viewer for Java before you connect

VNC Viewer for Java is ready to connect to VNC Server and control a host computer out-of-the-box. You do not need to configure it. However, you can change some aspects to suit your requirements and environment if you wish.

Some options must be configured before you connect. Most, however, can be configured once you are connected, and changes applied to the current connection. For more information, see Using the VNC Viewer - Options dialog.

To configure VNC Viewer for Java before you connect, click the Options button in the VNC Viewer dialog. The VNC Viewer - Options dialog opens:

The following options must be configured before a connection is made:

•  To make the connection more secure, choose an alternative to the default key length of 512 bits. This option is on the Security tab.

•  To ensure your privacy at the start of the connection, turn off Shared (don’t disconnect other VNC Viewers) in order to disconnect other users. This option is on the Misc tab.