TestOptimal Wiki

Model-Based Testing (MBT)

User Tools

Site Tools


TestOptimal Installation

This document provides the instructions to install TestOptimal IDE (screenshot).


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

Installing TestOptimal Server/IDE

Choose one of the installation options below:

Windows Installation

  • unzip TestOptimal_*_win.zip to a folder on the local disk (e.g. c:/TestOptimal).
  • double click (run) setup.bat located in the root folder (c:/TestOptimal), which automatically:

Next time when you log in to your computer, TestOptimal IDE should automatically opens.

Mac Installation

  • unzip TestOptimal_*_mac.zip to local disk (e.g. apps/TestOptimal.app).
  • TestOptimal uses GraphViz to generate some of the graphs. Downloaded and install GraphViz from http://www.graphviz.org/Download_macos.php (you may perform this step later):
    • click on graphviz-2.28.0.pkg link next to the OS version that matches your OS version
    • follow the instruction from GraphViz to complete the installation.
    • run command dot -version in a command window to verify GraphViz version 2.28 has been installed.
  • double click TestOptimal.app to start TestOptimal IDE.
  • If using Safari browser for testing AUT, you will need to install WebDriver Safari Extension:
    • open Safari browser and click on here
    • run the downloaded file named SafariDriver.safariextz you have just downloaded

JavaIDE Installation

You may also install TestOptimal in your Java IDE to be integrated with JUnit. Choose one of the options below:

Cloud Setup

You may install TestOptimal in a cloud environment hosting Windows or Linux.

  • Download and unzip TestOptimal software to a local harddrive
  • For Windows create a scheduled task and configure it like these to auto run startTestOptimalServer.bat (click on each link to the right for screenshots): Main, Trigger, Action, Settings
  • For Linux set up a crontab to run startTestOptimalServer.sh to auto start TestOptimal server.

Additional Information

If you encounter any error while entering license key, please refer to License error codes for the explanation of the errors related to license key validation.


If required, you may perform the following customization:

Internet Proxy Server

Some organizations use internet proxy server to secure the access to the internet. In this situation, you must configure TestOptimal server to recognize the proxy server. More details at Proxy Server Setup.

Browser Setup

TestOptimal IDE utilizes multiple windows. To best result, you must set your browser's setting/option to enable pop-up to open in a new window:

If you have problem opening and automating the web app, please check the browser settings:

  • Disable Popup Blocker.
  • Enable javascript.
  • For IE browser (from Selenium Internet Explorer Driver):
    • On IE 7 or higher on Windows Vista or Windows 7, you must set the Protected Mode settings for each zone to be the same value. The value can be on or off, as long as it is the same for every zone. To set the Protected Mode settings, choose “Internet Options…” from the Tools menu, and click on the Security tab. For each zone, there will be a check box at the bottom of the tab labeled “Enable Protected Mode”.
    • Additionally, “Enhanced Protected Mode” must be disabled for IE 10 and higher. This option is found in the Advanced tab of the Internet Options dialog (under Security section).
    • The browser zoom level must be set to 100% so that the native mouse events can be set to the correct coordinates.
    • For IE 11 only, you will need to set a registry entry on the target computer so that the driver can maintain a connection to the instance of Internet Explorer it creates. For 32-bit Windows installations, the key you must examine in the registry editor is HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Internet Explorer\Main\FeatureControl\FEATURE_BFCACHE. For 64-bit Windows installations, the key is HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Internet Explorer\Main\FeatureControl\FEATURE_BFCACHE. Please note that the FEATURE_BFCACHE subkey may or may not be present, and should be created if it is not present. Important: Inside this key, create a DWORD value named iexplore.exe with the value of 0.
    • By default, 32 bit version of IE will be launched to run AUT. You may change it to lanuch 64 bit version IE by setting IE.Driver below(in file www/MbtSvr/config/webdriver.properties):
      • driver.IE=IEDriverServer_64BIT.exe
  • Be aware that some browser add-on may interfere with IDE, for example Google Toolbar on Internet Explorer (IE). If you experience strange behavior with IDE, try disable or remove the add-on.

Additionally, it is highly recommended that you disable auto-update feature of your browser due to the fact that newest browser versions may break the automation. You can easily find on the internet on how to disable/enable auto-update feature.

overview/installdoc.txt · Last modified: 2019/09/29 17:37 by admin