5. Licensing: Floating Licences and Licence Server

This chapter answers common questions about floating (network) licences: setting up the LM-X licence server, configuring clients, moving the server, borrowing licences and troubleshooting connection problems. Items that apply only to the legacy OLicense server are collected at the end.

5.1. Concepts and Setup

5.1.1. How do floating licences work, and how do they differ from single-user licences?

A single-user (node-locked) licence is installed on one computer and is valid for one user. A floating licence is installed on a licence server in your network and shared by several users:

  • A floating licence with N seats allows at most N users to work with UniPlot at the same time. Seats are not bound to named users. Any user whose PC can reach the licence server can take a free seat.

  • A seat is taken when UniPlot starts and returned when UniPlot is closed. The number of UniPlot instances is not limited, only the number of concurrent users.

  • The licence server cannot restrict individual licences to separate user groups and has no setting to release a seat after a period of inactivity. If you need separate user groups, use separate licence servers, each with its own licence file.

  • UniPlot needs a connection to the licence server while it runs. If you work outside the company network, either connect through VPN or borrow a licence beforehand (see How can I use a floating licence offline, for example on a business trip?).

  • The licence file of a floating licence is installed only on the licence server. Individual users do not receive a licence file.

See also: Dialog Box=>License.

5.1.2. How do I set up a floating licence server and get the server licence file?

A floating licence consists of the licence key, the licence server software on a server PC, and a server licence file created for that server. You need:

  • a server PC that all client PCs can reach and that is running whenever users need UniPlot (physical or virtual machine),

  • administrator rights on the server PC,

  • the installer of the licence server, named like TOPEXPERT license server <version>.exe, supplied by UniPlot support. Use the LM-X server version supplied for UniPlot. A different LM-X version can cause the error Err: 49 LM-X security configuration file mismatch,

  • client PCs with UniPlot installed. For UniPlot the client licensing software (a setup file named like Licensing20ii_jj.exe) has to be installed manually on every client, and administrator rights are needed on the clients to configure the client licence service.

The installation has five steps:

  1. Install the licence server on the server PC (How do I install the LM-X licence server?).

  2. Create the host ID file LmxHostid.txt on the server PC (How do I create the host ID file LmxHostid.txt?).

  3. Send LmxHostid.txt and your licence key to UniPlot support. State whether the server is physical or virtual and give a contact e-mail address. If an e-mail system blocks the attachment, send it zipped. You receive a server licence file with the extension .lic.

  4. Import the licence file on the server and check that it is served (How do I import the licence file on the LM-X server and check that it is served?).

  5. Connect the clients to the server (How do I tell UniPlot on a client PC where the licence server is?).

The licence file is bound to the host ID of the server and to the licence key.

5.1.3. How do I install the LM-X licence server?

Run the installer TOPEXPERT license server <version>.exe on the server PC with administrator rights. After the installation:

  • The Windows start menu contains the group X-Formation with the entries LM-X Configuration Tool, LM-X End Users Guide, LM-X License Server Client, Start LM-X license server and Stop LM-X license server.

  • The installation folder (for example C:\Program Files (x86)\FEV GmbH\TOPEXPERT license server <version>) contains the server lmx-serv.exe, its configuration file lmx-serv.cfg, the log file lmx-serv.log, the tools lmxconfigtool.exe and lmxendutil.exe and LicserverClient.jar.

Do not run the server setup on client PCs.

5.1.4. How do I create the host ID file LmxHostid.txt?

A unique identification of the server is needed to create the licence file. Create it on the machine that will run the licence server, not on a client:

  1. Start the LM-X Configuration Tool (lmxconfigtool.exe in the installation folder of the licence server).

  2. Open the tab HostID. It lists the host IDs of the network adapters and of the hard disk of the system.

  3. Click Save To File and save the host ID information in the text file LmxHostid.txt.

  4. Send the file to UniPlot support together with your licence key.

