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

OpenLM Platform で Workstation Agent のインストール、起動、Agent Activity への表示が想定どおりに動作しない場合は、次の回答を参考にしてください。インストールの手順については、Workstation Agent をインストールするを参照してください。

エージェントのログはどこにありますか？

各ユーザーの Workstation Agent が、それぞれのログを書き出します。

• Windows: ユーザーのプロファイル内の %APPDATA%\OpenLM\Agent\logs\。OpenLM Agent Updater Service は、%ProgramData%\OpenLM\Agent\logs\ に UPDATER_ で始まるファイル名でログを書き出します。
• Linux: /opt/openlmagent/logs/<user>/。エージェントが起動できない場合、メッセージはユーザーのジャーナル (journalctl --user -u openlmagent) にあります。
• macOS: /Library/OpenLMAgent/logs/<user>/。

エージェントは、すべての内容を記録するログ Agent.ALL.<yyyymmdd>.log と、領域ごとのログ (Agent.Agent.<yyyymmdd>.log など) を 1 日に 1 つずつ書き出します。起動するたびに、ログは Running v<version> で始まります。接続したエージェントは、その後 SENDING: Agent details: <address>, "Connected" を記録し、alive メッセージを送信します。

より詳しい情報を得るには、エージェントの設定を変更するの説明に従って、settings.json で logging.minimumLevel を Debug に設定し、エージェントを再起動します。

インストーラーが認証ファイルを拒否するのはなぜですか？

Windows のインストーラーは、Agent Authorization ページで Next を選択した時点で認証ファイルを確認し、問題があれば「Authorization file validation error」メッセージで報告します。

• The file is empty. または The file could not be read. It may be corrupted or encrypted with an unknown key.: ファイルが不完全か、変更されています。Identity からもう一度ダウンロードします。
• clientType property value must be Agent.: ファイルは Broker などの別のコンポーネント用です。種類が Agent のクライアントのファイルを生成します。
• cloudLocation property is not valid for cloud mode.: ファイルのアドレスがクラウドの OpenLM Platform ではありません。セルフホストの OpenLM Platform の場合は、Operation Mode ページで OpenLM On-Premise を選択します。
• cloudLocation property is not valid for on-premise.: ファイルはクラウドの OpenLM Platform 用です。Operation Mode ページで OpenLM Cloud を選択します。
• clientId property can't be empty. など、プロパティを空にできないというメッセージ: ファイルが不完全です。もう一度ダウンロードします。

Check connectivity が失敗するのはなぜですか？

セルフホストの OpenLM Platform に Windows のインストーラーを接続するとき、Agents Hub Configuration ページの Check connectivity は、マシンから Host name のホストの Agents Hub に接続します。Unable to connect. Please check your OpenLM Agents Hub instance and the address you provided. と報告された場合は、次の原因を確認します。

• ホスト名: https:// やパスを含めず、ホスト名だけを入力します。
• ポートと SSL: Port と Use SSL は、OpenLM Platform が接続を受け付ける方法と一致している必要があります。既定は SSL を使用するポート 443 です。
• ネットワーク: マシンは、そのポートでホストにアクセスできる必要があります。ファイアウォールやプロキシがブロックすることがあります。

エージェントが Agent Activity に表示されないのはなぜですか？

Agent Activity の一覧は自動では更新されないため、まず Refresh アイコンを選択します。それでも Workstation Agent が一覧にない場合は、次の原因を確認します。

• エージェントが動作していない: Windows では、エージェントはサインインしているユーザーのために OpenLM.Agent.Windows.Core.exe として動作します。Linux では、そのユーザーとして systemctl --user status openlmagent を実行します。macOS では、そのユーザーとして launchctl print "gui/$(id -u)/com.openlm.agent" を実行します。
• エージェントが OpenLM Platform に到達できない: エージェントのログに、エージェントが試したアドレスとともに Failed reconnecting to Hub が記録されます。マシンから OpenLM Platform のアドレスへの送信 HTTPS を許可します。
• エージェントがまだプレースホルダーの認証ファイルを使っている: Linux と macOS では、Failed reconnecting to Hub に OpenLM Platform ではないアドレスが表示されます。Linux に Workstation Agent をインストールするまたは macOS に Workstation Agent をインストールするの説明に従ってファイルを置き換えます。
• セルフホストの OpenLM Platform のアドレスが settings.json にない: Linux と macOS では、agentsHub.address、port、useSSL を設定してエージェントを再起動します。Linux に Workstation Agent をインストールするまたは macOS に Workstation Agent をインストールするを参照してください。ファイアウォールやプロキシが接続をブロックすることもあります。
• 認証クライアントが削除されたか、シークレットがリセットされた: エージェントに新しい認証ファイルを渡すの説明に従って、エージェントに新しい認証ファイルを渡します。

パーソナルダッシュボードが開かないのはなぜですか？

ユーザーが Workstation Agent からパーソナルダッシュボードを開けない場合は、次の原因を確認します。

• End-User Services が無効になっている: Windows では、インストーラーで Use End-User Services を選択した場合、またはサイレントインストールで USE_ENDUSERS_SERVICES="true" を指定した場合にのみ、インストーラーが OpenLM Personal Dashboard ショートカットを追加します。
• インストール時にダッシュボードが開かなかった: Windows のサイレントインストールでは、ダッシュボードは開きません。Linux のインストールでは、デスクトップセッションにサインインしているユーザーに対してのみ開きます。Windows に Workstation Agent をインストールするまたはLinux に Workstation Agent をインストールするの説明に従って、エージェントから開きます。
• エージェントがダッシュボードのアドレスを取得できない: ダッシュボードを開くために、エージェントは OpenLM Platform からアドレスを取得します。エージェントが Agent Activity に表示されないのはなぜですか？の説明に従って、エージェントが接続していることを確認します。

