You are here: Chapter 1: Getting Started > Setting up the Environment

Setting up the Environment

By now you should have decided for one of the supported configurations and you should have identified your SUT and client system. Let's set up the test environment on your computer(s) now. If you are going to use the tool for static image testing, you only have to perform the steps described in the Client System Installation paragraph.

SUT Installation

  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 serverand 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.

Client System Installation

  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 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.

  3. For Mac OS there is a .dmg package to allow a copy into the applications directory.

    For other environments (Linux etc.) 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.

  4. 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 behaviour, review the Troubleshooting chapter of Release Notes for most common errors.

  5. 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.

 

12 December 2014

Copyright © T-Plan Ltd.

Version 1.0