The host ID used for the licence is derived from the MAC address of a network adapter of the server. If the server has several network adapters, see The licence server shows no licence after a reboot or network change: Err: 10 HostID does not match license.

LmxHostid.txt is needed only for floating (server) licences. If your key is a single-user licence, install UniPlot directly on the PC and send the licence request file created by UniPlot instead (see How do I activate a single-user (node-locked) licence after installing UniPlot?).

5.1.5. How do I import the licence file on the LM-X server and check that it is served?

  1. Copy the .lic file into a known folder of the server.

  2. Open the file lmx-serv.cfg in the installation folder of the licence server with an editor and add the path of the licence file in the LICENSE_FILE line, for example LICENSE_FILE = d:\server\network.lic. To activate a line of the file, remove the # character at its beginning. The file names must be lowercase. You can specify several paths.

  3. Start the server with Start > X-Formation > Start LM-X license server. If the server is already running, stop it with Stop LM-X license server and start it again.

  4. Check that the licences are served: start the LM-X Configuration Tool, open the tab Query License Server, enter localhost as host and 6200 as port, and click Perform. The served licences are listed with their start and expiry date. The text There are no licenses served by the license server means that the server did not load a licence file (see The licence server reports 0 licences or licence type “Grace”).

5.1.6. I bought a floating licence. Do I need to send a request file from each client?

No. A request file is needed only for single-user (node-locked) licences. For a floating licence the licence file is imported on the licence server, and the UniPlot clients fetch a licence from the server while they run. A request file created on a client PC cannot activate a floating licence.

If UniPlot shows the licensing window with the request button although your company uses a floating licence, it cannot reach the licence server (see UniPlot suddenly asks for a licence file or shows the licensing window although it worked before). Do not send a new request in this case. A company can use both licence types at the same time, so check which type your key is.

5.1.7. What is the difference between the OLicense server and the LM-X licence server?

Two licence server generations exist:

  • LM-X licence server (current, supplied as “TOPEXPERT license server”): licence file .lic, host information exchanged as LmxHostid.txt, default port 6200 (TCP and UDP), log file lmx-serv.log, usage monitored with the LM-X License Server Client and the LM-X tools. The clients are configured in the licence manager.

  • OLicense server (legacy): licence file .xml, port 81 recommended in the installation guide, clients configured with the file lic-server, controlled with the OLicense control program or a web browser.

The licence file must match the server type. The two are not interchangeable. If you installed the wrong server, uninstall it and install the server that matches your licence file. Items that apply only to the legacy server are collected in Legacy OLicense Server.

5.1.8. Can the licence server run on a virtual machine, a Linux server or a server with other applications?

  • Virtual machine: yes. Tell UniPlot support when requesting the licence file that the server is virtual. Make sure the MAC address of the virtual machine does not change, otherwise a new licence file is needed.

  • Linux: a Linux LM-X server is possible. Ask UniPlot support for the Linux package. Create the host ID file on the Linux machine and send LmxHostid.txt to receive the .lic file. The UniPlot client itself runs on Windows. The LM-X command line tools you use for monitoring must not be newer than the server. A newer client tool reports New client version is newer than the license server version. Please update license server to a more recent version.

  • Terminal server: UniPlot works through RDP and Citrix. The licence server can be the terminal server itself or another server.

  • Other applications on the same host: the licence server needs its port (default 6200) to be free.

5.1.9. Can I set up a backup licence server? What happens when the server is not available?

A floating licence is created for one specific host ID, so a second server cannot run the same licence.

As a safety net, LM-X keeps a grace licence on the client after a successful checkout from the licence server. The grace licence is valid for 168 hours (7 days); the licence parameter GRACE is given in hours. When the server is unreachable or not running, UniPlot can continue on this client with the grace licence until it expires or the server is available again. A grace licence exists only on a client that has obtained a licence from the server before; a PC that has never used UniPlot with this server gets no grace licence. UniPlot also warns before it shuts down when the connection to the server is lost (see UniPlot shows “Connection to license server lost. The application will shut down in … minutes”. What does it mean?). For planned offline work, borrow a licence instead (see How can I use a floating licence offline, for example on a business trip?).

