---
title: GNS
description: OpenLM Version 26 で、ライセンスされたプログラムごとに GNS のステータスツール licstat.exe を実行するように OpenLM Broker を設定し、EasyAdmin で GNS ライセンスサーバーを承認します。
product: OpenLM Version 26 (legacy)
---

> **OpenLM Version 26（レガシー）。** このページは OpenLM Platform ではなくレガシー製品について説明しています。

以下の手順で、GNS ライセンスサーバーのネットワークライセンスを OpenLM で監視します。GNS ライセンスサーバーは GNS mbH（Gesellschaft für numerische Simulation）の製品です。Animator や Generator などの GNS のプログラムと、CDH/SPOT や CDH/VAO などの CDH のプログラムにネットワークライセンスを提供します。OpenLM Broker はライセンスファイルからプログラム名を取得し、プログラムごとに GNS のステータスツール `licstat.exe` を 1 回実行して、ライセンスの合計数、有効期限、およびライセンスを保持しているユーザーを OpenLM SLM にレポートします。

:::note
OpenLM はこの連携を CDH/SPOT でテストしました。Broker はライセンスファイルに記載されているプログラムのみを照会するため、[ライセンスサーバーを確認する](#ライセンスサーバーを確認する)の説明に従ってご自身のライセンスファイルを確認してください。
:::

## 要件

開始する前に、次を用意してください。

- 組織内のマシンにインストールされた OpenLM SLM、または [Software License Management Cloud（SLMC）](https://www.openlm.com/documentation/ja/legacy/slmc/index) アカウント。
- OpenLM SLM にレポートしている、Windows 上の OpenLM Broker v26.1.20.946 以降。ライセンスマネージャーの種類に **GNS** が表示されるこれより前の Broker バージョンでは、すべてのライセンスの合計数が 0 とレポートされます。
- GNS ライセンスサーバーが実行されていて、監視するライセンスがあること。
- Broker マシン上のステータスツール `licstat.exe`。ライセンスサーバーのインストーラーでは、独立したコンポーネント **License Server status tool** として表示されます。
- Broker マシン上の、ライセンスサーバーのライセンスファイル。ライセンスサーバー v3.14e4 の既定のインストールでは `C:\Program Files (x86)\GNS mbH\LicenseServer_v3.14e4` に置かれ、たとえば CDH/SPOT では `spotlicense.dat` という名前です。

Broker は、`licstat.exe` とライセンスファイルの両方があるライセンスサーバーマシンにインストールします。ベンダーのインストールガイドには、`licstat.exe` はライセンスサーバーでもクライアントでも、どの Windows マシンでも実行できると記載されています。ほかのマシン上の Broker を使う場合は、そのマシンにこのツールとライセンスファイルのコピーが必要です。

`licstat.exe` は、Broker の **License Managers** ページの **Host** フィールドのホストにあるライセンスサーバーに問い合わせます。ほかのマシン上の Broker を使う場合は **Host** にライセンスサーバーマシンの名前を設定する必要があり、このフィールドはその Broker のすべてのライセンスマネージャーに適用されます。

## 監視機能

OpenLM Broker による GNS の現在の監視機能は次のとおりです。

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

ライセンスファイルに記載されている各プログラムについて、Broker は次の情報をレポートします。

- **Feature name**: ライセンスファイルに記載されているプログラム名。たとえば `CDH-SPOT` です。
- **License total**: ライセンスサーバーがそのプログラム用に保持しているライセンスの数。
- **Expiration date**: そのプログラムのライセンスの有効期限。
- **Licenses in use**: そのプログラムのライセンスを保持しているユーザー 1 人につき 1 ライセンス。
- **Vendor**: `GNS`、または **Vendors** タブで追加したベンダー。

使用中の各ライセンスについて、Broker はライセンスを保持している**ユーザー名**と**ワークステーション**をレポートします。Broker は開始時刻をレポートしないため、OpenLM は Broker がそのユーザーを最初にレポートした時点でセッションを開始します。

拒否された要求、借用ライセンス、ライセンス割り当ては利用できません。

## OpenLM と GNS の連携方法

*OpenLM が GNS の使用状況を収集する仕組み*

Broker は既定で 55 秒ごとにライセンスファイルを読み取り、ファイルに記載されているプログラムごとに `licstat.exe` を 1 回実行して、その結果を OpenLM SLM に送信します。レポートには、問い合わせの時点でライセンスサーバーが一覧表示していた内容が含まれます。

Broker は問い合わせのたびにライセンスファイルを読み直すため、同じパスにあるライセンスファイルを更新すると、次の問い合わせから反映されます。

Broker は GNS ライセンスサーバーのログファイルを読み取りません。

## ライセンスサーバーを確認する

Broker は、ライセンスファイルのプログラムについて `licstat.exe` が返す内容をレポートします。そのため、まず手動でこのツールを実行します。

1. ライセンスファイルをテキストエディターで開き、プログラム名（たとえば `CDH-SPOT`）を探します。

    ファイルにライセンスコードだけがあり、プログラム名がない場合、Broker が照会する対象がありません。

2. Broker マシンで、`licstat.exe` があるフォルダーでコマンドプロンプトを開きます。

3. プログラム名とライセンスサーバーのホスト名を指定して `licstat.exe` を実行します。

    ```text
    licstat.exe CDH-SPOT gns01.example.com
    ```

    プログラム名はライセンスファイルに記載されているとおりに指定し、ホスト名にはご自身のライセンスサーバーマシンの名前を指定します。

4. ツールがライセンスの数、有効期限、およびライセンスを保持しているユーザーを表示することを確認します。

    ライセンスサーバーに接続できないとツールが報告する場合は、ライセンスサーバーのサービス（たとえば CDH/SPOT では `spotserver`）が実行されていることを確認します。ライセンスサーバーのポートを指定する `-p` オプションを付けたときだけ接続できる場合は、そのポートを控えます。同じオプションを Broker に追加します。

5. `licstat.exe` があるフォルダー、ライセンスファイルのフルパス、およびライセンスサーバーのポート（固定されている場合）を控えます。

    これらを Broker に入力します。CDH/SPOT では、ライセンスサーバーのフォルダーにある `spotport.dat` ファイルで固定ポートを設定します。

## OpenLM Broker の設定

:::note
この手順を開始する前に、OpenLM Broker をインストールし、OpenLM SLM にレポートしていることを確認してください。
:::

1. Broker マシンでブラウザーを開き、Broker の Web UI（[http://localhost:5090/](http://localhost:5090/)）に移動します。

2. **License Managers** ページで、**Host** にライセンスサーバーマシンのホスト名が表示されていることを確認します。

    Broker はこの名前を `licstat.exe` に渡し、OpenLM はこの名前でライセンスサーバーを一覧表示します。このフィールドには、GNS だけでなく、ページ上のすべてのライセンスマネージャーのホストが保持されます。フィールドが空の場合や別のマシンの名前になっている場合は、ホスト名を入力し、フィールドの横にある保存アイコンを選択します。Broker は GNS を追加した時点でホスト名をコマンドに書き込むため、ライセンスマネージャーを追加する前に **Host** を設定します。

3. **License Managers** → **Add License Manager** に移動します。

4. **LM Type** から **GNS** を選択します。

5. **Port** にライセンスサーバーのポート（たとえば `60000`）を入力し、**Add** を選択します。

    Broker と OpenLM は、ホスト名とこのポートでライセンスマネージャーを識別します。ライセンスサーバーに固定ポートがない場合は、この Broker のほかのライセンスマネージャーが使っていない番号を入力します。

    *GNS をライセンスマネージャーとして追加する*

6. **Settings** タブで、ライセンスファイルを追加します。

    1. **Set license file path manually** を選択します。
    2. **Add license file path** を選択します。
    3. **License file path** に、ライセンスファイルのフルパス（たとえば `C:\Program Files (x86)\GNS mbH\LicenseServer_v3.14e4\spotlicense.dat`）を入力するか、検索アイコンを選択してファイルを参照します。
    4. **Continue** を選択します。

    ライセンスファイルのパスは 1 つだけ追加します。Broker は一覧の最初のファイルを読み取り、残りは無視します。別のライセンスファイルのプログラムを監視するには、専用のポートを指定して GNS ライセンスマネージャーをもう 1 つ追加します。

    *Broker にライセンスファイルの場所を指定する*

7. **Commands** タブの **Executable path** に、`licstat.exe` があるフォルダー（たとえば `C:\Program Files (x86)\GNS mbH\LicenseServer_v3.14e4`）を入力します。

    保存すると、Broker はこのパスを `licstat.exe` の前に付けます。

8. **Periodic commands** の下の **Data Inquiry** を確認します。

    コマンドには、`licstat.exe`、プレースホルダー `@feature@`、およびホスト名が含まれます。Broker は `@feature@` をライセンスファイルの各プログラム名に置き換えるため、コマンドはそのままにします。**Watch interval (sec)** は `55` です。**Use the operating system start/stop commands** はオフのままにします。Broker は GNS の **Service name** を設定しません。

    手動で実行したときに `licstat.exe` が `-p` オプションを付けたときだけ接続できた場合は、コマンドの末尾に空白、`-p`、ポート番号を追加します。たとえば `-p 60000` です。

    *licstat.exe を実行する定期的な Data Inquiry*

9. （任意）**Vendors** タブで **Add Vendor** を選択し、OpenLM に表示するベンダー名（たとえば `CDH`）を入力して、**Continue** を選択します。

    ベンダーを追加しない場合、OpenLM には `GNS` と表示されます。

10. **Save** を選択します。

11. （任意）設定をテストするには、GNS のエントリをもう一度開き、**Commands** タブを選択して、**Execute** を選択します。

    **Execution Result** ダイアログに、Broker が作成するレポートが表示されます。プログラムごとに 1 つの `FEATURE` 要素、使用中のライセンスごとに 1 つの `USER` 要素が含まれます。

## OpenLM SLM の設定

### EasyAdmin による自動設定

ここまでの手順が完了していれば、Broker は既定で 55 秒ごとに `licstat.exe` を実行し、GNS を OpenLM SLM にレポートします。EasyAdmin でライセンスサーバーを承認します:

1. EasyAdmin（`http://<Server IP>:5015`）を開き、**Start → Widgets → License Manager - Servers** に移動します。
2. ウィジェット上部の **There are N servers pending approval** のリンクを選択します。

    **Administration - License Manager Servers** ウィンドウが開き、保留中のエントリが一覧の先頭に表示されます。

3. 保留中の GNS エントリ（Broker で設定したホスト名とポート）を探し、その行の末尾にある編集アイコンを選択します。

    このエントリの **Status** は **Pending**、**Display Name** は `<port>@<host>` です。OpenLM SLM には GNS の種類に対応するプラグインがないため、**Type** は Broker がレポートに使うプロトコルの **OpenLM Generic** です。編集アイコンは、行にポインターを合わせると表示されます。

4. 必要に応じて **Display name** で接続名を変更し、**Host Name** と **Port** を確認してから **APPROVE** を選択します。

### EasyAdmin による手動設定

自動設定が失敗した場合:

1. **Start → Administration → License Manager Servers** に移動します。
2. **Add LM** を選択します。
3. **Display name** に接続名（例: `GNS`）を入力します。
4. **Type** で **OpenLM Generic** を選択します。

    **Use Broker** がオンになります。

5. **Host Name**、**Port**、**Time Zone** の下の行に、GNS 用に Broker で設定したとおりのホスト名とポートを入力し、タイムゾーンを選択します。
6. **SAVE** を選択します。

## 設定の確認

1. ブラウザーで EasyAdmin を開きます。
2. **Start → Widgets → License Manager - Servers** に移動します。
3. GNS のライセンスサーバーを探し、**Status** が **Up to date** であることを確認します。

    承認の直後は、ステータスは **Waiting for data from Broker** です。**Quantity** にはすべてのプログラムのライセンスの合計数を合わせた数、**Used** には使用中のライセンス数が表示されます。

4. GNS のライセンスサーバーの行で、**Quantity** の数を選択します。

    **Licenses** ウィンドウが開き、プログラムごとに 1 行が表示されます。**Vendor** は `GNS` で、**Total** にライセンスの合計数、**Used** に使用中のライセンス数が表示されます。

5. プログラムの **Used** の数を選択して、セッションが届いていることを確認します。

    **Currently Consumed Licenses** ウィンドウが開きます。使用中の各ライセンスがユーザー名とワークステーションとともに表示されます。**Start Time** は、OpenLM がそのセッションを最初に受信した時刻です。

**Feature Usage Status** ウィジェットには、フィルターで追加したフィーチャーだけが表示されます。そのため、GNS のプログラムは自動では表示されません。

## トラブルシューティング

以下のいずれの問題でも、詳細は Broker のインストールフォルダーの `logs` フォルダーにある Broker のログで確認できます。

GNS が EasyAdmin で保留中として表示されない場合は、Broker が OpenLM SLM にレポートしていることを確認します。同じ Broker のほかのライセンスマネージャーが EasyAdmin で更新されていれば、レポートは届いています。

Broker UI の **Execution Result** に `GNS license file not configured` と表示される場合は、Broker がライセンスファイルを見つけられていません。**Settings** タブで、**Set license file path manually** が選択されていること、一覧にライセンスファイルのパスがあること、およびそのパスにファイルが存在することを確認します。

ライセンスサーバーにプログラムが表示されない場合は、Broker はライセンスファイルを読み取りましたが、プログラム名が見つからなかったため、`licstat.exe` に問い合わせる対象がありませんでした。**Settings** タブのパスが、`CDH-SPOT` などのプログラム名が記載されたライセンスファイルを指していること、およびそのファイルが一覧の最初にあることを確認します。

すべてのプログラムの合計数が 0 と表示される場合は、Broker が `licstat.exe` を実行できないか、その応答を読み取れません。この場合、Broker はエラーをレポートしません。次の原因を確認します。

- **Broker のバージョン**: v26.1.20.946 より前の Broker バージョンでは、すべての合計数が 0 とレポートされます。Broker をアップグレードします。
- **Executable path**: **Commands** タブの **Executable path** は、`licstat.exe` があるフォルダーである必要があります。
- **コマンド**: **Data Inquiry** コマンドを編集した場合は、**Commands** タブで **Restore Default** を選択し、**Save** を選択します。Broker は、小文字の `@feature@` という形のプレースホルダーだけを認識します。
- **ライセンスサーバー**: [ライセンスサーバーを確認する](#ライセンスサーバーを確認する)の説明に従って、手動で `licstat.exe` を実行します。ツールが接続できない場合、Broker がレポートできる内容はありません。

有効期限が表示されない場合は、Broker マシンの Windows の言語を確認します。日本語など英語以外の言語の場合、Broker はライセンスの合計数とユーザーをレポートしますが、有効期限はレポートしません。[既知の制限](#既知の制限)を参照してください。

## 既知の制限

- Broker は、拒否された要求、借用ライセンス、ライセンス割り当てをレポートしません。`spot_error.log` などのライセンスサーバーのログファイルを読み取らないため、OpenLM での使用状況は、ライセンスマネージャーを設定した時点から始まります。
- Broker は各問い合わせの時点で使用中のライセンスをレポートします。既定では 55 秒ごとです。2 回の問い合わせの間に開始して終了したセッションはレポートされません。
- ライセンスサーバーがプログラムについて一覧表示するユーザーは、それぞれ使用中のライセンス 1 つとして数えられます。
- Broker は開始時刻をレポートしません。OpenLM でのセッションは、ユーザーがライセンスを取得した時点ではなく、Broker がそのユーザーを最初にレポートした時点で始まります。
- Broker は、GNS ライセンスマネージャー 1 つにつきライセンスファイルを 1 つ読み取ります。ライセンスファイルごとに、専用のポートを指定して GNS ライセンスマネージャーを追加します。
- 空白を含むプログラム名には対応していません。Broker はそのようなプログラムを合計数 0 でレポートします。
- Broker マシンの Windows が英語以外の言語で動作している場合、Broker は有効期限をレポートしません。
- `licstat.exe` が実行されない場合や、プログラムのライセンスデータを返さない場合、Broker はそのプログラムを合計数 0 でレポートし、エラーはレポートしません。
- Broker は、**License Managers** ページの **Host** に指定された 1 つのライセンスサーバーホストに問い合わせます。3 台構成の冗長ライセンスサーバーは 1 つのセットとしては照会されません。また、**Host** はその Broker のすべてのライセンスマネージャーで共通です。
- Data Inquiry コマンドは、Windows 用のステータスツールである `licstat.exe` を指定します。OpenLM は GNS を Windows 上の Broker でテストしました。
- OpenLM はこの連携を、ライセンスサーバー v3.14e4 上の CDH/SPOT のライセンスファイルと `licstat.exe` の出力でテストしました。お使いの GNS ライセンスサーバーの応答が異なる場合は、OpenLM Support にお問い合わせください。
