AppVerify Installation Guide

The AppVerify suite consists of three components – The Manager, rTester, and ScenarioBuilder. Together, they comprise Automai’s Robotic Functional Testing solution.

Install the AppVerify components in the following manner:

  1. The Manager – Install on a Windows PC or Windows Server. A web based application from which Test plans are built, managed and executed. It also generates summarized and detailed test results and reports.
  2. Robot Tester (rTester) – Install on a Windows PC or Windows Server. The robot that executes the Test plans defined in the Manager.

       Note: Make sure that the Manager is already installed before installing the rTester.

  1. ScenarioBuilder – Install on a Windows PC or Windows Server. The tool for recording and maintaining automation scripts.

*AppVerify components can be installed on either physical or virtual machines.

Install AppVerify Suite

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

Prerequisite Softwares

Specific software needs to be installed before you can install AppVerify. When you run the installation wizards (“AVSetup.exe”, “rTesterSetup.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.

Install the Manager

1. Run the AVSetup.exe file.

av_2019_install_1

 

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

av_2019_install_2

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

3. Click “Install” to accept the default settings and initiate the installation process.

Use "Customize Installation" option if you want to modify the destination folder and Web Server port configuration for the AppVerify installation.

av_2019_install_3

 

av_2019_install_4

 

4. Click “Finish” to complete the AppVerify installation.

av_2019_install_5

 

Install rTester

The rTester installer is split into two main modules, each being dedicated to a particular task in robotic functional testing. The rTester modules are:

  • Robot Tester (rTester): The robot that executes the Test plans configured in AppVerify. 
  • Sessions Controller: Automai Sessions Controller is a service for robots (ScenarioStation, rTester) to maintain sessions active in order for the scenario images to be buffered and to prevent any connection errors during scenario playback. It can start automatically and run in background while executing processes (scenarios/scripts) without human supervision. For more information, see this article.

1. Run the rTesterSetup.exe file.

r_tester_2019_install

 

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

r_tester_2019_install_2

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

3. Enter the hostname of the machine where the AppVerify is located.

Enter the “Port Number” address – use the same port that was assigned for “Web Server Port” in the AppVerify installation. (Choose the default one: “Port Number: 8888” ).

Next, enter a correct user credential (username [domain if needed] and password used to login to the Windows machine where Sessions Controller and robot are being installed), so the Automai Sessions Controller service can start and run. Please refer to this article to learn more about Sessions Controller.

r_tester_2019_install_3

 

Click “Install” to accept the default settings and initiate the installation process.

r_tester_2019_install_4

 

4. Click “Finish” to complete the rTester and Sessions Controller installation.

r_tester_2019_install_5

Installation Tips:

1. The installation can also be customized, to better suit your needs. Choose "Customize Installation" option if you would like to use non-default settings.

Select the modules that you want to install on this page and click "Next".

r_tester_2019_install_1_1

Please note that, by default, Sessions Controller and robots are installed at the following location "C:\Program Files (x86)\Automai\..." folder. You can change it by using "Customize Installation" option.

r_tester_2019_install_1_2

 

2. Use the "Add new rTester" option and follow the instructions to add a new rTester for a user dedicated to it. This only applies if you install rTester in a Windows Server.

r_tester_2019_install_1_3

 

r_tester_2019_install_1_4

You can install as many rTesters as you need within different user accounts in the server.

Note: By default, Sessions Controller creates a user session using default RDP settings with Automai Sessions Controller service running for each user once rTester is installed. You may change the settings by launching the Sessions Controller app and going to "Manage sessions" section. To learn more, see this article.

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

r_tester_2019_install_1_6      r_tester_2019_install_1_7

 

Install ScenarioBuilder

1. Run the SBSetup.exe file.

Screenshot_104

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

Screenshot_105

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

3. Enter the IP address of the machine hosting the Controller / Manager / Base in the “Host IP” field.

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

Screenshot_112

 

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

Screenshot_113
Screenshot_114

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

Screenshot_117

Screenshot_115-1

 

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

Screenshot_116

 

7. After finishing the installation, ScenarioBuilder will launch.

Screenshot_118