5.2. Client Configuration

5.2.1. How do I tell UniPlot on a client PC where the licence server is?

With the LM-X licence server the client is configured in the licence manager that is installed with the client licensing software. Administrator rights are required.

  1. Start the licence manager of your release from the Windows start menu (group FEV GmbH, entry Licensing <release>). The window TOPEXPERT license manager opens.

  2. Click Configuration. In the dialog Server configuration enter the name or IP address of your licence server in the field Server and the port in the field Port (default 6200), then click Save. Leave Include local license checked if the PC also uses a local licence file.

  3. Check the status: click the TOPEXPERT logo and select UniPlot, select the UniPlot entries and check that the status is Valid. With a floating licence the licence type Network is shown, and the status line shows the server and port.

After the server information is saved, UniPlot requests a licence from the licence server whenever it is started. The port must be the port configured on the licence server. If UniPlot is installed on a file server and started from workstations, the workstations need read access to the UniPlot folder and all its subfolders. If you use the legacy OLicense server, the client is configured with the file lic-server instead (see OLicense: how do I configure UniPlot on a client PC?).

5.2.2. After installing UniPlot with a floating licence, an unreadable error message appears and UniPlot closes. What is missing?

UniPlot does not know where the licence server is. The message contains garbled symbols, you can only click OK, and UniPlot then closes. Typical causes:

  • LM-X server: the licence server is not configured or configured wrongly in the licence manager of this PC (see How do I tell UniPlot on a client PC where the licence server is?), or the server cannot be reached because of the network, a firewall or VPN.

  • OLicense server: the file lic-server is missing in the Program folder of the new installation, or it was saved with a file extension. Copy it from the Program folder of a working older installation, or create it again (see OLicense: how do I configure UniPlot on a client PC?).

  • The licence file has not yet been imported on the server.

The same symptom can appear when the connection to the licence server is interrupted while UniPlot is running. Check the connection and restart UniPlot.

5.2.3. After installing a new UniPlot release with a floating licence I get a licence error, but the old release works. Why?

A new installation does not necessarily know your licence server. Check the following:

  1. LM-X server: install the client licensing software for the new release if required, start its licence manager and check Configuration (see How do I tell UniPlot on a client PC where the licence server is?).

  2. OLicense server: copy lic-server from the Program folder of the working installation (for example C:\Program Files\UniPlot Software\R2024\Program) into the Program folder of the new release.

  3. Check that the licence server is running and reachable.

  4. Restart UniPlot.

If the message License expired or a message that the licence cannot be verified appears, also check that the installed release is covered by the licence file on the server. See UniPlot shows “0 days remaining” or “License expired” with a valid floating licence.

5.2.4. How can I check whether my installation uses a floating licence or a local licence?

Start the licence manager of your release. With a floating licence the licence type Network is shown and the status line shows the server and port. A single-user licence works without a server connection and uses a licence file for the Windows user (see How do I install the licence file (.lic) that I received?). With the legacy OLicense server, UniPlot fetches its licence from the server if the file lic-server exists in the Program folder of the installation and contains a server address. The licence usage shown by the licence server shows whether your PC takes a seat.

5.3. Server Administration and Migration

5.3.1. How do I move the licence server to a new PC?

