Ultra VNC Repeater Guide

Document Version: 5

Modified Date: 2006-02-13

1.

Downloading the repeater...................................................................................................................1

2.

Extracting the Zip File ........................................................................................................................4

3.

Running/Configuring the Repeater.....................................................................................................7

3.1

Settings .......................................................................................................................................9

3.2

Logs ......................................................................................................................................... 13

4.

Configuring the Viewer / SC to use the Repeater ........................................................................... 18

4.1

Configuring Single Click using the repeater ........................................................................... 19

4.2

Configuring UltraVNC Viewer ............................................................................................... 21

5.

Configuring the service ................................................................................................................... 24

6.

Linux Repeater................................................................................................................................. 27

6.1

Downloading / Compiling ....................................................................................................... 27

6.2

Running.................................................................................................................................... 28

6.3

Mode I Log Information .......................................................................................................... 31

6.4

Mode II Log Information......................................................................................................... 33

6.5

Example Repeater Log for a Mode I Connection.................................................................... 35

Ultra VNC Repeater Guide

1.

Downloading the repeater

The current stable version of the repeater is: 1.0.4

The current test version of the repeater is: 1.2.2.1

The current stable linux version of the repeater is: 0.08

Rev: 5

Figure 1 - UVNC Homepage

1. Let

’s start at the Ultra VNC website. For this step by step I am using Firefox 1.7 but you can use IE or any other browser. Go to: http://www.utravnc.com

2. On the right had side of the page you will see the Repeater listed

3. Left click on

Page 1

Ultra VNC Repeater Guide Rev: 5

4. This will take you to the sourceforge

1 download mirror site. On there is a list of servers where the zip file, containing the repeater, can be downloaded from. Pick one that is closest to you.

Page 2

Ultra VNC Repeater Guide Rev: 5

Page 3

Ultra VNC Repeater Guide

2.

Extracting the Zip File

1. Double click the UltraVNC-Repeater-104.zip file

Rev: 5

Figure 6 - UltraVNC-Repeater-104.zip file contents in WinZip

2. Go to Actions->Extract menu.

3. This will bring up a new dialog. Select the Desktop as the extract location and make sure you have All Files selected.

4. Click Extract

Figure 7 - Extract Window

5. The files will now be available on your desktop

Page 4

Ultra VNC Repeater Guide Rev: 5

Figure 8 - Extracted files on desktop with renamed readme.txt

6. Rename the readme.txt to Repeater104Readme.txt a. This means that you can copy the repeater readme file to the UltraVNC folder without having to overwrite the UltraVNC Readme file.

7. If you have UltraVNC Installed go to Step 8 otherwise go to step 9.

8. Highlight the two files and move them to the UltraVNC directory a. Default Installation directory is: c:\Program Files\UltraVNC\ but this may differ depending on your installation.

b. Go to step 11.

Figure 9 - Move Repeater files to UltraVNC Directory

Page 5

Ultra VNC Repeater Guide Rev: 5

9. If you are running a repeater on a PC without UltraVNC installed you will need to create a new directory where you would like to run the repeater from.

a. E.g. c:\Program Files\UltraVNCRepeater\

10. Highlight the two files and move them to the directory you have just created.

11. Once that is done you can delete the repeater.1.0.4.zip file if you wish or archive it.

12. Finally, run the repeater by double clicking on it

Page 6

Ultra VNC Repeater Guide Rev: 5

3.

Running/Configuring the Repeater

1. If you are running windows XP with SP2 the following will dialog box will appear. Otherwise, if you are using a different firewall package it will prompt you with a similar dialog box to windows firewall.

2. Make Sure to allow the Repeater to run and open TCP port 5901 for Mode I and Port 5500 for

Mode II, if necessary.

a. The difference between the modes is explained below in Section 3.1 Step 7. Only open the required ports.

3. These ports can be changed to suite your needs through the settings configuration found in

Section 3.1 Step 10. For example, you can use ports 443 and 2105

Figure 10 - Windows firewall access permission screen

4. For Windows Firewall users choose

Figure 11 - Unblock button

Page 7

Ultra VNC Repeater Guide

5. If everything is correct you should notice the repeater Icon on your system tray a. NOTE: Your icons down here will vary depending on what you have loaded

Rev: 5

