HomeInstallation GuideTestCollab on VMTestCollab on VM

4.1. TestCollab on VM

This page is dedicated to the steps of procedure that are required to be followed in order to get the TestCollab application running on Virtual Machine (VM).


Import the Virtual Machine

Make sure these steps are followed by root user (on Linux based OS) or 'Administrator' user (on Windows based OS) as only they have necessary permissions on the host OS to setup forwarding on ports 80 and 443.

Linux Users: First start a root terminal with "sudo su" and then enter "virtualbox" to start virtualbox in root mode.

Windows Users: Right click VirtualBox icon and click 'Run as Administrator'

You receive an VirtualBox appliance packed in an ova (Open Virtual Appliance) file. To import the virtual machine on the host:

Start VirtualBox, and use File->Import Appliance... option, and choose the ova to import.


You will get a dialog to provide the VM specific settings

Most of the settings are straight forward, you may like to change the size of RAM available for VM, or may want to change the location of the virtual disk image that will be kept on host machine.

Once settings have been defined and you click Import button, the process of importing the VM will begin and you will be shown the progress so far.


When import process completes successfully, you should see a new entry in the left pane of the VirtualBox main window.

New VM named "TestCollabVM" should appear.


Start the Virtual Machine

You can either double click the VM name in the list, or use Start button (shown with a green arrow).

Once ready to start, you will be shown an info box about the capturing of keyboard actions on VM.

Click on Ok, and you will see the VM booting.

When booting finishes, you should see the login prompt for the newly imported VM.

Note: If this window bothers you, you can also start the VM in headless mode using virtual box's API (specific instructions are not included but can be found on Virtual Box API).

You are now ready to install and use the TestCollab application.

The virtual machine is pre-configured to forward the ports required to access the application.

To run the application, just open your favorite browser, and key in the URL http://localhost, and you are now ready to install the application. Advanced users can also modify the port forwarding in case host ports are already in use or can't be freed, but we recommend all clients to use the VM configuration as is, for best results.


The Installation Process

You should see a screen similar to this:

Click on Next Step to start the installation wizard

Most of the information that the wizard seeks is straight forward and self explanatory.


System Settings

Before installing the application, wizard checks for its dependencies, which include the permissions that should be available for various directories.


Database Configuration

In this step, database related information is to be provided.

Note that the database username to be given should be root, and password should be tcm. You can specify any name for the database and it will be created on runtime automatically.


Network Settings

In case you are using a proxy server to connect to the internet then this setting will be required to be defined.

License Agreement

You should be having the application's main license key handy, in order to finish this step.

Backend Configuration

This covers the website management related settings

General Configuration

These are application wide settings.

Your Information


Finishing Installation

The wizard ends with your login information, and an instruction to change directory permissions for the config directory.
When the installation completes, you will be redirected to the application's login form.
You can login to the application using the credentials you have set during "Your Information" step of installation.
Please note that being an administrator, one can change the application wide and project specific settings.
For email setting, make sure that you select SMTP Server as the Type of Mailing System to be used, as shown in the screen shot below.


This page was: Helpful | Not Helpful
Test Case Management
Test Collab Support
Product Tour