Document toolboxDocument toolbox

Header

OV_Linux Installation Guide

Owned by Shruti Agrawal
Last updated: May 23, 2024
3 min read

🔑Prerequisites:

Here’s a list of hardware and software requirements before you can get started.

Hardware Requirements

  1. Processor: Intel Core i5 64-bit or Equivalent server processor and above

  2. RAM: 16 GB or higher  

  3. Disk Space: 500 GB or more (SSD), 10 GB or more for /opt folder, and 10 GB or more for /tmp folder 

Software Requirements

  1. Operating System: 64-bit version of RED HAT 9.0 or later. 64-bit Ubuntu 22.04 LTS or later.

  2. GIT: 2.39 or above

Privileges Required

Local Administrator privileges (for installation of Qualitia Server)

Communication Ports TCP (Inbound)

The following list indicates the communication ports for each component:

8889: Qualitia License Service

8887: Qualitia Web Service

🔀 Workflow and Process

First time Installation of Qualitia Automation Studio-Server-9.x.x

  1. From the terminal type tar–xzvf ./QualitiaAutomationStudio-9.0.4.tar.gz

  2. In the terminal window, you will see the following files are extracted. This process usually takes less than a minute.

    1. Qualitiainstaller.sh

    2. QualitiainstallerAssets.tar.gz

    3. Qualitiauninstaller.sh

    4. Settings.yaml

  3. Once extracted, open the folder Qualitia Automation Studio-Server-9.0.4.

  4. You will see these four files:

    1. Qualitiainstaller.sh

    2. QualitiainstallerAssets.tar.gz

    3. Qualitiauninstaller.sh

    4. Settings.yaml

  5. Go to the Settings.yaml file.

    1. Find the attribute QUALITIA_SERVER_PORT.

    2. 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.

    3. Look for the attribute called ReportAssetsPath.

      1. Its default value is blank.

      2. 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.

      3. Save the file.

  6. After updating the QUALITIA_SERVER_PORT and ReportAssetsPath, open the terminal again.

  7. Go to the QAS9.x folder by using this command in the terminal “cd QualitiaAutomationStudio-9.0.4” and hit Enter.

  8. Once you are in the folder, enter this command - ./QualitiaInstaller.sh and hit Enter.

  9. This will extract the package. This process should take a minute.

  10. When prompted for the localadmin password, enter the admin password.

  11. Installer will verify or validate:

    1. Whether this is an update or a fresh installation

    2. Git

    3. Settings

  12. 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>

  13. 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.

  1. You can view the status of attribute Active as active (running).

  2. You can check the folders under folder.

 

💡 Golden Nuggets: Best Practices for Linux Installation

  1. Privilege check: Ensure you have Localadmin and Sudo privileges on your OS before attempting the installation process.

  2. Correct extraction command: Use the correct command tar -xzvf ./QualitiaAutomationStudio-9.0.4.tar.gz to extract the installation files without errors.

  3. 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.

  4. Terminal navigation: Carefully navigate to the correct folder in the terminal using the "cd" command before executing the installation script.

  5. Enter the correct password: When prompted for the localadmin password during installation, enter the correct password to avoid issues.

  6. 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.

  7. 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!

  1. 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 installation.

  2. Extraction issues: If you encounter problems while extracting the installation files using the command tar -xzvf ./QualitiaAutomationStudio-9.0.4.tar.gz, 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.

  3. 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

If you have questions that are not addressed in the documentation, you may raise them here in the Qualitia Community.

 

Footer