🔑Prerequisites:
Privilege requirements:
Should have Localadmin and Sudo privileges to install the software.
Before we start, make sure your computer meets the following hardware and software requirements:
Installer File Size: Approximately 1.5 GB
Server Hardware Requirements
Processor: 2.0 GHz or faster
RAM: 16 GB or higher
Disk Space: 4 GB or more
Software Requirements
Operating System: Debian or Fedora-based Linux distribution
Java: Java 8 (JRE 1.8) or higher
.NET Framework: .NET Framework 4.6 or higher
GIT 2.39.1
🔀 Workflow and Process
Install the Qualitia Automation Studio-Server-9.0.4 for the first time
From the terminal type tar–xzvf ./QualitiaAutomationStudio-9.0.4.tar.gz
In the terminal window you will see the following files are extracted. This process usually takes less than a minute.
Qualitiainstaller.sh
QualitiainstallerAssets.tar.gz
Qualitiauninstaller.sh
Settings.yaml
Once extracted, open the folder Qualitia Automation Studio-Server-9.0.4.
You will see 4 files:
Qualitiainstaller.sh
QualitiainstallerAssets.tar.gz
Qualitiauninstaller.sh
Settings.yaml
Go to the Settings.yaml file.
Find the attribute - QUALITIA_SERVER_PORT.
Default port is 8887. If you prefer to change it to a different port, update the port number. Ensure the port number is updated within the single quotes.
Look for the attribute called ReportAssetsPath.
Default value is blank.
If you prefer to update the path, update it within the single quotes. If the folder path is specified, the assets will be created in that path.
Save the file.
After updating the QUALITIA_SERVER_PORT and ReportAssetsPath, open the terminal again.
Go to the QAS9.x folder by using this command in the terminal - “cd QualitiaAutomationStudio-9.0.4” and press Enter.
Once you are in the folder, enter this command - ./QualitiaInstaller.sh and press Enter.
This will extract the package and this should take a minute.
When prompted for the localadmin password, enter the admin password.
Installer will verify or validate:
Whether this is an update or a fresh installation
Git
Settings
Once the installation is completed, the Qualitia Automation Studio Server portal will open in the default browser configured in your server. This page is shown for first-time installation. <Screenshot>
The portal confirms that the installation is successful.
👁️🗨️ Verify installation
From the terminal, you can check the status of the service by entering the command - systemctl status Qualitia-web.service and enter.
You can view the status of attribute Active as active (running).
You can check the folders under folder.
Update Qualitia Automation Studio-Server-9.0.4
Copy the installer file to the OPT location. You have two options:
Copy and paste via interface.
Copy and paste via terminal
Navigate to the folder via command line by typing cd /opt/qualitia\ Automation\ Studio\ -\ Server/installerUpdates and press Enter
Once you are in the folder, enter if you have not copy pasted the installer using interface you can do via terminal by providing ‘sudo cp’ followed by the file location and press Enter.
Example: sudo cp home/localadmin/Downloads/9.1.5/QualitiaAutomationStudio- 9.1.5.tar.gz and press Enter.
Once you have copied the file, launch the Qualitia Automation Studio portal.
You will be notified about the update with the version number followed by the Update button.
Click Update to start the update.
You will see a pop-up message to continue the update.
Click Continue to continue with the update or if you wish to cancel the update click Cancel.
Upon clicking continue, you will be directed to a page where you can see that the Update in Progress.
This update usually takes a minute.
Refresh the page after a minute, you can view the Qualitia Automation Studio server portal with the updated version number.
👁️🗨️ Verify installation
From the terminal, you can check the status or health of the services by entering systemctl status qualitia web service. You can view the status next to the attribute Active: active (running).
💡 Golden Nuggets: Best Practices for Linux Installation
Privilege check: Ensure you have Localadmin and Sudo privileges on your Mac before attempting the installation process.
Correct extraction command: Use the correct command "tar -xzvf ./QualitiaAutomationStudio-9.0.4.tar.gz" to extract the installation files without errors.
Custom settings: Before running the installation script, review and update the settings in the Settings.yaml file, such as the QUALITIA_SERVER_PORT and ReportAssetsPath, as needed.
Terminal navigation: Carefully navigate to the correct folder in the terminal using the "cd" command before executing the installation script.
Enter the correct password: When prompted for the localadmin password during installation, enter the correct password to avoid issues.
Verify installation: After the installation is complete, use the "systemctl status qualitia web service" command in the terminal to check the status of the services and confirm a successful installation.
Keep software updated: Regularly update your software to ensure you are using the latest features, improvements, and bug fixes.
🔧 Got a problem? Let’s fix!
Incorrect privileges: If you do not have Localadmin and Sudo privileges, you may face issues during the installation process.
Remedial Step: Request for the necessary privileges before attempting to install the software.Extraction issues: If you encounter problems while extracting the installation files using the "tar -xzvf ./QualitiaAutomationStudio-9.0.4.tar.gz" command, the installation process may not proceed.
Remedial Step: Double-check the command you've entered and ensure the file path is correct. If the issue persists, try downloading the installation files again.Service status: If you are unable to verify the installation or the services are not running as expected, you may need to check the service status.
Remedial Step: Use the "systemctl status qualitia web service" command in the terminal to check the status of the services. If the services are not running, try restarting them or contact the software support team for assistance.
📞📚 Here to Help: Support and Resources
Need a helping hand? Don't hesitate to reach out to your Qualitia Relationship Manager. For more resources, our official Qualitia documentation and community website are just a click away!