Skip to main content

GNS

Follow these steps to monitor the network licenses of a GNS license server with OpenLM. The GNS license server comes from GNS mbH (Gesellschaft für numerische Simulation). It serves network licenses for GNS programs, such as Animator and Generator, and for CDH programs, such as CDH/SPOT and CDH/VAO. OpenLM Broker takes the program names from your license file, runs the GNS status tool licstat.exe once for each program, and reports the license total, the expiration date, and the users who hold a license to OpenLM SLM.

Note

OpenLM tested this integration with CDH/SPOT. Broker queries only the programs that the license file names, so check your own license file as described in Check the license server.

Requirements​

Before starting, make sure you have:

  • OpenLM SLM installed on a machine in your organization, or a Software License Management Cloud (SLMC) account.
  • OpenLM Broker v26.1.20.946 or higher on Windows, reporting to OpenLM SLM. Earlier Broker versions that list GNS as a license manager type report every license total as 0.
  • The GNS license server running, with the licenses that you want to monitor.
  • The status tool licstat.exe on the Broker machine. The license server installer lists it as its own component, License Server status tool.
  • The license file of the license server on the Broker machine. A default installation of license server v3.14e4 keeps it in C:\Program Files (x86)\GNS mbH\LicenseServer_v3.14e4, for example as spotlicense.dat for CDH/SPOT.

Install Broker on the license server machine, which holds both licstat.exe and the license file. The vendor's installation guide states that licstat.exe runs on any Windows machine, on the license server or on a client. A Broker on another machine needs the tool and a copy of the license file on that machine.

licstat.exe asks the license server on the Host of the Broker's License Managers page. A Broker on another machine needs Host set to the name of the license server machine, and that field applies to every license manager on the Broker.

Monitoring capabilities​

The current monitoring capabilities for GNS through OpenLM Broker are:

LM Type in the BrokerCommandsLogsQuantityExpiration dateDeniedBorrowingAllocationsReport resolution
GNSYesNoYesYesNoNoNoSeconds

For each program that the license file names, Broker reports:

  • Feature name: the program name from the license file, for example CDH-SPOT.
  • License total: the number of licenses that the license server holds for the program.
  • Expiration date: the date on which the license of the program expires.
  • Licenses in use: 1 for each user that holds a license of the program.
  • Vendor: GNS, or the vendor that you add on the Vendors tab.

For each license in use, Broker reports the username and the workstation that holds the license. Broker reports no start time, so OpenLM starts a session when Broker first reports the user.

Denied requests, borrowed licenses, and license allocations are not available.

How OpenLM interfaces with GNS​

Diagram: OpenLM Broker on a Windows machine reads the license file, runs licstat.exe once for each program to ask the GNS license server for the license total, the expiration date and the licenses in use, and sends the license data to OpenLM SLM, which you manage in EasyAdmin. How OpenLM collects GNS usage

Every 55 seconds, by default, Broker reads the license file, runs licstat.exe once for each program that the file names, and sends the result to OpenLM SLM. The report holds what the license server listed at the moment of the query.

Broker reads the license file again on every query, so a renewed license file at the same path counts from the next query.

Broker reads no log file of the GNS license server.

Check the license server​

Broker reports what licstat.exe returns for the programs of your license file, so run the tool by hand first:

  1. Open the license file in a text editor and find the program name, for example CDH-SPOT.

    If the file holds a license code only, with no program name, Broker has nothing to query.

  2. On the Broker machine, open a command prompt in the folder that holds licstat.exe.

  3. Run licstat.exe with the program name and the host name of the license server.

    licstat.exe CDH-SPOT gns01.example.com

    Use the program name as your license file writes it, and the host name of your license server machine.

  4. Confirm that the tool shows the number of licenses, the expiration date, and the users who hold a license.

    If the tool reports that it cannot connect to the license server, check that the license server service runs, for example spotserver for CDH/SPOT. If the tool connects only when you add the option -p with the port of the license server, note the port. You add the same option in Broker.

  5. Note the folder that holds licstat.exe, the full path of the license file, and the port of the license server if it has a fixed one.

    You enter them in Broker. For CDH/SPOT, the file spotport.dat in the license server folder sets a fixed port.

OpenLM Broker configuration​

Note