エージェントがアドレスを取得できない場合は、SignInDashboard: Personal Dashboard address could not be retrieved from AgentsHub (empty response). Skipping dashboard open. を記録します。ダッシュボードを開くプロセスはエージェントと並行して動作するため、ログフォルダーにあるその日の 2 つ目のログファイル (Agent.ALL.<yyyymmdd>_001.log など) に書き込むことがあります。

macOS でエージェントが起動しないのはなぜですか？

(root ではなく) ユーザーコンテキストで LaunchAgent を再読み込みします。

launchctl bootout "gui/$(id -u)/com.openlm.agent" 2>/dev/null
launchctl bootstrap "gui/$(id -u)" /Library/LaunchAgents/com.openlm.agent.plist

次に、検疫属性が削除されていることを確認します。削除されている場合、このコマンドは何も返しません。

xattr -p com.apple.quarantine /Library/OpenLMAgent/OpenLM.Agent.macOS

まだ設定されている場合は、sudo xattr -rd com.apple.quarantine /Library/OpenLMAgent を実行します。また、Mac のプロセッサ (Intel または Apple Silicon) に合ったビルドをインストールしたことを確認します。

macOS でウィンドウタイトルが空になる、または画面収録のプロンプトが繰り返し表示されるのはなぜですか？

必要な権限を付与するの説明に従って画面収録の権限を付与し、エージェントを再起動します。プロンプトが繰り返し表示される場合は、通常、記録された権限の識別子が不安定であることを意味し、これはアドホック署名に関連しています。権限は Mac ごとに 1 回付与し、バイナリに再署名しないでください。

macOS で Safari の履歴が収集されないのはなぜですか？

必要な権限を付与するの説明に従って OpenLM.Agent.macOS にフルディスクアクセスを付与し、settings.json で webmonitor.useWebMonitor が true であることを確認します。フルディスクアクセスがないと、エージェントは Safari の履歴をエラーなしでスキップします。他のブラウザーは影響を受けません。

Linux でエージェントが再起動を繰り返すのはなぜですか？

Linux では、systemctl --user status openlmagent に activating (auto-restart) (Result: core-dump) と表示され、Workstation Agent はログを書き出しません。理由はジャーナルで確認します。

journalctl --user -u openlmagent -n 50 --no-pager

ジャーナルに Couldn't find a valid ICU package installed on the system. Please install libicu (or icu-libs) using your package manager and try again. と表示される場合は、ICU ライブラリをインストールします。Rocky Linux と Red Hat Enterprise Linux では、sudo dnf install libicu を実行します。エージェントは、約 10 秒以内の次の自動再起動で起動します。

新しいユーザーのエージェントが再起動を繰り返すのはなぜですか？

Linux で tar.gz アーカイブからインストールした後に追加したユーザーの場合、Workstation Agent が起動のたびに停止し、ジャーナルに Access to the path '/opt/openlmagent/OpenLM' is denied. と表示されることがあります。エージェントは、データをユーザーの .config フォルダーに保存し、ログを /opt/openlmagent/logs/<user> に書き出します。新しいアカウントにはまだ .config フォルダーがないため、エージェントはユーザーが書き込めない /opt/openlmagent にデータを保存しようとします。また、そこにはユーザーのログフォルダーもありません。

解決するには、両方のフォルダーを作成し、ユーザーのエージェントを再起動します。

sudo mkdir -p /opt/openlmagent/logs/<user>
sudo chown <user> /opt/openlmagent/logs/<user>
sudo -u <user> mkdir -p /home/<user>/.config

次に、そのユーザーとして systemctl --user restart openlmagent を実行します。

パッケージのインストールで openlm アカウントに関する警告が表示されるのはなぜですか？

Workstation Agent の Linux パッケージは、インストールするファイルの所有者を openlm アカウントに設定します。このアカウントがない場合、DEB パッケージは chown: invalid user: 'openlm:openlm' を、RPM パッケージは warning: user openlm does not exist - using root を、ファイルごとに表示します。この場合、ファイルは root の所有になり、エージェントは動作します。これらの行は無視してかまいません。

ログのどのエラーは無視できますか？

Linux では、Workstation Agent は起動時に Error loading of built-in plugins from: /opt/openlmagent/Extensions を記録します。拡張機能は Windows にしかないためです。また、ユーザーの最初の起動時には、読み取るファイルがまだないため、Failed to read Web Sessions Last Report Time も記録します。どちらも想定どおりの動作です。

問題が解決したかどうかを確認するにはどうすればよいですか？

問題を修正した後、エージェントが動作してレポートしていることを確認します。

1. エージェントの設定を変更するの説明に従って、エージェントを再起動します。
2. エージェントのログを開き、"Connected" を含む行を探します。
3. OpenLM Platform で Navigation を開き、Agents、Agent Activity の順に選択して、Refresh アイコンを選択します。
4. マシンのホスト名の行を探します。エージェントが接続している間、Online にチェックマークが表示されます。

次のステップ

エージェントがまだ接続しない場合は、logging.minimumLevel を Debug に設定してログを収集し、OpenLM サポートに連絡してください。エージェントがオンラインになったら、Directory Synchronization Agent (DSA) のインストールに進んで設定を続けます。