Header

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »

🔑Prerequisites:

  1. Privilege requirements:

    1. Use should have Localadmin and Sudo privileges to install the software. Before starting, ensure your computer meets the following hardware and software requirements:

  2. Installer File Size: Approximately 1.5 GB

  3. Server Hardware Requirements

    1. Processor: 2.0 GHz or faster

    2. RAM: 16 GB or higher

    3. Disk Space: 4 GB or more

  4. Software Requirements

    1. Operating System: Debian or Fedora-based Linux distribution

    2. Java: Java 8 (JRE 1.8) or higher

    3. .NET Framework: .NET Framework 4.6 or higher

    4. GIT 2.39.1

🔀 Workflow and Process

First time Installation of Qualitia Automation Studio-Server-9.0.4

  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.

Update Qualitia Automation Studio-Server-9.0.4

  1. Copy the installer file to the OPT location. You have two options:

    1. Copy and paste via interface.

    2. Copy and paste via terminal

      1. Navigate to the folder via command line by typing cd /opt/qualitia\ Automation\ Studio\ -\ Server/installerUpdates and press Enter

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

    3. For example, type or copy-paste “sudo cp home/localadmin/Downloads/9.1.5/QualitiaAutomationStudio- 9.1.5.tar.gz” and hit Enter.

  2. Once you have copied the file, launch the Qualitia Automation Studio portal.

  3. You will be notified about the update with the version number followed by the Update button.

  4. Click Update to start the update.

  5. You will see a popup message to continue the update.

  6. Click Continue to proceed with the update; otherwise, click Cancel.

  7. Upon Continue, you will be directed to a page where you can see that the Update in Progress.

  8. This update usually takes a minute.

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

  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 face any issue, feel free to reach out to your Qualitia Relationship Manager. For more resources, our official documentation and community website are just a click away!


  • No labels