--- title: Windows に Broker をインストールする description: Windows のライセンスサーバーに OpenLM Platform 用の OpenLM Broker をインストールウィザードまたはサイレントでインストールし、認証ファイルで OpenLM Platform に接続します。 product: OpenLM Platform --- Windows のライセンスサーバーからライセンスの使用状況を収集するには、ライセンスサーバー上 (またはその近く) に Broker をインストールし、認証ファイルで OpenLM Platform に接続します。OpenLM Broker インストーラー `OpenLM_Broker_.msi` をダウンロードします ([インストーラーをダウンロードする](https://www.openlm.com/documentation/ja/cloud/getting-started/install-broker/index#インストーラーをダウンロードする)を参照)。次に、インストールウィザードを使用するか、コマンドラインからサイレントに Broker をインストールします。インストーラーには Java ランタイムが含まれています。 ## 開始する前に 次の前提条件を確認します。 - ライセンスサーバーマシンが[システム要件](https://www.openlm.com/documentation/ja/cloud/deployment-operations/system-requirements/?component=broker)を満たしている。 - ライセンスサーバーごとに 1 つの Broker を用意する計画である。1 つの Broker は同一マシン上の複数のライセンスマネージャーを監視できますが、ライセンスサーバーを追加するたびに専用の Broker が必要です。 - この Broker 用の[認証ファイル](https://www.openlm.com/documentation/ja/cloud/getting-started/authorize-components)がある。 - Broker マシンからライセンスマネージャーサーバーおよびインターネット (ポート 443) へのネットワークアクセスがある。Broker がインターネットに直接接続できない場合は、HTTP または HTTPS プロキシ経由で接続します (資格情報の設定も可能)。[Proxy Configuration](https://www.openlm.com/documentation/ja/cloud/data-collection/openlm-broker/#broker-の設定) を参照してください。 ## インストールウィザードでインストールする インストールウィザードで Broker をインストールするには、次の手順を実行します。 1. インストーラーファイル `OpenLM_Broker_.msi` を開きます。 *Windows インストーラーによるインストールの準備* 2. **Welcome** ページで **Next** を選択します。 *Welcome ページ* 3. **License Agreement** ページで **I Agree** を選択し、**Next** を選択します。 **I Agree** を選択すると **Next** を選択できるようになります。変更を加えずにインストーラーを終了するには、**Cancel** を選択します。 *I Agree を選択した License Agreement ページ* 4. **Java Selection** ページで **Next** を選択し、インストーラーに同梱の Java ランタイム (**Install Broker with Java 11 OpenJDK**) を使用します。 インストール済みの Java ランタイムを使用するには、**Already have Java 11 installed?** を選択してそのフォルダーを指定し、**Next** を選択します。インストーラーは Java 8、Java 11、および 11 より新しいバージョンを受け付けます。Java がインストールされていないマシンでは、インストーラーが同梱のランタイムを選択します。 *Java Selection ページ* 5. **Select Installation Folder** ページで、既定のフォルダー `C:\Program Files\OpenLM\OpenLM Broker\` のまま **Next** を選択します。 別のフォルダーにインストールするには、先に **Browse** を選択します。 *Select Installation Folder ページ* 6. **Confirm Installation** ページで **Next** を選択して、インストールを開始します。 *Confirm Installation ページ* 7. インストールが完了するまで待ちます。 *インストールの進行中* 8. **Close** を選択します。 次に、ブラウザーで操作を続けます。インストールが完了すると、インストーラーが既定のブラウザーで [Broker UI](https://www.openlm.com/documentation/ja/cloud/getting-started/install-broker/index#broker-ui) の **Broker Initial Setup** ページを開きます。Broker UI は Broker サービスが配信し、マシン上の最初の Broker のアドレスは `http://localhost:5090` です。 *Broker UI の前面に表示されたインストーラーの最後のページ* 9. **Broker Initial Setup** ページで、**OpenLM Cloud Account** の下の **Continue** を選択します。 Broker を後で設定する場合は、**skip Broker initial setup** を選択します。 *Broker を OpenLM Platform に接続するには OpenLM Cloud Account を選択します* 10. **Import Broker Authorization File** を選択し、この Broker 用に生成した認証ファイルを選択します。 ファイルの内容で、OpenLM Platform のリージョンのアドレスを含む **Url**、**Client ID**、**Client Secret** が入力されます。値を手動で入力することもできます。 *認証ファイルをインポートして接続情報を入力します* 11. **Continue** を選択します。 Broker が OpenLM Platform への接続をテストした後、マシン上のライセンスマネージャーをスキャンし、検出したものを事前設定します。 *Broker Initial Setup の最後のページ* 12. **OpenLM User Interface** を選択して、OpenLM Platform の **Broker Hub** を開きます。 13. **Pending Brokers** を選択します。 14. Broker を選択します。 15. **Approve Brokers** を選択します。 次に、[接続を確認する](https://www.openlm.com/documentation/ja/cloud/getting-started/install-broker/index#接続を確認する)の説明に従って、ライセンスマネージャーを接続して承認します。 ## サイレントインストール 多数のライセンスサーバーに Broker を展開する場合や、スクリプトから展開する場合は、サイレントインストールを使用します。`msiexec` は、コマンドラインで指定したオプションを使用し、ウィザードなしで Broker をインストールします。 サイレントインストールでも、マシン上のライセンスマネージャーがスキャンされます。インストーラーは Broker サービスを開始するときに、インストールフォルダーの `detect.bat` (`detect.sh` の Windows 版) を実行します。あらかじめ用意した設定ファイルから開始するには、`BROKERXML` で指定します。 Broker をサイレントインストールするには、次の手順を実行します。 1. 次のいずれかの方法で、管理者としてコマンドプロンプトを開きます。 - タスクバーの検索フィールドに `cmd` と入力します。結果の**コマンドプロンプト**のコンテキストメニューを開き、**管理者として実行**を選択します。 - `C:\Windows\System32\cmd.exe` のコンテキストメニューを開き、**管理者として実行**を選択します。 - **スタート**のコンテキストメニューを開き、**Windows PowerShell (管理者)** を選択します。 2. 次の形式で、インストールオプションを指定して `msiexec` を実行します。 ```bash msiexec /i "" /qn TRANSFORMS=":I01" MSINEWINSTANCE="1" ``` `` は Broker の MSI ファイルのフルパスに、`` は必要なパラメーターに置き換えます。`TRANSFORMS` はインスタンス ID を指定します。同じマシンに Broker を追加するたびに次の ID を使用し (例: 2 つ目は `:I02`)、`MSINEWINSTANCE="1"` はそのままにします。1 台のマシンで実行できるインスタンスは最大 10 個で、インスタンス ID は `:I01` から `:I10` までです。 次のパラメーターを追加できます。 - `INSTALLLOCATION`: インストールフォルダー。フォルダーが存在しない場合は、インストーラーが作成します。このパラメーターを省略すると、既定のフォルダー `C:\Program Files\OpenLM\OpenLM Broker\` が使用されます。 - `BROKERXML`: インストールフォルダーにコピーして、最初の設定として使用する `broker.xml` ファイル。 - `AUTH_FILE_PATH`: この Broker 用の[認証ファイル](https://www.openlm.com/documentation/ja/cloud/getting-started/authorize-components)のフルパス。インストーラーがファイルをインポートするため、Broker は **Broker Initial Setup** を使わずに OpenLM Platform に接続します。インストーラーは相対パスをインストールフォルダーを基準に解決するため、フルパスを指定してください。平文と暗号化済みのどちらの認証ファイルにも対応しています。 - `USE_OPENLM_JAVA`: 既定値の `"true"` では、インストーラーに同梱の Java ランタイムで Broker を実行します。インストール済みの Java ランタイムを使用するには `"false"` に設定し、そのフォルダーを `JAVA_PATH` で指定します。 - `JAVA_PATH`: `USE_OPENLM_JAVA` が `"false"` の場合に使用する、インストール済み Java ランタイムのフォルダー。指定がない場合、または互換性のない Java バージョンを指している場合、インストールは失敗します。 :::note 認証ファイルのインポートに失敗した場合 (パスの誤りやファイルを読み取れない場合など) でも、インストールは成功として報告されます。手順 4 の説明に従って、インストール後にインポートを確認してください。インポートが成功した場合、再起動は不要です。 ::: たとえば、同梱の Java ランタイムで最初のインスタンスをインストールし、認証ファイルをインポートして、ログファイルを書き出すには、次のコマンドを実行します。 ```bash msiexec /i "C:\Users\admin\Desktop\OpenLM_Broker_.msi" /qn TRANSFORMS=":I01" MSINEWINSTANCE="1" USE_OPENLM_JAVA="true" AUTH_FILE_PATH="C:\Users\admin\Desktop\broker-auth.json" /l*v "C:\Users\admin\Desktop\log.txt" ``` 3. **Enter** を押してコマンドを実行します。 インストールはバックグラウンドで実行され、コマンドプロンプトはすぐに戻ります。 *管理者のコマンドプロンプトで実行したサイレントインストールのコマンド* 4. インストールが完了したら、結果を確認します。 - ログファイルに `MainEngineThread is returning 0` が含まれている。 - Windows のサービスで **OpenLM Broker** サービスが実行されている。 - `AUTH_FILE_PATH` を使用した場合、インストールフォルダーの `logs\auth_import.log` が `auth_import SUCCESS (exit=0)` で終わっている。 5. `auth_import.log` が `auth_import FAILED` で終わっている場合は、認証ファイルを再度インポートしてから、サービスを再起動します。 ```bat "C:\Program Files\OpenLM\OpenLM Broker\auth_import.bat" "C:\Users\admin\Desktop\broker-auth.json" net stop "OpenLM Broker" net start "OpenLM Broker" ``` ## Broker をサイレントにアップグレードする Broker をサイレントにアップグレードするには、新しいインストーラーと、アップグレードする Broker のインスタンス ID を指定してインストールコマンドを実行します。 インストーラーは、インストールフォルダーの内容ではなく、`TRANSFORMS` のインスタンス ID を使ってマシンに登録されている Broker インスタンスから以前のバージョンを見つけ、そのインスタンスをその場でアップグレードします。 インスタンスがすでに同じバージョンまたは新しいバージョンの場合は、アップグレードせずにエラーで停止します。繰り返し再展開するスクリプトでは、事前にインストール済みのバージョンを確認してください。同じバージョンの場合、`msiexec` は終了コード 1639 で終了し、`MSINEWINSTANCE requires a new instance that is not installed.` を記録します。 ## セルフホストの OpenLM Platform に接続する Broker をセルフホストの OpenLM Platform に接続するには、ご自身の OpenLM Platform で認証ファイルを生成します。このファイルには、お使いの OpenLM Platform のアドレスが含まれています。次のいずれかの方法で Broker を接続します。 - **インストールウィザードで**: **Broker Initial Setup** で、**OpenLM Cloud Account** の下の **Continue** を選択します。このオプションが OpenLM Platform 用です。**Local OpenLM Installation** は OpenLM SLM 用です。次に、**Import Broker Authorization File** を選択します。 - **サイレントインストールで**: `AUTH_FILE_PATH` でファイルを渡します。 Broker マシンがお使いの OpenLM Platform の証明書を信頼していない場合は、先に証明書をインポートします。[Broker 用の TLS 証明書をインポートする](https://www.openlm.com/documentation/ja/cloud/getting-started/install-broker/manage#broker-に-tls-証明書をインポートする)を参照してください。接続を確認するには、[Broker UI](https://www.openlm.com/documentation/ja/cloud/getting-started/install-broker/index#broker-ui) の **OpenLM Servers** 画面で **Check Connectivity** を選択します。 ## Broker を確認する インストール後、[接続を確認する](https://www.openlm.com/documentation/ja/cloud/getting-started/install-broker/index#接続を確認する)の説明に従って、OpenLM Platform で Broker を承認し、ライセンスマネージャーを接続して承認します。新しい Broker が **Pending Brokers** に表示されない場合は、[新しい Broker が Pending Brokers に表示されないのはなぜですか？](https://www.openlm.com/documentation/ja/cloud/getting-started/install-broker/troubleshooting#新しい-broker-が-pending-brokers-に表示されないのはなぜですか)を参照してください。 :::note[次のステップ] [最初のライセンスマネージャーを接続する](https://www.openlm.com/documentation/ja/cloud/getting-started/connect-first-license-manager)に進みます。続いて、[Workstation Agent のインストール](https://www.openlm.com/documentation/ja/cloud/getting-started/install-workstation-agent/index)に進み、エンドユーザーマシンからアクティビティデータを収集してください。 :::