Applying Floating Licenses (Legacy File-Based) up to VirtServer 3.3.0

Important Notice for VirtServer Customers

Starting from ReadyAPI 3.62.0, VirtServer 3.29.0, and TestEngine 1.34.0, SmartBear Product Family has fully deprecated file-based licenses and transitioned to the ID-based SmartBear License Management (SLM) system. Any customers still using file-based licenses must complete their migration to SLM by September 30, 2025.

From October 1, 2025, existing and activated file-based licenses will continue to work for some time. However, SmartBear will no longer generate new file-based licenses or support activation and deactivation of file-based licenses in ReadyAPI, VirtServer, or TestEngine. All new and updated licenses are now issued in SLM only.

All technical support for file-based licenses has now ceased, and SmartBear no longer maintains the file-based licensing system. Any access or service issues will result in service disruptions that we will not be able to restore.

If you have not completed the process of migrating, contact your Account Manager or SmartBear representative today. Our teams are ready to assist you with smooth transition strategies. For additional support, log a request with our SmartBear Support.Migration Process

For more information and timelines, refer to the File-based License End-of-Support Policy page.

Important

This topic describes how to consume a floating license from Protection! Licensing Server 4 that is compatible with anyone using VirtServer 3.3.0.

A floating license allows running VirtServer on different computers, but each license can be used only on one computer at a time. To use a floating license, you must first install and set up a license server from which VirtServer will be able to check out a license.

Requirements

  • Important

    Before checking out a floating license on your machine, you need to install and configure the server on your computer or on some machine in your local network. See Configure License Server 4.x (Legacy) for details.

  • Your computer must have access to the license server. Make sure the firewalls and proxies in your network do not block the access.

  • If you access the floating license server through a firewall (for example, from a remote server or from home), you will need to open the port 443. Ask your system administrator for assistance, if needed.

Apply license

  1. Download the License Manager packaged application from the SmartBear website.

    Note

    The License Manager requires Java 12. You can use Java shipped with VirtServer or download the required version from https://jdk.java.net/archive/.

  2. Run the License Manager .bat (or .sh on Linux and macOS) file with the -s <serverIP>:<Port> option:

    • For example, if you use Java shipped with VirtServer, perform the following commands:

      cd <VirtServer directory>\jre\bin
      <path to license manager>\license-manager.bat -s 127.0.0.1:443
      
    • If you use Java installed in your operating system, perform the following command:

      license-manager.bat -s 127.0.0.1:443
      
  3. The License Manager will ask you what license information you want to check out. Enter 5 to apply the VirtServer license.

The License Manager will check out the license from the license server and apply it.

In case of an error

In case of an error, you will see a message explaining the problem. See Troubleshooting for information on typical issues and possible solutions.

If you are unable to solve the problem, contact our Support Team. We will be glad to help you.

See Also

Publication date: