QAS - Environment setup

QMetry Automation Studio is not based on SAAS, hence, user have to install it on his machine (Click here to download the latest QAS). However, to experience the smooth automation testing with QAS, users need to configure the prerequisites and should have a working environment ready before installing QAS. Below are the prerequisites and machine-level settings user needs to set up for QAS.

Prerequisites

  • Must have supported OS platform I.E Mac and Windows (Win 7 and above).
  • Java version 8 (64 bit) or above, should be installed on the machine.
  • Apache Maven should be installed on the machine.
  • The high-end hardware configuration for smooth work.
  • QAS is not supported on VM.

Setting up a machine level environment for QAS:

  • Install Java on your machine. Click here to download the Java SE.
  • Configure JAVA_HOME environment variable to point to the base directory location where Java is installed on your machine. (User machine's Java_Home should point to JAVA 8 installation path - in case if user have multiple Java versions installed)
Operating SystemJava path
WindowsSet the environment variable JAVA_HOME to C:\Program Files\Java\jdk1.8.x.x
Macexport JAVA_HOME=/Library/Java/Home
  • Append Java compiler location to System Path.
Operating SystemOutput
WindowsAppend the string “;C:\Program Files\Java\jdk1.8.x.x\bin” to the end of the system variable, Path.
MacNot required
  • Verify Java installation on the machine, open Console/Terminal and run the following java command.
Operating SystemCommandConsole/Terminal Output
Windowsjava -versionjava version "1.8.x.x"
Java(TM) SE Runtime Environment (build 1.8.0_171-b11)
Java HotSpot(TM) 64-Bit Server VM (build 25.171-b11, mixed mode)
Macmachine:~ joseph$ java -versionjava version "1.8.x.x"
Java(TM) SE Runtime Environment (build 1.8.0_171-b11)
Java HotSpot(TM) 64-Bit Server VM (build 25.171-b11, mixed mode)
  • Install Apache Maven. Click here to download Apache Maven on your machine.
  • Extract the archive, to the directory you wish to install Maven 3.x.x. The subdirectory apache-maven-3.x.x will be created from the archive.
Operating SystemLocation (can be different based on your installation)
WindowsC:\Program Files\Apache Software Foundation\apache-maven-3.x.x
Mac/usr/local/apache-maven
  • Setup Maven environment variable, Add M2_HOME, M2, MAVEN_OPTS to environment variables of your machine.
Operating SystemVariable path
Windows

Set the environment variables using system properties.

M2_HOME=C:\ProgramFiles\ApacheSoftwareFoundation\apache-maven-3.x.x

M2=%M2_HOME%\bin MAVEN_OPTS=-Xms256m -Xmx512m

Path = %M2_HOME%\bin

Mac

Open command terminal and set environment variables.

export M2_HOME=/usr/local/apache-maven/apache-maven-3.x.x

export M2=$M2_HOME/bin

export MAVEN_OPTS=-Xms256m -Xmx512m

  • Verify Maven installation on the machine, open Console/Terminal and run the following command.
Operating SystemCommandConsole/Terminal Output
Windowsmvn --versionApache Maven 3.5.4 (1edded0938998edf8bf061f1ceb3cfdeccf443fe; 2018-06-18T00:03:14+05:30)
Maven home: c:\Program Files\maven\bin\..
Java version: 1.8.x.x, vendor: Oracle Corporation, runtime: C:\Program Files\Java\jdk1.8.x.x\jre
Default locale: en_US, platform encoding: Cp1252
OS name: "windows 10", version: "10.0", arch: "amd64", family: "windows"
Macmachine:~ joseph$ mvn --version

Apache Maven 3.5.4 (1edded0938998edf8bf061f1ceb3cfdeccf443fe; 2018-06-18T00:03:14+05:30)

Java version: 1.8.x.x

Java home: C:\Program Files\Java\jdk1.8.x.x \jre


Once, you are done with installation/configuration all the above mentioned prerequisites and environment variables, you can install/run the QAS. If you will face any issues with the QAS on your machine then refer to this help document for troubleshooting of QAS.