On-premise setup

To start using PaceConnect, you need to download the PaceConnect agent software, install it on the machine or machines that will execute the tests, and connect each agent to your organization in Qentinel Pace. After that, users in your organization can create robots in Qentinel Pace that automatically use the agents to run the tests.

PaceConnect agent is available for four environments: Docker, Windows, Mac and Mobile. On Mac & Windows systems, you can choose whether to run the agent in a Docker container, which isolates the test environment from the operating system, or as a native application, which makes it more straightforward for the tests to interact with the desktop and GUI applications.

PaceConnect for Mobile enables you to use your own mobile device(s) on your own pc and still run test cases from Qentinel Pace.

Downloading

PaceConnect client can be downloaded from your organizations agent view. Navigate to your organization’s Agents view by clicking your profile icon > Organizations > PaceConnect/Agents button.

(or follow direct link https://pace.qentinel.com/paceconnect)

To download Docker PaceConnect, click the Docker button. This starts downloading the image file (roughly 1.4 GB).

To download Windows installer, click the Windows button.

To download Mac installer, click the Mac button.

To download Mobile installer, click the Mobile button.

paceconnect download










After downloading, please follow the instructions for downloaded version:

Docker PaceConnect instructions

Prerequisites

PaceConnect agent runs locally in a Docker container, so installing Docker is a prerequisite. Docker is a widely used container platform available for Windows, Linux, and Mac. Install Docker from https://docs.docker.com/get-docker/, and make sure you can run the docker command line tool in a terminal window.

Add image to Docker

In a terminal window, run

docker load -i image

where image is the path to the downloaded file (by default, paceconnect_latest.gz). This adds PaceConnect to the images managed by your Docker installation.

Verify the installation by running:

docker run --rm paceconnect --version

which should print the PaceConnect agent version.

To view all your local versions of PaceConnect, run:

docker image ls paceconnect

Start the PaceConnect agent locally

Start the PaceConnect agent locally by running in a terminal window

docker run -ti --rm --name containername --mount type=volume,src=volumename,dst=/agent --shm-size=256m paceconnect

The containername and volumename will be the name of the Docker container that runs the agent software and the name of a new Docker volume, respectively. The agent identity and authorization data will be stored in that volume, i.e. in a file managed by your Docker installation. Pick recognizable containername and volumename, e.g. set both to paceconnect-my-first-agent if the agent name is My First Agent.

if your terminal uses Git Bash on Windows, you may need to replace /agent with //agent on the command line.

Because this is the first run with an empty Docker volume, PaceConnect will ask for the authorization string in the terminal window. Copy the authorization string you got when creating agent in Qentinel Pace, paste it into the terminal, and press enter. The agent connects to Qentinel Pace and is ready to use.

Windows PaceConnect instructions

Prerequisites

A 64-bit Windows 10 operating system is required. To run web tests, a compatible browser (Chrome or Firefox) is needed.

It is strongly recommended to run the PaceConnect agent as a dedicated non-admin user. The test cases that PaceConnect runs have the same access rights to the machine that the user has, including reading and writing the user’s files and settings, launching applications, and sending data to the internet. Running the PaceConnect agent under a human user’s personal account could interfere with normal usage and risk the security of the user and of any systems that the user can access.

Installation

Run the downloaded file (by default, paceconnect_latest.exe) to install the Qentinel PaceConnect agent application. If you get a dialog titled "Windows protected your PC", click "More info" and then "Run anyway" to proceed with the installation. The installer needs a working internet connection to download its software dependencies.

Start the Windows PaceConnect agent locally

To start PaceConnect for Windows, click on the Qentinel PaceConnect/Qentinel PaceConnect shortcut under Start Menu.

paceconnect windows shortcut








The agent will open in a new terminal window. On the first run PaceConnect will ask for the authorization string in the terminal window. Copy the authorization string you got when creating agent in Qentinel Pace, paste it into the terminal, and press enter. The agent connects to Qentinel Pace and is ready to use.

paceconnect windows first run

Closing the terminal window exits the agent. It will not keep running in the background. Connections to Qentinel Pace agents are only allowed when PaceConnect is running (i.e. terminal is open).

The authorization string is saved under the Windows user’s application data folder, so running PaceConnect again on the same machine as the same user will automatically connect to Qentinel Pace as the same agent.

If you make a mistake and need to revoke the token, you can do so by removing the file login from \AppData\Local\Qentinel\PaceConnect\agent.
When running a web browser test for the first time, you may see a dialog titled "Windows Defender Firewall has blocked some features of this app". This is an artifact of the Webdriver software used for communicating with browsers. Unless your test cases specifically need to accept incoming network connections, you can disallow access by clicking Cancel.

Mac PaceConnect instructions

Prerequisites

A 64-bit Mac operating system is required. To run web tests, a compatible browser (Safari, Chrome or Firefox) is needed.

At the moment Macs with latest Apple’s M1 processor are not supported.

If using Safari as a web browser, please enable "Remote Automation". Go to Safari’s preferences and enable "Show Develop menu in menu bar" under Advanced tab. Then open Developer menu and enable Remote Automation.

Installation

  1. Run the downloaded file (by default, paceconnect_latest.dmg) to install the Qentinel PaceConnect agent application.

  2. Drag and drop PaceConnect icon to Applications.

  3. Right click the DMG window and select "Eject Qentinel PaceConnect"

paceconnect mac installer
  1. Launch PaceConnect using LaunchPad or Finder. A dialog should tell that PaceConnect is started in a new Terminal window. The dialog closes itself after 10 seconds unless user clicks OK.

paceconnect mac launcher dialog
  1. In the first run PaceConnect for Mac asks for token. Input it. If you don’t yet have a token, please create agent on Qentinel Pace cloud as described here.

  2. PaceConnect should state that it is connected to Qentinel Pace and you can verify this by checking the agent’s status from Pace. A green icon should be visible and details presented about your "Mac".

PaceConnect for Mobile instructions

Prerequisites

A 64-bit Windows 10 operating system is required. A local mobile device needs to be properly setup and connected with USB cable.

It is strongly recommended to run the PaceConnect agent as a dedicated non-admin user. The test cases that PaceConnect runs have the same access rights to the machine that the user has, including reading and writing the user’s files and settings, launching applications, and sending data to the internet. Running the PaceConnect agent under a human user’s personal account could interfere with normal usage and risk the security of the user and of any systems that the user can access.

Installation

Run the downloaded file (by default, qentinel_paceconnect_mobile_setup.exe) to install the Qentinel PaceConnect agent application. If you get a dialog titled "Windows protected your PC", click "More info" and then "Run anyway" to proceed with the installation. The installer needs a working internet connection to download its software dependencies.

Start the Mobile PaceConnect agent locally

To start PaceConnect for Windows, click on the Qentinel PaceConnect/Qentinel PaceConnect shortcut under Start Menu.

paceconnect windows shortcut








The agent will open in a new terminal window. On the first run PaceConnect will ask for the authorization string in the terminal window. Copy the authorization string you got when creating agent in Qentinel Pace, paste it into the terminal, and press enter. The agent connects to Qentinel Pace and is ready to use.

paceconnect windows first run

Closing the terminal window exits the agent. It will not keep running in the background. Connections to Qentinel Pace agents are only allowed when PaceConnect is running (i.e. terminal is open).

The authorization string is saved under the Windows user’s application data folder, so running PaceConnect again on the same machine as the same user will automatically connect to Qentinel Pace as the same agent.

If you make a mistake and need to revoke the token, you can do so by removing the file login from \AppData\Local\Qentinel\PaceConnect\agent.
Remember to setup your mobile device as instructed here

You can attach multiple devices via usb to your PaceConnect machine. Each of these devices will be automatically identified and can be seen in your organizations PaceConnect status page (https://pace.qentinel.com/paceconnect).

In the screenshot below, (1) is the PaceConnect laptop/agent and 2-4 are mobile devices connected via usb.

paceconnect mobile devices connected