Redstone Software, Inc.
http://www.redstonesoftware.com

                        Readme for OS9vnc Server v3.5.0
                                           01/26/2004

Send questions or comments to os9vnc@redstonesoftware.com.

Place the OS9vnc Server application anywhere on your hard drive. 
The Applications folder is the recommended location.

Place the OS9vncPatches extension in your System Folder:Extensions folder; 
enable it using the Extensions Manager control panel; and restart your machine.

Double click the OS9vnc application to start it. You can accept the default 
configuration options when you are presented with the Settings panel.

The OS9vnc Server panel (upper left) will show you the IP Address of your
machine and the port number that the server is listening on.

If you did not change any of the configuration settings, you can now use 
Eggplant or any VNC viewer (client) on another networked machine to 
connect to the OS9vnc Server on port 5900. No password is required unless
you set one in the Settings panel.

Notes:

OS9vnc Server is based on ChromiVNC Server from Jonathan Morton. Our
thanks to him for his assistance as well as for the source code.

The OS9vncPatches extension is a renamed version of the vncPatches68k_adaptive extension from Adrian Umpleby.

Known Issues:

There is a delay following any mouse click. This delay is a factor of the user-configurable double-click speed; to minimize the delay, open the Mouse Control Panel and set the Double-Click speed to the fastest setting. This delay is necessary to allow the OS9vnc server to determine whether it is receiving a single click or just the first click of a double-click. 

Clipboard synching in this server works only in the client-to-server direction. Data copied to the clipboard of the server machine is not available to the client machine (the machine running Eggplant or a standalone VNC viewer).

There appears to be a conflict between the OS9vncPatches extension and Internet Explorer. The result of this conflict is that if Internet Explorer is running when the machine goes to sleep, the system may lockup and require a hard reboot. If you need to use Internet Explorer and OS9vnc, changing the settings in the Energy Saver control panel so that the OS 9 machine never goes to sleep may prevent this problem. 

Issues for Eggplant Users:

In general, you should be able to create and run Eggplant scripts against this server without needing to modify Eggplant's default Run Options settings, with one exception described in the following paragraph.

If you are using Eggplant 1.41 or 1.42, you should open Eggplant > Preferences > Run Options > Keyboard and increase the Key-Down Delay setting from 0.001 to 0.01. If this is not done, these versions of Eggplant will likely send keystrokes to the OS9vnc server too quickly, causing dropped characters and other inconsistencies. If you are running against a very slow Mac OS 9 machine, you may need to further increase this setting, dependent on your success with the TypeText command. This should not be a problem in Eggplant's Live Mode or with standalone VNC viewers; it is unlikely that manual typing would be fast enough to cause a problem. 

This software has been tested on an iMac with a 400Mhz PowerPC G3 processor; if you run a slower Mac OS 9 and you experience inconsistent results when running scripts, you may need to fine-tune Eggplant's Run Options. If you require assistance with this, please contact support@redstonesoftware.com with details of the problems you are experiencing.

About Eggplant:

Eggplant is Redstone Software, Inc.'s automation and testing product. Eggplant runs under Mac OS X 10.1 or higher and leverages VNC to allow you to automate processes and test applications on virtually any other platform or operating system. Eggplant sees what the user sees and interacts with user interface elements (including the command line) using the same clicks, drags, keystrokes, and other actions that a user would use. This allows you to test and automate without regard to the underlying implementation details such as development environment, programming language, or operating system.

For more information on Eggplant:
http://www.redstonesoftware.com
info@redstonesoftware.com
(800) 891-3486 x15