Installing the Provengo Tool

provengo is a commandline tool that runs locally. No internet connection is required, no data is stored or transferred to our servers. You can use it in on your local machines, in CI/CD pipelines, and in air-tight isolated systems.

Installation

Provengo’s downloads site contains updated installation packages for Linux, Mac, Windows, and files for manual installations.

Prerequisites

In most cases, the software listed below can be installed using your platform package manager, such as brew on MacOS, apt-get/yum/apk on Linuxes, or winget on Windows.
Hardware Requirements

As far as minimal system goes, provengo was successfully tested on an a laptop equipped with an Intel i5 CPU and 4GB of RAM. However, we recommend at least 8GB of RAM. In general, memory requirements will increase with model complexity.

Java 11 or later

Any Java 11 or later works. Adoptium offers a free version.

Terminal/Command line Application

Provengo tool is run from the command line. The default applications for this kind of access are CMD on windows, and Terminal on MacOS and Linux, but other tools exist too.

For a GUI option, please check out the Provengo Studio VSCode Plugin.
Graphviz (Optional)

Graphviz is used for generating the test-space charts. It can be downloaded here. Required for visualizations.

Console Colors on Windows

In order for Windows' CMD to display colors, both following conditions need to be met:

  1. Windows version should be at least 10

  2. There should be a registry key:

    [HKEY_CURRENT_USER\Console]
"VirtualTerminalLevel"=dword:00000001

To register this key and value, write the following command in the CMD prompt:

REG ADD HKCU\CONSOLE\ /v VirtualTerminalLevel /t REG_DWORD /d 1

Color prints to the console will become available, starting in the next PowerShell windows opened.

Provengo and Selenium

Integrated Drivers

Provengo uses Selenium for web automation. By default, Provengo uses Selenium’s integrated web drivers. This has the advantage of automatically synchronizing specific web browser drivers with versions available on the local machine. In most circumstances, Provengo users should not need to take any action for web browser automation to work, as driver downloads will be handled automatically by Selenium Manager.

Another built-in option is to use WebDriverManager by @bonigarcia. To do this, set the selenium.driver-manager configuration key to WebDriverManager. See Project Configuration.

When running Provengo in environments with limited internet connectivity (e.g. because of firewall rules), additional configuration might be required for Selenium Manager to be able to load the correct drivers. Please consult the Selenium Manager and your system administrators about setting up your environment.

Remove Drivers / Selenium Grid

Provengo also supports running tests on a remote Selenium Grid. For this, the configuration key selenium.server should contain the URL for that grid.

By default, the address for a locally installed Selenium Grid server is http://localhost:4444/wd/hub .
When starting a local Selenium Server, use the --selenium-manager true flag to have it manage its drivers automatically.