Figure 12 - Repeater Icon in system tray

6. Right click on your repeater icon on the system tray

Figure 13 - Right Click context menu

7. On the right click menu you will notice two options: i. settings and, ii. log

8. These are very important when working with a repeater. Be sure to note that you right click on the repeater icon on the system tray to access them

Page 8

Ultra VNC Repeater Guide Rev: 5

3.1

Settings

1. Right click on the repeater icon in the system tray

2. Select Settings

3. The follow dialog box will appear (minus the Mode I and Mode II (SC) diagram text. These were added for clarification purposes).

Figure 14 - Repeater Settings Window

4. As you can see there are several sections to the repeater settings page

5. On the top left hand side are the port configurations

Figure 15 - Port Configuration

Page 9

Ultra VNC Repeater Guide

·

Accept 5901 ( this is the Proxy port for the standard UltraVNC viewer and servers )

·

Listen 5500 ( is the listening port of SC and possibly other servers )

Rev: 5

6. These ports can be changed if the default ones do not work.

a. Note: If using mode II under restrict access to server port make sure that you enter 0

7. The repeater can operate in the following modes: i. Mode I and II, or ii. Mode I, or iii. Mode II b. I personally prefer only mode II it gives you the best of both configurations c. I would suggest disabling any mode that you don

’t need.

Figure 16 - Mode Configuration

8. ID are used to help secure connection requests a. Keep in mind the SC is a special VNC server but it still is a server acting in reverse mode

9. You are at the step that you have to decided what kind of repeater you wish to run and make sure that it is enabled a. For the following example I am going to use mode II only so disable Mode 1 (See

Figure 17 - Single Mode II Configuration).

Figure 17 - Single Mode II Configuration

Page 10

Ultra VNC Repeater Guide

10. The Only Allow Connections to Server if checked

Rev: 5

Figure 18 - Only Allow Connection to Server Option

11. Only allows IP Addresses added to the box below the option. Each address must be separated by a ; a. For example, IP Addresses 192.168.2.1 and 192.168.2.2, would be entered as:

Figure 19 - Configured Only Allow Connections to Server dialog

12. The Only Allow ID if Checked

Figure 20 - Only Allow ID Option

13. Only allows ID

’s added to the box below the option. Each ID must be separated by a ; a. For Example, ID's 1234;1235;1236, would be entered as:

Page 11

Ultra VNC Repeater Guide

Figure 21 - Configured Only Allow ID dialog

14. The Refuse Connections to Server if checked

Rev: 5

Figure 22 - Refuse Connections to Server Option

15. Refuses connections from IP Addresses added to the box below the option. Each address must be separated by a ; a. For example, IP Addresses 192.168.2.1 and 192.168.2.2, would be entered as:

Figure 23 - Configured Refuse connections to Server Dialog

16. Note: BE SURE TO SAVE YOUR SETTINGS!!!!!

17. The window will disappear. Any changes made to the settings only become active when the repeater is restarted.

Page 12

Ultra VNC Repeater Guide Rev: 5

3.2

Logs

The following section aims to provide a brief overview of the Repeater logs and how you can use them for troubleshooting as well as port usage.

1. Right click on the repeater icon in the system tray

2. Select Log

3. The following window will appear

Page 13

Ultra VNC Repeater Guide Rev: 5 b. If there are no repeater errors then there is a problem either routing to your repeater or the viewer configuration.

i. To check your routing is working issue the following command from inside your network via a command prompt:

telnet ipaddress port

Figure 25 - Telnet Commands [Top = Mode I, Bottom = Mode II]

ii. If you are running in Mode I you will see the following (See Figure 26 -

Telnet 127.0.0.1 5901 results):

Figure 26 - Telnet 127.0.0.1 5901 results

iii. If you are running in Mode II you will connect but there will be no feedback.

Look at the repeater log and you will see a server accepted message (See

Figure 27 - Telnet 127.0.0.1 5500 results).

Page 14

Ultra VNC Repeater Guide Rev: 5

Page 15

Ultra VNC Repeater Guide Rev: 5

Page 16

Ultra VNC Repeater Guide Rev: 5

Page 17

Ultra VNC Repeater Guide Rev: 5

4.

Configuring the Viewer / SC to use the Repeater

