Installing TestEngine on Azure

Applies to TestEngine 1.24, last modified on September 14, 2021

TestEngine is available on the Azure marketplace, which allows you to quickly deploy TestEngine in the Azure cloud. This guide explains how you can launch a TestEngine instance from the Azure Marketplace.

Prerequisites

To deploy TestEngine to Azure you need:

Create a TestEngine virtual machine

  1. In the Azure portal sidebar, click Create a resource.

  2. Search for testengine and select ReadyAPI TestEngine in the search results.

    Creating a TestEngine VM in the Azure portal

    Click the image to enlarge it.

  3. In the Select a software plan list, select whether you want to create a Windows- or Linux-based virtual machine and click Create.

    Creating a TestEngine VM

    Click the image to enlarge it.

  4. On the Basics page, specify the following options:

    Option Value
    Subscription Select your Azure subscription
    Resource group Click Create new and specify TestEngine as the resource group name. A resource group is a logical container that holds related resources for deployment.
    Virtual machine name Enter a name for your TestEngine VM
    Region Select the Azure region to deploy the VM to
    Availability options Optional -- select if needed
    Image Leave as is
    Size The recommended VM size is F2s_v2 (selected by default), but you can use a different size if you wish. The selected VM size must have at least 2 vCPUs and at least 4 GB of memory.
  5. Configure the authentication settings. They depend on what image you are going to run.

    Windows-based image:

    Option Value
    Username

    Specify the username of the virtual machine administrator. Note: You will use this account for the initial TestEngine configuration.

    Password

    The password for the virtual machine administrator.

    Linux-based image:

    Option Value
    Authentication type SSH public key
    Username Specify the ubuntu username. Note: This is the default account of the Linux machine. You will use this account for the initial TestEngine configuration.
    SSH public key Paste your SSH public key
  6. Click Next : Disks.

  7. Leave all the options as is and click Next : Networking.

  8. Specify the networking options:

    Option Value
    Virtual network and Subnet Select the virtual network and subnet where the VM must be deployed, or create new ones.
    Public IP Azure automatically assigns a public IP address to the VM so that the VM can be accessed from the Internet. The IP address is dynamic by default. If you want a static IP, click Create new and change Assignment to Static.
    NIC network security group Leave as is. TestEngine VM image has preconfigured network security rules.
    Configure network security group Leave as is
    Accelerated networking Leave as is
    Load balancing Select No
  9. Click Next : Management.

  10. Specify the following options:

    Option Value
    Boot diagnostics Optional -- select if needed
    OS guest diagnostics Optional -- select if needed
    Diagnostics storage account If you enabled boot diagnostics or OS guest diagnostics, select the storage account for diagnostic data
    System assigned managed identity Off
    Enable auto-shutdown Off
  11. Click Review + create, then Create.

  12. Wait until the VM is deployed. This may take a few minutes. You can track the deployment status via the notifications menu.

  13. After the VM has been deployed, click Go to resource.

    Deployment is complete

    Click the image to enlarge it.

  14. Note down the public IP address of the VM.

    Public IP address of the TestEngine VM

    Click the image to enlarge it.

Initial TestEngine configuration

At this step, you connect to the created instance and install TestEngine. The exact steps depend on your operating system and the instance you run.

  1. Connect to your Windows instance via Remote Desktop Protocol (RDP). In this guide, we will use the Remote Desktop Connection (mstsc.exe) utility built in the Windows operating system. On other operating systems, use its alternatives:

  2. In Azure, click Connect and select RDP:

    Install TestEngine on Azure: Connecting to the TestEngine instance

    Click the image to enlarge it.

  3. Click Download RDP File and save the .RDP file:

    Install TestEngine on Azure: Download the .RDP file

    Click the image to enlarge it.

  4. Right-click the downloaded file and select Edit:

    Install TestEngine on Azure: Connect to remote desktop
  5. Specify a username you've set during the VM creation and click Connect:

    Install TestEngine on Azure: Connect to remote desktop
  6. Use the password you've specified during the VM creation.

  7. Open the installation file from the C:\Program Files folder:

    Install TestEngine on Azure: Run TestEngine installation

    Click the image to enlarge it.

  8. During the installation, select the Autostart service option:

    Install TestEngine on Azure: Select the Autostart Service option

    Click the image to enlarge it.

  9. Select the Set admin password option and specify the password you want. You will use this password to log in to TestEngine for the first time:

    Install TestEngine on Azure: Set admin password

    Click the image to enlarge it.

  10. The TestEngine service starts automatically after the installation. Now, you can close the remote desktop connection.

To connect to the Linux instance, use the SSH connection. On the Windows operating system, you can also use PuTTY.

  1. Make sure your key pair file is private.

    How to do it on Linux

    How to do it on Windows

  2. Open Terminal (on Linux) or PowerShell (on Windows) and run the following command:

    ssh -i <your-key-pair.pem> ubuntu@<public-IP-address>

    You can get the IP address in the Azure console:

    Install TestEngine on Azure: Get public IP address

    Click the image to enlarge it.

    For example, your command may look like this:

    ssh -i ".\my-key-pair.pem" ubuntu@40.71.228.90

  3. After the connection, you will get the headless access to the instance. To install TestEngine, run the following command:

    ./ReadyAPITestEngine-x64-1.24.0.sh -q -Vautostart=true -VadminPassword=<your password>

    The -VadminPassword=<your password> argument specifies a password for the default TestEngine account. You will need it to log in to TestEngine for the first time.

  4. The TestEngine service starts automatically after the installation. Now, you can close the SSH connection.

Connect to TestEngine and install license

  1. Navigate to http://public-IP-address:8080/login to open TestEngine Web UI.

  2. Use the following credentials to login to TestEngine:

    Username: admin
    Password: a password you specify during the installation

  3. Install your TestEngine license.

After that, you can access TestEngine at http://<public-IP-address>:8080.

How to update TestEngine instance

To update TestEngine instance in Azure:

  1. Connect to the instance as it is described above.

  2. Update TestEngine as a regular installation.

Next steps

See Also

Installing TestEngine
Administrative Tasks
Run Tests in TestEngine Using Jenkins
Audit Log

Highlight search results