Get a Floating License Seat in Private Network

Applies to ReadyAPI 3.52, last modified on April 18, 2024

This page is related to the new SmartBear ID-based licenses that we’ve introduced in ReadyAPI 3.8.1.
In this version, we included support for SmartBear-hosted ID-based (online) licenses. Furthermore, in version 3.40.0, we added support for on-premise hosted and offline ID-based licenses.

About

SmartBear offers a special license type – offline – that can be used on computers that have no access to the SmartBear license servers. The word offline means the license is controlled by the licensing subsystems on your side, not by SmartBear license servers available online.

To use a Floating offline license, you can install the On-Premises License Server in your network. ReadyAPI running on user workstations will connect to this server and consume license seats from it. Below is a step-by-step instruction on this. If you are a licensed user (the person who will run and use ReadyAPI), you will need assistance from your license administrator to perform some steps.

1. License administrator actions

  • Log in to the SmartBear Licensing Portal as a license administrator.

  • Download, install, and configure the On-Premises License Server in your network. This will be your local Licensing Portal and separate from the SmartBear Licensing Portal which will have access to the internet.

  • Your license must have no users assigned in order to be converted. Unassign any users before requesting conversion.
  • To download, click on ‘Export License to On-premise License Server’.

    Export licene Onprem

    Click the image to enlarge it.

  • If you do not have On-Premise License Server installed, follow instruction and click on ‘download’ or download from here.

    Export licene Onprem

    Click the image to enlarge it.

  • Once installed, go to http://localhost:40892/#.

  • License administrator logs in and selects ‘Add License’ in On-Premises License Server.

    slm onprem server

    Click the image to enlarge it.

  • Copy server fingerprint data to clipboard.

    copy server fingerprint

    Click the image to enlarge it.

    copy server fingerprint success

    Click the image to enlarge it.

  • License administrator goes to the SmartBear Licensing Portal and exports license to Onprem License Server.

    export license slm onprem

    Click the image to enlarge it.

  • License administrator uploads server fingerprint to the SmartBear Licensing Portal and downloads License File.

    download slm license

    Click the image to enlarge it.

  • License gets exported.

    slm license exported

    Click the image to enlarge it.

  • License administrator uploads the license file to On-Premises License Server.

    add license onprem server

    Click the image to enlarge it.

  • License administrator selects Add License.

    slm license added

    Click the image to enlarge it.

  • License administrator either assigns user to license or shares license by a link from the On-Premise License Server so user can click and accept the license assignment.

    slm assign license

    Click the image to enlarge it.

    slm license link

    Click the image to enlarge it.

    slm on prem license sharebylink

    Click the image to enlarge it.

  • User clicks on the link to accept license.

    slm onprem license accept

    Click the image to enlarge it.

  • User will return to ReadyAPI and the license will be activated.

For more information on these steps, see the SmartBear Licensing Portal documentation.

Note that the On-Premise License Server can handle multiple SmartBear licenses. If you already have it in your network, you can skip the downloading, installation, and configuration steps, and deal with converting and activating the license.

2. User actions

  • Start ReadyAPI

  • Go to Help > License Manager

    ready license manager

    Click the image to enlarge it.

  • Click Install License.

    Ready Install License

    Click the image to enlarge it.

  • Select License from Server. ReadyAPI will invoke the following dialog box:

    Offline Float Request

    Click the image to enlarge it.

  • Enter the Server IP and Port (request from your License Administrator).

  • Enter the IP address and port of the On-Premise License Server, for example:
    http://192.168.1.20:40892

    40892 is the default port number. If you run ReadyAPI on the computer, where this License Server is installed, you can use localhost as the computer name. In other words, the address will look like http://localhost:40892.

  • Click Finish to connect to the specified License Server and consume a license seat from it. User should have accepted the license already or it should have been assigned by the license administrator.

  • Further actions depend on how your On-Premise License Server is configured. To configure the On-Premise License Manager, you can use either LDAP or OIDC.

    You may need to enter your domain user name and password, or ReadyAPI can try authenticating you by using your Windows account automatically (that is, ReadyAPI will not ask for any credentials). Ask the On-Premise License Server administrator about the server settings configured.

    slm configure access

    Click the image to enlarge it.

    To know about how to configure on-premise license manager, refer to this page

Note

An offline Floating license is bound to the computer, where the On-Premise License Server is running, not to user machines.

To release a license on a user computer, simply close ReadyAPI.

See Also

ReadyAPI – Licensing in Private Networks

Highlight search results