Document toolboxDocument toolbox

Installing Qualitia Server

Before you Start Installation

Qualitia requires local administrative privileges for Qualitia Server installation. Ensure you have administrative access to the system where you are installing Qualitia server. 

Additionally, as Qualitia uses client-server architecture, you must open port 8889 and 8887 for all clients (client machines). Qualitia uses these ports to communicate between different components.

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. /wiki/spaces/TEST1/pages/1718944196
  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 Web dashboards functionality. 
    For more information about Web 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. Specify the Result Path to store results of the test cases executed outside Qualitia.

    Qualitia uses this folder to store results of test cases executed through CI Tools (Jenkins, TeamCity, Bamboo), Build / Release Cycles from TFS/Azure DevOps, and offline package.
    All the Qualitia clients should have read access to this directory.



  17. Click Next.
    The Confirm Installation screen appears.

  18. If the space of the computer where you are installing Qualitia server is less than 500GB, then the following message is displayed.

    Do one of the following:

    • Click Yes to continue the installation.

    • Click No to stop installation so that you can increase the allocated space for Qualitia server.

  19. Click Install.
    The installation will get started and after a successful installation, the Installation Complete screen appears. 
  20. Click Finish to exit the setup wizard.
  21. 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 /wiki/spaces/T2/pages/1381635712 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


Please refer to the /wiki/spaces/T2/pages/1381635712section in case you face any error when installing Qualitia Server.