OpenLM Broker の Windows インストール

概要

OpenLM Broker は、OpenLM Software License Management（本書では SLM）または Software License Management Cloud（SLMC）とライセンスマネージャー間の通信を仲介し、ライセンス統計と機能を強化します。ライセンスマネージャーに直接アクセスして定期的にライセンス情報を照会し、そのデータを OpenLM SLM (Server) に中継します。OpenLM Broker はオプションのコンポーネントですが、OpenLM システムのライセンス管理体験と機能を強化するため、導入を強く推奨します。

OpenLM Broker のインストール

OpenLM Broker は Java ベースで、Java をサポートするプラットフォームで動作します。Broker はライセンスマネージャーと同じマシンにインストールする必要があります。Java 環境が必要なため、Java Runtime Environment (JRE) はインストールに同梱されています（Broker のインストール時のみ）。インストールを開始する前に、システム要件 を確認することを推奨します。本書では、Windows に OpenLM Broker をインストールする方法として、標準のウィザードインストール（A. インストールウィザードで OpenLM Broker をインストール）とサイレントインストール（B. OpenLM Broker のサイレントインストール）を説明します。Linux または Unix にインストールする場合は、OpenLM Broker の Linux/Unix インストールを参照してください。

両方の方法で OpenLM Broker インストーラーが必要です。ダウンロードページhttps://www.openlm.jp/downloads/から取得できます。www.openlm.com からダウンロードする場合は OpenLM Platform アカウントが必要です。登録、サインイン、V26 タブでの Broker の見つけ方は Version 26 インストーラーのダウンロード を参照してください。インストーラーのファイル名は OpenLM_Broker_<version>.msi です。

A. インストールウィザードで OpenLM Broker をインストール

1. インストーラーファイル（OpenLM_Broker_#.#.#.#.msi）をダブルクリックしてインストールを開始します。インストール Welcome 画面（図 2）の前に「Preparing to install」画面（図 1）が一時的に表示されます。

図 1: インストール準備画面。

図 2: インストール Welcome 画面。

2. [Next] をクリックして続行します。ライセンス契約画面が表示されます（図 3）。

図 3: ライセンス契約画面。

3. 条件に同意してインストールを続行する場合は、I Agree のラジオボタンをクリックします（図 4）。ラジオボタンをクリックすると [Next] ボタンが有効になります。[Cancel] をクリックすると、変更を行わずにインストーラーを終了します。

図 4: I Agree を選択したライセンス契約画面。

4. [Next] をクリックします。Java 選択画面が表示されます。バンドルされた OpenJDK を使用する（Install Broker with Java 11 OpenJDK）か、Already have Java 11 installed? を選択して既にインストールされている Java 11 のパスを指定してください（図 5）。Java がインストールされていないマシンでは、バンドルされた OpenJDK のオプションが既定で選択されています。

図 5: Java 選択画面。

[Next] をクリックします。既定のインストールパス C:\Program Files\OpenLM\OpenLM Broker\ が表示された Select Installation Folder 画面が表示されます（図 6）。

図 6: インストールフォルダーの選択画面。

5. [任意] [Browse] をクリックして別のインストールパスを選択します。既定パスを推奨します。

6. [Next] をクリックします。インストール確認画面が表示されます（図 7）。

図 7: インストール確認画面。

7. [Next] ボタンをクリックしてインストールを開始します。インストール進行画面が表示されます（図 8）。インストール完了後、成功画面（図 9）が表示されます。成功画面が表示される前に、インストーラーは既定のブラウザーで Broker UI（http://localhost:5090）を開き、Broker Initial Setup ページを表示します。
   

図 8: インストール進行画面。

図 9: インストール成功通知。Broker 初期設定ウィンドウ

8. [Close] ボタンをクリックしてインストーラーを終了します。

9. Broker に戻り、Broker がデータを送信する先（クラウドアカウントまたはオンプレミスインストール）を選択します。

Broker UI の Broker Initial Setup ページ。

オンプレミスインストール:

1. Local OpenLM Installation を選択して [Continue] をクリックします。
2. EasyAdmin の URL を入力します。Url フィールドには、最初は同じマシン上の OpenLM SLM のアドレス http://localhost:5015 が入っています:
   
3. [Continue] をクリックします。Broker が EasyAdmin への接続を試行します。

Identity Service 経由で OpenLM SLM に接続している場合:

1. EasyAdmin -> Start Menu -> Administration -> System & Security -> Authorization -> Add に移動します。
   
2. ドロップダウンリストから [Broker] を選択します。
3. 適切な説明を入力します:
   
4. [Save] をクリックします。
5. Client Secret と Client ID に関する「Attention」メッセージをよく読んでから [OK] をクリックします。
   
6. 次のプロンプトで Client Secret と Client ID が表示されます。これらは Broker にインポートする必要があります。インポート方法は、JSON ファイルのダウンロードか Copy&Paste のいずれかです。適切な方法を選択して Broker に戻ります:
   
7. [Import Broker Authorization File] をクリックします。Authorization File をダウンロードしたパスを指定します。
8. Authorization File をインポートするとフィールドが自動入力されます。同様の操作は Copy&Paste でも可能です。[Continue] をクリックします。
   

[Continue] をクリックすると、Broker は接続をテストし、マシン上のライセンスマネージャーをスキャンします。次に、Broker が報告したライセンスサーバーを承認します。OpenLM のユーザーインターフェースで License Servers ウィンドウを開き、Pending の各エントリを開いて Approve を選択します。

Broker Initial Setup の最後のページ

これで OpenLM Broker のインストールは完了です。OpenLM User Interface をクリックすると EasyAdmin が開きます。設定の詳細は OpenLM Broker 設定 を参照してください。

B. OpenLM Broker のサイレントインストール

複数のインストールを展開するシステム管理者は、サイレントインストールを使用すると効率的です。この方法では、事前定義したオプションでウィザードの対話なしに OpenLM Broker をインストールできます。また、インストール時に Broker の自動検出機能が実行され、特定のライセンスマネージャー（例: FlexLM）が自動で検出・設定されます。

1. 管理者権限でコマンドプロンプトを開きます（図 10）。コマンドプロンプトは次の方法で起動できます:

• タスクバーの検索欄に cmd と入力して [ENTER]。結果の Command Prompt を右クリックし、Run as administrator を選択。
• EXE を直接起動（例: C:\Windows\System32\cmd.exe を右クリックし、Run as administrator を選択）。
• スタートメニューから Windows PowerShell を開き、Start を右クリックして Windows PowerShell (Admin) を選択。管理者モードで PowerShell が開きます。

図 10: 管理者権限で開いたコマンドプロンプト画面。

2. 管理者権限のコマンドプロンプトで、次の形式で msiexec を実行します:

msiexec /i "<full Broker MSI file path>" /qn TRANSFORMS=":I01" MSINEWINSTANCE="1" <parameters>

TRANSFORMS と MSINEWINSTANCE フラグはインストールのインスタンス ID を示します。Broker を追加インスタンスとしてインストールする場合は番号を変更してください（例: 同一マシンで 2 つ目のインストールを行う場合は :I02 と 2 など）。MSINEWINSTANCE="1" は、追加のどのインスタンスでも使用できます（例: TRANSFORMS=":I03" と組み合わせる）。

使用できるパラメータは次のとおりです:

• INSTALLLOCATION - インストールフォルダーを指定します。既定から変更する場合に使用します。フォルダーが存在しない場合は作成されます。このパラメータを省略すると既定のインストールフォルダーが使用されます（例: C:\Program Files\OpenLM\OpenLM Broker）
• OPENLMLOCATION - Broker が接続する既定の OpenLM SLM を指定します。形式は PORT@IP（例: 5015@10.0.0.201）です。
• BROKERXML - Broker フォルダーにコピーして既定の設定ファイルとして使用する Broker.xml ファイルを指定します。
• AUTH_FILE_PATH - インストール中にインポートする Broker 認証ファイルのフルパスを指定します（例: EasyAdmin でダウンロードしたファイル。A. インストールウィザードで OpenLM Broker をインストール の手順 9 を参照）。相対パスはインストールフォルダーを基準に解決されるため、フルパスを使用してください。インポートの結果はインストールフォルダーの logs\auth_import.log に記録されます。手順 5 の説明に従って確認してください。
• USE_OPENLM_JAVA - 既定の "true" では、インストーラーに同梱の OpenJDK で Broker を実行します。マシンに既にインストールされている Java を使用する場合は "false" に設定し、そのフォルダーを JAVA_PATH で指定します。
• JAVA_PATH - USE_OPENLM_JAVA が "false" の場合に使用する Java のフォルダーを指定します。

例: ログファイルを出力するサイレントインストールのコマンドは次のとおりです:

msiexec /i "C:\Users\admin\Desktop\OpenLM_Broker_22.3.30.1312.msi" /qn TRANSFORMS=":I01" MSINEWINSTANCE="1" USE_OPENLM_JAVA="true" /l*v "C:\Users\admin\Desktop\log.txt"

同じ手順で Broker 認証ファイルもインポートするには、AUTH_FILE_PATH を追加します:

msiexec /i "C:\Users\admin\Desktop\OpenLM_Broker_<version>.msi" /qn TRANSFORMS=":I01" MSINEWINSTANCE="1" AUTH_FILE_PATH="C:\Users\admin\Desktop\broker-authorization.json" /l*v "C:\Users\admin\Desktop\log.txt"

3. インストールコマンドを入力したら [Enter] を押してインストールを開始します。コマンドプロンプトは次の行に進み、バックグラウンドでインストールが完了します。

4. コマンドプロンプトを閉じます。

5. 結果を確認します。ログファイルに MainEngineThread is returning 0 が含まれ、Windows のサービスで OpenLM Broker サービスが実行中であれば、インストールは成功です。AUTH_FILE_PATH を使用した場合は、インストールフォルダーの logs\auth_import.log も開きます。ログが auth_import SUCCESS (exit=0) で終わっていれば、インポートは成功です。

   インポートに失敗した場合でも、インストールは成功と報告されます。ログが auth_import FAILED で終わっている場合は、ファイルを再度インポートし、サービスを再起動します:

   "C:\Program Files\OpenLM\OpenLM Broker\auth_import.bat" "C:\Users\admin\Desktop\broker-authorization.json"
   net stop "OpenLM Broker"
   net start "OpenLM Broker"

サイレントインストールのため、追加のユーザー入力は不要です。同じインスタンス ID（TRANSFORMS）で以前のバージョンの OpenLM Broker がマシンに登録されている場合は、自動的にアップグレードされます。インストーラーはインストールフォルダーの内容は確認しません。そのインスタンスが既に同じバージョンの場合、msiexec は終了コード 1639 で停止し、ログに「MSINEWINSTANCE requires a new instance that is not installed.」と記録されます。

OpenLM Broker を 2 インスタンス以上インストールする場合

OpenLM Broker は 2 インスタンス以上インストールできます。この構成では次の要件があります:

• 追加の OpenLM Broker インスタンスは、それぞれ別の OpenLM SLM に接続するよう構成する必要があります。
• 追加の OpenLM Broker インスタンスは、本番の OpenLM Broker と同じライセンスサーバーマシンにインストールする必要があります。

以下の手順は、対象のライセンスサーバーに 1 つの Broker インスタンスが既にインストールされていることを前提としています。追加の OpenLM Broker インスタンスをインストールするには次の手順を使用します。

1. インストーラーファイルをダブルクリックしてインストールを開始します。ウィザードの Welcome 画面が表示されます。既存インストールが検出され、画面には Upgrade、Install、Modify の 3 つのボタンが表示されます（図 11）。Upgrade はインストーラーより古いインスタンスがある場合にのみ、Modify はインストーラーと同じバージョンのインスタンスがある場合にのみ使用できます。Install は常に使用できます。並列インストールでは Install を選択します。

