Configure your TESTaide virtual machine with the Azure Image

In this guide

Once you have purchased the TESTaide image from the Azure Marketplace, open the Azure Portal and login with the desired account.

Creating your own TESTaide Virtual Machine

There are a few important steps in the virtual machine creation that is required to allow TESTaide to work properly.

  • The Image

    • Make sure to select the correct version of the purchased TESTaide image in the drop-down menu, you might have to click ‘See all images’ to find it.

  • VM Size

    • It is highly recommended to select at least the minimum size recommendation found on the TESTaide image. Selecting a size less than this can cause undesired issues or for the virtual machine to not work.

      • VM size & data disks can be configured & attached as desired, though not necessary unless a large amount of users will use the application.

  • Administrator account

    • Make sure to select the ‘Password’ option for the authentication type with the username ‘TESTaide’, this is important. The password is less important and you are free to choose any desired password.

For detailed information on creating the virtual machine, please refer to the official Azure documentation available here.

Opening port 8080 for inbound connections

Once you have created and deployed your virtual machine, if you want to be able to connect to the web application from outside networks, you must add an inbound connection rule. To do this, simply;

  • Open the resource page for the virtual machine and select the ‘Networking’ setting from the left-hand navigation bar.

  • Select the ‘Inbound port rules’ tab and click ‘Add inbound port rule'.

    • The default fields should be for the port 8080

  • Enter the required fields according the desired security and connection allowances. Click ‘Add’ to finish and after ~1m you should be able to connect to the web application, assuming that you have started application.

Post-creation of the virtual machine

Connecting to the Virtual Machine

On the overview page you will be able to view the IP-Address, note down the IP-address and then open the command line, such as PowerShell on Windows or Linux Shell/Terminal. Type the command as shown below, changing the IP-address to what your virtual machine has.

#Following the format, ssh <user>@<IP-Address>
ssh TESTaide@24.654.24.75

Type ‘yes’ & press enter when asked to continue connecting and enter the password you entered above.

Starting the TESTaide application

After having connected to the virtual machine, with your command line type the command:


This will start your application on port 8080, which you opened and allowed for inbound connections to in the above process.

On the first start and initialization of the TESTaide application, it is highly recommended to restart the virtual machine to make sure that all database and Infrastructure Agent connections are properly made as intended. Simply restart the machine in the Azure portal & run the start command when the virtual machine has restarted to continue using the TESTaide application.

View the execution log

To view the execution log of the application, type the command:

tail -f /home/TESTaide/testaide-v3.0.0/log/launcher.log

This will allow you to continuously view the incoming log messages sent to by the TESTaide application. To exit the log, press [CTRL+Z] on your keyboard

Stopping the TESTaide application

After having started the TESTaide application, to stop application, type the command:

/home/TESTaide/testaide-v3.0.0/bin/ -p=8080

This will stop your application, if you used another port to start the application, simply change the value of 8080 in the parameter ‘-p=8080' to the correct port number.