TestOptimal Installation

This document provides the instructions to install TestOptimal Server.


  • JDK 8 or later
  • OS: Windows (7 or later) or Mac.
  • Memory: at least 4GB
  • Disk Space (free): at least 2GB.

Installing TestOptimal Server/IDE

Choose one of the installation options below. After completing the installation, open TestOptimal IDE with a browser at: http://localhost:8888. The community license is pre-instaplled. You just need to accept License Agreement and set up the login account to access your server.

Windows Installation

  • unzip TestOptimal_'ver#'_win.zip to a folder on the local disk (e.g. c:/app/TestOptimal).

Mac / Linux Installation

  • unzip TestOptimal_'ver'_mac.zip to local disk (e.g. apps/TestOptimal.app).
  • Install GraphViz (you may perform this step later):
 ruby -e "$(curl -fsSL https://raw.githubusercontent .com/Homebrew/install/master/install)" < /dev/null 2> /dev/null
 brew install graphviz

Start TestOptimal Servver

On Windows:

 double click or run //startTestOptimalServer.bat// located in the root folder (//c:/app/TestOptimal//)

On Mac:

 sh [file_path/]startTestOptimalServer.sh

Browser Setup

TestOptimal utilizes Selenium/WebDriver to perform browser automation. The appropriate browser driver must be present/installed, if not already installed, the system will automatically download it and thus internet is required during the download.

Alternative, you may manually copy the required browser driver package into the expected location. Check SvrLog file for the location: e.g.

 2020-05-18 13:44:40 [INFO] loading chrome driver from C:\Users\myAccount\.m2\repository\webdriver\chromedriver\win32\80.0.3987.106\chromedriver.exe

If using Safari browser for testing AUT, on Terminal window, run once to enable Safari automation:

 safaridriver --enable

Eclipse and Other Java IDE Setup

You may interact with TestOptimal server to perform testing in Eclipse and other Java IDEs. Using JavaConnector, you can dynamically build a model and execute it on TestOptimal server to generate test cases.

First download JavaConnector by clicking HERE and unzip it to your local directory:

  • README.md
  • TestOptimal-JavaConnector-1.0.1.jar
  • TestOptimal-JavaConnector-1.0.1-jar-with-dependencies.jar

Add one of the jar files to your java project class path, in Eclipse:

  1. right mouse click on project name and select “Properties”
  2. on “Properties for [your project]” dialog, select “Java Build Path” on the left pane
  3. select “Libraries” tab on the right pane
  4. click “Add External JARs …”
  5. locate to downloaded jar file and select it
  6. click “Apply and Close” button

License Setup

If you were given a license key, you can enter the license key information at: Manage License.


Refer to Server Configuration to customize your installation.

QR Code
QR Code installdoc (generated for current page)