図 11: OpenLM Broker ウィザードのセットアップ画面。

2. [Install] をクリックして続行します。ライセンス契約画面が表示されます（図 12）。

図 12: ライセンス契約画面。

3. I Agree ラジオボタンをクリックします（図 13）。ラジオボタンをクリックすると [Next] ボタンが有効になります。

図 13: I Agree を選択したライセンス契約画面。

4. [Next] をクリックします。Java 選択画面が再び表示されます。バンドルされた OpenJDK のままにするか、図 5 と同様にインストール済みの Java を選択して、[Next] をクリックします。既定のインストールパスが表示された Select Installation Folder 画面が表示され、Broker フォルダー名に自動的に数字が追加されます（例: C:\Program Files\OpenLM\OpenLM Broker 2\、図 14）。

図 14: インストールパスが表示された Select Installation Folder 画面。

5. [任意] [Browse] ボタンをクリックして別のインストールパスを選択します。既定パスを推奨します。

6. [Next] ボタンをクリックします。Confirm Installation 画面が表示されます（図 15）。

図 15: Confirm Installation 画面。

7. [Next] をクリックしてインストールを続行します。インストール進行画面が表示されます（図 16）。インストール完了後、成功画面（図 17）が表示されます。

図 16: インストール進行画面。

図 17: インストール成功画面。

8. [Close] をクリックしてインストーラーを終了します。

9. Broker の追加インスタンスをインストールするには Step #1 から Step #8 を繰り返します。

並列インストールは完了です。

各インスタンスは、インスタンス名の Windows サービスとして個別に動作します。2 つ目のインスタンスは OpenLM Broker 2、3 つ目は OpenLM Broker 3 のようになります。各インスタンスは次の空きポートで独自の Broker UI も提供します（例: 2 つ目のインスタンスは http://localhost:5091）。また、番号付きのショートカットを含む独自のスタートメニューフォルダー OpenLM Broker 2 が作成されます。各インスタンスは、それぞれの Broker UI で接続先の OpenLM SLM に接続します。手順は A. インストールウィザードで OpenLM Broker をインストール の手順 9 と同じです。

OpenLM Broker のアンインストール

OpenLM Broker のアンインストールは、Windows のコントロールパネル（Option A）、OpenLM Broker Setup Wizard からの変更（Option B）、または Windows Shell でのサイレントアンインストールで実行できます。

Option A: Windows コントロールパネルからアンインストール

1. Windows コントロールパネルを開きます。

2. Programs の下にある Uninstall a program をクリックします（図 18）。Programs and Features 画面が表示されます。

図 18: Programs の下に Uninstall a program リンクがある Windows コントロールパネル。

3. 名前一覧から OpenLM Broker を探してクリックします（Name をクリックしてアルファベット順に並べ替え可能）。プログラムの操作オプションが一覧上部に表示されます（図 19）。OpenLM Broker のオプションは Uninstall と Repair です。インスタンスごとに個別のエントリがあります（例: OpenLM Broker 2）。

図 19: OpenLM Broker を選択した Programs and Features 画面。

4. Uninstall をクリックします。確認画面が表示されます（図 20）。

図 20: アンインストール確認画面。

5. [Yes] をクリックしてアンインストールを確定します。進行画面が表示されます（図 21）。進行画面は処理完了時に閉じます。

図 21: OpenLM Broker のアンインストール進行画面。

6. Programs and Features 画面は右上の [x] をクリックして閉じます。

