Applies to ReadyAPI 3.1, last modified on March 26, 2020

There are several ways to install ReadyAPI TestEngine. The most typical way is to run the product installation wizard, but you can also run the installer in headless mode or without user interaction.

Download

Download the installer for your platform from the SmartBear website.

Typical installation

  1. Run the installation package you downloaded from the SmartBear website. It will be unpacked and get prepared for installation.

  2. Specify the installation directory.

  3. The wizard will ask you to select additional components to install. These components are optional, but they may be needed to run some of your tests:

    Component Description
    ReadyAPITestEngine Service,
    Autostart Server
    ReadyAPITestEngine Service commands the installation wizard to install TestEngine as a as a Windows service. This way TestEngine will run even if no user is logged in to the computer where it is installed.

    Autostart Service means that the operating system will run this service automatically upon startup. See Run TestEngine as Service for details.

    Microsoft JDBC Driver for SQL Server The JDBC Driver provided by Microsoft. You can download it at any time later from the MSDN website.

    This driver is needed to work with SQL servers and databases from your tests. We recommend installing it if you plan to run data-driven API tests.

    After selecting the desired components, click Next to finish the installation.

Default login

TestEngine installation: Setting up admin password

Click the image to enlarge it.

After the installation, you can specify a password for the default admin account.

Set the password at this step if you run TestEngine as a service for the first time. Otherwise, you will not be able to log in.

If you disable the Set admin password option, TestEngine generates a random password during the first run and posts it to the log.

Show image

Change the generated password, after installing a license.

To learn how to configure and run TestEngine, see TestEngine Tutorial.

Use the smartbear/readyapi-testengine Docker image to run a container with installed TestEngine. To do this, pull the image from Docker Hub:

smartbear/readyapi-testengine

To learn more about the image, see Run TestEngine in Docker Container.

To install ReadyAPI TestEngine without user interaction, run the installer with the -q command-line argument.

To specify the installation folder, use the -dir argument.

For more complex customization, use the response file as it is described in the install4j documentation.

Command-line arguments

-Vautostart=true

Configure the TestEngine service to run automatically.

Make sure you specify the -VadminPassword argument. Otherwise, you will not be able to log in to TestEngine.

-VadminPassword=<password>

Specifies the password for the default admin account.

To install ReadyAPI TestEngine on a computer with a headless environment or from the console, run the installer with the -c command-line argument. Then, follow the installation wizard instructions in the console.

Note: On Windows computers, use the following command:

start /wait ReadyAPITestEngine-1.8.1.exe -c

Next steps

Here are some topics that will help you prepare your TestEngine installation and start testing:

Install Fixed License

Install Floating License

Configure TestEngine

TestEngine Tutorial

See Also

Run Tests

Highlight search results