The licence file is bound to the host ID of the server, so a new PC, a new operating system installation or a changed network adapter needs a new licence file.

  1. Install the LM-X licence server software on the new PC (see How do I install the LM-X licence server?).

  2. Create LmxHostid.txt on the new PC (see How do I create the host ID file LmxHostid.txt?) and send it with your licence key to UniPlot support. State whether the new server is physical or virtual.

  3. The old server licence must no longer be used. Ask UniPlot support what is needed to release it, and stop the old server with Stop LM-X license server.

  4. Install the new .lic file on the new server (see How do I import the licence file on the LM-X server and check that it is served?) and check that the licence is served.

  5. If the server name or IP address changed, update the server configuration in the licence manager of every client.

If only the host name or IP address changes and the host ID (MAC address) stays the same, the existing licence file remains valid. The firewall rules of the server may be reset after a host name change, so allow the LM-X server application and port again.

5.3.2. How do I update the LM-X licence server to a newer version?

The new version can be installed in parallel to the existing version. The existing licence file can be used with the new version.

  1. Save the configuration file lmx-serv.cfg of the current server. It contains the path of the licence file in the LICENSE_FILE line. Save the licence file.

  2. Install the new version of the licence server with the installer TOPEXPERT license server <version>.exe.

  3. Configure the new server like the old one in its lmx-serv.cfg. The existing licence file is used; the log file name may be adapted to the new version.

  4. Stop the old server with Stop LM-X license server, then start the new server with Start LM-X license server. Make sure that the programs of the respective installation are used. It can be safer to start the programs directly from the installation folder than from the start menu group X-Formation.

5.3.3. The licence server shows no licence after a reboot or network change: Err: 10 HostID does not match license

The server log shows WARNING: Feature ... is ignored: (Err: 10) HostID does not match license. The host ID of the server no longer matches the host ID in the licence file, and UniPlot finds no licences on the server.

The LM-X host ID is derived from the MAC address of a network adapter. It changes when the adapter that is used changes, for example after NIC teaming, a virtual adapter (such as a remote-access tool), a multi-port network card, a Windows update that reorders the adapters, or a change of the virtual machine.

Fix:

  1. Remove or disable network adapters that are not needed. Ideally keep only one. Remove NIC teaming or use one port.

  2. Create a new LmxHostid.txt on the stabilised server and send it with the licence key to UniPlot support.

  3. Replace the old licence file in the path set in lmx-serv.cfg and restart the LM-X server.

On Linux servers check which network interface is first.

5.3.4. How do I install a new, renewed or extended licence file on the LM-X server?

You do not need to reinstall the server. A new licence file replaces the previous one and contains the total number of seats. When seats are added, you receive one file for the total number, not an additional file.

  1. Replace the licence file in the path set in LICENSE_FILE in lmx-serv.cfg (or change the path to the new file) and remove the old file.

  2. Restart the server: stop it with Start > X-Formation > Stop LM-X license server, close all LM-X windows and start it again with Start LM-X license server.

  3. Check with the tab Query License Server of the LM-X Configuration Tool that the new start and expiry dates and the number of seats are shown.

If the server still reports Feature expired, it is still using the old file. Check the LICENSE_FILE setting. Downloading UniPlot from the web site gives you only the latest software. It does not change the number of seats.

5.3.5. Why does my floating licence file contain no END date?

A perpetual licence has no END= field in the LM-X licence file. Time-limited (lease) licences contain an END date. The same file contains values such as COUNT (number of seats), BORROW and GRACE (both in hours, 168 means 7 days). Expiry monitoring based on END= therefore finds nothing for a perpetual licence. Query the licence server instead (see How can I see how many floating licences are in use and who uses them?).

5.3.6. The licence server reports 0 licences or licence type “Grace”

The server cannot validate the licence normally, so clients run with a grace licence. Check on the server:

  1. The .lic file exists at the path set in LICENSE_FILE in lmx-serv.cfg and the path has not changed.

  2. The server log lmx-serv.log does not show Err: 10 (see The licence server shows no licence after a reboot or network change: Err: 10 HostID does not match license) or Err: 49 (see How do I set up a floating licence server and get the server licence file?).

  3. A firewall does not block the LM-X server application and port 6200.

  4. The LM-X license server is running. Stop it and start it again.

