Pactera MARS User manual

© Pactera. All Rights Reserved.
1
MARS Installation Guide
V3.2.1
Pactera Technology International Ltd.

© Pactera. All Rights Reserved.
2
Contents
1. Welcome.................................................................................................................................................. 4
1.1. About the document ................................................................................................................. 4
1.2. Revision History .......................................................................................................................... 4
2. Required Environment ........................................................................................................................ 5
2.1. Workstation & Agent`s Hardware Requirement(Recomonded).................................... 5
2.2. Controller`s Hardware Requirement(Recomonded) ......................................................... 5
2.3. Software Requirement............................................................................................................... 5
2.3 MARS Components ........................................................................................................................ 5
3. Install MySQL.......................................................................................................................................... 7
4. Install MARS Controller.....................................................................................................................22
5. Install MARS Workstation................................................................................................................27
6. Install MARS Agent ............................................................................................................................32
7. Install MARS Mobile...........................................................................................................................37
8. Install MARS Plugins..........................................................................................................................43
9. FAQs(Frequently Asked Questions)..............................................................................................45
9.1 Do I need to debug MARS scripts?.......................................................................................... 45
9.2 What’s test scenario in MARS?................................................................................................. 45
9.3 When create DB in MARS, there is “SQL Error”, why?......................................................... 45
9.4 Why not able to create test projects logged in MARS as administrator? ..................... 45
9.5 License unmatched message displayed ,even the license file is copied to MARS
Controller. .............................................................................................................................................. 45
9.6 When start MARS Controller, “Access denied” message displays, how to resolve it?45
9.7 How to avoid test execution Hot Keys conflict ?.................................................................. 46

© Pactera. All Rights Reserved.
3
9.8 In some cases, IE engine can not find component or element of SUT screens, and
also sometimes weirds during test execution, how to avoid ? ............................................... 46
9.9 Sometimes user not able to install MARS properly due to user authorization
restrictions, how to set MARS installation folder previllege properly?................................. 52
9.10 How to get IE11 run properly with MARS?.......................................................................... 55
9.11 How to avoid the screen unmatch caused by cursor blink for screen shots MARS
captured during test execution?...................................................................................................... 56
9.12 Sometimes there are MARS runtime issues, how to avoid these issues? ............ 58
9.13 How to avoid IE browser automatic check messages disturbing MARS test
execution ?............................................................................................................................................. 64
9.14 How to disable IE browser’s scripts and AxtiveX running tips? ............................... 67
9.15 How to solve the website security certificate error?................................................... 70
9.16 How to get MARS Workstation displayed completely?............................................. 77

© Pactera. All Rights Reserved.
4
1. Welcome
Welcome to use MARS –the Pactera automated function testing
tool. The purpose of this document is to guide the user to install
the MARS package properly and get MARS ready for utilization.
1.1. About the document
This document describes how to install and configure MARS package correctly.
1.2. Revision History
Date
Content
2014-8-8
Created
2015-1-28
Add the installation instruction of MARS Agent
2015-3-13
Add the installation instruction of MARS Winform
2016-3-7
Batch updates
2016-6-20
Update to Ver 2.7.0
2017-4-24
Ver 3.0.3 based update, Mobile Testing Installation
Added
2017-5-15
FAQ 9.13, 9.14 Added
2017-6-9
FAQ 9.15 Added
2017-6-15
Update to MARS Mobile
2017-6-29
FAQ 9.16 Added
2017-12-15
update 2.3 browser requirement、2.4 MARS form a
schematic、MARS Mobile installation instructions

© Pactera. All Rights Reserved.
5
2. Required Environment
2.1. Workstation & Agent`s Hardware Requirement
Disk Storage : 80G or above
CPU : Intel i3-2120 or above
RAM : 4G or above
2.2. Controller`s Hardware Requirement
Disk Storage : 80G or above
CPU : Intel i5-3470 or above
RAM : 8G or above
2.3. Software Requirement
Operating system : Windows XP,Windows 7,Windows 8,Windows 8.1,Windows 10
Please install the browser supported by MARS.
Fixfox：55、56、57
Sarfari: MACOS 10.12、10.13
Chrome: 33~37、44、48、54~62
Edge: 14393、15063、16299
Database : MySQL 5.0
.Net Framework Version : 4.0
Please enable the network ports for the MARS components, and not used by other
application:
MySQL DB: 3306
MARS Controller: 9003
MARS Workstation: 9006
MARS Agent for Windows: 9007
2.4 MARS Components
MARS has five components, MySQL, Controller, Workstaion, Agent, and Mobile.
Ususally, MySQL is installed with MARS Controller on the same computer, the
MARS Controller, Agent, and Mobile are installed on different computers.

