---
title: GNS
description: Configure OpenLM Broker in OpenLM Version 26 to run the GNS status tool licstat.exe for each licensed program, and approve the GNS license server in EasyAdmin.
product: OpenLM Version 26 (legacy)
---

> **OpenLM Version 26 (legacy).** This page documents the legacy product, not OpenLM Platform.

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](#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)](https://www.openlm.com/documentation/legacy/slmc/index) 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 Broker | Commands | Logs | Quantity | Expiration date | Denied | Borrowing | Allocations | Report resolution |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| GNS | Yes | No | Yes | Yes | No | No | No | Seconds |

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

*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.

    ```text
    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/](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.

    *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.

    *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 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.

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

### 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.

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**.

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 **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](#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).

## 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.