5.3.7. How can I see how many floating licences are in use and who uses them?

  • Start LM-X License Server Client from the start menu group X-Formation. It needs Java, because it runs LicserverClient.jar from the installation folder; if the start menu entry does not work, open a command window and run java -jar "<installation folder>\LicserverClient.jar". Enter the licence server URL with port, for example http://localhost:6200 on the server or http://<server>:6200 on any other PC with the LM-X software. The tabs show the dashboard, the licence usage and the log file, which you can also download.

  • The tab Query License Server of the LM-X Configuration Tool lists the licences served by a server.

  • From the command line, query the server with lmxendutil -licstat -host <server> -port <port>. Use the version of the tool that matches the server version.

  • The server log lmx-serv.log in the installation folder shows the start-up messages and warnings of the server.

When all seats are in use, additional users cannot start UniPlot until a colleague closes it. Borrowed licences count as in use until they are returned.

5.4. Connection Problems and Error Messages

5.4.1. UniPlot cannot connect to the licence server. What should I check?

Work through this checklist:

  1. Server running: the LM-X license server is started and the licence file is loaded (see How do I import the licence file on the LM-X server and check that it is served?).

  2. Address and port: the server name or IP address and the port in the Server configuration of the licence manager are correct (default port 6200). With the legacy OLicense server check the file lic-server instead.

  3. Network: from the client, open a command window and ping the server. Make sure that ping is not blocked by the firewall of the server. Test with the host name, the fully qualified name and the IP address. In the LM-X Configuration Tool of a client PC, the tab Query License Server with the name of the server and port 6200 shows whether the server answers. Leave the host field empty to search for servers automatically.

  4. Firewall: the LM-X server uses port 6200 for TCP and UDP. Open both ports and allow the LM-X server application on the server. If UDP is blocked, the log shows Windows firewall blocks UDP port 6200 - automatic server discovery might not work.

  5. VPN and proxy: check that the VPN allows traffic to the server and port, and check the proxy settings. A sporadic licence error although the server is reachable is often caused by an unstable VPN.

  6. Key: the client was installed with the floating key. A key of an older server causes a mixed configuration. Reinstall with the correct key and update the configuration.

  7. Scope: find out whether all users or only a few are affected.

5.4.2. UniPlot suddenly asks for a licence file or shows the licensing window although it worked before

With a floating licence, the licensing window appears when UniPlot cannot reach the licence server.

  1. Check the network connection. If you are not in the office, connect the VPN. Make sure the VPN stays connected.

  2. Restart UniPlot after the connection is restored. After a short server outage a restart is sufficient.

  3. Do not send a new licence request. None is needed for a floating licence.

  4. If the problem persists, ask the licence administrator or IT to check the server and the firewall.

5.4.3. UniPlot shows “Connection to license server lost. The application will shut down in … minutes”. What does it mean?

UniPlot lost the connection to the floating licence server, for example because of a network, VPN or server problem. The error message shows the remaining time as minutes:seconds. When this time has elapsed, UniPlot closes.

  1. Save your work immediately.

  2. Re-establish the connection: check the VPN and the firewall, and check that the licence server is running.

  3. Restart UniPlot if it has closed.

If UniPlot closes by itself during data exchange, an unstable connection to the licence server is the most likely reason. If UniPlot closes unexpectedly, the autosave function keeps the changes of the open document. On a laptop, also check the power and network adapter settings that put the network connection to sleep.

The length of the countdown is not a UniPlot setting. It is set by the licensing component.

5.4.4. UniPlot shows “0 days remaining” or “License expired” with a valid floating licence

A licence file is valid for specific UniPlot releases. A new release is covered only if the licence file on the server includes it. If the server file was replaced by a file for a newer release, an older UniPlot release may report 0 days remaining as soon as the previous file expires. Install the UniPlot release that matches the licence, or ask UniPlot support for a file that includes your release.