© Pactera. All Rights Reserved.
6
MARS Agent can be installed with MARS Workstaton on the same computer to
debug the test cases edited within Workstation. After test cases edition, test
scenarios can be set to run in independent computers with MARS Agent installed
only.
If there are mobile testing, please install MARS Mobile with MARS Agent on the
same computer.
Of course, all the above MARS components can be installed on the same computer.
Following is an image of MARS components:

© Pactera. All Rights Reserved.
7
3. Install MySQL
※The MySQL installation package can be downloaded from MARS website ,
(http://mars.pactera.com/MySQLSetup.exe). Please make sure that MySQL folder
NOT exsited in the installation destination drive or folder before the installation.
Install MySQL Data Base
✓Double-click “MySQLSetup.exe” to start the installation.

© Pactera. All Rights Reserved.
8
✓Choose the Custom installation and click the Next button to start the custom
installation.
✓A tree view on the left side of the custom installation dialog lists all available
components. Click the left mouse button on the Developer Components,and choose
This feature, and all subfeatures, will be installed on local hard drive. to install this
feature on local hard drive. And do the same on MySQL Server,Client
Programs,Documentation to ensure that all the files to be installed into local drive.

© Pactera. All Rights Reserved.
9
✓Change the default installation destination folder by clicking the Change... button on
the right of the displayed installation destination. Choose your installation folder,
Click OK button to back to the custom installation.

© Pactera. All Rights Reserved.
10
✓After choosing your installation components and destination, click the Next button
to advance to the confirmation dialog.
✓In the confirmation dialog, your installation type and installation destination Folder
are displayed for your confirmation. Click the Intall button to continue.

© Pactera. All Rights Reserved.
11
✓Once you click the Install button , the MySQL Installation Wizard begins the
installation, please wait while the setup wizard is installing.
✓When installation completes, choose the Skip Sign-Up option,and click the Next
button to continue.

© Pactera. All Rights Reserved.
12
✓When completed the installation, you can choose to use the MySQL Server Instance
Config Wizard by checking the box next to the Configure the MySQL Server now
option in the Wizard Completed dialog. Click the Finish button to finish the
installation and start the MySQL Server Instance Configuration Wizard.
✓Start the MySQL Server Instance Configuration Wizard .Click the Next button to
advance to the Configuration Type dialog.

© Pactera. All Rights Reserved.
13
✓Choose Detailed Configuration, and click the Next button.

© Pactera. All Rights Reserved.
14
✓Choose Developer Machine option ,and click the Next button to advance to the
Database Usage dialog.
✓Choose Multifunctional Database option ,and click the Next button.

© Pactera. All Rights Reserved.
15
✓Use the default InnoDB Tablespace configuration,and click the Next button to
advance the Concurrent Connections dialog.
✓Choose Manual Setting, input connections number and click the Next button.

© Pactera. All Rights Reserved.
16
✓TCP/IP networking is enabled by default, check the box next to the Enable TCP/IP
Networking option. Port 3306 is used by default. Check the box next to the Enable
Strict Mode option. Click the Next button to advance the Character Set dialog.
✓Choose the Manual Selected Default Character Set/Collation,and choose the utf8
option from the Character Set drop-down list. Click the Next button to advance to
the Service Options dialog.

© Pactera. All Rights Reserved.
17
✓Check the box next to Install As Windows Service, using the service name MySQL as
default. Also check the box next to Include Bin Directory in Windows PATH. Click
the Next button to advance to the Security Options dialog.

© Pactera. All Rights Reserved.
18
✓Set a root password for your MySQL server. Check the box next to the Modify
Security Settings option. Enter the desired password into both the New root
password and Confirm boxes and make sure you can keep it safe and remembered.
Check the box next to the Enable root access from remote machines option.
Uncheck the box next to the Create An Anonymous Account option. Click the Next
button to advance to the Confirmation dialog.

© Pactera. All Rights Reserved.
19
✓To start the configuration process, click the Execute button.
✓Click the Finish button to finish the MySQL Server Configuration Wizard.

© Pactera. All Rights Reserved.
20
Further configuration settings
✓Edit the MySQL configuration file from MySQL installation destination folder: my.ini,
set max_allowed_packet=20M,
wait_timeout=30,
interactive_timeout=30 and
max_connect_errors=1000 after [MySQLd].
Save your changes and restart MySQL service.
✓Edit the MySQL configuration file from MySQL installation destination folder: my.in
Since the number of authorized users will vary, change the setting
max_connections=100, replace value 100 with the number calculated from
authorized number of users. For example, e.g: if the authourized users are 40, the
max connections can be 40 x 20 = 800, so we can set: max_connections = 800
✓Update the MySQL configuration files: my.ini and my-small.ini.