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 two environments: Docker and Windows. On a Windows system, you can choose whether to run the agent in a Docker container, which isolates the test environment from the operating system, or as a normal Windows application, which makes it more straightforward for the tests to interact with the Windows desktop and GUI applications.

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.

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.