Document toolboxDocument toolbox

A new version of Qualitia Automation Studio for Web and Mobile 7.2.x is now available. We highly recommend you upgrade. Find more details here.

Installation Process

Installing Qualitia Server

Qualitia recommends using File Share to keep Qualitia installable. This will help you to easily apply product updates in future.

To install Qualitia Server:

  1. Ensure you have activated product license for Qualitia. 
  2. Open the File Share / folder where you have unzipped Qualitia installable. 
  3. Open the Server folder.

    Executing Setup.exe from file server may take longer time. Therefore, it is recommended to copy Setup.exe on the local temporary folder.

  4. Double-click Setup.exe.
    The Welcome to the Qualitia Setup Wizard screen appears.
  5. Click Next.
    The Database Server Details section appears.

    Database Type

    Select the Database server (MySQL or SQL Server) 

    Server

    Enter the Host Name or IP address of the Database Server

    Port

    Enter the port number of the Database Server.

    The default value for MySQL is 3306.

    The default value for SqlServer is 1433.

    Contact Database Administrator for the port number of your database server. 

    Authentication

    (For Sql Server only)

    Select Authentication mode: Sql Server Authentication or Windows Authentication.

    For Sql Server Authentication: Enter Sql Server user ID and password.

    For Windows Authentication on SQL Server, you need to make some additional configurations to Qualitia Web Service. Click here for these configurations.

    User ID

    Enter the database server User ID.

    (Not applicable for Sql server with Windows Authentication)

    Password

    Enter the database server Password. 

    (Not applicable for Sql server with Windows Authentication)

  6. Click Next.
  7. Enter the desired Master Database name.
  8. Select the Enable Dashboard option if you want to access MS Excel-based dashboards functionality. 
    For more information about MS Excel-based Dashboards, click here.

    Enabling this option, Qualitia consumes an additional database (except master and project databases) for managing data related to the dashboard functionality.

  9. Enter the desired Dashboard Database name.
  10. Click Next.
    The Admin User Details screen appears.

  11. Enter admin credentials.

    Remember these credentials to access Qualitia for the first time as Qualitia Administrator. Qualitia administrator can create new user accounts directly in Qualitia or by accessing user accounts from your local LDAP. 

    Admin User ID

    Enter the desired username for the Qualitia administrator user.

    Password

    Enter the desired password for the Qualitia administrator user account.

    Confirm Password

    Enter the password again for confirmation.

  12. Click Next.
    The Qualitia Update Location screen appears. 

    Qualitia update location is the network shared location where Qualitia will look for update packages. Qualitia Admin should copy Qualitia update packages, when they are available, in the respective folders. Users can use the same folders created to save Qualitia installable on the File Server. All the Qualitia users should have Read Access to these folders. For more information about Qualitia Update location, click here. 

  13. Enter the details as follows:

    Server

    Enter the location where Qualitia Server will check for updates in future.

    Client

    Enter the location where Qualitia Client will check for updates in future.

  14. Click Next.
  15. Specify network ports that will be used to run Qualitia-related services. 

    By default, for Qualitia Server, 8887 is selected and for Qualitia License server 8889 is selected. You may change these port numbers based on your organizational requirements. These TCP ports needs to be opened (inbound) on Firewall which will be accessed by Qualitia clients.

  16. Click Next.
    The Confirm Installation screen appears.

  17. Click Install.
    The installation will get started and after a successful installation, the Installation Complete screen appears. 
  18. Click Finish to exit the setup wizard.
  19. Install Qualitia Client on the same machine.
    Installing Qualitia Client on the same machine helps in initiating upgrade process automatically, when available. 

Please refer to the Troubleshooting section in case you face any error when installing Qualitia Server.

Configurations for SQL Server Windows Authentication

If you are using Windows Authentication for SQL Server, you need to configure Qualitia Web Service accordingly. Follow these simple steps to configure Qualitia Web Service.

  1. Run services.msc to open the Services Manager. 
  2. Stop Qualitia Web Service.
  3. Right-click Qualitia Web Service and select properties from the context menu.
  4. In the Log On section, select This account: option.
  5. Enter Windows username and password (domain\USERNAME) using which you want to access SQL Database server.
  6. Click Apply and then OK.
  7. Restart Qualitia Web Service and start using Qualitia.

     View image

Installing Qualitia Client

Once Qualitia Server is installed, you can proceed to install Qualitia Client.

To install Qualitia Client:

  1. Ensure that the Port 8887 and 8889 is open from the machine where Qualitia Server is installed.
  2. Ensure you have closed all the instances of Internet Explorer.
    (warning) Do not open Internet Explorer during the installation process.
  3. Open the Client folder where you have downloaded the Qualitia Software package. 

    Executing Setup.exe from file server may take longer time. Therefore, it is recommended to copy Setup.exe on the local temporary folder.

  4. Double-click Setup.exe.
    System will ask for permission to run the application, click Yes.
    The Qualitia License Agreement screen appears.
  5. Once you have reviewed the agreement, select Yes, I accept the terms…, and then click Next.
    The Qualitia Installer screen appears.
  6. Once installed successfully, click Finish.
    You can now start working with Qualitia.
  7. To launch Qualitia, double-click the Qualitia icon on your desktop.
    A Configuration Settings window will open where you will have to enter the master database details to get started for the first time.

Dashboard gets generated and refreshed overnight which includes all the available data from the result databases. You will get MS Excel-based dashboard on the next day of completing the installation process.

Also, please note that results data will not be available into the dashboard immediately after the test case executions. Data of test case executions will reflect in the dashboards on next day.

For more information about the dashboards functionality, click here.

Please refer to the Troubleshooting section in case you face any error when installing Qualitia Server.

Not finding what you need?