1. To simplify things I will use a Class C non-routable IP Address scheme (found in most home networks)

192.168.0.1 - Router that connects to the outside world (netgear,

Linksys cable DSL router)

192.168.0.2 - My repeater server (note: WAN IP TCP ports 5500 and

5901 forwarded)

192.168.0.3 - Computer A (UltraVNC version 1.0.1)

192.168.0.4 - Computer B (SC connection)

2. Now before you begin configuring VNC for use on an Internet Connection please start in a Local Area Network (LAN) environment first as this will give you a feel for how VNC works. Also, it is easier to configure. Once you have the LAN mastered then you can move to the Internet Wide Area Network

(WAN).

3. If you want to use the repeater make sure it is running. At this point I am assuming that the repeater is installed and configured to run.

4. You can create an icon for it and place it on your desktop so that it only runs when you want it to. Another option is to copy a shortcut to the repeater into your start menu startup folder.

5. The repeater can be run as a service on any Windows NT/XP/2003.

To configure this see Section 5.

Page 18

Ultra VNC Repeater Guide Rev: 5

4.1

Configuring Single Click using the repeater

1. Lets Focus on Single Click (SC)

2. Dwalf wrote and awesome Step by Step

3.

http://forum.UltraVNC.net/viewtopic.php?t=4606

4. The Helpdesk.txt will need to have the following added

5. For example: A section of the helpdesk.txt

[TITLE]

Remote Support

[HOST]

Connection 1

-id 1234 -connect {your WAN or dynamic host address}:5500

[HOST]

Connection 2

-id 1235 -connect {your WAN or dynamic host address}:5500

[HOST]

Connection 3

-id 1236 -connect {your WAN or dynamic host address}:5500

6. Now that is a basic SC setup

7. The following settings for SC

-plugin = used for the encryption MSRC4 (note you can only use the noreg version only)

-noregistry = keeps the vnc server settings out of the pc's registry

-no tray icon = icon removes the icon from the system tray

-read only = makes the pc only in watch mode

-username = force username authentication

-password = force password authentication

Page 19

Ultra VNC Repeater Guide Rev: 5

8. I know that -plugin, -noregistry work. I have not tested the other ones.

9. Note: the

–plugin and –nonregistry switches are not need if you are using the SSL version

Page 20

Ultra VNC Repeater Guide

4.2

Configuring UltraVNC Viewer

1. Start UltraVNC Viewer

Rev: 5

Page 21

Ultra VNC Repeater Guide Rev: 5

Page 22

Ultra VNC Repeater Guide Rev: 5

6. Note: If you are running this command from older systems you may have problems due to the space between

“program files”. I always run the command as follows:

“c:\program files\UltraVNC\vncviewer” ID:1234 -proxy {your WAN IP or dynamic hosts address of proxy}:{proxy listening port}

7. If it works you will see the following in the repeater logs:

Figure 34 - Repeater Log: Viewer added to list

8. You can add the encryption in once you have it working. It is always better to start with a basic configuration then add the add-on in.

Page 23

Ultra VNC Repeater Guide

5.

Configuring the service

1. Now for those running windows 2000 or XP you can install the repeater as a service

(Using default Paths) for example

2. You can install the repeater from the command prompt

3. Start->Run->

“cmd”

Rev: 5

Figure 35 - Install Repeater as a service from the command prompt

4. This installs it a service named repeater_service and you can control it via the windows services or by running the command from the command prompt.

5. Start->Run->

”cmd”

Figure 36 - Opening the Service Manager from the command prompt

Page 24

Ultra VNC Repeater Guide Rev: 5

Figure 37 - Service Window

6. You can set it to automatic start or start when you wish. If the repeater is set to manual you can start or stop the repeater either from the services window or from a command prompt using the following command:

Figure 38 - Starting the service from a command prompt

a. Note: The service can be stopped by replacing the start in the net start command with stop. E.g. net stop repeater_service

7. If you would like to uninstall the repeater go to your windows services and disable it close the system tray icon.

8. You can uninstall the repeater from the command prompt

9. Start->Run->

“cmd”

“c:\Program Files\UltraVNC\repeater.exe” -uninstall

Page 25

Ultra VNC Repeater Guide Rev: 5

10. I have also created a document that has UltraVNC settings and their location in the registry.

