OpenLM Broker の Linux/Unix インストール

Linux または Unix のライセンスサーバーに OpenLM Broker をインストールすると、そのマシン上のライセンスマネージャーを照会し、使用状況を OpenLM SLM または Software License Management Cloud (SLMC) に送信できるようになります。Windows にインストールする場合は、OpenLM Broker の Windows インストールを参照してください。

この手順は、systemd を使用するディストリビューションと、それ以外の init システムを使用するディストリビューションの両方を対象とします。OpenLM がテストしているディストリビューションについては、システム要件を参照してください。

開始する前に

インストールの前に、次の点を確認してください。

• Java: マシンに動作する Java ランタイム (JRE または JDK) がインストールされている必要があります。Java 11 以降、または Java 8 が対象で、Java 9 と 10 はサポートされていません。Windows インストーラーと異なり、Linux 版のダウンロードには Java が含まれていません。
• ライセンスサーバーごとに 1 つの Broker: 1 つの Broker で同じマシン上の複数のライセンスマネージャーを監視できますが、ライセンスサーバーを追加するごとに Broker が 1 つ必要です。サーバーごとにこのページの手順を繰り返してください。
• ネットワークアクセス: Broker は、同じマシン上のライセンスマネージャーと、送信先の OpenLM SLM (既定ではポート 5015) にアクセスできる必要があります。SLMC の場合はインターネットへのアクセスが必要です。Broker がプロキシ経由でしかインターネットにアクセスできない場合は、OpenLM Broker の HTTP プロキシサーバー経由の接続を参照してください。
• 認証ファイル: SLMC、または Identity Service を使用する OpenLM SLM に接続する場合は、Broker の認証ファイル (.json) を用意してください。入手方法は認証ファイルをインポートするで説明しています。

Broker をダウンロードする

Linux 版の Broker はダウンロードページから入手できます。次の形式があり、いずれも x86-64 向けです。

• すべてのディストリビューションで動作する tar.gz アーカイブ。tar.gz アーカイブからインストールするを参照してください。
• Debian/Ubuntu 系および RHEL 系向けのネイティブ DEB / RPM パッケージ。DEB または RPM パッケージからインストールするを参照してください。

tar.gz アーカイブからインストールする

事前準備

