Floating Licenses in Private Networks

Last modified on August 5, 2022.

About

Right after purchase, your Floating license is controlled by the SmartBear licensing servers available on the Web. We call these licenses online ones.

To use a Floating license in a private network, you need to install an On-Premise License Server in that network, export the license to this On-Premise License Server, and activate it there. See below for details.

After the activation, the license will be controlled by the On-Premise License Server running on your side. We call these licenses offline ones. To assign and release license seats, you will use the On-Premise Licensing Portal. You can revoke the license and convert it back to an online one at any time.

Prerequisites

In your private network, you will need a computer with access to the Web. It is needed to exchange data with the Licensing Portal. This can be a computer, on which you install the On-Premise License Server, or any other one.

1. Request an offline license

By default, offline licensing and using the On-Premise License Server is off. To turn these features on, send a request to your Sales Representative at SmartBear. They will update our database to enable these features for you.

You can continue after you receive confirmation from your Sales Representative. If the features are enabled, you will see the Export License ... button for your Floating license on the SmartBear Licensing Portal:

Exporting a Floating license

Click the image to enlarge it.

2. Download and install the On-Premise License Server

1. Download the License Manager

Option 1
Option 2

You can also download the On-Premise License Server installer from the Export License wizard (see below).

2. Install the On-Premise License Server

The installation of the License Manager is a pretty straightforward procedure. The important steps are the ones where you specify the user name and password of the Administrator user, and the port on which the License Manager will function. Make sure to remember or write down these values. If you need detailed explanation, expand the steps below.

Installation steps

3. Export your Floating license to the On-Premise License Server

1. Download the On-Premise License Server fingerprint

  1. You start on the On-Premise License Server. After you’ve installed it, the installer opens the On-Premise Licensing Portal – http://localhost:40892 – in a browser:

    The Login dialog of the On-Premise License Server Portal

    Click the image to enlarge it.

    You can open this page any time later. The URL is <license-server>:<port>, where license-server is the IP address or name of the computer, on which the License Manager is installed, and port is the port number you specified during License Manager installation (40892, by default).

  2. Log in to the On-Premise License Server using the administrator user name and account (you specified them during installation):

    Logging in to the On-Premise Licensing Portal

    Click the image to enlarge it.

  3. In the Portal, click “+” at the top-right or click Add License (this button is visible in case you have not added any licenses to the Portal yet):

    Adding a license

    Click the image to enlarge it.

    The following dialog box will appear:

    Add License dialog

    Click the image to enlarge it.

  4. In the dialog, click Download to download the License Manager’s fingerprint file, or copy the fingerprint data to the clipboard. The fingerprint data has encoded info on the License Manager computer hardware.

    Copy fingerprint data

    Click the image to enlarge it.

    Important: keep the dialog box open.

2. Export the license

  1. Now, open the SmartBear Licensing Portal webpage in your browser:

    https://manage.smartbear.com

    If your local License Manager’s computer has access to the Internet, you can do this right on it. Else, do it on another machine that has access to the Web.

    If you have not yet logged in to the SmartBear Licensing Portal, use your license administrator account for logging in.

  2. In the SmartBear Licensing Portal, find your Floating license and click Export License:

    Start license export

    Click the image to enlarge it.

    This will invoke the following dialog box:

    The Export License dialog
  3. In the dialog, upload the fingerprint file you got on your On-Premise License Server or insert the file content into the dialog:

    Upload the fingerprint file
    Note:

    To activate the “content insertion” mode, click the insert its content link in the dialog:

    The 'insert its content' link
  4. After you uploaded the fingerprint file, the Portal will generate a file with the license data. Download this file and copy it to the On-Premise License Server computer:

    Download the license data file

3. Activate the license on the local license server

  1. Now, return to the On-Premise Licensing Portal. Upload the license file in the Add License dialog or insert the file content there:

    Activate offline Floating license - Final step

    Click the image to enlarge it.

    Note:

    To activate the “content insertion” mode, click the insert its content link in the dialog:

    The 'insert its content' link
  2. Click Add License to activate the license on the server.

Now your Floating license is bound to the On-Premise License Server and you can assign license seats to users.

Next steps

  1. Assign license seats to users. See –

    Assign Licenses to Users

  2. Configure your SmartBear product

    When users start their SmartBear product, they need to specify the On-Premise License Server as the license server. Then, depending on the License Manager settings, they may need to enter their domain user name and password. The dialogs they see depend on the product. For more information, see documentation on your SmartBear product:

Note

The activated offline Floating license is controlled by the On-Premise License Server and is bound to the License Server’s computer. To move a license to another computer, you have to free it on the current machine first and return it back to the SmartBear Licensing Portal. For more information on this, see Return Licenses Back.

See Also

Activate and Use Licenses
License Types

Highlight search results