---
title: OpenText AutoPass License Server
description: OpenLM Version 26 で OpenLM Broker を設定して、OpenText AutoPass License Server（APLS）の使用状況、借用ライセンス、ライセンス拒否を監視し、EasyAdmin で承認します。
product: OpenLM Version 26 (legacy)
---

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

以下の手順で、OpenText AutoPass License Server（APLS）が提供するライセンスを OpenLM で監視します。APLS は以前は Micro Focus の製品で、Dimensions RM や UFT One などの OpenText ソフトウェアの同時使用ライセンスを提供します。OpenLM Broker は APLS の REST API からライセンスの合計数、使用中のライセンス、拒否されたライセンス要求を定期的に読み取り、OpenLM SLM にレポートします。Broker には、サインインに使用する APLS ユーザーと、監視する製品の一覧を指定します。

:::note
このページの対象は、OpenText AutoPass License Server（APLS）でライセンスされる OpenText 製品です。ImgLM ライセンスマネージャーを使用する OpenText Desktop Viewer（旧 Spicer Imagenation）については、[OpenText (Spicer)](https://www.openlm.com/documentation/ja/legacy/interfacing-articles/opentext) を参照してください。
:::

## 要件

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

- 組織内のマシンにインストールされた OpenLM SLM v25.x 以降、または [Software License Management Cloud（SLMC）](https://www.openlm.com/documentation/ja/legacy/slmc/index) アカウント。
- HTTPS で APLS に到達できるマシンにインストールされ、OpenLM SLM にレポートしている OpenLM Broker v26.10.13.929 以降。これより前の Broker バージョンでは、ライセンスマネージャーの種類に AutoPass が表示されません。
- Broker 用の APLS のユーザー名とパスワード。Broker は使用状況を読み取るだけなので、閲覧専用のユーザーで十分です。
- 監視する各製品の製品定義識別子。[製品識別子を確認する](#製品識別子を確認する)を参照してください。

Broker が対応しているのは、OpenText（旧 Micro Focus）の AutoPass License Server です。

## 監視機能

OpenLM Broker を通じた OpenText AutoPass License Server の現在の監視機能は次のとおりです。

| LM Type in the Broker | Commands | Logs | Quantity | Expiration date | Denied | Borrowing | Allocations | Report resolution |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| AutoPass | Yes (REST API) | No | Yes | No | Yes (APLS 24.3 or higher) | Yes | No | Seconds |

データ照会のたびに、Broker は次の情報をレポートします。

- **Feature name**: APLS のフィーチャーの説明。説明のないフィーチャーは、`7001:1` のようにフィーチャー ID とバージョンでレポートされます。
- **Version**: フィーチャーのバージョン。
- **Product**: 製品識別子に含まれる製品コードとバージョン。たとえば `10027_1.0_UFT_14.50` の場合は `UFT 14.50` です。
- **Total**: APLS のライセンスサマリーにある、フィーチャーの合計容量。
- **In use**: APLS の **In Use** レポートでチェックアウトされている容量。APLS がチェックアウトのレコードなしで使用中の容量をレポートする場合、Broker はその容量をレポートします。
- **Username**: 各チェックアウトのユーザー名。`CORP\` のようなドメインのプレフィックスは除かれます。
- **Workstation**: 各クライアントのホスト名。APLS にホスト名がない場合は IP アドレス。
- **Start time**: 各チェックアウトの開始時刻を UTC に変換したもの。
- **Borrowed**: Commuter と Remote Commuter のチェックアウト。借用ライセンスとしてレポートされます。
- **Denials**: 前回のデータ照会以降に APLS が拒否したライセンス要求と、APLS が示す拒否の理由。このレポートは APLS 24.3 以降にあります。
- **Vendor**: **Vendors** タブで別のベンダーを追加しない限り、Broker は `OpenText` をレポートします。

OpenText AutoPass License Server では、ライセンスの有効期限とライセンス割り当ては利用できません。

## OpenLM と AutoPass の連携方法

**AutoPass** ポートを設定した場合、Broker が入力するのは次の設定のみです。残りのライセンスマネージャー設定は空のままになります。

- **コマンド:** `data_inquiry` のみで、Broker UI では **Data Inquiry** と表示されます。既定のコマンドラインはプログラムではなく、APLS の REST API のベースアドレスです。

    ```text
    https://{$host}:{$port}/autopass
    ```

    Broker UI のコマンドラインには、`{$host}` と `{$port}` の代わりに、**License Managers** ページの **Host** とライセンスマネージャーのポートがすでに入っています。実行のたびに、Broker はこのアドレスに次の要求を送信します。
    - `POST /services/v10.5/feature/usage/summary`: 指定した製品ごとに 1 回送信し、製品のフィーチャーとその合計数を取得します。
    - `GET /services/v10.3/feature/usage/raw?reportType=0`: 使用中の各フィーチャーについて、そのチェックアウト（**In Use** レポート）を取得します。
    - `GET /services/v24.3/feature/usage/raw?reportType=3`: 各フィーチャーについて、前回の実行以降に拒否された要求（**Rejected** レポート）を取得します。24.3 より前の APLS にはこのレポートがありません。その場合、Broker サービスが再起動するまで、Broker はこのレポートを要求しなくなります。

    すべての要求で、APLS のユーザー名とパスワードを HTTP Basic 認証で送信します。AutoPass にはステータスコマンドがないため、要求が成功していれば、Broker はライセンスサーバーをアクティブとしてレポートします。
- **詳細オプション:** ライセンスマネージャーの **Advanced** タブにある `username`、`password`、`products`。Broker はパスワードを暗号化して保存し、マスクして表示します。
- **ライセンスファイル:** なし。
- **ログファイル:** なし。**Log Files** タブは空のままになります。
- **ポーリング:** データ照会は既定で 55 秒ごとに実行されます。2 回の実行の間に開始して終了したチェックアウトは OpenLM に届きません。拒否は届きます。Broker は前回の実行以降に拒否されたすべての要求を読み取るためです。

## AutoPass License Server の準備

Broker が APLS から必要とするものは 3 つあります。サインインに使用するユーザー、監視する製品の識別子、そして Broker マシンが信頼する証明書です。

### APLS ユーザーを選ぶ

Broker は、ライセンスマネージャーの **Advanced** タブにあるユーザー名とパスワードで APLS にサインインします。Broker は APLS で何も変更しないため、閲覧専用のユーザーで十分です。APLS には `aplsUser` という名前の閲覧専用ユーザーが用意されています。APLS の管理者がそのパスワードを変更している場合や、監視用に別の読み取り専用ユーザーを設定している場合は、そのユーザーを使用してください。

### 製品識別子を確認する

Broker は APLS にインストールされている製品を一覧表示できないため、監視する製品を指定します。各製品は、`pdfid_pdfVersion_productCode_productVersion` の形式の製品定義（PD）識別子で識別されます。これは製品の PD ファイルの名前から拡張子 `.pd` を除いたもので、たとえば `10027_1.0_UFT_14.50` です。

各製品の識別子は APLS の管理者に確認できます。Broker が監視するのは指定した製品のみなので、OpenLM でライセンスを確認したいすべての製品を追加してください。

### 証明書を確認する

APLS は REST API を HTTPS で提供し、既定のポートは `5814` です。Broker はほかの HTTPS クライアントと同様に APLS の証明書を検証するため、Broker マシンがその証明書、またはそれを発行した認証局を信頼している必要があります。

Broker マシンがまだ信頼していない証明書を APLS が使用している場合は、[OpenLM Broker の SSL 設定](https://www.openlm.com/documentation/ja/legacy/openlm-broker/openlm-broker-ssl-configuration#broker-を-openlm-slm-に-https-で接続する)の説明に従い、OpenLM SLM の証明書と同じ方法で信頼させてから、Broker を再起動します。

## OpenLM Broker の設定

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

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

2. **License Managers** ページで **Host** を確認します。

    OpenLM はこのホスト名でライセンスサーバーを一覧表示します。このフィールドは APLS だけでなく、ページ上のすべてのライセンスマネージャーのホストを保持します。

    - フィールドが空の場合は、APLS のホスト名を入力し、フィールドの横にある保存アイコンを選択します。
    - 別のマシンが指定されている場合はそのままにしておき、代わりに手順 7 でデータ照会に APLS のアドレスを入力します。

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

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

    *OpenText AutoPass License Server をライセンスマネージャーとして追加します*

5. APLS のポート（管理者が変更していない限り `5814`）を入力し、**Add** を選択します。

6. **Advanced** タブで 3 つのオプションを設定します。オプションごとに編集アイコンを選択し、値を入力して **Continue** を選択します。

    - `username`: APLS のユーザー名（例: `aplsUser`）。
    - `password`: そのユーザーのパスワード。
    - `products`: 監視する製品の識別子をコンマで区切ったもの（例: `10027_1.0_UFT_14.50,10000_1.0_DimensionsRM_25.4`）。

    **Continue** を選択した後に一覧が表示されなくなった場合は、別のタブを選択してから **Advanced** をもう一度選択します。

    *Advanced タブの APLS ユーザーと監視する製品*

7. **Commands** タブで **Data Inquiry** コマンドを選択し、大きなテキストボックスでコマンドラインを確認します。

    - **手順 2 で Host に APLS のマシンを設定した場合:** 既定のコマンドラインのままにします。
    - **APLS が別のホストにある場合:** `{$host}:{$port}` を、APLS のホスト名とポートに置き換えます（例: `https://apls01:5814/autopass`）。

    アドレスの末尾の `/autopass` はそのままにし、その後には何も追加しないでください。APLS のレポートのパスは Broker が付け加えます。

    *Host と APLS のポートが入力済みの既定の Data Inquiry*

8. **Watch interval (sec)** は 55 秒のままにするか、任意のポーリング間隔を設定します。**Timeout (sec)**（既定 60 秒）は、Broker が APLS の各応答を待つ時間の上限です。

9. **Vendors** タブと **Log Files** タブは空のままにします。OpenLM に `OpenText` 以外のベンダー名を表示したい場合にのみ、ベンダーを追加します。

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

11. **License Managers** の一覧から AutoPass ライセンスマネージャーを開き直し、**Commands** タブに移動して **Execute** を選択し、データ照会をテストします。

    テストに成功すると、指定した製品のライセンス済みフィーチャーごとのフィーチャーと、チェックアウトごとのユーザーエントリを含むライセンスサーバーの XML が返されます。テストが失敗した場合は、`SERVER` 行の `server_status` に理由が表示されます。[トラブルシューティング](#トラブルシューティング)を参照してください。一度も保存していないライセンスマネージャーでは Broker は **Execute** を受け付けず、`Need to save first in order to execute command` を返します。

## OpenLM SLM の設定

### EasyAdmin による自動設定

ここまでの手順が完了していれば、Broker は次回の定期的なデータ照会で APLS のデータを OpenLM SLM に送信します。**Execute** は Broker UI 内でコマンドをテストするだけで、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. 保留中の AutoPass エントリ（Broker で設定したホスト名とポート）を探し、その行の末尾にある編集アイコンを選択します。

    Broker は OpenLM Generic プロトコルで APLS をレポートするため、**Type** は **OpenLM Generic** です。

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

### EasyAdmin による手動設定

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

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

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

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

## 設定の確認

1. ブラウザーで EasyAdmin を開きます。
2. **Start → Widgets → License Manager - Servers** に移動します。
3. APLS のライセンスサーバーの **Status** が **Up to date** であることを確認します。
4. **Start → Widgets → Feature Usage Status** に移動し、指定した製品のフィーチャーが、**Quantity** に総数、**Used** に使用中ライセンス数とともに表示されることを確認します。APLS の **License Usage** ペインと数を比較してください。
5. **Start → Reports → License Activity** に移動し、**Include Current Activity** を選択して、**Apply** を選択します。各チェックアウトがユーザー名とワークステーションとともに表示されることを確認します。
6. APLS 24.3 以降では、ライセンス要求が拒否された後に **Start → Reports → Denials** に移動し、拒否が届いていることを確認します。

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

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

Broker がレポートしているのに APLS がフィーチャーなしで表示される場合は、Broker UI の **Commands** タブに戻り、**Execute** を選択します。データ照会が失敗した理由は、Broker が `SERVER` 行の `server_status` に書き込みます。次の一覧と照合してください。

- `No products configured for the AutoPass port <port>` — **Advanced** タブの `products` オプションが空です。監視する製品の識別子を入力します。
- `APLS returned no licensed features for product <identifier>`、または `Product Definition is not found` などの `APLS error <code>: <message>` — APLS がその識別子を認識していないか、その製品にライセンスがインストールされていません。バージョンの部分も含めて、識別子を APLS の管理者に確認します。
- 末尾が `401` と `Check username and password in the AutoPass port settings` のステータス — APLS がユーザー名またはパスワードを拒否しました。**Advanced** タブの `username` と `password` のオプションを修正します。
- `PKIX path building failed` や `unable to find valid certification path` などの証明書エラー — Broker マシンが APLS の証明書を信頼していません。[OpenLM Broker の SSL 設定](https://www.openlm.com/documentation/ja/legacy/openlm-broker/openlm-broker-ssl-configuration#broker-を-openlm-slm-に-https-で接続する)の説明に従って信頼させ、Broker を再起動します。
- `Connection refused` またはタイムアウト — そのホストとポートで応答するものがありません。データ照会のホストとポートを確認し、Broker マシンと APLS の間でファイアウォールがポートをブロックしていないことを確認します。
- 末尾が `404` のステータス — コマンドラインが APLS の REST API を指していません。`https://apls01:5814/autopass` のように、末尾が `/autopass` になっていることを確認します。

フィーチャーは届くのに拒否が届かない場合は、APLS のバージョンを確認してください。24.3 より前の APLS には **Rejected** レポートがなく、その場合 Broker のログに `APLS has no denial report, it is older than 24.3` と記録されます。

詳細は、Broker インストールフォルダーの `logs` フォルダーにある Broker のログに記録されます。手動の **Execute** は `broker-service.log` に、定期的なデータ照会は `port-<port>-AutoPass.log` に書き込まれます。

## 既知の制限

- Broker は APLS にインストールされている製品を検出できません。監視するのは `products` オプションに指定した製品のみなので、APLS に新しい製品をインストールした場合はそこに追加してください。
- Broker は、ライセンスの有効期限とライセンス割り当てをレポートせず、使用状況の履歴もアップロードしません。OpenLM での使用状況は、ライセンスマネージャーを設定した時点から始まります。
- 拒否は APLS 24.3 以降でのみ利用できます。
- Broker はログではなく現在の **In Use** レポートを読み取るため、データ照会の実行時に開いているチェックアウトのみを把握できます。監視間隔より短いチェックアウトは捕捉されないことがあります。
- 複数サーバーの冗長化は利用できません。EasyAdmin で **Is Triad Configuration** のチェックを外したままにしてください。