これでコントロールパネルからのアンインストールは完了です。OpenLM Broker の設定ファイルは削除されず、再インストール時に以前の設定を保持するために残されています。必要であれば手動で削除してください。既定では C:\Program Files\OpenLM\OpenLM Broker (#) にあります。フォルダーには broker.xml、broker.id、broker.xml.backup、application.properties と、bufferfiles、logs、markerfiles の各フォルダーが残ります。アンインストールでは、Windows サービス、スタートメニューのフォルダー、プログラムファイルが削除されます。同じフォルダーに再インストールすると、Broker は残された broker.xml と broker.id を使用して起動します。その場合、サービスの準備ができる前にインストーラーが Broker UI を開くことがあります。ブラウザーに localhost への接続が拒否されたと表示された場合は、数秒待ってからページを再読み込みしてください。

Option B: OpenLM インストーラーパッケージからアンインストール

1. インストーラーファイルを探してダブルクリックします。OpenLM Broker Setup Wizard 画面が表示され、Upgrade、Install、Modify のボタンがあります（図 22）。Modify は、インストーラーがインストール済みのインスタンスと同じバージョンの場合にのみ使用できます。

図 22: OpenLM Broker Setup Wizard 画面。

2. Modify をクリックして削除オプションを選択します（図 22）。

3. Select Instance 画面が表示されます（図 23）。各インスタンスがバージョン付きで一覧表示されます。

図 23: Select Instance 画面。

4. リストからインスタンスを選択します（一覧の最初のインスタンスは既にハイライトされています）。

5. [Remove] ボタンをクリックします。

6. 進行画面が表示されます。
   

図 24: OpenLM Broker の削除進行画面。

7. OpenLM Broker に関連するプロセスがまだ稼働中の場合は、関係するプロセス情報を含むエラー画面が表示されます。これらのプロセスは Windows Services で停止できます（例: C:\WINDOWS\system32\services.msc を実行するか、タスクバーの Windows 検索で Services と入力して Services アプリを選択します）。停止後、[Try Again] をクリックして削除を続行します。削除が完了すると、削除成功画面が表示されます（図 25）。

図 25: 削除成功画面。

8. [Close] ボタンをクリックして Setup Wizard を終了します。

これで OpenLM Broker Installer ウィザードを使用した削除は完了です。OpenLM Broker の設定ファイルは削除されず、再インストール時に以前の設定を保持するために残されています。必要であれば手動で削除してください。既定では C:\Program Files\OpenLM\OpenLM Broker (#) にあります。

Option C: OpenLM Broker のサイレントアンインストール

サイレントでアンインストールしたいシステム管理者は、以下の方法を使用できます。

1. 管理者権限でコマンドプロンプトを開きます（図 26）。コマンドプロンプトは管理者権限で実行する必要があります。起動方法は「B. OpenLM Broker のサイレントインストール」の該当セクションを参照してください。

図 26: 管理者権限で開いたコマンドプロンプト画面。

2. コマンドプロンプトで、次の形式でアンインストール用パラメータを入力します:

msiexec /x "<msi installation file path>" /qn TRANSFORMS=":I##"

MSI ファイルパスは、インストール用にダウンロードした MSI ファイルの場所です。シンプルなアンインストール例は次のとおりです（アンインストール対象のインスタンス番号を示す TRANSFORMS パラメータ [:I##] を含みます）。

msiexec /x "C:\Users\admin\Desktop\OpenLM_Broker_22.3.30.1312.msi" /qn TRANSFORMS=":I01"

MSI は、削除するインスタンスと同じバージョンである必要があります。バージョンが異なるとインストーラーはインスタンスを検出できず、ログに「Failed to detect Broker instance to uninstall.」と記録されます。

3. アンインストールコマンドを入力したら [Enter] を押してアンインストールを開始します。コマンドプロンプトは次の行に進み、バックグラウンドでアンインストールが完了します。

4. 右上の [x] をクリックしてコマンドプロンプトを閉じます。

サイレントアンインストールのため、追加のユーザー入力は不要です。OpenLM Broker の設定ファイルは削除されず、再インストール時に以前の設定を保持するために残されています。必要であれば手動で削除してください。既定では C:\Program Files\OpenLM\OpenLM Broker (#) にあります。