ライセンスファイル管理 (LFM)

デモを新しいタブで開く

License File Management（LFM）を使用すると、ライセンスサーバーのライセンスファイルを閲覧、編集、検証、デプロイできます。LFM では、現用ファイルに影響を与えずにドラフトで変更を試し、push する前に検証し、すべての変更を追跡し、ライセンスサーバー間の整合性を保てます。

はじめに

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

• Broker がインストールされ、報告していること。LFM は Broker Hub から収集したライセンスファイルを一覧表示するため、Broker が報告するまでファイルは表示されません。

LFM を開くには、OpenLM Platform のヘッダーにある Navigation（グリッドアイコン）、Licenses and Features、License File Management の順に選択します。

関連する作業については、License Servers と アラート を参照してください。

LFM でできること

LFM では、次の作業を実行できます。

• すべてのライセンスファイルを 1 か所で閲覧: LFM は Broker Hub からライセンスファイルを収集し、最新バージョンを表示します。
• 解析された内容を確認: LFM は FlexLM および RLM ファイルを解析し、機能（feature）、ベンダー、バージョン、ライセンスタイプ、各種日付、数量、キーを生のテキストと並べて一覧表示します。
• コードエディター形式でファイルを読む: FlexLM および RLM ファイルは、シンタックスハイライト、視覚的に区切られたサーバー／機能ブロック、各機能を要約するホバーカード付きで表示されます。
• ドラフトで安全に作業: ドラフトを作成してライセンス本文を編集し、現用ファイルに触れずに変更を保存できます。
• 入力しながらミスを検出: ドラフトの編集中、LFM はバックグラウンドでテキストを検証し、push する前に問題をインラインで下線表示します。
• push 前に検証: ドラフトに対して事前検証チェックを実行し、構文、機能、ホスト名、ポート、サーバー可用性に関する問題をデプロイ前に検出します。
• バージョンを比較して結果をエクスポート: ドラフトとデプロイ済みファイル、または任意の 2 つの保存済みバージョンを比較し、比較結果を CSV ファイルにエクスポートできます。
• コントロールされたデプロイ: ドラフトを単一の Broker、またはトライアドクラスター内のすべての Broker に push します。
• 完全な履歴を追跡: ドラフト、デプロイ、無効化、削除を含む、ライセンスファイルのあらゆるイベントを参照します。
• SLM と同期: トライアド構成を含め、ライセンスファイルと正しい SLM サーバー名のリンクを自動で維持します。
• 状況を把握: デプロイ失敗やドラフトが拒否された場合にアラートを受け取ります。

LFM の仕組み

LFM がデプロイ、解析、編集、履歴をどのように扱うかを、次に示します。

• トライアドなし: 1 台の Broker に変更を反映します。
• トライアドあり: 同じライセンスファイルを 3 台すべての Broker に反映し、冗長性を確保します。1 台が停止しても、残りのサーバーが引き続きライセンスを供給します。
• ドラフト優先のワークフロー: 本番環境に push する前に、必ずドラフトで作業します。
• 機能解析: LFM は FlexLM および RLM ファイルを解析するため、生のテキストではなく構造化された機能リストを確認できます。
• スマートエディター: FlexLM および RLM ファイルは、シンタックスハイライト、ホバーによる要約表示、ドラフト編集中のライブ検証を備えたコードエディター形式で表示されます。
• 事前検証: Broker に到達する前に、各ドラフトをよくある問題についてチェックできます。
• 自動化: LFM は Broker Hub と連携し、Kafka 経由で更新を送信します。
• SLM 同期: LFM はライセンスファイルとライセンスサーバー間のリンクを SLM と同期して維持できます（トライアドメンバーを含む）。
• 監査とアラート: LFM は完全な変更履歴を保存し、監査・アラートサービスと連携します。

注意

ローカルマシン上で直接変更されたファイルも、LFM が検出します。Broker は定期的に Broker Hub に更新を送信するため、LFM は同期を維持します。

ライセンスファイルを閲覧する

ライセンスファイルを表示するには、一覧から開きます。LFM は Broker Hub からライセンスファイルを自動的に取得します。各ファイルについて、次の情報を確認できます。

• 現在のファイル本文と、解析された機能の一覧。
• 完全な更新履歴（ドラフト、デプロイ、無効化、削除）。
• ドラフトの有無と、ドラフトと元ファイルの比較。

解析されたライセンス機能

ライセンスファイルにどの機能が含まれているかを確認するには、ファイルを開いて解析された機能を確認します。LFM は FlexLM および RLM ライセンスファイルの内容を解析し、抽出した機能を生のテキストと並べて保存します。

次の画像は、選択したライセンスファイルの解析された機能を示します。

選択したライセンスファイルの Parsed Features パネル