This can be found at the following location: http://forum.UltraVNC.net/viewtopic.php?t=4684

Page 26

Ultra VNC Repeater Guide Rev: 5

6.

Linux Repeater

The Linux version of the repeater can be downloaded from: http://koti.mbnet.fi/jtko/uvncrepeater/ . The following tests were run in Suse Linux 9.3 running on a VMWare system. These instructions should cover the majority of linux distributions.

6.1

Downloading / Compiling

1. Download the Repeater008.zip file to the desktop.

2. If downloading on a windows PC then go to Step 3, otherwise go to Step 5.

3. Follow Section 2 Steps 1

– 5 for instructions on extracting the zip file to the desktop.

4. Copy the extracted files to your Linux box. I would suggest putting them in a folder of their own.

5. On your Linux box go to the directory where the extracted files have been stored.

6. Type make a. For make to work you need to have gcc installed and configured.

7. The repeater will be built and linked. A correct make will look like Figure 39: Repeater make

Output.

Figure 39: Repeater make Output

8. The build should be successful. If not you will need to fix the errors and then do Step 6 again.

9. Go to the next section.

Page 27

Ultra VNC Repeater Guide Rev: 5

6.2

Running

1. Open a console

2. Go to the location where the built repeater files are located a. If you have stored the files in a subfolder within your home directory an example command would be:

cd Modifiedrepeater009

b. Where Modifiedrepeater009 is the folder name c. Note: everything is case sensitive

3. Type ./repeater a. The repeater will run the repeater with default settings i. Viewer listen port (Mode I): 5900, ii. Viewer Server Port (Mode II): 5500 b. A successful execution of the repeater will look like Figure 40: Linux Repeater startup.

Page 28

Ultra VNC Repeater Guide Rev: 5

Figure 41: Linux Repeater Bind Error

4. If you want to run the repeater on a different port then it is possible to specify the port number.

The repeater command takes two arguments:

a. ./repeater [viewerlistenport] [serverlistenport]

b. E.g. ./repeater 5901 5501

c. Note: Only root can open ports under 1024 so it is advised that you use ports greater than 1024.

Figure 42: Linux Repeater Running on Non Default Ports

Page 29

Ultra VNC Repeater Guide Rev: 5

5. Once the repeater is up and running the console is locked and the way to stop the repeater running is to press ctrl+c.

a. No other commands will be available from the console until the repeater process has been stopped.

6. Another way of running the repeater, which will not lock the console is to run

a. ./repeater [optionalViewerPort] [optionalServerPort] &

./repeater 5910 5510 &

7. To list the running processes run the following command:

ps -e

8. If you have run the repeater with the & paramter then the only way of stopping the process is to run

killall repeater

a. Note: The log information will continue to be printed in the console window.

Page 30

Ultra VNC Repeater Guide Rev: 5

6.3

Mode I Log Information

1. When a viewer connects to a remote PC via the repeater you will see the following information written to the console window:

Page 31

Ultra VNC Repeater Guide Rev: 5

Page 32

Ultra VNC Repeater Guide Rev: 5

6.4

Mode II Log Information

1. When a VNC server connects to the repeater you will see the following information written to the console window:

2. For this example i have used an ID of 1234.

Figure 45: Linux Repeater Server Connection

3. When the viewer connects to the repeater the logs will look as follows:

Figure 46: Linux Repeater Server-Viewer Connection

Page 33

Ultra VNC Repeater Guide

4. Finally, when the viewer disconnects the log information will display the following:

Rev: 5

Figure 47: Linux Repeater Server-Viewer Connection Close

Page 34

Ultra VNC Repeater Guide Rev: 5

6.5

Example Repeater Log for a Mode I Connection

The following listing provides an example log for a connection from one pc to another via the repeater using Mode I: simon@linux:~/Modifiedrepeater009> ./repeater

UltraVnc Linux Repeater version 0.09

UltraVnc Sun Feb 12 22:06:46 2006

> startListeningOnPort(): socket() initialized

UltraVnc Sun Feb 12 22:06:46 2006

> startListeningOnPort(): setsockopt() success

UltraVnc Sun Feb 12 22:06:46 2006

> startListeningOnPort(): bind() succeeded to port 5900

UltraVnc Sun Feb 12 22:06:46 2006

