AppsWatch Installation Guide

Before the Installation

The AppsWatch Suite consists of three components – AppsWatch Base, ScenarioStation, and ScenarioBuilder.  Together, they comprise Automai’s performance monitoring solution for your environment.

     1. AppsWatch Base – Install on a Windows PC or Windows Server. Installation creates the Base, the virtual console which opens in a browser and from which performance testing monitors are configured and managed.

     2. ScenarioStation – Install on a Windows PC or Windows Server. The station simulating real-user interactions against the application under test with a specified frequency. The robot that executes and runs tests configured in the Base.

     3. ScenarioBuilder – Install on a Windows PC or Windows Server. The test scripting tool that understands and interacts with any application accessible from a graphical user interface.

You have options when installing AppsWatch. It is a flexible solution that can be installed in a number of ways. Please review the following before proceeding with your installation:

  • Method 1:  Install the three components on one machine.  If you select this method, make a note to install ScenarioStation in “Dedicated” mode to ensure that the station locks/unlocks when scenarios play/finish playing.
  • Method 2:  Install AppsWatch and ScenarioBuilder on one machine and ScenarioStation on another. If you select this method, the two machines must have identical specs (OS, default browser, color depth, etc.). Ideally, this method is used on machines that are clones of each other.
  • Method 3:  Install AppsWatch on one machine and ScenarioBuilder and ScenarioStation on another.  This method is the preferred multi-machine configuration as it ensures that Scenarios are created on the desktop from which they will be played back.

Note: Generally, it is preferable to install ScenarioStation on a PC rather than a server.

Note: AppsWatch components can be installed on either Physical or Virtual machine(s).

Tip: For your first test, we recommend you to install the three AppsWatch components on a Microsoft Windows PC.

Install AppsWatch Suite

Start by downloading the AppsWatch installation package from the Downloads page on the Automai website. And save the AppsWatch, ScenarioStation and ScenarioBuilder to your Windows PC or Windows Server.

Prerequisite Software

Specific software needs to be installed before you can install AppsWatch. When you run the installation wizards (“AWSetup.exe”, “SStationSetup.exe”, “SBSetup.exe”), if the prerequisite software is not already installed on your computer, the wizard detects which software is missing. If you continue with the installation, all missing prerequisites will be installed.

The following prerequisite software need to be installed:

  • .NET Framework 4.5
  • Microsoft Visual C++ 2015 Redistributable (x86)

Install AppsWatch Base

 1. Run the AWSetup.exe file.

AppsWatch Installation Guide (221326088)_Screenshot_105

 2. Click “Next” to advance to the “End User License Agreement” (EULA).

AppsWatch Installation Guide (221326088)_Screenshot_106

Review the terms of the EULA and click “I accept the agreement” and click “Next” to continue.

     3. Select the destination folder for the AppsWatch Base program installation. Click “Next” to accept the default location or “Browse” to an alternate location, then click “Next.” 

AppsWatch Installation Guide (221326088)_Screenshot_107

4. Enter the web server configuration and click “Next”. (Choose the default unless it is used by other applications. “Web Server Port : 8888)

AppsWatch Installation Guide (221326088)_Screenshot_108

AppsWatch Installation Guide (221326088)_Screenshot_109

5. Review settings and click on “Install” to initiate the installation process.

AppsWatch Installation Guide (221326088)_Screenshot_110

AppsWatch Installation Guide (221326088)_Screenshot_111

 6. Click “Finish” to complete the AppsWatch Base installation.

AppsWatch Installation Guide (221326088)_Screenshot_112

Install ScenarioStation

     1. Run the SStationSetup.exe file.

AppsWatch Installation Guide (221326088)_Screenshot_113

   2. Click “Next” to advance to the “End User License Agreement” (EULA).

AppsWatch Installation Guide (221326088)_Screenshot_114

Review the terms of the EULA and click “I accept the agreement” and click “Next” to continue.

     3. Select the destination folder for the ScenarioStation program installation. Click “Next” to accept the default location or “Browse” to an alternate location, then click “Next.”

AppsWatch Installation Guide (221326088)_Screenshot_115

 4. Enter the hostname of the Server where the AppsWatch Base is located.

Enter the “AppsWatch Web Server Port” address – use the same port that was assigned to the AppsWatch “Web Server Port” in the AppsWatch installation. (Choose the default one: “Web Server Port: 8888”), then click “Next”.

AppsWatch Installation Guide (221326088)_Screenshot_116

 5. The ScenarioStation setting will be configured automatically, Click “Next.”

AppsWatch Installation Guide (221326088)_Screenshot_117

Note: ScenarioStations can only be added to an AppsWatch Base during installation.

AppsWatch Installation Guide (221326088)_Screenshot_118

6. Review settings and click “Install” to initiate the installation process.

AppsWatch Installation Guide (221326088)_Screenshot_119

AppsWatch Installation Guide (221326088)_Screenshot_120

 7. Click “Finish” to complete the ScenarioStation installation.

AppsWatch Installation Guide (221326088)_Screenshot_121

Note: Once installed, the ScenarioStation will start automatically. But if it does not start, you can start it from the ScenarioStation’s folder in program menu or by using the desktop shortcuts.

AppsWatch Installation Guide (221326088)_ss10

AppsWatch Installation Guide (221326088)_ss11

Tip: In order to add a new Station, click the “Add New Station” button from the ScenarioStation’s folder in program menu and then follow the instructions to add a new Station.

AppsWatch Installation Guide (221326088)_ss12

Install ScenarioBuilder

     1. Run the SBSetup.exe file.

AppsWatch Installation Guide (221326088)_Screenshot_96

 2. Click “Next” to advance to the “End User License Agreement” (EULA).

AppsWatch Installation Guide (221326088)_Screenshot_97

Review the terms of the EULA and click “I accept the agreement” and click “Next” to continue.

     3. Enter the IP address of the server hosting the Controller (if using with AppLoader) or Base (if using with AppsWatch) in the “Host Name” field.

Enter the “Port Number” address – use the same port that was assigned for “Web Server Port” in the Controller/Base installation. (Choose the default one: “Port Number : 8888” ), then click “Next”.

AppsWatch Installation Guide (221326088)_Screenshot_98

     4. Select the destination folder for the ScenarioBuilder program installation. Click “Next” to accept the default location or “Browse” to an alternate location, then click “Next.”

AppsWatch Installation Guide (221326088)_Screenshot_99

AppsWatch Installation Guide (221326088)_Screenshot_100

Note: If upgrading from an older version or reinstalling the current version of ScenarioBuilder, the windows for steps 3,4 will not appear – prior settings will be used.

     5. Review settings and click “Install” to initiate the installation process.

AppsWatch Installation Guide (221326088)_Screenshot_101

AppsWatch Installation Guide (221326088)_Screenshot_102

   6. Click “Finish” to complete the ScenarioBuilder installation.

AppsWatch Installation Guide (221326088)_Screenshot_103

     7. After finishing the installation, ScenarioBuilder will launch.

AppsWatch Installation Guide (221326088)_Screenshot_104