1. アーカイブ (OpenLM_Broker_#.#.#.#.tar.gz) を任意の場所に展開します。展開すると openlm-broker という名前のフォルダーが作成されます。

2. お好みのエディターで settings.sh ファイルを開きます。このファイルには、Broker の動作に必要なすべての変数が含まれています。出荷時のファイルでは JAVA_HOME が空のため、Java ランタイム (Java 11 以降、または Java 8) のパスを設定する必要があります。

   JAVA_HOME のパスの末尾にスラッシュを付けてはいけません。

   「root」以外のアカウントでサービスを実行する場合は、BROKERSRVNAMEUSER 変数を編集します。この場合、openlm-broker フォルダー内のすべてのファイルの所有権を新しいユーザーに再割り当てする必要があります。

   OpenLM Broker の複数インスタンスを並行してインストールする場合は、BROKERSRVNAME 変数を変更します。

   出荷時のファイル:

   #!/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=

3. ファイルを保存し、お使いの Linux ディストリビューションに応じたインストール手順に進みます。

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

お使いの Linux バージョンが systemd をサポートしている場合、次の手順で OpenLM Broker をシステム起動時に自動的に開始するサービスとしてインストールします。

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

   sudo ./broker.sh install

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

   sudo ./broker.sh status

3. Broker を OpenLM SLM または SLMC に接続するの説明に従って、Broker を接続し、ライセンスマネージャーを追加します。

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

お使いの Linux バージョンが systemd をサポートしていない場合は、次の手順で OpenLM Broker をバックグラウンドプロセスとして実行します。

1. Broker プロセスを開始します。

   sudo ./broker.sh start

2. Broker を OpenLM SLM または SLMC に接続するの説明に従って、Broker を接続し、ライセンスマネージャーを追加します。

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

tar.gz アーカイブの代わりに、ディストリビューション向けのネイティブパッケージをインストールすることもできます。

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

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

RHEL 系システムの場合:

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 の接続とライセンスマネージャーの追加です。Broker を OpenLM SLM または SLMC に接続するを参照してください。

Broker を OpenLM SLM または SLMC に接続する

インストール直後の Broker は、照会するライセンスマネージャーも、データの送信先もまだ知りません。マシンに合った方法を選んでください。

• デスクトップのないサーバーでは、Broker フォルダー内のスクリプトを使用します。オンプレミスの OpenLM SLM には detect.sh、SLMC または Identity Service には auth_import.sh を使います。
• ネットワーク上の任意のブラウザーからは、Broker Web UI を使用します。
• デスクトップ環境があるマシンでは、sudo ./broker.sh config でローカルの設定ツールを開きます。

detect.sh を使用した Broker の設定

detect.sh スクリプトは、マシン上で動作しているサポート対象のライセンスマネージャーを検出し、そのポートを Broker の設定ファイルに追加します。OpenLM SLM のアドレスを指定すると、その OpenLM SLM への接続も追加します。

正しく動作させるには、detect.sh を root として実行する必要があります。

このスクリプトには次のような動作があります。

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

コマンド形式:

sudo ./detect.sh <fileName.xml> [<port>@]<OpenLM SLM host>

2 番目のパラメーターは省略可能です。指定したホスト上のオンプレミスの OpenLM SLM への接続を追加します。ホスト名の前に別のポートを付けない限り、ポートは 5015 です。

detect.sh は指定したファイルを対象とし、その場で更新します。指定したファイルを broker.xml にマージするわけではありません。Broker サービスは常に broker.xml を読み込むため、別の名前を指定して実行した場合、そのファイルの名前を変更するか broker.xml に上書きコピーするまで設定は反映されません。

たとえば、ライセンスマネージャーを検出し、slm.example.com の OpenLM SLM に既定のポートで接続するには、次のコマンドを実行します。

sudo ./detect.sh broker.xml slm.example.com

別のポート (たとえば古いインストールで使われている 7016) を使用する場合:

sudo ./detect.sh broker.xml 7016@slm.example.com

ポートが見つからない場合は、-v を付けて再実行すると、詳細なログが Broker のログに書き込まれます。例: sudo ./detect.sh -v broker.xml

実行後、新しい設定を読み込ませるため Broker を再起動します。Broker を再起動するを参照してください。

認証ファイルをインポートする

Broker を SLMC、または Identity Service を使用するオンプレミスの OpenLM SLM に接続するには、auth_import.sh で Broker の認証ファイルをインポートします。まず認証ファイルを生成します。

• SLMC の場合は Cloud Portal で生成します。Automatic mode を参照してください。
• Identity Service を使用するオンプレミスの OpenLM SLM の場合は EasyAdmin で生成します。OpenLM SLM(Server) の追加を参照してください。

インポートするには:

1. 認証用の .json ファイルを、OpenLM Broker がインストールされているフォルダーにコピーします。

2. root として次のコマンドでインポートします。

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

   インポートはバックグラウンドで実行され、結果はターミナルではなく Broker フォルダー内の logs/auth_import_nohup.log に書き込まれます。このファイルに Saving broker.xml の行があることを確認してください。

3. 認証情報を反映させるため、Broker を再起動します。Broker を再起動するを参照してください。

auth_import.sh は、broker.xml にすでにあるすべての OpenLM SLM 接続に認証情報を書き込みます。接続が 1 つもない場合は、接続を 1 つ追加します。送信先が 1 つの Broker で使用してください。1 つの Broker からオンプレミスの OpenLM SLM と SLMC の両方に送信する場合は、2 つ目の接続を Broker Web UI で追加します。

ブラウザーから Broker を設定する

Broker は、broker.xml で webUIPort が off に設定されていない限り、既定でポート 5090 でブラウザー用のインターフェイスを提供します。デスクトップ環境は不要です。ライセンスサーバー自体で開く場合はログインは不要です。別のコンピューターから開く場合は、ライセンスサーバー上で生成する有効期間の短いトークンが必要です。リモートアクセスと OpenLM SLM 接続の追加については、OpenLM Broker Web UI を参照してください。

別の Broker から設定をコピーする

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

sudo ./detect.sh brokerAddon.xml

Broker を再起動する

設定を変更したら、Broker を再起動します。

sudo ./broker.sh restart

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

sudo ./broker.sh stop
sudo ./broker.sh start

Broker.sh のコマンド

broker.sh では次のコマンドを使用できます。

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

コマンド形式:

sudo ./broker.sh <command>

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

既存の Broker インストールをアップグレードする

tar.gz アーカイブからインストールした Broker をアップグレードするには:

1. ダウンロードページから Unix/Linux 用の最新バージョンの OpenLM Broker をダウンロードします。
2. 現在の Broker インストールを削除します。

   • systemd を使用している場合は、現在の Broker サービスをアンインストールします。

     sudo ./broker.sh uninstall

   • systemd を使用していない場合は、Broker プロセスを停止します。

     sudo ./broker.sh stop

3. アーカイブ (OpenLM_Broker_#.#.#.#.tar.gz) を任意の場所に展開します。
4. 以前の Broker インストールフォルダーから broker.xml と settings.sh ファイルを新しいフォルダーにコピーします (必要に応じて上書きします)。
5. 新しい openlm-broker フォルダーから、新しいバージョンの Broker サービスをインストールします。

   • systemd を使用している場合は、サービスをインストールします。

     sudo ./broker.sh install

   • systemd を使用していない場合は、プロセスを開始します。

     sudo ./broker.sh start

その後、Broker Web UI または sudo ./broker.sh config で、設定とライセンスサーバーが変わっていないことを確認します。さらに、Broker が監視しているライセンスマネージャーが EasyAdmin の License Servers ウィジェットに引き続き表示されていることを確認してください。

Broker をアンインストールする

Broker を削除しても設定はあえて残されるため、後で再インストールすると同じ設定が引き継がれます。完全に削除する場合は、インストールフォルダーを手動で削除してください。

サービスを停止し、systemd から削除します。

sudo ./broker.sh uninstall

このコマンドは Broker を停止し、サービスを無効化して、systemd のユニットファイルを削除します。broker.xml やログを含む Broker のフォルダー自体は残ります。

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

sudo ./broker.sh stop

HTTPS で接続する

Java がまだ信頼していない証明書を使う OpenLM SLM に Broker が HTTPS で接続する場合は、JAVA_HOME が指す Java ランタイムのキーストアに発行元の証明書をインポートします。ステップ 2. 証明書を信頼する（Linux）を参照してください。Java 8 では、キーストアは Java 11 以降より 1 階層深い $JAVA_HOME/jre/lib/security/cacerts にあります。

接続を確認する

EasyAdmin の License Servers ウィジェットを開きます。Broker が監視している各ライセンスマネージャーが、ステータスとともに表示されます。ステータスメッセージが問題を示している場合は、EasyAdmin UI メッセージによる OpenLM Broker のトラブルシューティングを参照してください。