Setting up the environment

1. Install a VNC server on the SUT. See the VNC chapter of the Release Notes for a list of tested products and platform specific instructions. We recommend UltraVNC for a Windows SUT and TightVNC or RealVNC for other systems.
   
2. Start the VNC server and optionally use a VNC viewer (usually bundled with the server) to make sure it is accessible. On MS Windows open the server configuration panel (usually located in the system tray) and select the 'Poll full screen' option; it resolves often experienced refresh problems. On Unix/Linux one typically starts the server through the vncserver command from the command line.
   

1. Make sure that Java 1.6 or higher is installed on your machine and its binaries are on the system path. To test it open a command prompt (Windows) or a terminal (Unix/Linux) and run "java -version". If the system reports an unknown command or the version reported is lower than 1.6, install or upgrade your Java. For more instructions and troubleshooting refer to the Release Notes document.
   
   Though there are more Java producers, we recommend you to download Java from Oracle Inc. (formerly distributed by Sun Microsystems). There are two distributions, Java Runtime Environment (JRE) and Java Development Kit (JDK). JDK is basically a JRE with development libraries and tools (such as compiler). T-Plan Robot Enterprise will run with either one. If you however plan on writing Java test scripts, you have to install JDK. The tool will otherwise refuse to compile and execute Java source code. Be aware that on most systems installation of JDK doesn't make it the default interpret of Java programs and additional configuration steps are required, such as putting the JDK's bin/ folder onto the system path. Refer to the first chapter of Release Notes for instructions.
   
   
2. Download T-Plan Robot Enterprise version 2 and install it. If your hosting system is MS Windows, you may use the package with Windows Installer (Enterprise version only). It manages the installation through the Windows framework, creates an item in the Start menu and registers T-Plan Robot Enterprise as default application for test scripts with the .tpr file extension.

The tool is also distributed as a platform independent ZIP package. There's no installer and one just unzips it to a folder on the hard drive. This is the only option on non-Windows systems.


3. Start the tool either from the Windows Start menu (Programs->T-Plan->Robot) or using a command specified in the Startup chapter of Release Notes. It will ask you to provide path to the license key file which you should have received together with the product (Enterprise version only). Then restart the tool. If the installation and configuration has completed successfully, the Login Dialog will display. Should you experience any failures or unexpected behavior, review the Troubleshooting chapter of Release Notes for most common errors.
   
   
4. Connect Robot to your VNC server. If your SUT is Windows, the address is typically <server>:5900. On Unix/Linux the default port is occupied by the default system desktop and VNC servers take up the first free higher port (<server>:5901). On a successful login the tool should display the server desktop.