Document toolboxDocument toolbox

Upgrading Qualitia from 4.1.x to 4.1.6

Applying product updates will give you an enhanced experience of working with Qualitia Automation Studio for Web and Mobile.

If you are using Qualitia Automation Studio for Web and Mobile v4.1.x, you need to upgrade it to the v4.1.6 before you upgrade to the latest version. 

Prerequisites

  • Qualitia WebDriver 4.1.x.
  • It is strongly recommended to backup up Qualitia server databases (Master, Project, and Result Databases).
  • If your MySQL database server is installed on Linux machine, you must ensure that the values of column ProjectName and ProjectDBName names are in the lowercase under Master Project database in the table tblprojects. Entering project names in uppercase may cause failing upgrade process.
  • Ensure port 8889 is open and accessible from the machine where you are installing Qualitia Server.
  • If the number of projects to be upgraded is more than 50, you must increase the max_connections limit from MySQL database configuration settings. For more information about increasing the limit, refer to Qualitia Troubleshooting section.
  • Ensure you close all the instances of Qualitia Automation Studio and Internet Explorer before you start the upgrade process.
    (info) 
    If Qualitia Automation Studio is open, the upgrade process closes all the active Qualitia instances. If you have multiple Qualitia instances open, ensure you save the changes and close all the Qualitia instances before you start the upgrade process.

Upgrade Qualitia Server

Automatic Process

If you have installed Qualitia client on the same machine where Qualitia Server is installed, Qualitia intelligently picks up the upgrade packages, when available. Qualitia administrator has to log in to Qualitia client to initiate the automatic upgrade process.

To update Qualitia Server:

  1. Ensure you have the valid product license activated for Qualitia.
  2. Open the Qualitia Update Location defined when Installing Qualitia Server.
  3. Replace the content with Qualitia Product Update.
    (info) Once the Qualitia Update Package is placed on the designated location, Qualitia intelligently picks it up when logging on as an administrator user.
  4. Log on to the machine where you have installed Qualitia Server and log on to Qualitia Client as Qualitia Administrator user.
  5. Once you enter user credentials and click Log On, Qualitia informs the user that the next update is available.
  6. Do one of the following:
    • If you want to update Qualitia Server, click Yes.
    • If you want to ignore the update and continue working on the previous version, click No.
  7. It is recommended to use the updated product versions applying available product updates for seamless user experience.
  8. Once you click Yes, Welcome to the Qualitia Setup Wizard screen appears.
  9. Click Next.
    All the database server details appear.
  10. All these fields are displayed in non-editable mode, click Next.

    The Project Details screen appears.
  11. Click Next.
    The Confirm Installation screen appears.
  12. Click Install.
  13. Once installed successfully, click Finish to exit the setup.
  14. Install / Upgrade Qualitia Client on this machine.

Manual Process

If Qualitia client is not installed on the machine where Qualitia server is installed, you must run Setup.exe manually to upgrade server.  

To update Qualitia Server:

  1. Ensure you have the valid product license activated for Qualitia.
  2. Open the Qualitia Update Location defined when Installing Qualitia Server.
  3. Replace the content with Qualitia Product Update.
  4. Log on to the machine where Qualitia Server is installed and navigate to the Qualitia Update Location where you have kept the product update.
  5. Open Server folder.
  6. Right-click Setup.exe and select Run as administrator.
    The Welcome to the Qualitia Setup Wizard screen appears.
  7. Click Next.
    All the database server details appear.
  8. All these fields are displayed in non-editable mode, click Next.

    The Project Details screen appears.
  9. Click Next.
    The Confirm Installation screen appears.
  10. Click Install.
  11. Once installed successfully, click Finish to exit the setup.
  12. Install / Upgrade Qualitia Client on this machine.  

Upgrading Qualitia Client

Once the administrator has updated Qualitia Server, other Qualitia users can update respective clients.

To update Qualitia Client:

  1. Log on to the machine where you want to upgrade Qualitia client. 
  2. Close all the instances of Internet Explorer and do not open it during the installation process.
  3. Double-click the Qualitia icon.
    If the server is updated, Qualitia users (other than the Qualitia administrator) will get a notification about updating Qualitia Client.
    (warning) 
    Qualitia users will not get this notification if Qualitia Server is not updated.


  4. Once the installation process is completed, click Finish.