Broker のトラブルシューティング

Broker のインストール、表示、接続、OpenLM Platform へのデータ送信が想定どおりに動作しない場合は、次の内容を確認します。インストールの手順については、Broker をインストールするを参照してください。

Broker のログはどこにありますか？

Broker のインストールフォルダーにある logs フォルダーを開きます。Windows の最初のインスタンスでは C:\Program Files\OpenLM\OpenLM Broker\logs、Linux のパッケージインストールでは /opt/broker/logs です。このフォルダーには次のログがあります。

• broker-service.log: Broker のメインログ。10 MB に達するとローテーションされ、broker-service-1.log から broker-service-10.log まで、以前のファイルが最大 10 個保持されます。
• ライセンスマネージャーのポートごと、OpenLM サーバー接続ごとのログ。
• auth_import.log: Windows での認証ファイルのインポート結果。Linux では、auth_import.sh が auth_import_nohup.log に書き込みます。
• broker_nohup.log: systemd を使用しない Linux での Broker の出力。systemd を使用する場合は、既定のサービス名であれば journalctl -u openlm_broker_root で出力を確認します。

既定では、Broker はエラーのみを記録します。より詳しく記録するには、Broker UI を開いて Settings を選択し、Broker Log Level を変更します。ログを OpenLM サポートに送るには、同じタブで Download Logs を選択します。Broker は logs フォルダーを broker-logs.zip に圧縮します。

Broker UI が開かないのはなぜですか？

次の原因を確認します。

• サービスの準備がまだできていない: 同じフォルダーに再インストールした場合、Broker サービスが待ち受けを開始する前に、インストーラーがブラウザーを開くことがあります。ブラウザーに localhost で接続が拒否されたと表示された場合は、数秒後にページを更新します。
• サービスが停止している: Windows のサービスで OpenLM Broker を開始するか、Linux で sudo ./broker.sh start を実行します。
• ポート 5090 が使用中: その場合、Broker は次に空いているポートを使用し、broker.xml の webUIPort に保存します。代わりに http://localhost:<webUIPort> を開きます。同じマシンに追加した Broker インスタンスは、このようにそれぞれ別のポートを使用します。
• Broker UI がオフになっている: Settings の Turn off Web UI オプションは、broker.xml に webUIPort="off" を設定します。Broker UI を再びオンにするには、webUIPort を "5090" などのポート番号に設定し、Broker サービスを再起動します。

Broker UI でリモートアクセストークンを求められるのはなぜですか？

トークンなしで Broker UI を開けるのは、ライセンスサーバー自体で http://localhost:<port> を開いた場合だけです。127.0.0.1 やマシン名を含め、それ以外のアドレスでは ENTER REMOTE ACCESS TOKEN 画面が開きます。トークンを取得するには、次の手順を実行します。

1. ライセンスサーバーで http://localhost:5090/api/new-token を開きます (Broker UI のポートが 5090 でない場合は、そのポートを使用します)。
2. トークンをコピーし、別のコンピューターの Enter Token に貼り付けて、Continue を選択します。

別のコンピューターから Linux のライセンスサーバーのトークンを取得するには、次のコマンドを実行します。

ssh <license-server> wget -O - http://localhost:5090/api/new-token

別のコンピューターから Windows のライセンスサーバーのトークンを取得するには、次のコマンドを実行します。

winrs -r:<license-server> powershell -command "(Invoke-WebRequest -Uri http://localhost:5090/api/new-token -Method GET).Content"

<license-server> は、ライセンスサーバーの名前に置き換えます。

トークンの有効期間は 30 分です。ブラウザーはトークンを現在のタブにのみ保持するため、新しいタブでは再びトークンを求められます。

新しい Broker が Pending Brokers に表示されないのはなぜですか？

新しい Broker は、ライセンスマネージャーを監視する前でも、接続した時点で Pending Brokers に表示されます。表示されない場合は、OpenLM Platform への接続をテストします。

1. Broker UI で OpenLM Servers を選択し、OpenLM Platform の接続を選択します。

2. Check Connectivity を選択します。

   Test completed successfully. は、Broker が OpenLM Platform に到達できることを示します。Broker failed to connect to OpenLM server. は、到達できないことを示します。

テストに失敗した場合は、次の原因を確認します。

• OpenLM Platform への経路がない: Broker マシンから OpenLM Platform のアドレスへの送信 HTTPS (ポート 443) を許可します。マシンがプロキシ経由でのみインターネットに接続する場合は、Broker UI の Settings にある Proxy Configuration でプロキシを設定します。
• サイレントインストール後に資格情報がない: 認証ファイルのインポートに失敗しています。サイレントインストールの説明に従って、auth_import.log を確認します。
• 資格情報が拒否された: 認証クライアントが削除された場合やシークレットがリセットされた場合、OpenLM Platform は Broker を拒否します。Broker は Stop transmitting due to security failure. を記録し、12 時間送信を停止します。接続で新しい認証ファイルをインポートして Save を選択し、Broker サービスを再起動します。