Install OpenLM Broker and confirm that it reports to OpenLM SLM before starting these steps.

  1. Open a browser on the Broker machine and go to the Broker web UI at http://localhost:5090/.

  2. On the License Managers page, check that Host shows the host name of the license server machine.

    Broker passes this name to licstat.exe, and OpenLM lists the license server under it. The field holds the host for every license manager on the page, not for GNS alone. If the field is empty or names another machine, enter the host name and select the save icon next to the field. Set Host before you add the license manager, because Broker writes the host name into the command when you add GNS.

  3. Go to License Managers → Add License Manager.

  4. From LM Type, select GNS.

  5. In Port, enter the port of the license server, for example 60000, and select Add.

    Broker and OpenLM identify the license manager by the host name and this port. If the license server has no fixed port, enter a number that no other license manager on this Broker uses.

    The Add License Manager dialog with LM Type set to GNS and port 60000 Add GNS as a license manager

  6. On the Settings tab, add the license file:

    1. Select Set license file path manually.
    2. Select Add license file path.
    3. In License file path, enter the full path of the license file, for example C:\Program Files (x86)\GNS mbH\LicenseServer_v3.14e4\spotlicense.dat, or select the search icon to browse to it.
    4. Select Continue.

    Add 1 license file path only. Broker reads the first file in the list and ignores the others. To monitor the programs of another license file, add another GNS license manager with its own port.

    The License file path dialog on the Settings tab, with the path of the license file spotlicense.dat Point Broker at the license file

  7. On the Commands tab, in Executable path, enter the folder that holds licstat.exe, for example C:\Program Files (x86)\GNS mbH\LicenseServer_v3.14e4.

    Broker puts this path in front of licstat.exe when you save.

  8. Check Data Inquiry under Periodic commands.

    The command names licstat.exe, the placeholder @feature@, and the host name. Broker replaces @feature@ with each program name of the license file, so leave the command as it is. Watch interval (sec) is 55. Leave Use the operating system start/stop commands off: Broker fills no Service name for GNS.

    If licstat.exe connected only with the -p option when you ran it by hand, add a space, -p, and the port number to the end of the command, for example -p 60000.

    The Commands tab of the GNS license manager with the Executable path, the periodic Data Inquiry command for licstat.exe, and Watch interval 55 The periodic Data Inquiry that runs licstat.exe

  9. (Optional) On the Vendors tab, select Add Vendor, enter the vendor name that you want OpenLM to show, for example CDH, and select Continue.

    Without a vendor, OpenLM shows GNS.

  10. Select Save.

  11. (Optional) To test the configuration, open the GNS entry again, select the Commands tab, and select Execute.

    The Execution Result dialog shows the report that Broker builds, with 1 FEATURE element per program and 1 USER element per license in use.

OpenLM SLM configuration​

Automatic configuration through EasyAdmin​

