---
title: Linux または Unix に Broker をインストールする
description: Linux または Unix のライセンスサーバーに OpenLM Platform 用の OpenLM Broker を tar.gz アーカイブまたは DEB/RPM パッケージからインストールし、サービスとして実行して、detect.sh で設定します。
product: OpenLM Platform
---

Linux または Unix に Broker をインストールするには、tar.gz アーカイブ、またはお使いのディストリビューション向けの DEB または RPM パッケージを使用します。手順は systemd を使用するディストリビューションと、それ以外の init システムを使用するディストリビューションの両方に対応しています。サポートされているディストリビューションと Java のバージョンについては、[システム要件](https://www.openlm.com/documentation/ja/cloud/deployment-operations/system-requirements/?component=broker)を参照してください。

Linux 版の Broker は 3 つの形式で提供しています。入手先は[インストーラーをダウンロードする](https://www.openlm.com/documentation/ja/cloud/getting-started/install-broker/index#インストーラーをダウンロードする)を参照してください。

- **tar.gz** アーカイブ: すべてのディストリビューション向け。以降のセクションで説明します。
- **DEB** パッケージ: Debian および Ubuntu 向け。
- **RPM** パッケージ: RHEL 系システム向け。

パッケージについては、[DEB または RPM パッケージからインストールする](#deb-または-rpm-パッケージからインストールする)を参照してください。

## 開始する前に

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

- マシンに Java ランタイム (JRE または JDK) をインストールする。Java 11 以降、または Java 8 に対応しています。Java 9 および 10 はサポートされていません。サポートされているディストリビューションについては、[システム要件](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-の設定) を参照してください。

## tar.gz のインストールを準備する

tar.gz のインストールを準備するには、次の手順を実行します。

1. Unix/Linux 用の Broker をダウンロードします。[インストーラーをダウンロードする](https://www.openlm.com/documentation/ja/cloud/getting-started/install-broker/index#インストーラーをダウンロードする)を参照してください。

2. アーカイブ `OpenLM_Broker_<version>.tar.gz` を任意のフォルダーに展開します。

   `<version>` は、アーカイブ名に含まれるビルド番号を表します。アーカイブを展開すると `openlm-broker` という名前のフォルダーが作成されます。

3. テキストエディターで `settings.sh` を開きます。

4. `JAVA_HOME` に Java ランタイム (Java 11 以降、または Java 8) のパスを設定します。

   `settings.sh` には、Broker に必要な変数が含まれています。出荷時のファイルでは `JAVA_HOME` が空です。`JAVA_HOME` のパスの末尾にスラッシュを付けないでください。

   `root` 以外のアカウントでサービスを実行するには、`BROKERSRVNAMEUSER` にそのアカウントを設定し、`openlm-broker` フォルダー内のすべてのファイルの所有権をそのアカウントに割り当てます。

   複数の Broker インスタンスを並行して実行するには、インスタンスごとに個別の `BROKERSRVNAME` を設定します。

   出荷時のファイルは次のとおりです。

   ```text
   #!/usr/bin/env bash
   # Edit this file and customize service name in order to install multiple Broker services in parallel
   BROKERSRVNAMEUSER="root"
   BROKERSRVNAME="openlm_broker_$BROKERSRVNAMEUSER"
   BROKERSRVNAMEFILE="$BROKERSRVNAME.service"

   #Change JAVA_HOME to point at installation folder
   [[ -z "$JAVA_HOME" ]] && JAVA_HOME=
   ```

5. ファイルを保存します。続いて、お使いの init システムに対応するセクションに進みます。

## Broker をサービスとしてインストールする (systemd)

systemd を使用するシステムでは、マシンの起動時に開始するサービスとして Broker をインストールします。

1. Broker サービスをインストールします。

   ```bash
   sudo ./broker.sh install
   ```

2. Broker サービスのステータスを確認します。

   ```bash
   sudo ./broker.sh status
   ```

3. [Broker を OpenLM Platform に接続する](#broker-を-openlm-platform-に接続する)の説明に従って、Broker を OpenLM Platform に接続します。

4. (任意) デスクトップ環境があるマシンでは、ローカルの設定ツールを開きます。

   ```bash
   sudo ./broker.sh config
   ```

Broker を接続したら、[ライセンスマネージャーを検出する](#ライセンスマネージャーを検出する)の説明に従って、ライセンスマネージャーを追加します。ブラウザーで Broker を設定するには、[Broker UI](https://www.openlm.com/documentation/ja/cloud/getting-started/install-broker/index#broker-ui) を参照してください。

## Broker をバックグラウンドプロセスとして実行する (systemd なし)

systemd を使用しないシステムでは、Broker をバックグラウンドプロセスとして開始します。

```bash
sudo ./broker.sh start
```

Broker の設定ツールを開くには:

```bash
sudo ./run_brokerconfig.sh
```

次に、[Broker を OpenLM Platform に接続する](#broker-を-openlm-platform-に接続する)の説明に従って、Broker を OpenLM Platform に接続します。そのセクションの再起動では、`restart` に systemd が必要なため、`stop` に続けて `start` を実行します。

## DEB または RPM パッケージからインストールする

ディストリビューションのパッケージマネージャーで Broker をインストールするには、[ダウンロードページ](https://www.openlm.com/downloads/)から DEB または RPM パッケージをダウンロードしてインストールします。

Debian/Ubuntu 系システムの場合:

```bash
sudo dpkg -i openlm_broker_<version>_amd64.deb
# If dpkg reports missing dependencies, resolve them with:
sudo apt-get install -f
```

RHEL 系システムの場合:

```bash
sudo rpm -ivh openlm_broker_<version>.x86_64.rpm
```

パッケージからのインストールは、tar.gz アーカイブとは次の 3 点で異なります。

- ファイルは固定のフォルダー `/opt/broker` に配置されます。設定用のスクリプトはこのフォルダーから実行してください。
- RPM パッケージは、`PATH` 上で最初に見つかった `java` をもとに `settings.sh` の `JAVA_HOME` を設定します。Java ランタイムが複数あるマシンでは、意図したものが選ばれたか確認してください。
- パッケージが systemd サービスを登録して開始するため、`./broker.sh install` を実行する必要はありません。

パッケージからのインストール後は、[Broker を OpenLM Platform に接続する](#broker-を-openlm-platform-に接続する)と[ライセンスマネージャーを検出する](#ライセンスマネージャーを検出する)の説明に従って、認証ファイルをインポートし、ライセンスマネージャーを検出します。

## Broker.sh のコマンド

次の `broker.sh` コマンドで Broker サービスを管理します。

| コマンド名 | 説明 | systemd が必要 |
| --- | --- | --- |
| `install` | `systemctl enable` を使用して OpenLM Broker をサービスとしてインストールします | 必要 |
| `uninstall` | インストール済みの OpenLM Broker インスタンスがサービスとして起動しないように無効化します | 必要 |
| `start` | OpenLM Broker サービスを開始します | 不要 |
| `stop` | OpenLM Broker サービスを停止します | 不要 |
| `restart` | OpenLM Broker サービスを再起動します | 必要 |
| `status` | OpenLM Broker サービスの現在のステータスを表示します | 不要 |
| `config` | ローカルの Broker 設定ツールを起動します | 不要 |

次の形式でコマンドを実行します。

```bash
sudo ./broker.sh <command>
```

`broker.sh` は systemd の有無を確認し、対応するスクリプトを実行します。systemd がないマシンでは、systemd が必要な 3 つのコマンドは何も実行せず、使用方法を表示して終了します。`restart` の代わりに `stop` と `start` を順に実行してください。

## Broker を OpenLM Platform に接続する

この Broker 用に生成した[認証ファイル](https://www.openlm.com/documentation/ja/cloud/getting-started/authorize-components)を `auth_import.sh` でインポートします。systemd の有無、tar.gz アーカイブかパッケージかにかかわらず、すべてのインストールでこの操作を行います。インポートするまで、Broker は **Pending Brokers** に表示されません。

1. ダウンロードした認証用の `.json` ファイルを、OpenLM Broker がインストールされているフォルダーにコピーします。
2. root として次のコマンドでインポートします。

   ```bash
   sudo ./auth_import.sh <authorization-file>.json
   ```

   インポートはバックグラウンドで実行され、結果はターミナルではなく、Broker フォルダーの `logs/auth_import_nohup.log` に書き込まれます。このファイルで `Saving broker.xml` の行を確認します。
3. 認証情報を反映させるため、Broker を再起動します。

   ```bash
   sudo ./broker.sh restart
   ```

   systemd がないマシンでは `restart` は使用できません。代わりにプロセスを停止してから開始してください。

   ```bash
   sudo ./broker.sh stop
   sudo ./broker.sh start
   ```

4. OpenLM Platform で、[接続を確認する](https://www.openlm.com/documentation/ja/cloud/getting-started/install-broker/index#接続を確認する)の説明に従って Broker を承認します。

### セルフホストの OpenLM Platform に接続する

Broker をセルフホストの OpenLM Platform に接続するには、ご自身の OpenLM Platform で認証ファイルを生成し、前の手順と同じようにインポートします。このファイルには、お使いの OpenLM Platform のアドレスが含まれています。代わりに Broker UI を使用する場合は、**Broker Initial Setup** で **OpenLM Cloud Account** を選択します。このオプションが OpenLM Platform 用です。**Local OpenLM Installation** は OpenLM SLM 用です。次に、**Import Broker Authorization File** を選択します。

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 の設定に追加するには、root として `detect.sh` を実行します。このスクリプトは、サポートされているライセンスマネージャーのポートを検出し、設定ファイルに追加します。

このスクリプトは、次のどちらかの方法で動作します。

- 設定ファイルがない場合は、マシン上で開いていると検出されたライセンスマネージャーのポートを含む設定ファイルを作成します。
- 設定ファイルがある場合は、不足しているポートをそのファイルに追加します。その前に、元のファイルを隣接する `broker.xml.backup` フォルダーに `broker.xml.2026-08-24T153045123` のようなタイムスタンプ付きの名前でコピーするため、繰り返し実行しても以前のバックアップは上書きされません。

次の形式で実行します。

```bash
sudo ./detect.sh <file-name>.xml
```

`<file-name>.xml` は、設定ファイルの名前に置き換えます。このスクリプトは指定したファイルを更新し、そのファイルを `broker.xml` にマージしません。Broker サービスが読み込むのは `broker.xml` だけなので、別の名前のファイルは、名前を変更するか `broker.xml` に上書きコピーするまで反映されません。Broker の設定を直接更新するには:

```bash
sudo ./detect.sh broker.xml
```

同じポート構成を多数のライセンスサーバーに適用するには、設定済みの Broker マシンから `broker.xml` をコピーし、`detect.sh` でインポートします。対象マシンに `broker.xml` が既に存在する場合は、コピーしたファイルの名前を先に変更してください。

```bash
sudo ./detect.sh brokerAddon.xml
```

## Broker を確認する

インストール後、[接続を確認する](https://www.openlm.com/documentation/ja/cloud/getting-started/install-broker/index#接続を確認する)の説明に従って、OpenLM Platform で Broker を承認し、ライセンスマネージャーを接続して承認します。Broker をアップグレードするには、[Broker をアップグレードする](https://www.openlm.com/documentation/ja/cloud/getting-started/install-broker/manage#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)に進み、エンドユーザーマシンからアクティビティデータを収集してください。
:::