===== TestOptimal Installation =====

This document provides the instructions to install & start //TestOptimal Server//.

====Prerequisite====
  * //JDK 17// or later
  * OS: //Windows, Mac, Linux//. 
  * Memory: at least 4GB
  * Disk Space (free): at least 2GB.
  * Modern browser (Firefox, Chrome, Edge, Safari)

----
==== Installing TestOptimal Server/IDE ====
Choose one of the installation options below. After completing the installation, open [[../ide_overview|TestOptimal IDE]] with a browser at: [[http://localhost:8888/ | 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.

Check out this [[https://www.youtube.com/watch?v=XVtxmMyL3g4 | video: Download & Install]].

===Windows Installation===
  * run (double-click) downloaded file //TestOptimal_Setup.exe// and follow the instruction
  * alternatively if you've downloaded the zip file instead, just unzip the zip file and run (double-click) startTestOptimalServer.bat

===Mac / Linux Installation===
  * unzip //TestOptimal_'ver'_mac.zip// to local disk (e.g. //apps/TestOptimal.app//).
  * Install [[https://graphviz.gitlab.io/download/ | 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 server by running //startTestOptimalServer.sh//

===Docker===
   * run following docker command to start TestOptimal server:

      docker run -p 8888:8888 testoptimal/mbt:7.0.3
----


==== Browser Setup ====
//TestOptimal// utilizes //Selenium/WebDriver// to perform browser automation.  The system will automatically download the appropriate driver when it's needed and thus internet is required.  

Alternatively, you may copy the required browser driver into the expected location ahead of time to remove this dependency. 
Check {{http://localhost:8888/api/v1/file/log/tosvr| SvrLog file}} for the location of the driver files: 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 you are performing AUT testing on Safari browser, you will need to enable automation on Safari browser by running the following command once:

   safaridriver --enable

----



==== Customization ====
Refer to [[Configuration | Server Configuration ]] to customize your installation.