BqGenie (Client) Installation

Owned by
Shivangi Sah
Last updated: Dec 09, 2022
6 min read


Pre-requisite :

There are certain pre-requisites to ensure Bq Genie runs correctly on your local machine.

  1. JRE 8 with latest update should be installed and setup. It can be downloaded from the following location https://www.oracle.com/java/technologies/downloads/#java8
    Once the JRE installation is complete, launch the terminal/cmd and type the below command to view the version : java -version
    If you receive the error “Java not found“ while checking the java version, please set JAVA_HOME in system environment

  2. Minimum one browser should be installed in PC
    Note : Currently supported browsers are Chrome, Firefox, IE, Edge and Safari for web execution 

Mobile Automation

(Follow these steps only if you intend to test your mobile apps and have a license for Mobile Automation)

For testing Mobile apps, the following are required :

Mac

Windows

Mac

Windows

Brew
( The easiest and most flexible way to install the UNIX tools that Apple didn’t include with macOS. )

1- Install Brew (if not already installed) by following the below command
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

-

Node (version : 12.13.1)
( Node.js is used to create fast web servers that can run JavaScript code on your computer free of any web browser. Appium use it internally. )

1- Launch terminal
2- Run command brew install node

Node (version : 12.13.1)
( Node.js is used to create fast web servers that can run JavaScript code on your computer free of any web browser. Appium use it internally. )

1- Go to Node.js download page.
2- Download related version
3- Double click on the node.js installer to install it.
You do not require any special configuration during the installation process.

Mobile device libraries
( library and utility to talk to iBoot/iBSS via USB on Mac OS )

1- Launch terminal
2- Run command brew install libimobiledevice --HEAD

-

Ios-deploy Node.js library
( used to install and debug iOS apps without using Xcode. Designed to work on un-jailbroken devices. )

1- Launch terminal
2- Run command npm install -g ios-deploy

-

Carthage 
( Use to build webDriverAgent application using XCODE )

1- Launch terminal
2- Run command brew install Carthage

-

Xcode (Version : 12.2)

1- Download Xcode from App Store and install it
2- Launch the app.
3- Click on Open Developer Tool and then click on Simulator.
Simulator will be launched.

Please refer to the https://bqurious.atlassian.net/wiki/spaces/BSD/pages/934510601 for details about supported versions.

An iOS Developer Account either Free or Paid will be required for iOS automation.

-

Android Studio (Version : latest)

1- Go to Android Developers tools website to download and install it.
2- Launch Android Studio and create an AVD (click on Configure dropdown and then click on AVD Manager.)

At least one AVD is required

After installing Android Studio, follow the below steps to set up ANDROID_HOME

  1. Launch the terminal window.

  2. Enter the command open ~/.bash_profile

  3. Add ANDROID_HOME variable and update PATH variable.
    To change editor into Insert mode
     export ANDROID_HOME = <path to android folder>
    example of path : /Users/<systemUser>/Documents/Environment/Android/sdk

     export PATH=$ANDROID_HOME/platform-tools:$PATH

     export PATH=$ANDROID_HOME/tools:$PATH

1- Go to Android Developers tools website to download and install it.
2- Launch Android Studio and create an AVD (click on Configure dropdown and then click on AVD Manager.)

At least one AVD is required

After installing Android Studio, follow the below steps to set up ANDROID_HOME

1- Navigate to environment variables
2- Click on New button
3- Enter ANDROID_HOME in ‘variable name’ and sdk path in ‘variable value’.
Example of sdk path : C:\Users\<systemUser>\AppData\Local\Android\Sdk
4- Edit the path variable and add %ANDROID_HOME%\platform-tools and %ANDROID_HOME%\tools
5- Click on Ok on New User Variable window.
6- Click on OK on Environment Variable window.

 

Before running your mobile test, make sure Appium Home path is set in client setup.

Appium Home : C:/Users/xxxxx/AppData/Roaming/npm/node_modules/appium

Android Home : C:/Users/xxxxx/AppData/Local/Android/Sdk

Please note, if AppData folder is not visible, try viewing the hidden files, AppData folder should be displayed.

Also check that appium is installed on your machine via BQ Client. Use the below command to check the appium version on cmd

appium -v

 

SAP Automation

(Follow these steps only if you have purchased the license for SAP)

Setting up Bq Genie for SAP Automation requires the following:

  1. SAP GUI installed and working on the client machine.

Please refer to https://bqurious.atlassian.net/wiki/spaces/BSD/pages/17240140 for troubleshooting any issues automating SAP.

 

 

Instructions to install the client

  1. Click on the user displayed in the top right corner to display the menu. Click on “Download Client”.

     

  2. Once the file is downloaded, double click to run it. Ensure that you have a valid JRE 1.8+ installed and properly configured on your machine.


     

  3. Select the packs as per your license and follow through with the installation as directed in subsequent screenshots.
    If you have installed all the prerequisites for Mobile Application, please ensure to select the check box Appium for BqGenie Mobile.





     

  4. Enter the credentials to successfully register the client and select the browsers installed on your machine.

     

  5. If you select the Cloud Install option, the BQ Auth URL and BQ Node Server URL will be taken care of.

     

  6. If you select the In-premise Install option, you will have to enter the BQ Auth URL and BQ Node Server URL manually.


    Although bq client will auto detect the proxy settings. In case, you want to enter the proxy settings manually then select the radio button “Enter Manually” and enter proxy setting manually.

     

  7. If proxy with authentication is running then it will ask for authentication details.

     

  8. You need to provide your proxy authentication detail.

     

  9. Click on Next button.





     

    Sit back and relax while the client is installed on your machine. It may take a few minutes.

  10. Click on the “Done” button to complete installation.



Watch a video :

 

Starting the client

If you are using Windows :
A shortcut will be created on your desktop.
Click on the icon on desktop to start the client.
An icon will appear in your tray. This starts the client and enables it to talk to the Bqurious Cloud.
The color of the tray icon will eventually change to green.

If you are using Mac :
Use the terminal to start the client.
Navigate to the client installation folder by running the command cd clientInstalledFolderName
Then run the command java -jar startBqClient.jar

 

 

 

 

Related articles :

https://bqurious.atlassian.net/wiki/spaces/BSD/pages/1613234185