If the preceding steps are complete, Broker runs licstat.exe every 55 seconds, by default, and reports GNS to OpenLM SLM. Approve the license server in EasyAdmin:

  1. Open EasyAdmin (http://<Server IP>:5015) and go to Start → Widgets → License Manager - Servers.

  2. Select the There are N servers pending approval link at the top of the widget.

    The Administration - License Manager Servers window opens, with the pending entries at the top of the list.

  3. Find the pending GNS entry, with the host name and the port as configured in Broker, and select the edit icon at the end of its row.

    The entry has the Status Pending and the Display Name <port>@<host>. OpenLM SLM has no plugin for the GNS type, so its Type is OpenLM Generic, the protocol that Broker reports it with. The edit icon appears when you hover over the row.

    The Administration - License Manager Servers window with the pending GNS entry, Type OpenLM Generic, Source Broker, and the edit icon at the end of the row

  4. Optionally rename the connection in Display name, confirm the Host Name and Port, and select APPROVE.

    The PENDING LICENSE MANAGER page for the GNS entry, with Display name 60000@gns01.example.com, Type OpenLM Generic, Use Broker on, the host name, port 60000, and the APPROVE button

Manual configuration through EasyAdmin​

If automatic configuration fails:

  1. Go to Start → Administration → License Manager Servers.

  2. Select Add LM.

  3. In Display name, enter a name for the connection, for example GNS.

  4. From Type, select OpenLM Generic.

    Use Broker turns on.

  5. In the row under Host Name, Port, and Time Zone, enter the host name and the port exactly as configured in Broker for GNS, and select a time zone.

  6. Select SAVE.

Verify your configuration​

  1. Open EasyAdmin in your browser.

  2. Go to Start → Widgets → License Manager - Servers.

  3. Find the GNS license server and confirm that its Status is Up to date.

    Immediately after the approval, the status is Waiting for data from Broker. Quantity holds the license totals of all programs together, and Used the number of licenses in use.

    The License Manager - Servers widget with the GNS license server, Status Up to date, Type OpenLM Generic, Quantity 25, and Used 2

  4. In the row of the GNS license server, select the number in Quantity.

    The Licenses window opens with 1 row for each program, with Vendor GNS, the license total in Total, and the number of licenses in use in Used.

    The Licenses window with the 3 programs of the GNS license server, License Type Floating, and their Total and Used counts

  5. Select a program's number in Used to confirm that sessions arrived.

    The Currently Consumed Licenses window opens. Each license in use appears with its username and workstation. Start Time is the time when OpenLM first received the session.

    The Currently Consumed Licenses window with 2 sessions of the GNS license server, each with its username, feature, start time, and workstation

The Feature Usage Status widget lists only the features that you add through its filter, so the GNS programs do not appear there by themselves.

Troubleshooting​

The Broker log holds the detail for each of these problems, in the logs folder of the Broker installation.

If GNS never appears as pending in EasyAdmin, confirm that the Broker reports to OpenLM SLM: other license managers on the same Broker update in EasyAdmin.

If the Execution Result in the Broker UI shows GNS license file not configured, Broker found no license file. On the Settings tab, confirm that Set license file path manually is selected, that the list holds the path of the license file, and that the file exists at that path.

If the license server shows no programs, Broker read the license file but found no program name in it, so it had nothing to ask licstat.exe. Confirm that the path on the Settings tab leads to the license file that names your program, such as CDH-SPOT, and that this file is the first one in the list.

If every program shows a total of 0, Broker cannot run licstat.exe, or cannot read its answer, and it reports no error for that. Check these causes:

  • The Broker version: Broker versions earlier than v26.1.20.946 report every total as 0. Upgrade Broker.
  • The Executable path: on the Commands tab, Executable path must be the folder that holds licstat.exe.
  • The command: if someone edited the Data Inquiry command, select Restore Default on the Commands tab, then select Save. Broker recognizes the placeholder only as @feature@, in lowercase.
  • The license server: run licstat.exe by hand, as described in Check the license server. If the tool cannot connect, Broker has nothing to report.

If the expiration date is missing, check the language of Windows on the Broker machine. When it is not English, such as Japanese, Broker reports the license totals and the users, but no expiration dates. See Known limitations.

Known limitations​

  • Broker does not report denied requests, borrowed licenses, or license allocations. It reads no log file of the license server, such as spot_error.log, so usage in OpenLM starts when you configure the license manager.
  • Broker reports the licenses that are in use at the moment of each query, every 55 seconds by default. A session that starts and ends between 2 queries is not reported.
  • Each user that the license server lists for a program counts as 1 license in use.
  • Broker reports no start time. A session in OpenLM starts when Broker first reports the user, not when the user took the license.
  • Broker reads 1 license file for each GNS license manager. Add a GNS license manager, with its own port, for each license file.
  • A program name that contains a space is not supported. Broker reports such a program with a total of 0.
  • When the Broker machine runs Windows in a language other than English, Broker reports no expiration dates.
  • When licstat.exe does not run or returns no license data for a program, Broker reports the program with a total of 0 and no error.
  • Broker asks 1 license server host, the Host of the License Managers page. A redundant set of 3 license servers is not queried as a set, and Host is the same for every license manager on the Broker.
  • The Data Inquiry command names licstat.exe, the Windows status tool. OpenLM tested GNS with Broker on Windows.
  • OpenLM tested this integration with the license file and the licstat.exe output of CDH/SPOT on license server v3.14e4. If your GNS license server answers differently, contact OpenLM Support.

The documentation team might draft this page using a large language model. A technical writer reviews every page and verifies it against the product before publishing it. A human makes the final decision.