--- title: Broker の変更、アップグレード、アンインストール description: OpenLM Platform 用の OpenLM Broker に TLS 証明書をインポートし、Windows、Linux、Unix で Broker をアップグレードまたはアンインストールします。 product: OpenLM Platform --- Broker をインストールした後は、ライセンスサーバー上で証明書のインポート、Broker のアップグレード、削除を行います。稼働中の Broker のライセンスマネージャーや設定を変更するには、[Broker UI](https://www.openlm.com/documentation/ja/cloud/getting-started/install-broker/index#broker-ui) を使用します。 ## Broker に TLS 証明書をインポートする Broker が HTTPS で接続するオンプレミスの OpenLM 環境 (セルフホストの OpenLM Platform または OpenLM SLM) の証明書を Broker マシンがまだ信頼していない場合は、その証明書を Broker マシンに追加します。Windows と Linux/Unix の Broker では参照する信頼ストアが異なるため、追加する場所はプラットフォームによって異なります。 ### Windows の場合 **Local Computer**、**Trusted Root Certification Authorities** の順に開き、`certlm.msc` または次のコマンドで証明書をインポートします。 ```bash certutil -addstore Root my-cert.crt ``` その後、OpenLM Broker サービスを再起動して変更を適用します。 Broker サービスは `-Djavax.net.ssl.trustStoreType=Windows-ROOT` を指定して実行されるため、証明書の検証には **Windows 証明書ストア**を使用し、Java 独自の `cacerts` ファイルは読み込みません。 ### Linux/Unix の場合 Broker は `JAVA_HOME` が指す Java ランタイムの信頼ストアを使用します。証明書を信頼させるには、次の手順を実行します。 1. OpenLM サーバーの URL に HTTPS を使用します: `https://:` 2. 接続をテストします。 一部の Java ディストリビューションは、システムの信頼ストアから TLS 証明書をインポートします。Broker が接続できれば、作業は完了です。 3. SSL エラーが発生する場合は、原因を確認します。 主な原因は、Java が信頼されたルート証明書ディレクトリを読み取れない、Java がシステムの信頼ストアを使用していない、または証明書を Java KeyStore に手動で追加する必要がある、のいずれかです。 4. それでも Broker が接続できない場合は、`keytool` で証明書をインポートします。 Java 11 以降では、信頼ストアは `$JAVA_HOME/lib/security/cacerts` にあります。Java 8 では 1 階層深く、`$JAVA_HOME/jre/lib/security/cacerts` にあります。 ```bash keytool -import -trustcacerts \ -keystore $JAVA_HOME/lib/security/cacerts \ -storepass changeit \ -noprompt \ -alias mycert \ -file my-cert.pem ``` `keytool` がインポートできるのは `.crt`、`.cer`、`.pem` ファイルです。`.pfx` ファイルは、インポート前に `.crt` に変換してください。 5. Broker のサービスまたはプロセスを再起動して、変更を適用します。 ## Broker をアップグレードする 1 つの Broker または複数の Broker をアップグレードするには、Broker の管理方法に合った方法を選びます。 - **多数の Broker を OpenLM Platform から**: Broker Hub の **Update Brokers** を使用します。選択した Broker に更新を送信するため、ライセンスサーバーへのアクセスは不要です。[Broker を更新する](https://www.openlm.com/documentation/ja/cloud/data-collection/broker-hub/#broker-を更新する)を参照してください。 - **1 つの Broker をその Broker の UI から**: [Broker UI](https://www.openlm.com/documentation/ja/cloud/getting-started/install-broker/index#broker-ui) で **Settings**、**Update Broker Version** の順に選択し、**Update** を選択します。Broker が最新バージョンをダウンロードし、その場で自身を更新します。[Broker の設定](https://www.openlm.com/documentation/ja/cloud/data-collection/openlm-broker/#broker-の設定)を参照してください。 - **ライセンスサーバー上で (Windows)**: 新しいインストーラーと、アップグレードする Broker のインスタンス ID を指定して、サイレントインストールのコマンドを実行します。インストーラーは、そのインスタンスをその場でアップグレードします。[Broker をサイレントにアップグレードする](https://www.openlm.com/documentation/ja/cloud/getting-started/install-broker/windows#broker-をサイレントにアップグレードする)を参照してください。 - **ライセンスサーバー上で (Linux または Unix)**: 次のセクションで、パッケージの種類に合った手順に従います。 アップグレードした Broker が Broker Hub で同じ位置に残るのは、`broker.id` を引き継いだ場合だけです。新しい Broker として表示される場合は、[アップグレードした Broker が新しい Broker として表示されるのはなぜですか？](https://www.openlm.com/documentation/ja/cloud/getting-started/install-broker/troubleshooting#アップグレードした-broker-が新しい-broker-として表示されるのはなぜですか)を参照してください。 ### Linux または Unix で tar.gz インストールをアップグレードする tar.gz アーカイブからインストールした Broker をアップグレードするには、次の手順を実行します。 1. Unix/Linux 用の OpenLM Broker をダウンロードします。[インストーラーをダウンロードする](https://www.openlm.com/documentation/ja/cloud/getting-started/install-broker/index#インストーラーをダウンロードする)を参照してください。 2. 現在の Broker インストールを削除します。 - systemd を使用している場合は、現在の Broker サービスをアンインストールします。 ```bash sudo ./broker.sh uninstall ``` - systemd を使用していない場合は、Broker プロセスを停止します。 ```bash sudo ./broker.sh stop ``` 3. アーカイブ `OpenLM_Broker_.tar.gz` を任意のフォルダーに展開します。 4. 以前の Broker インストールフォルダーから `broker.xml`、`broker.id`、`settings.sh` を新しいフォルダーにコピーし、既存のファイルを上書きします。 `broker.id` には Broker の ID が保存されています。このファイルがないと、アップグレードした Broker は新しい Broker として報告されます。 5. 以前のフォルダーに `application.properties`、`proxy.properties`、`bufferfiles`、`markerfiles` がある場合は、それらもコピーします。 これらには、HTTPS とプロキシの設定、未送信のデータ、ライセンスマネージャーのログの読み取り位置が保存されています。 6. 新しい `openlm-broker` フォルダーから、新しいバージョンの Broker サービスをインストールします。 - systemd を使用している場合は、サービスをインストールします。 ```bash sudo ./broker.sh install ``` - systemd を使用していない場合は、プロセスを開始します。 ```bash sudo ./broker.sh start ``` アップグレード後、[Broker UI](https://www.openlm.com/documentation/ja/cloud/getting-started/install-broker/index#broker-ui) または `sudo ./broker.sh config` で、設定とライセンスサーバーが変わっていないことを確認します。次に、Broker のライセンスマネージャーが引き続き Broker Hub に表示されていることを確認します。 ### DEB または RPM パッケージをアップグレードする インストール済みのパッケージに、新しいパッケージを上書きインストールします。パッケージは常に `/opt/broker` にインストールされます。マシンで systemd を使用している場合、パッケージはアップグレード後に Broker サービスを再起動します。 1. `/opt/broker` から `broker.xml` と `broker.id` を安全な場所にコピーします。アップグレードした Broker が新しい Broker として表示された場合は、これらを元に戻せます。 2. アップグレード先のバージョンの DEB または RPM パッケージをダウンロードします。[インストーラーをダウンロードする](https://www.openlm.com/documentation/ja/cloud/getting-started/install-broker/index#インストーラーをダウンロードする)を参照してください。 3. インストールします。 ```bash # Debian and Ubuntu sudo dpkg -i openlm_broker__amd64.deb # RHEL-family systems sudo rpm -Uvh openlm_broker_.x86_64.rpm ``` 4. Broker Hub で、Broker が新しいバージョンで **Up** になっていることを確認します。 ## Broker をアンインストールする Broker を削除するには、ライセンスサーバー上でアンインストールします。アンインストールしても設定は残るため、後で再インストールすると同じ設定が引き継がれます。完全に削除するには、アンインストール後にインストールフォルダーを手動で削除します。 Windows では、インストールフォルダーに `broker.xml`、`broker.id`、`broker.xml.backup`、`application.properties` と、`bufferfiles`、`logs`、`markerfiles` の各フォルダーが残ります。同じフォルダーに再インストールすると、Broker は残された `broker.xml` と `broker.id` を使って起動し、Broker Hub には以前と同じ ID で表示されます。 Broker を OpenLM Platform からも削除するには、Broker Hub で削除します。アンインストールだけでは、Broker Hub に表示されたままになります。[Broker を削除する](https://www.openlm.com/documentation/ja/cloud/data-collection/broker-hub/#broker-を削除する)を参照してください。 ### Windows で削除する 次のいずれかの方法で、Windows から Broker を削除します。 - **プログラムと機能**: コントロールパネルで **Programs**、**Uninstall a program** の順に選択します。**OpenLM Broker**、**Uninstall** の順に選択し、**Yes** で確定します。インスタンスごとに個別のエントリがあります (例: **OpenLM Broker 2**)。 *プログラムと機能の OpenLM Broker* - **インストーラー**: インストーラーをもう一度開き、**Modify** を選択します。**Select Instance** ページでインスタンスを選択し、**Remove** を選択します。 - **サイレントアンインストール**: インストール時に使用したインスタンス ID を指定して `msiexec /x` を実行します。 ```bash msiexec /x "" /qn TRANSFORMS=":I01" ``` `` は、Broker の MSI ファイルのフルパスに置き換えます。`:I01` はインスタンス ID です。削除対象のインスタンスに合わせて変更してください。インスタンス ID については[サイレントインストール](https://www.openlm.com/documentation/ja/cloud/getting-started/install-broker/windows#サイレントインストール)を参照してください。 :::warning[インストーラーのバージョンを合わせる] サイレントアンインストールでは、削除対象のインスタンスと**同じバージョン**のインストーラーを指定してください。インストーラーは登録済みインスタンスをインスタンス ID とバージョンの両方で照合し、どちらかが一致しない場合は `Failed to detect Broker instance to uninstall.` で失敗します。インストール時に使用したインストーラーを保管しておくか、アンインストール前に同じバージョンをダウンロードしてください。 ::: ### Linux/Unix で削除する サービスを停止し、systemd から削除します。 ```bash sudo ./broker.sh uninstall ``` このコマンドは Broker を停止し、サービスを無効化して、systemd のユニットファイルを削除します。`broker.xml` やログを含む Broker のフォルダーは残ります。 systemd がないマシンでは `uninstall` は使用できません。代わりにプロセスを停止してください。 ```bash sudo ./broker.sh stop ``` ### DEB または RPM パッケージを削除する パッケージマネージャーでパッケージを削除します。パッケージを削除すると、Broker サービスが停止し、systemd のユニットファイルが削除されます。 RHEL 系システムでは、パッケージ名は `openlm_broker` です。 ```bash sudo rpm -e openlm_broker ``` Debian と Ubuntu では、先にパッケージ名を確認してから削除します。 ```bash dpkg -l | grep -i openlm sudo apt-get remove ``` :::info[次のステップ] [最初のライセンスマネージャーを接続する](https://www.openlm.com/documentation/ja/cloud/getting-started/connect-first-license-manager)に進み、ライセンスデータの収集を開始します。変更後に Broker が復帰しない場合は、[Broker のトラブルシューティング](https://www.openlm.com/documentation/ja/cloud/getting-started/install-broker/troubleshooting)を参照してください。 :::