---
title: CADMATIC
description: Configure OpenLM Broker in OpenLM Version 26 to read the web interface of CADMATIC License Server 2.0, monitor CADMATIC license usage, and approve the 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 CADMATIC licenses with OpenLM. CADMATIC License Server is a Windows service that serves the licenses of CADMATIC products, such as CADMATIC Hull, to the computers on your network. It also publishes a web page that lists the licenses in use and the licenses still free. OpenLM Broker requests that page on a schedule and reports the licenses, their totals, and the users who hold them to OpenLM SLM.

## 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.7.8.1247 or higher, installed on a Windows or Linux machine that reaches the license server over HTTP, and reporting to OpenLM SLM. Earlier Broker versions do not list **CADMATIC** as a license manager type. Use v26.9.16.1403 or higher, so that a user who holds several licenses arrives in OpenLM as 1 user, each session carries its workstation, and no sessions are lost when the 2 tables on the page disagree.
- CADMATIC License Server 2.0, which runs as the Windows service **CADMATIC License Server 2.0**. Broker reads the layout of the version 2.0 web page.
- The HTTP TCP/IP port of the license server, which serves its web interface. The default is `2998`. The License TCP/IP port, `2999` by default, serves license requests, and Broker does not use it.
- A web interface that opens without a username and password. Broker does not sign in to it.

## Monitoring capabilities

The current monitoring capabilities for CADMATIC through OpenLM Broker are:

| LM Type in the Broker | Commands | Logs | Quantity | Expiration date | Denied | Borrowing | Allocations | Report resolution |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| CADMATIC | Yes | No | Yes | Yes | No | No | No | Seconds |

From the **Available Licenses** table of the web page, Broker reports each application as a feature:

- **Feature name**: the **Application** column, for example `Hull Structure`.
- **Total**: the **Perpetual + Term** column.
- **In use**: the total minus the **Free** column. When the **Reserved Licenses** table has rows for the application and their number differs, Broker reports the number of rows. See [How OpenLM interfaces with CADMATIC](#how-openlm-interfaces-with-cadmatic).
- **Version**: the **Versions** column without the part in parentheses, so `26(+1)` becomes `26`.
- **Expiration date**: the **License expiration date** at the top of the page. Broker reports the same date for every application.
- **Vendor**: `CADMATIC`, unless you add a vendor on the **Vendors** tab in Broker.

From the **Reserved Licenses** table, Broker reports each row as a session that holds 1 license:

- **Username**: the **User** column. When CADMATIC adds a counter to the name, such as `jsmith (+1)`, Broker removes it, so all the rows of 1 user arrive as that user.
- **Workstation**: the **Host** column.
- **Start time**: the **Login Time** column, to the second.

Broker versions before v26.9.16.1403 keep the counter in the username and report no workstation. Broker ignores the **Version** column of this table. The page holds no denied requests, borrowed licenses, or license allocations, so they are not available for CADMATIC.

## How OpenLM interfaces with CADMATIC

*How OpenLM collects CADMATIC usage*

Broker requests the web page of the license server over HTTP and sends the license data to OpenLM SLM. The integration works like this:

- **Commands:** A new CADMATIC license manager gets 2 commands with the same web address:

    ```text
    http://{$host}:{$port}/index.html
    ```

    In the Broker UI, each command line shows the **Host** from the **License Managers** page and the port of the license manager in place of `{$host}` and `{$port}`. **Data Inquiry**, under **Periodic commands**, runs every 55 seconds by default. It sends an HTTP `GET` request to the address and reads the page that comes back. **Status**, under **On-demand commands**, holds the same address and does not run on a schedule.

- **Page:** Broker reads the license expiration date and 2 tables. In this example, `jsmith` holds 2 **Hull GUI** licenses and 1 **Hull Structure** license:

    ```text
    License expiration date : 31.12.2026

    Reserved Licenses (3)
    Host      Application     Version         User          Login Time
    WS-1001   Hull GUI        2025T2R1 (26)   jsmith        Tue Oct 27 08:12:31 2026
    WS-1001   Hull Structure  2025T2R1 (26)   jsmith        Tue Oct 27 08:12:40 2026
    WS-1001   Hull GUI        2025T2R1 (26)   jsmith (+1)   Tue Oct 27 09:47:05 2026

    Available Licenses
    Application     Free  Perpetual + Term  Versions
    Hull GUI        8     10                26(+1)
    Hull Structure  4     5                 26
    ```

    Broker reports **Hull GUI** with a total of 10 and 2 licenses in use, both held by `jsmith` on `WS-1001`.

- **Sessions:** Broker reports the licenses that are reserved when the data inquiry runs, each with its **Login Time** as the start time. A license that is checked out and returned between 2 data inquiries does not reach OpenLM.
- **In-use count:** In Broker v26.9.16.1403 and higher, when the number of rows for an application in **Reserved Licenses** differs from its total minus **Free**, Broker reports the number of rows as the licenses in use. The 2 tables can differ for a moment when a license is checked out or returned while the license server builds the page. An application with no rows in **Reserved Licenses** keeps the count from **Available Licenses**.
- **Time zone:** Broker reads **Login Time** in the time zone of the Broker machine and converts it to UTC.
- **Log files:** None. Broker reads no CADMATIC log file, so the **Log Files** tab stays empty.

## Prepare the CADMATIC License Server

Broker reads the same page that a web browser shows at the data inquiry address. Before you configure Broker, check that the page opens from the machine where Broker runs:

1. Find the HTTP TCP/IP port of the license server.

    You set it on the **TCP/IP Ports** page when you installed CADMATIC License Server. The default is `2998`.

2. On the Broker machine, open a web browser and go to `http://<license server>:<port>/index.html`, for example `http://cadmatic01.example.com:2998/index.html`.

    The page shows the **Reserved Licenses** and **Available Licenses** tables.

3. If the page does not open, check that the firewalls on the license server and on the route between the 2 machines let the Broker machine reach the HTTP TCP/IP port.

    CADMATIC License Server needs both of its ports free and unblocked: `2999` for license requests and `2998` for the web interface, by default.

4. If the browser asks for a username and password, Broker can't read the page. See [Known limitations](#known-limitations).

For more about the web interface, see [License server's web interface](https://docs.cadmatic.com/hull/Content/License_Server_new/manage_web_interface.htm) in the CADMATIC documentation.

## OpenLM Broker configuration

:::note
Install OpenLM Broker and confirm that it reports to OpenLM SLM before starting these steps. Broker can run on the license server machine or on another machine that reaches the web interface.
:::

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

    OpenLM lists the license server under this host name, and Broker builds the address of the web page from it when you add the license manager. The field holds the host for every license manager on the page, not for CADMATIC alone.

    - **Broker on the license server machine:** if the field is empty, enter the host name of the machine and select the save icon next to the field.
    - **Broker on another machine:** if the field is empty, enter the host name of the license server and select the save icon. If it names another machine, leave it as it is, and enter the license server's host name in the commands in step 6 instead.

3. Go to **License Managers** → **Add License Manager**.

4. From **LM Type**, select **CADMATIC**.

5. In **Port**, enter the HTTP TCP/IP port of the license server, `2998` by default, and select **Add**.

    Broker requests the web page on this port, so don't enter the License TCP/IP port, `2999`. If another license manager on this Broker already uses the port, Broker shows `Port already exists`.

    *Add CADMATIC as a license manager*

6. On the **Commands** tab, under **Periodic commands**, select **Data Inquiry**, and check the command line in the large text box.

    It reads `http://<Host>:<port>/index.html`, with the **Host** from step 2 and the port from step 5. If **Host** names a machine other than the license server, replace the host name in the command line with the license server's host name, for example `http://cadmatic01.example.com:2998/index.html`. Make the same change to **Status**, under **On-demand commands**.

    *The Data Inquiry command requests the web page of the license server*

7. Leave **Watch interval (sec)** at 55 seconds, or set the polling interval that you want. **Timeout (sec)**, 60 seconds by default, limits how long Broker waits for the license server to answer.

8. Leave the **Vendors** and **Log Files** tabs empty. Add a vendor only if you want OpenLM to show a vendor name other than `CADMATIC`.

9. Select **Save**.

## OpenLM SLM configuration

### Automatic configuration through EasyAdmin

If the preceding steps are complete, Broker runs the data inquiry every 55 seconds, by default, and reports CADMATIC 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 CADMATIC entry, with the host name and the port that you configured in Broker, and select the edit icon at the end of its row.

    Broker reports CADMATIC with the OpenLM Generic protocol, so its **Type** is **OpenLM Generic**.

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 `CADMATIC`.
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 CADMATIC, 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. Confirm that the CADMATIC license server shows the **Status** **Up to date**.
4. Go to **Start → Widgets → Feature Usage Status** and confirm that each application from the **Available Licenses** table shows its total in **Quantity** and the licenses in use in **Used**.
5. Go to **Start → Reports → License Activity**, select **Include Current Activity**, and select **Apply**. Confirm that each row of **Reserved Licenses** appears with its username and workstation.

## Troubleshooting

If CADMATIC 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 license server is approved but shows no applications or no usage, test the data inquiry in the Broker UI. Open the CADMATIC license manager, go to the **Commands** tab, select **Data Inquiry**, and select **Execute**. A successful test returns the license server XML, with a `FEATURE` element for each application and a `USER` element for each session. Broker refuses **Execute** on a license manager that you have never saved, and answers `Need to save first in order to execute command`.

If the test fails or returns no `FEATURE` elements, open the address from the command line, for example `http://cadmatic01.example.com:2998/index.html`, in a web browser on the Broker machine:

- **The page does not open:** Broker can't reach the license server either. Check the host name and the port in the command line, check that the port is the HTTP TCP/IP port and not `2999`, and check the firewalls between the 2 machines.
- **The browser asks for a username and password:** Broker can't sign in to the web interface. See [Known limitations](#known-limitations).

If the page lists users for an application that shows no usage in OpenLM, check that the application appears in **Available Licenses** with the same name. Broker skips a row of **Reserved Licenses** whose application is missing from **Available Licenses**.

If OpenLM shows 1 person as several users, such as `jsmith`, `jsmith (+1)`, and `jsmith (+2)`, upgrade Broker to v26.9.16.1403 or higher.

If session start times in OpenLM are off by whole hours, compare the time zone of the Broker machine with the time zone of the license server. Broker reads **Login Time** in the time zone of the Broker machine.

The Broker log holds the detail, in the `logs` folder of the Broker installation. The periodic data inquiry writes to `port-<port>-CADMATIC.log`, for example `port-2998-CADMATIC.log`. These messages show the cause:

- `HTTP request failed`, in Broker v26.9.16.1403 and higher: Broker can't reach the address in the command line. The message names the address.
- `No available licenses parsed from CADMATIC response`: the page that Broker received has no **Available Licenses** rows in the layout that Broker reads.
- `Reserved session references unknown feature`: a row of **Reserved Licenses** names an application that **Available Licenses** does not list.

Broker logs at `ERROR` level by default, so the last 2 messages, which Broker logs at `WARN` level, appear only after you go to **Settings** → **Broker Log Level**, set **Broker service** to `WARN`, and select **Save**.

## Known limitations

- Broker does not report denied requests, borrowed licenses, or license allocations.
- Broker sees only the licenses that are reserved when the data inquiry runs, so it can miss a license that is checked out and returned within the watch interval.
- Broker does not sign in to the web interface. If the page asks for a username and password, Broker can't read the license data.
- The page shows 1 expiration date for the whole license server, so Broker reports that date for every application.
- Broker removes only a counter with a plus sign, such as `(+1)`, from a username. A name that ends in a number in parentheses without a plus sign, such as `jsmith (1)`, stays as it is.
- Broker expects the table layout of the CADMATIC License Server 2.0 web page. Rows in another layout don't reach OpenLM.