各ファイルについて、LFM は次の項目を表示します。

• 機能名（Feature name）
• ベンダー（Vendor）
• バージョン（Version）
• ライセンスタイプ（License type）
• 開始日（Start date）
• 有効期限（Expiration date）
• 数量（Quantity）
• キー（Key）

ファイルの 2 つのバージョンを比較すると、LFM はすべての機能を New（追加）、Changed（変更）、Removed（削除）、Unchanged（変更なし）に分類します。これにより、push する前にドラフトの実際の影響を確認できます。詳細はバージョンの比較を参照してください。

注意

解析は FlexLM および RLM のライセンスファイル形式に対応しています。

ライセンスファイルエディター

FlexLM または RLM ライセンスファイルを読むには、ファイル内容パネルで開きます。パネルには、ファイルがコードエディター形式で次の機能付きで表示されます。

• シンタックスハイライト: キーワード（FlexLM の SERVER、VENDOR、FEATURE、INCREMENT、RLM の HOST、ISV、LICENSE）、日付、引用符付き文字列、コメントが色分けされます。
• 視覚的なブロック表示: サーバーブロックと各機能ブロックには色付きのアクセントバーが付き、ファイルの構造がひと目で分かります。
• ホバーによる要約カード: 機能ブロックにマウスを重ねると、解析されたレコード（機能名、ベンダー、バージョン、有効期限、数量）が表示され、生の位置ベースのフィールドを読み解く必要がありません。
• コードエディターの標準機能: 行番号、ブロックの折りたたみと展開（ガター内の折りたたみ矢印）、パネル側面のミニマップ、エディター内検索（Control+F、macOS では Command+F）を利用できます。

次の画像は、エディターでの機能ブロックのホバーカードを示します。

機能ブロックにマウスを重ねると解析済みの要約カードが表示される

パネル上部の Displaying ドロップダウンリストで、次の 2 つの表示を切り替えます。

• Original file: Broker が最後に報告したファイルの読み取り専用表示。
• *Draft: ドラフトのテキスト。ドラフトが編集可能な場合、パネルには Editable Draft Text と表示され、ライブ検証が有効になります。編集できない場合（ファイルの Broker が接続されていない、またはドラフトがすでに push 済みの場合など）は読み取り専用で開きます。

注意

その他の形式のファイル（OpenLM Generic、LUM、DSLS など）は、LFM がハイライトや検証なしのプレーンテキストとして表示します。

ドラフトを作成する

現用ファイルを変更せずにライセンスファイルを編集するには、ドラフトを作成します。

1. 変更したいライセンスファイルを開きます。

2. Create New Draft を選択します。

3. Displaying を *Draft に切り替えます。

4. ライセンス本文を編集します。

   編集内容は LFM が自動的に保存します。

編集中のライブ検証

push する前に問題を見つけるには、ドラフトを編集して下線に注意します。ドラフトの編集中、LFM は push 前検証と同じルールでバックグラウンドのテキスト検証を実行します。キーワードの打ち間違い、不正な行、ホスト名の不一致などの問題は、LFM が入力中にインラインで下線表示するため、push するまで待つ必要はありません。下線部分にマウスを重ねると、メッセージを確認できます。

次の画像は、ドラフトに表示されるライブ検証のメッセージを示します。

ライブ検証はドラフト内の問題に下線を付け、ホバーで内容を説明する

注意

ライブ検証は FlexLM および RLM のドラフトに適用され、Settings ページで Internal validation before pushing a license file がオンになっている場合にのみ実行されます。

バージョンの比較

ドラフトまたは保存済みバージョンのライセンスファイルを比較するには、次のいずれかの場所から Compare Draft File ダイアログを開きます。

• ドラフトとデプロイ済みファイルの比較: ドラフトを表示した状態で Compare Draft を選択します。ダイアログでは、デプロイされている元ファイルとドラフトが比較され、ダイアログから直接ドラフトを push することもできます。
• 保存済みバージョンの比較: ファイルの更新履歴を開き、テキストスナップショットを保存しているイベントの Compare アイコンを選択します。ダイアログでは、任意の 2 つの保存済みバージョン（File A と File B）、または保存済みバージョンと Currently deployed（現在デプロイ中のファイル）を比較できます。

File Display Mode ドロップダウンリストで比較の表示方法を切り替えます。

• Text: 生のライセンステキストを左右に並べた差分表示。追加された行と削除された行がハイライトされます。
• Parsed Features: 解析された機能のテーブル。比較する両側の列がペアで表示されます（ドラフト比較では Original と Draft、履歴バージョン比較では A と B）。

次の画像は Text モードを示します。

Text モード：デプロイ済みファイルとドラフトの差分を左右に並べて表示

次の画像は Parsed Features モードを示します。

Parsed Features モード：デプロイ済みファイルとドラフトの機能単位の比較