Also check that the client knows the licence server (see After installing a new UniPlot release with a floating licence I get a licence error, but the old release works. Why?).

5.4.5. UniPlot or the licence manager shows “Invalid TOPEXPERT configuration”

The message Invalid TOPEXPERT configuration (Operation ‘Startup’ can not be executed) can appear after installing the client licensing software or after Windows updates.

  1. Uninstall UniPlot and the client licensing software.

  2. Install the runtime prerequisites supplied by UniPlot support, then reinstall UniPlot and the client licensing software and reboot.

  3. Download the installers again to exclude corrupt files.

  4. If other products with a licence manager (for example TOPexpert or xCal) are installed, check that the installed licence manager version does not conflict.

If the error persists, send the complete exception text and the UniPlot version to UniPlot support.

5.5. Borrowing and Offline Use

5.5.1. How can I use a floating licence offline, for example on a business trip?

You can borrow (check out) a licence from the licence server for a limited time. UniPlot then runs without a connection to the server. Without borrowing, UniPlot asks for a licence as soon as the connection to the licence server is lost and the grace licence has expired (see Can I set up a backup licence server? What happens when the server is not available?).

  1. Borrow the licence while the PC is connected to the licence server (network or VPN). Start the licence manager of your release, select the UniPlot licences you need and click Borrow…. Choose until when you need the licence.

  2. Test offline operation before you travel.

  3. When you no longer need the licence and the licence server is reachable again, start the licence manager, select the licence and click Return borrowed. The licence is then available to your colleagues again. It also returns automatically when the borrow period ends.

While a licence is borrowed, one seat less is available to your colleagues. Closing UniPlot in online mode returns the seat immediately. The server cannot withdraw a seat from an idle UniPlot session.

For a PC that is permanently offline, a single-user licence is the alternative. For the legacy OLicense server see OLicense: how do I check out a licence for offline use?.

5.5.2. How can I change the maximum borrow period or the number of licences that can be borrowed?

Both limits are part of the licence file (BORROW in hours, and the number of licences that may be borrowed) and cannot be changed on the server. Ask UniPlot support for a new licence file with the desired maximum period and quantity and install it as described in How do I install a new, renewed or extended licence file on the LM-X server?. Always use a time limit and a limited quantity, because a licence borrowed for an unlimited period is not available to other users until it is returned.

5.6. Legacy OLicense Server

The items in this section apply only if you still run the legacy OLicense server (licence file .xml, port 81 recommended). The current LM-X server is described in the other sections.

5.6.1. How do I install the legacy OLicense server and import the licence file?

  1. Run the OLicense server setup on the server PC and accept the defaults. Open the control program OLicense-Server-Control (OLicenseServerCtrl.exe).

  2. Set the port in the tab Server-INI-File: insert the line -port=81 below the comment //-port=8080 and click Save. Port 81 is recommended in the installation guide.

  3. Exit the control program and start it again as administrator. In the tab Start/Stop click Install as Service. After some time the control program shows Server is running on port 81 (Service mode).

  4. To create the licence file, UniPlot support needs the MAC address (physical address) of the server, which you find with the command ipconfig /all. If the server has several network cards or is virtual, send the log file named like OLXXXXXX.txt from the installation folder of the OLicense server instead.

  5. Save the licence file you receive on the server. In the tab License Import select the file with the button ... and click Import License File Now. A message such as License ... accepted confirms the import.

  6. Check the server in a browser: http://localhost:81. The View Licenses button shows the number of available and used licences.

5.6.2. OLicense: how do I configure UniPlot on a client PC?

Create a plain text file named lic-server without any file extension in the Program folder of the UniPlot installation (for example C:\Program Files\UniPlot Software\<version>\Program). Use Notepad or another plain text editor, not Microsoft Word. The file contains the server name or IP address, a colon and the port number, for example servername:81. Make sure that Windows does not append .txt. If UniPlot is installed on a file server and started from workstations, the workstations need read access to the UniPlot folder and all its subfolders.

