A new version of Qualitia Automation Studio 7.2.x is now available. We highly recommend you upgrade. Find more details here.
Upgrade Process
For more information about new features released in the newer version of Qualitia, please refer to the Release Notes section.
Qualitia supports upgrade from v3.14. In case you are using prior version of Qualitia WebDriver, please upgrade to v3.14 first and then upgrade to Qualitia for Web and Mobile v4.1.6.
In order to optimize execution performance for non-browser test cases, Qualitia now launches the browser only on the OpenURL action. This might cause failing test cases with any browser-based actions used before OpenURL in 4.1.x and above.
Qualitia users must use the browser-based actions such as MaximizeBrowser and so on after the OpenURL action.
Upgrading Qualitia from 3.14 to 4.1.6
Prerequisites
In order to upgrade to the latest version, you need to set up an environment.
- Qualitia WebDriver v3.14.
- It is strongly recommended to back 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.
- Identify a File Server and create a folder to keep all the Qualitia Installables. This File Share will be used by Qualitia to apply any future upgrades / update packages. It is mandatory that all the Qualitia users should have Read Access to this folder.
Make sure you are pointing to the correct database server when upgrading to the higher version of Qualitia. Pointing to an incorrect database may result in data loss.
Upgrading Qualitia Server
When upgrading to a new version of Qualitia, you must first ensure that you have taken a back up of your Qualitia databases. Upgrading Qualitia includes upgrading the Qualitia server and client.
To upgrade Qualitia Server:
- Open the folder on the Flie Server where you have kept Qualitia Installable.
Open the Server folder.
Executing Setup.exe from file server may take longer time. Therefore, it is recommended to copy Setup.exe in the local temporary folder.
- Double-click Setup.exe.
The Welcome screen is displayed. - Click Next.
- As you are already using previous version of Qualitia, system will notify to upgrade to the latest version. Click OK.
Enter Database server details.
Fields
Description
Database Type
Select the database type (MySQL or MSSQL) from the drop-down list.
Server
Enter the Host Name or IP Address of the Qualitia database server.
Port
Enter the Port number of the Qualitia database server.
Default is 3306 for MySQL and 1433 for SQLServer.
Database Name
Enter the master database name.
Authentication
(for SQLServer only)
Select authentication mode.
SqlServer Authentication: Login with SQL Server user account (Enter User ID and Password)
Windows Authentication: Login with Windows account.
User ID
Enter the database server user ID.
Password
Enter the database server password.
In MySQL this database user ID should have Grant All privileges on the database.
In SQL Server this database user ID should have DBO privileges on the database.
- Click Next.
A Project Details screen is displayed with all the existing list of projects. Click Next.
The Qualitia Update Location screen is displayed.Qualitia update location is the network shared location in the file server where Qualitia will look for update packages. For details please refer to the Prerequisites section above.
- Enter the details as follows:
Fields
Description
Server
Enter the location where Qualitia will check for server updates.
Client
Enter the location where Qualitia will check for client updates.
- Click Next.
The Confirm Installation screen is displayed. - Click Install.
The installation will get started and after a successful installation, the Installation Complete screen is displayed. - Click Finish to exit the setup wizard.
If you get any error during upgrade, refer to the Troubleshooting section.
Upgrading Qualitia Client
This activity should be done once the Qualitia Server is updated.
To upgrade Qualitia client:
- Refer to the prerequisites section for Qualitia Client before upgrading Qualitia Client.
- Open the folder on Flie Server where you have kept Qualitia Installable.
Open the Client folder.
Executing Setup.exe from file server may take longer time. Therefore, it is recommended to copy Setup.exe in the local temporary folder.
- Double-click Setup.exe.
System will ask for permission to run the application, click Yes.
If you have not uninstalled the previous version of Qualitia, system will uninstall it with prior notification.
The Qualitia Installer screen is displayed.
- Once you have reviewed Qualitia License Agreement, select Yes, I accept the terms…, and then click Next.
- Once installed successfully, click Finish.
You can now start working with Qualitia. - To launch Qualitia, double-click the Qualitia icon on your desktop.
If you get any error during upgrade, refer to the Troubleshooting section.
Upgrading Qualitia from 4.1.x to the Latest Version
Applying product updates will give you an enhanced experience of working with Qualitia Automation Studio.
Prerequisites
- Qualitia WebDriver 4.1.x.
- It is strongly recommended to back 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.
Upgrading Qualitia Server
Qualitia administrator user has to initiate the update process applying server updates logging on to the Qualitia Administrator account.
To update Qualitia Server:
- Open the Qualitia Update Location defined when Installing Qualitia Server.
- Replace the content with Qualitia Product Update.
Once the Qualitia Update Package is placed on the designated location, Qualitia intelligently picks it up when logging on as an administrator user. - Log on to Qualitia as an administrator user.
- Once you enter user credentials and click Log On, Qualitia informs the user that the next update is available.
- 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.
It is recommended to use the updated product versions applying available product updates for seamless user experience.
- Once you click Yes, Welcome to the Qualitia Setup Wizard screen appears.
- Click Next.
All the database server details appear. - All these fields are displayed in non-editable mode, click Next.
The Project Details screen appears. - Click Next.
The Confirm Installation screen appears. - Click Install.
- Once installed successfully, click Finish to exit the setup.
Upgrading Qualitia Client
Once the administrator has updated Qualitia Server, other Qualitia users can update respective clients.
To update Qualitia Client:
- Double-click the Qualitia icon.
If the server is updated, Qualitia users (other than the administrator) will get a notification about updating Qualitia Client.
Qualitia users will not get this notification if Qualitia Server is not updated. - Once the installation process is completed, click Finish.