次の画像は、ファイル履歴から開いた比較を示します。

ファイル履歴の保存済みバージョンとデプロイ済みファイルの比較

比較結果を CSV にエクスポートする

比較結果を CSV ファイルとして保存するには（たとえば、差分を変更依頼に添付したり、Excel でフィルタリングしたりする場合）、Search フィールドの隣にあるエクスポートボタン（ツールチップ: Export Parsed Features）を選択します。エクスポートには次の特徴があります。

• エクスポートには、選択している表示モードに関係なく、常に Parsed Features の比較テーブルが含まれます。
• 各機能は Status 列（New、Changed、Removed、Unchanged）付きでエクスポートされ、その後に画面上のテーブルと同じ列が続きます。列ラベルは、ドラフト比較では Original と Draft、履歴比較では A と B になります。
• 日付はユーザーの日付形式設定に従い、空の値は画面上のテーブルと同じプレースホルダー（「No start date」、「No quantity」など）でエクスポートされます。
• ファイル名は比較対象を反映します。ドラフト比較では <license file name>_<export timestamp>.csv、履歴比較では <license file name>_<File A date>_<File B date>_<export timestamp>.csv です（Currently deployed を選択した場合は当日の日付が使用されます）。
• ファイルは UTF-8 でエンコードされ、Excel で正しく開けます。

比較にエクスポートできる内容がない場合、LFM は 「There are no comparison results to export」と表示します。

push 前にドラフトを事前検証する

ドラフトを Broker に push する前に、事前検証チェックを実行します。LFM はドラフトに対して 3 つのチェックグループを実行し、それぞれに重大度のタグが付いたメッセージのリストを返します。

次の画像は、事前検証で見つかったエラーを示します。

事前検証で見つかったエラーが表示された Push Draft File ダイアログ

事前検証のチェック内容

事前検証では、次のグループのチェックを実行します。

• 構造チェック: ファイルが空ではないこと、形式が認識できること、必須キーワードが含まれていることを確認します。FlexLM の場合、LFM は SERVER、VENDOR または DAEMON、および少なくとも 1 つの FEATURE または INCREMENT 行を確認します。RLM ファイルは形式固有のキーワードに対してチェックされます。
• セマンティックチェック: ホスト名が設定済みサーバーと一致すること、ポートが一致すること、機能が正しく解析できること、機能名が存在すること、機能が期限切れまたは期限切れ間近でないことを確認します。FlexLM 固有のチェックでは、FEATURE 行の重複、対応する FEATURE または INCREMENT を持たない PACKAGE エントリ、および機能数量がゼロまたは負の値である場合もフラグ付けされます。
• サーバーチェック: SLM 同期がオンの場合、LFM は対象サーバーが到達可能であることを確認し、ファイルにリンクされているトライアドメンバーを報告します。

重大度

各メッセージには、次のいずれかの重大度が付きます。

重大度	意味
Error	Broker がファイルを拒否する可能性が高い問題です。push する前に確認して修正してください。
Warning	期限切れ間近の機能や FEATURE 行の重複など、潜在的な問題です。確認は必要ですが、push 自体は可能です。
Info	サーバーの状態や検出されたトライアドメンバーなど、参考情報です。

ヒント

サービス可用性とトライアド情報をチェックするには、SLM 同期をオンにします。SLM 同期がオフの場合、LFM はサーバーチェックをスキップします。

事前検証は push をブロックしません。よくある問題を早い段階で示し、push、編集、キャンセルのいずれを選ぶかを判断できるようにします。

同じチェックは、ドラフトの編集中にも継続的に実行されます。詳細は編集中のライブ検証を参照してください。

注意

事前検証は FlexLM および RLM のファイル形式に対応しています。

ドラフトをデプロイする

ドラフトを Broker またはトライアドに push するには、お使いの構成に応じた手順を実行します。

単一 Broker にドラフトをデプロイする

Broker がトライアドではない場合は、次の手順を実行します。

1. ドラフトを開きます。
2. 事前検証を実行し、エラーや警告を確認します。
3. Push Draft を選択します。

ドラフトが当該 Broker の旧ファイルを置き換えます。

トライアドにドラフトをデプロイする

Broker がトライアドの場合は、次の手順を実行します。

1. ドラフトを開きます。

2. 事前検証を実行します。

   このファイルにリンクされているトライアドメンバーが Info メッセージとして表示されます。

3. Push Draft を選択します。

ドラフトがクラスター内のすべての Broker（3 台）のファイルを置き換えます。

警告

トライアドでは、すべての Broker でファイルパスが一致している必要があります。ファイルパスが異なる場合、デプロイは失敗します。

デプロイに関する注意

デプロイするときは、次の点に留意してください。

