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:

A Microsoft Azure subscription. You can sign up at https://azure.microsoft.com.

Tip: An Azure subscription is also included in a Visual Studio subscription and some other Microsoft subscriptions.
For Windows-based images:

A remote desktop client. The recommended application depends on your operating system and the TestEngine instance you use. For the complete list, see the Azure documentation:

How to connect and sign on to an Azure virtual machine running Windows
For Linux-based images:

An SSH key pair. To learn about it, see the Azure documentation:

Create and use an SSH public-private key pair for Linux VMs in Azure
A TestEngine license file provided by a SmartBear representative. To request a free trial license, please fill out this form:

https://smartbear.com/product/ready-api/testengine/contact-us/

Create a TestEngine virtual machine

In the Azure portal sidebar, click Create a resource.
Search for testengine and select ReadyAPI TestEngine in the search results.

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

Click the image to enlarge it.

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.

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

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

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

Click Next : Management.

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

Click Review + create, then Create.
Wait until the VM is deployed. This may take a few minutes. You can track the deployment status via the notifications menu.
After the VM has been deployed, click Go to resource.

Click the image to enlarge it.
Note down the public IP address of the 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.

Windows instance

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:
- Linux: rdesktop
- macOS: Microsoft Remote Desktop
In Azure, click Connect and select RDP:

Click the image to enlarge it.
Click Download RDP File and save the .RDP file:

Click the image to enlarge it.
Right-click the downloaded file and select Edit:
Specify a username you've set during the VM creation and click Connect:
Use the password you've specified during the VM creation.
Open the installation file from the C:\Program Files folder:

Click the image to enlarge it.
During the installation, select the Autostart service option:

Click the image to enlarge it.
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:

Click the image to enlarge it.
The TestEngine service starts automatically after the installation. Now, you can close the remote desktop connection.

Linux instance

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

Make sure your key pair file is private.

How to do it on Linux
How to do it on LinuxHow to do it on Linux
1. Run the following command:
  
  chmod 400 <your-private-key.pem>
How to do it on Windows
How to do it on WindowsHow to do it on Windows
1. Right-click the private key file and select Properties.
2. Switch to the Security tab and click Advanced:
3. Make sure that you are the owner of the file.
4. Click Disable inheritance to remove all the inherited permissions:
  
  Click the image to enlarge it.
5. Click Add and grant permissions to your account:
  
  Click the image to enlarge it.
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:

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
After the connection, you will get the headless access to the instance. To install TestEngine, run the following command:

./ReadyAPITestEngine-x64-1.17.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.
The TestEngine service starts automatically after the installation. Now, you can close the SSH connection.

Connect to TestEngine and install license

Navigate to http://public-IP-address:8080/login to open TestEngine Web UI.
Use the following credentials to login to TestEngine:

Username: admin
Password: a password you specify during the installation
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:

Connect to the instance as it is described above.
Update TestEngine as a regular installation.

Next steps

TestEngine Tutorial

Manage Users

Run Tests

Installing TestEngine on Azure