> startListeningOnPort(): listen() succeeded

UltraVnc Sun Feb 12 22:06:46 2006

> startListeningOnPort(): socket() initialized

UltraVnc Sun Feb 12 22:06:46 2006

> startListeningOnPort(): setsockopt() success

UltraVnc Sun Feb 12 22:06:46 2006

> startListeningOnPort(): bind() succeeded to port 5500

UltraVnc Sun Feb 12 22:06:46 2006

> startListeningOnPort(): listen() succeeded

UltraVnc Sun Feb 12 22:06:46 2006

> routeConnections(): starting select() loop, terminate with ctrl+c

UltraVnc Sun Feb 12 22:06:50 2006

> routeConnections(): new viewer connecting, accepting...

UltraVnc Sun Feb 12 22:06:50 2006

> acceptConnection(): connection accepted ok from ip: 192.168.2.15

UltraVnc Sun Feb 12 22:06:50 2006

> acceptConnection(): pv = RFB 000.000

UltraVnc Sun Feb 12 22:06:50 2006

> checkIdCode(): 192.168.2.14:5900 is not IdCode string

UltraVnc Sun Feb 12 22:06:50 2006

> parseHostAndPort() start: id = 192.168.2.14:5900

UltraVnc Sun Feb 12 22:06:50 2006

> parseHostAndPort() end: host = 192.168.2.14, port = 5900

UltraVnc Sun Feb 12 22:06:50 2006

> open_connection(): connecting to 192.168.2.14:5900

UltraVnc Sun Feb 12 22:06:50 2006

> addViewerList(): Viewer added to list -1

UltraVnc Sun Feb 12 22:06:50 2006

> setViewerActive(): activated viewer at 0, code = -1

Page 35

Ultra VNC Repeater Guide

UltraVnc Sun Feb 12 22:06:50 2006

> addServerList(): Server added to list -1

UltraVnc Sun Feb 12 22:06:50 2006

> setServerActive(): activated server at 0, code = -1

UltraVnc Sun Feb 12 22:06:50 2006

> acceptConnection(): Mode 1: forking doRepeater(6, 5)

UltraVnc Sun Feb 12 22:06:50 2006

> addRepeaterProcList(): Added proc to index 0, pid=6433, code=-1

UltraVnc Sun Feb 12 22:06:50 2006

> updateServerViewerInfo(): servers[] has changed at index 0

UltraVnc Sun Feb 12 22:06:50 2006

> updateServerViewerInfo(): New server connection from : 192.168.2.14

UltraVnc Sun Feb 12 22:06:50 2006

> updateServerViewerInfo(): viewers[] has changed at index 0

UltraVnc Sun Feb 12 22:06:50 2006

> updateServerViewerInfo(): New viewer connection from : 192.168.2.15

UltraVnc Sun Feb 12 22:07:24 2006

> doRepeater(): connection closed by viewer

UltraVnc Sun Feb 12 22:07:25 2006

> cleanUpAfterRepeaterProcExit(): exitCode=3, pid=6433

UltraVnc Sun Feb 12 22:07:25 2006

> findRepeaterProcList(): proc found at 0, pid=6433, code = -1

UltraVnc Sun Feb 12 22:07:25 2006

> findServerList(): server found at 0, code = -1

UltraVnc Sun Feb 12 22:07:25 2006

> findViewerList(): viewer found at 0, code = -1

UltraVnc Sun Feb 12 22:07:25 2006

> removeRepeaterProcList(): Removing proc from index 0, pid=6433

UltraVnc Sun Feb 12 22:07:25 2006

> cleanUpAfterRepeaterProcExit(): code=-1, serverInd=0, viewerInd=0

UltraVnc Sun Feb 12 22:07:25 2006

> removeServerList(): Server Removed from list -1

UltraVnc Sun Feb 12 22:07:25 2006

> removeViewerList(): Viewer removed from list -1

UltraVnc Sun Feb 12 22:07:25 2006

> updateServerViewerInfo(): servers[] has changed at index 0

UltraVnc Sun Feb 12 22:07:25 2006

> updateServerViewerInfo(): viewers[] has changed at index 0

UltraVnc Sun Feb 12 22:07:36 2006

> main(): relaying done.

Rev: 5

Page 36