OpenText AutoPass License Server

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 ユーザーと、監視する製品の一覧を指定します。

注意

このページの対象は、OpenText AutoPass License Server（APLS）でライセンスされる OpenText 製品です。ImgLM ライセンスマネージャーを使用する OpenText Desktop Viewer（旧 Spicer Imagenation）については、OpenText (Spicer) を参照してください。

はじめに

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

• OpenLM Platform。
• HTTPS で APLS に到達できるマシンにインストールされた OpenLM Broker v26.10.13.929 以降。これより前の Broker バージョンでは、ライセンスマネージャーの種類に AutoPass が表示されません。
• その Broker が 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 のベースアドレスです。

  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 証明書をインポートするの説明に従ってインポートし、Broker サービスを再起動します。

OpenLM Broker の設定

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

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

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

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

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

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

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

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

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

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

6. Add を選択します。

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

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

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

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

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

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

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

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

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

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

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

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

13. Save を選択します。

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

15. Commands タブを選択します。

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

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

17. 約 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 にサインインします。

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

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

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

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

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

連携の検証

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

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

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

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

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

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

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

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

5. APLS 24.3 以降を使用している場合は、ライセンス要求が拒否された後に Denials を開き、拒否が届いていることを確認します。

注意

新しい接続の後、ステータスが更新されるまで最大 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 証明書をインポートするの説明に従ってインポートし、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 では複数サーバーの冗長化は利用できません。