• Broker の稼働状態: LFM は送信前に Broker の稼働状態を確認しません。push の後、LFM は更新履歴とアラートを通じて失敗を報告します。
• エラーハンドリング: Broker がファイルを適用できない場合、エラーがデプロイ応答に表示され、LFM はそのエラーをファイルの更新履歴に記録します。

SLM とライセンスファイルを同期する

LFM は、ライセンスファイルと SLM が管理するライセンスサーバーとのリンクを自動的に同期して維持できます。設定をオンにすると、LFM は次のように動作します。

• 各ライセンスファイルについて、ホストとポートから正しい SLM サーバー名を解決します。
• SLM データが変更されたときに、ライセンスファイルのサーバーリンクを更新します。
• トライアド構成を検出し、各メンバーのステータス（UP、UNKNOWN）を記録します。

SLM 同期をオンにする

SLM 同期をオンにすると、次のことができます。

• 各ライセンスファイルの最新の SLM サーバー名とステータスを表示したい。
• トライアド内のすべてのメンバーに同じライセンスファイルを push するトライアドデプロイを利用したい。
• 事前検証時にサーバー可用性とトライアドのチェックを実行したい。

次の画像は、SLM 同期がオンの Settings ページを示します。

SLM 同期がオンの Settings ページ

SLM 同期がオンの場合、License files ページには、ライセンスファイルが自動的にサーバーにアタッチされることを示すバナーが表示されます。次の画像は、そのバナーを示します。

SLM 同期が有効な状態の License files ページ

注意

同期をオンにすると、初回の同期がバックグラウンドで実行されます。完了までの時間は、環境内のライセンスサーバー数とライセンスファイル数によって異なります。

更新履歴

ライセンスファイルを監査するには、その更新履歴を開きます。LFM は各変更を、ステータス、タイムスタンプ、注記とともに自動的に記録します。

次の画像は File History パネルを示します。

選択したライセンスファイルの File History パネル

LFM が記録するイベント

LFM は次の 3 つのカテゴリのイベントを記録します。

• ライセンスファイルのライフサイクル: Broker がファイルを最初に報告したとき、ホスト上で本文を直接更新したとき、受信した更新が保存済みの内容と一致したとき、およびファイルが無効化または削除されたとき。
• ドラフトのライフサイクル: ドラフトを作成、編集、削除、push したとき、およびデプロイが成功または失敗したとき。
• サーバーデータの更新: ファイルにリンクされたサーバーの識別情報が変更されたとき（例：SLM 同期の実行後）。

デプロイ関連のイベントについては、注記でその内容（例：単一のホスト宛か、トライアドの全メンバー宛かなど）と失敗した場合の理由が説明されます。

履歴エントリの詳細

すべての履歴エントリには次が含まれます。

• Event: Draft created や Draft deployed successfully などの変更の種類。
• Event date: 変更が発生した日時。
• Note: 操作またはエラーの簡潔な説明。イベント名にマウスを重ねると表示されます。

ライセンスファイルのライフサイクルイベントのうち、ファイルが最初に報告されたとき、元のテキストが変更されたとき、ファイルが削除されたときの 3 つのイベントでは、LFM はその時点のライセンス本文のスナップショットも保存します。これにより、過去のファイル内容を確認できます。これらのスナップショットイベントには Compare アイコンが表示され、バージョン比較ダイアログを開いて、保存されたテキストを他の保存済みバージョンやデプロイ済みファイルと比較できます。

履歴の用途

履歴は次の目的で使用できます。

• 監査とコンプライアンス: いつ、どの経路（Broker の更新、ドラフトの push、削除）で、何が変更されたかを確認できます。
• トラブルシューティング: 失敗したデプロイをドラフト、Broker のレスポンス、関連するイベントまでさかのぼって追跡できます。
• カスタマーサポート: ログを手作業で突き合わせる代わりに、ファイルのイベントから問題の経緯を再構築できます。

ベンダーのライセンスファイルを更新する

ベンダーのライセンスファイルを更新するには、次の手順を実行します。

1. LFM でライセンスファイルを開きます。

2. 解析された機能リストを確認し、現在有効な機能を確認します。

3. ドラフトを作成します。

4. 新しいライセンス本文を編集または貼り付けます。

   ライブ検証で下線が付いた箇所を修正します。LFM は編集内容を自動的に保存します。

5. ドラフトとデプロイ済みファイルを比較します。

6. （任意）共有が必要な場合は、比較結果をエクスポートします。

7. 事前検証を実行し、エラーや警告を確認します。

8. ドラフトを push します。

   単一 Broker の場合、ファイルが直接更新されます。トライアドの場合、3 台すべての Broker でファイルが更新されます。

9. ファイルの更新履歴を開いてデプロイ状況を確認し、アラートで失敗の有無を確認します。