5.6.3. OLicense: how do I check out a licence for offline use?

The licence is checked out from the server to the PC with a local OLicense installation. The checkout must be allowed on the server first.

  1. On the server open the browser front end (Open Browser Frontend in the control program) and click Administer Licenses. Click Edit in the column check out, enter the maximum number of days in max runtime (days) and the number of licences in max floats, and click Change this license now. The row {alle} applies to all servers; the value -1 in max runtime disables the checkout.

  2. On the user PC install the OLicense server software (as for the server), open its browser front end, enter the address of the licence server with port in the field License Check In/Out and click Check Out Licenses. Select the licence and click Check out the selected licenses now. View Licenses shows that the licence is now available on the PC.

  3. Change the content of the file lic-server in the Program folder of the UniPlot installation to the address that is shown in the browser of the local OLicense server (for example 127.0.0.1:81) and start UniPlot. UniPlot can be used for the number of days for which the licence was issued.

  4. To return the licence early, connect the PC to the network again, click Check In Licenses, select the check box in the column change and click Change the selected licenses now. Then change lic-server back to the address of the main server.

5.6.4. OLicense: error 454 or “OIComm 452 request cannot find hostname”, UniPlot closes after 5 minutes

Typical message: The connection to OLicense-Server failed. Check the address settings of the computer on which OLicense-Server is running. Check proxy and firewall settings. UniPlot shows a warning and closes after about 5 minutes.

  1. In the Program folder of the UniPlot installation, check that the file lic-server exists and contains the correct server and port, for example servername:81.

  2. Copy the content of lic-server into a browser on the client. If the licence server page opens, the server can be reached.

  3. If it does not open, check that the OLicense service is running, that the server IP address has not changed, and that firewall, VPN and proxy allow the connection. The server application olicenseserver.exe must be allowed through the Windows firewall.

  4. Check that the licence file is still loaded on the server. A licence that was unloaded cannot be reloaded without a new file.

  5. In some cases a reinstallation of the OLicense server with administrator rights fixes a suddenly failing server.

5.6.5. OLicense: importing the licence XML file fails

Reported causes and solutions:

  • Port: the OLicense server should run on port 81. A different port caused import errors.

  • File dialog: set the file type filter to All Files so the .xml file becomes visible. Rename a downloaded file and remove suffixes such as (3).

  • Wrong MAC address: a new file is required. Delete the old file and tell UniPlot support.

  • Virtual server: the host ID of a virtual server carries the suffix _V. This is required for virtual machines.

  • Parse error: license fatal parse error in line 12 col 15, letter is expected means that the registered company name contains a special character such as &. Request a new file with a name without special characters.

  • Persistent errors: uninstall the OLicense server, reinstall it and repeat the import (only possible when no licences are in use).

Once a licence file has been unloaded from the server, it cannot be activated again. Request a new file.

5.6.6. OLicense: the server does not start, the web page is not reachable or the database is full

  • After reboot or Windows update: make sure the server is installed as a Windows service that starts automatically. Run OLicenseServerCtrl.exe as administrator and use Install as Service in the tab Start/Stop. Test with localhost:81 in a browser on the server and check with netstat that the port is in use. If the port is not listened on, use another free port, or uninstall the server completely (installation folder and registry entries), reboot and reinstall.

  • Web page works only without the port in the URL: correct the port setting in the tab Server-INI-File of the OLicense control program and restart the service.

  • Failed to open database - Mapping error. MapViewOfFile failed, Error = 487: the licence database reached its size limit of 1 GB. Stop the service, back up the database file, obtain an empty database from UniPlot support, point OLicenseServerDB.ini to it, start the service and import the licence file again. The licence history is lost, which does not affect operation.

id-991269