User Interface (UI) Overview

The Floating Server UI allows you to manage licenses efficiently. You can:

  • Activate and deactivate licenses (online, offline, air-gapped)

  • Trigger synchronizations with the License API

  • Update server configuration

  • Review users registered to licenses and features

Licenses Page

The Licenses page lists all licenses added to the server.

Key Actions

  • Add a license: Enter a license key or upload a license file.

To add a bundle license to a floating server:

circle-info

Ensure the License Type is set to Bundle. (See picture below)

To add a bundle license to a floating server, ensure that your bundle License Policy is configured for floating licenses. Specifically, set Offline Floating License = Yes to enable the license to function as a floating license on the server. (See picture below)

circle-info

With the release of Floating Server v2.1.0, product features are now fully visible for both individual Floating Licenses and Bundle Licenses.

  • Activate / Deactivate licenses:

    • Online: Uses the License API directly

    • Offline / Air-gapped: See Offline & Air-gapped Licensing below

  • View details: Inspect license status, expiry, features, and usage

  • See registered users: Click on a license to view users associated with that license and its features

  • Trigger a sync: Push local consumption data and pull updates (button located at the top right)

Offline & Air‑gapped Licensing

Use this page when the server cannot reach the License API directly.

  • Supports generating and uploading activation/deactivation files or codes for offline and air‑gapped environments

  • Starting from V2.1.0, this page supports the refreshing of offline licenses and bundles.

  • Refer to the respective endpoints for detailed workflows

Offline Refresh

circle-info

This offline update functionality was introduced in v2.1.0.

To update a license or bundle that has been added to the Floating Server using the offline method, follow these steps:

1

Open the license’s page on the platform.

2

Locate the refresh file

Find the refresh file under the Devices section.

3

Upload the refresh file

Upload this file using the corresponding form on the Floating Server.

Configuration Page

Adjust server-level settings that affect synchronization, connectivity, and other global options.

Periodic Synchronization

The server automatically synchronizes with the License API to maintain a consistent state.

During synchronization:

  • Sends local consumption data to the License API

  • Pulls license updates, including status, features, expiration dates, and usage limits

How to configure synchronization:

  • Set the Sync period on the Configuration page

  • Use Sync Data (top-right) to trigger a manual synchronization at any time

Using the Swagger Page

Before opening the Swagger UI, please make sure your local Floating Server instance is running.

You can access the Swagger interface here:

Swagger UI: http://localhost:8080/swagger/index.html

The Swagger interface allows you to test API endpoints directly.

Example: Adding a license

1

Fill the request

Fill out the required fields in the request body.

2

Execute the request

Click Execute.

3

Inspect the response

If successful, the server will return the appropriate response.

Authorization:

  • Look for the small lock icon 🔒 (or authorization icon) on the right side of the endpoint

  • Click it and provide your JWT token in the format:

Using CLI Instead of Swagger

After testing an endpoint in Swagger, you can switch to the command line interface (CLI):

  • Copy the equivalent curl command generated by Swagger (visible below the response section)

  • Paste it into your terminal to execute the same request

Last updated

Was this helpful?