bufferfiles フォルダーが大きくなり続けるのはなぜですか？

増加を止めるには、新しい Broker が Pending Brokers に表示されないのはなぜですか？の説明に従って接続を修正します。

Broker は、OpenLM Platform にデータを送信できない間、データを bufferfiles に保存します。

• 送信に 3 回続けて失敗すると、Broker は接続をオフラインにし、新しいデータを接続ごとのキューとして、既定で 3 MB のファイルにこのフォルダーへ書き込みます。
• Broker は最大 10 分間隔で再試行を続け、OpenLM Platform が再び応答すると、保存したデータを古いものから送信します。
• Broker は、10 日より古いバッファーファイルを削除します。

接続に保存されたデータを破棄するには、OpenLM Servers でその接続を開き、Advanced を展開して、Clear Buffer を選択します。

ログに「No license servers defined」と表示されるのはなぜですか？

Broker に監視するライセンスマネージャーがない間、broker-service.log には No license servers defined, can't run BrokerKeepAlive or GetBrokerCommands と記録されます。接続を確認するの説明に従って、ライセンスマネージャーを検出または追加します。

サイレントインストールでライセンスマネージャーが検出されないのはなぜですか？

サイレントインストールは detect.bat でライセンスマネージャーを検出しますが、detect.bat は常にインストーラーに同梱の Java ランタイムを使用します。USE_OPENLM_JAVA="false" の場合、detect.bat は実行できません。代わりに Broker UI でライセンスマネージャーを検出します。License Managers を選択し、Detect を選択します。

サイレントインストールがエラーで停止したのはなぜですか？

/l*v で指定したログファイルで原因を確認します。よくあるメッセージは次のとおりです。

• A newer version of OpenLM Broker is already installed.: TRANSFORMS のインスタンス ID に、同じバージョンまたは新しいバージョンがすでにインストールされています。新しいインストーラーか、新しいインスタンス ID を使用します。
• MSINEWINSTANCE requires a new instance that is not installed. (終了コード 1639): TRANSFORMS のインスタンス ID に、このバージョンがすでにインストールされています。
• TRANSFORMS property not specified.: TRANSFORMS を追加します (例: TRANSFORMS=":I01")。
• Java Path is missing!: USE_OPENLM_JAVA="false" の場合は、JAVA_PATH も指定します。

管理者権限がない場合、32 ビット版の Windows の場合、または .NET Framework 4.5 以降がない場合も、インストーラーは停止します。

アップグレードした Broker が新しい Broker として表示されるのはなぜですか？

Broker は ID を broker.xml の隣にある broker.id に保存します。このファイルがないと新しい ID を作成するため、Broker Hub には新しい Broker として表示されます。tar.gz インストールをアップグレードするときは、Linux または Unix で tar.gz インストールをアップグレードするの説明に従って、broker.xml と settings.sh に加えて broker.id もコピーします。

パッケージインストール後に keytool が Java の信頼ストアを見つけられないのはなぜですか？

RPM パッケージは、settings.sh の JAVA_HOME に、PATH 上で最初に見つかった java を含む bin フォルダーの親フォルダーを設定します。これは多くの場合 /usr で、$JAVA_HOME/lib/security/cacerts は存在しません。readlink -f "$(which java)" で実際の Java フォルダーを確認し、末尾の /bin/java を除いたフォルダーを Linux/Unix で TLS 証明書をインポートする手順の keytool コマンドで使用します。

ライセンスマネージャーに使用状況データが表示されないのはなぜですか？

Broker UI でライセンスマネージャーを開き、Commands タブを選択して、Data Inquiry コマンドで Execute を選択します。出力が空の場合やエラーの場合は、実行ファイルのパス、ポート、ホスト名を修正します。出力が正しい場合は、OpenLM Servers 画面で接続ステータスを確認します。それでも失敗する場合は、Broker Log Level を DEBUG に上げて問題を再現し、Download Logs を選択します。Broker のログはどこにありますか？を参照してください。

Broker Hub に Time Sync Error と表示されるのはなぜですか？

ライセンスサーバーの時計がずれています。Network Time Protocol (NTP) で同期してください。Broker は使用状況のタイムスタンプをマシンのローカル時刻から変換するため、正しい時刻が重要です。Broker のステータスを理解するを参照してください。

Broker Hub に Duplicate と表示されるのはなぜですか？

2 つの Broker が同じ ID を共有しています。Broker がインストールされた仮想マシンを複製した後に、よく起こります。複製したマシンを起動する前に、複製側の broker.id ファイルを削除してください。Broker が新しい ID を生成します。重複した行を破棄するには、Broker のステータスを理解するを参照してください。

次のステップ

Broker が Pending Brokers に表示されたら、最初のライセンスマネージャーを接続するに進みます。Broker を変更、アップグレード、削除するには、Broker の変更、アップグレード、アンインストールを参照してください。