Document toolboxDocument toolbox

Header

(v1) License Management

Qualitia Automation Studio (QAS) offers multiple license server management system to easily scale your operations.

🌟 Core Features:

QAS supports a multiple license server management system. This feature not only simplifies the activation, assignment, and deactivation of licenses, but also enables efficient server management for streamlined and successful automation testing operations.

  • 🔐 Agile and Efficient License Management: The multi-license server management system is designed with flexibility and efficiency in mind. It facilitates easy activation, deactivation, and deletion of licenses, ensuring swift adaptation to changing requirements.

  • 🚀 Adaptable and Scalable License Solutions: QAS accommodates the expansion of your testing needs with ease.

Scenarios

There are two scenarios in which you may be activating License.

  1. Local License: This is used to activate the QAS license installed in the system you have logged in where the server is also installed.

  2. External Server Licenses: This is used to activate the license for a server that is not installed in the current machine.

When managing licenses, you may encounter the following scenarios:

  1. Activate license on a new installed server.

  2. Manage Licenses (about to expire or expired or deactivate)

If QAS Server has multiple registered licenses, when a Qualitia Automation Studio Client attempts to interact with a server, the following will occur:

  • Look for list of existing license servers registered with QAS Server.

  • Look for seat availability in the first server.

  • If no seat is available or license is expired, it will switch to the next installed license server.

Register External License Server to Qualitia Portal

🔀 Online License Activation - Local and External

🔑Prerequisites:

  1. A Windows or Linux server

  2. Installed Qualitia Automation Studio: This is required to manage and use the licenses.

  3. Internet Connection: This is needed for online license activation and deactivation. For offline mode, you'll need a machine with internet access to generate and retrieve the required activation and deactivation files from the Cryptlex portal.

Before we start, ensure your computer meets the following hardware and software requirements:

Activate License - Online

  1. Login to QAS server.

    1. You will land of the Setup page.

  2. Head to License Management screen.

  3. Select Online in the License Activation Mode.

  4. In the License Key for Qualitia Server text box, paste the license key that was shared with you by the Qualitia’s Support team.

  5. Click Activate License.

    1. You will see the license information, which indicates the license is activated.

🔀 Offline License Activation - Local and External

🔑Prerequisites:

Before we start, make sure your computer meets the following requirements:

  1. Installed Qualitia Automation Studio: This is required to manage and use the licenses.

  2. Visual C++ 2015: Ensure that Visual C++ 2015 is installed on the machine where the Qualitia License service will be installed.

Activate License - Offline flow

  1. Login to QAS - server.

    1. You will land on the Setup screen.

  2. Head to the License Management screen.

  3. Select Offline in the License Activation Mode.

  4. Enter the License Key for Qualitia Server and click Generate Request to download a request file.

  5. A request file named qualitia_offline_activation_request.txt will get downloaded.

  6. You can see a new field Response File.

  7. Copy the content in qualitia_offline_activation_request.txt file.

  8. Now, browse to Cryptlex portal.

  9. Locate and click the license key for which you want to make the offline activation.

  10. Click Activations on top right of the screen.

  11. Then, click Offline Activation on top right.

  12. Paste the copied content (in the step 7) in the field Offline Activation Request.

  13. Click Activate.

  14. Now, click Download Response button to download the response file.

    1. A response file named offline_response<dynamic key>.dat gets downloaded.

  15. Copy the downloaded file.

  16. Paste it in the server where you are activating the local or external (as per the context) Server License.

  17. Then, go the Qualitia Server Portal.

  18. Click Upload next to the Response File field to upload the response file (offline_response <dynamic key>.dat).

  19. Click Activate License.

    1. You will see the license information, which indicates the license is activated.

 

Based on the Server you wanted your QA to connect, provide them with the IP address and Port of the server.

Deactivate License – for Servers with Online activation.

  1. Login to Qualitia Automation Studio server.

  2. You will be directed to the Setup page.

  3. Head to the License Management page.

  4. Navigate to the License you wanted to deactivate.

  5. Click Deactivate License.

  6. Clicking Deactivate License will ask you for a conformation.

    1. Click Deactivate to proceed. Otherwise, click Don’t Deactivate.

  7. Once deactivated, you’ll get a success message Qualitia License is Deactivated.

The License Management page will now show the starting page with option to activate the license, which you may use to activate the license again, at a later point.

Deactivate License – for Servers with Offline activation.

  1. Login to Qualitia Automation Studio server.

  2. You will be directed to the Setup page.

  3. Head to the License Management page.

  4. Navigate to the License you wanted to deactivate.

  5. Click Deactivate License

  6. You will be shown a confirmation screen.

    1. Click Deactivate to deactivate.

    2. Click Don’t Deactivate if you have accidentally clicked.

  7. A file qualitia_offline_deactivation_request.txt will get downloaded.

  8. Copy the contents of the file.

  9. Go to Cryptlex Portal.

  10. Locate and click the license key you wanted to deactivate.

  11. Click Activations button on top right.

  12. You will see the list of all the hosts.

  13. Click Offline Activation button on top right.

  14. Click Deactivation tab.

  15. Paste the context in the text box Offline Deactivation Request.

  16. Click Deactivate to remove the entry from the Cryptlex portal.

💡 Golden Nuggets: Best Practices for License Management

When it comes to managing licenses in Qualitia Automation Studio, a strategic approach can improve efficiency and prevent issues down the line. Here are some best practices to consider:

  1. License Distribution: Distribute licenses based on client and project needs, but always retain a small buffer for unexpected requirements.

  2. Track Usage: Keep a close eye on license usage, ensuring that licenses are being used efficiently and are not lying dormant.

  3. Maintain Validity: Monitor the validity of licenses to prevent unexpected expirations that could disrupt operations.

  4. Online vs Offline: Choose the mode of license activation (online or offline) based on your server's internet connectivity and requirements. If internet connectivity is not available at the time of activation, then offline mode is a good alternative.

  5. License Deactivation: For offline scenarios, always remember to deactivate from Cryptlex portal as well.

  6. Regular Reviews: Conduct regular reviews of license allocation and usage to optimize license management.

🔧 Got a trouble? Let’s fix!

  1. If you are unable to activate a license, check if the license key is correct and if the server has internet access (for online activation).

  2. If offline activation is unsuccessful, ensure the generated request file content is properly copied to the Cryptlex portal, and the downloaded response file has been correctly uploaded to the Qualitia Automation Studio.

  3. Verify Service:

    1. Navigate to the machine where License Service is installed.

    2. Look for Qualitia License Service named qualitia-license-service for which the status should be Running.

    3. If the service is in Stopped status, try restarting the service.

  4. If a client is unable to connect to the license server, confirm the IP address and the server port. Also, ensure the server has a license available for leasing.

  5. If you encounter an issue when deactivating a license, ensure the correct deactivation file is uploaded to the Cryptlex portal (for offline deactivation).

  6. If you encounter an issue when deactivating a license, ensure a stable internet connection (for online deactivation).

  7. If any of the Qualitia Automation Studio Client is throwing a License Not Reachable check whether Qualitia License Service is running and is active. Additionally, check if the IP address and Port are correct and reachable.

  8. When user is unable to login, check:

    1. If Qualitia Server is reachable.

    2. If Qualitia License Server is reachable.

    3. User has input the correct credentials.

    4. You have the limit and validity.

  9. When workspace is moved from one machine A to another machine B, the local server license activation will have to be redone. If the external license server is not reachable (or is on a different network domain) from Machine B, then you should make it reachable or reregister new license server if required (if on a different network domain).

📞📚 Here to Help: Support and Resources

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


Footer