---
title: OpenText AutoPass License Server
description: APLS の REST API と OpenLM Broker を使用して、OpenText AutoPass License Server（APLS）の使用状況、借用ライセンス、ライセンス拒否を OpenLM Platform で監視します。
product: OpenLM Platform
---

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

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

## はじめに

次の前提条件を確認します。

- OpenLM Platform。
- HTTPS で APLS に到達できるマシンにインストールされた [OpenLM Broker](https://www.openlm.com/documentation/ja/cloud/data-collection/openlm-broker) v26.10.13.929 以降。これより前の Broker バージョンでは、ライセンスマネージャーの種類に **AutoPass** が表示されません。
- その Broker が [Broker Hub](https://www.openlm.com/documentation/ja/cloud/data-collection/broker-hub) で承認済みであること。OpenLM Platform は承認済みの Broker からのライセンスマネージャーデータのみを受け付けるため、Broker 自体が承認されるまで AutoPass エントリは **Pending Servers** に表示されません。
- Broker 用の APLS のユーザー名とパスワード。Broker は使用状況を読み取るだけなので、閲覧専用のユーザーで十分です。
- 監視する各製品の製品定義識別子。[製品識別子を確認する](#製品識別子を確認する)を参照してください。

## 監視できる内容

OpenLM Broker は、OpenText AutoPass License Server について次の項目を監視します。

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

OpenLM Broker は、コマンドに APLS の REST API を使用します。拒否には APLS 24.3 以降が必要です。

データ照会のたびに、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 以降にあります。
- **License type**: Broker はすべてのフィーチャーを **Floating** としてレポートします。
- **Vendor**: **Vendors** タブで別のベンダーを追加しない限り、Broker は `OpenText` をレポートします。

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

## OpenLM Platform と 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 Platform に届きません。拒否は届きます。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 Platform でライセンスを確認したいすべての製品を追加してください。

### 証明書を確認する

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

Broker マシンがまだ信頼していない証明書を APLS が使用している場合は、[Broker に TLS 証明書をインポートする](https://www.openlm.com/documentation/ja/cloud/getting-started/install-broker/manage#broker-に-tls-証明書をインポートする)の説明に従ってインポートし、Broker サービスを再起動します。

## OpenLM Broker の設定

AutoPass 用に OpenLM Broker を設定するには、次の手順を実行します。

1. APLS を監視する Broker の Broker UI を開きます。

    - **Broker マシンで**: `http://localhost:5090/` を開きます。ローカルアクセスに資格情報は不要です。
    - **ほかのマシンから**: OpenLM Platform で **Broker Hub** を開き、その Broker の **Broker UI** アイコンを選択します。リモートアクセストークンの処理も含めてインターフェイスが開きます。

1. **License Managers** ページで、**Host** に APLS のホスト名が設定されていることを確認します。

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

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

1. **License Managers**、**Add License Manager** の順に選択します。

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

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

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

1. **Add** を選択します。

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

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

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

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

1. **Commands** タブで **Data Inquiry** コマンドを選択します。

1. コマンドラインを確認します。

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

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

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

1. （任意）**Watch interval (sec)** を既定の 55 秒から変更します。**Timeout (sec)**（既定 60 秒）は、Broker が APLS の各応答を待つ時間の上限です。

1. **Vendors** タブと **Log Files** タブは空のままにします。

1. （任意）`OpenText` 以外のベンダー名を表示するには、**Vendors** タブでベンダーを追加します。

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

1. **License Managers** の一覧から AutoPass ライセンスマネージャーを開き直します。

1. **Commands** タブを選択します。

1. **Execute** を選択して、データ照会をテストします。

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

1. 約 1 分待ちます。

    **Execute** は Broker UI 内でコマンドをテストするだけで、OpenLM Platform には何も送信されません。Broker は定期的なデータ照会で APLS を OpenLM Platform にレポートするため、保存してから約 1 分後にライセンスサーバーが **Pending Servers** に表示されます。

## OpenLM Platform で AutoPass を承認

Broker は OpenLM Generic プロトコルで APLS をレポートし、Broker UI で設定した **Host** の名前でライセンスサーバーを識別します。そのため保留中のエントリは、そのホスト名と入力したポートで一覧表示され、**License Manager Type** は **AutoPass** と表示されます。

OpenLM Platform で AutoPass を承認するには、次の手順を実行します。

1. 管理者から提供された URL で OpenLM Platform にサインインします。

1. **Navigation**（OpenLM Platform のヘッダーにあるグリッドアイコン）、**Licenses and Features**、**License Servers** の順に選択します。

1. **Management** の下で **Pending Servers** を選択します。

1. Broker で設定したライセンスマネージャーと **Host Name** および **Port** が一致する行を探します。

    その行の **License Manager Type** は **AutoPass** で、**Source** には Broker の名前が表示されます。

1. その行、**Approve and merge** の順に選択します。

## 連携の検証

連携を検証するには、次の手順を実行します。

1. OpenLM Platform で、**License Servers** を選択し、**Operational** の下の **Live Servers Statistics** を選択します。

1. 設定したホストとポートの行を探し、**Status** が **Up** であることを確認します。

    OpenLM Platform がライセンスと使用状況をサーバーから最後に読み取った時刻である **RSQT**（Recent Successful Query Time）が最近の時刻であること、および **Quantity** と **Used** に数値が入っていることを確認します。

1. **Navigation**、**Licenses and Features**、**Licenses** の順に選択し、**Live Statistics** を選択します。

    指定した製品のフィーチャーがそれぞれ 1 行として表示され、**License Type** には **Floating**、**Total** と **Used** には APLS の数が表示されます。APLS の **License Usage** ペインと比較してください。

1. フィーチャーの **Used** の件数を選択して、セッションが届いていることを確認します。

    件数を選択すると **Usage** アプリの **Currently Consumed Licenses** が開き、各チェックアウトがユーザー名、ワークステーション、開始時刻とともに表示されます。

1. APLS 24.3 以降を使用している場合は、ライセンス要求が拒否された後に [Denials](https://www.openlm.com/documentation/ja/cloud/reporting/ui-reports/denials) を開き、拒否が届いていることを確認します。

:::note
新しい接続の後、ステータスが更新されるまで最大 3 分かかることがあります。
:::

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

次の項目では、APLS が **Pending Servers** に表示されない場合、APLS にフィーチャーが表示されない場合、拒否が届かない場合、Broker のログを扱います。

### APLS が Pending Servers に表示されないのはなぜですか

**Broker Hub** を開き、この Broker が **Pending Brokers** ではなく **Brokers** にステータス **Up** で表示されていることを確認してください。OpenLM Platform は承認済みの Broker からのライセンスマネージャーデータのみを受け付けます。

### APLS にフィーチャーが表示されないのはなぜですか

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 の証明書を信頼していません。[Broker に TLS 証明書をインポートする](https://www.openlm.com/documentation/ja/cloud/getting-started/install-broker/manage#broker-に-tls-証明書をインポートする)の説明に従ってインポートし、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 のログに詳細が記録されます。ログは Broker インストールフォルダーの `logs` フォルダーにあります。手動の **Execute** は `broker-service.log` に、定期的なデータ照会は `port-<port>-AutoPass.log` に書き込まれます。

## 既知の制限事項

OpenText AutoPass License Server の監視には次の制限があります。

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