--- title: Workstation Agent のトラブルシューティング description: Workstation Agent のログを確認し、認証ファイルの拒否、接続確認の失敗、Linux で再起動を繰り返すエージェント、OpenLM Platform の Agent Activity に表示されないエージェントに対処します。 product: OpenLM Platform --- OpenLM Platform で Workstation Agent のインストール、起動、Agent Activity への表示が想定どおりに動作しない場合は、次の回答を参考にしてください。インストールの手順については、[Workstation Agent をインストールする](https://www.openlm.com/documentation/ja/cloud/getting-started/install-workstation-agent/index)を参照してください。 ## エージェントのログはどこにありますか？ 各ユーザーの Workstation Agent が、それぞれのログを書き出します。 - **Windows**: ユーザーのプロファイル内の `%APPDATA%\OpenLM\Agent\logs\`。**OpenLM Agent Updater Service** は、`%ProgramData%\OpenLM\Agent\logs\` に `UPDATER_` で始まるファイル名でログを書き出します。 - **Linux**: `/opt/openlmagent/logs//`。エージェントが起動できない場合、メッセージはユーザーのジャーナル (`journalctl --user -u openlmagent`) にあります。 - **macOS**: `/Library/OpenLMAgent/logs//`。 エージェントは、すべての内容を記録するログ `Agent.ALL..log` と、領域ごとのログ (`Agent.Agent..log` など) を 1 日に 1 つずつ書き出します。起動するたびに、ログは `Running v` で始まります。接続したエージェントは、その後 `SENDING: Agent details:
, "Connected"` を記録し、alive メッセージを送信します。 より詳しい情報を得るには、[エージェントの設定を変更する](https://www.openlm.com/documentation/ja/cloud/getting-started/install-workstation-agent/manage#エージェントの設定を変更する)の説明に従って、`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 をインストールする](https://www.openlm.com/documentation/ja/cloud/getting-started/install-workstation-agent/linux#エージェントを接続する)または [macOS に Workstation Agent をインストールする](https://www.openlm.com/documentation/ja/cloud/getting-started/install-workstation-agent/macos#エージェントを接続する)の説明に従ってファイルを置き換えます。 - **セルフホストの OpenLM Platform のアドレスが `settings.json` にない**: Linux と macOS では、`agentsHub.address`、`port`、`useSSL` を設定してエージェントを再起動します。[Linux に Workstation Agent をインストールする](https://www.openlm.com/documentation/ja/cloud/getting-started/install-workstation-agent/linux#セルフホストの-openlm-platform-に接続する)または [macOS に Workstation Agent をインストールする](https://www.openlm.com/documentation/ja/cloud/getting-started/install-workstation-agent/macos#エージェントを接続する)を参照してください。ファイアウォールやプロキシが接続をブロックすることもあります。 - **認証クライアントが削除されたか、シークレットがリセットされた**: [エージェントに新しい認証ファイルを渡す](https://www.openlm.com/documentation/ja/cloud/getting-started/install-workstation-agent/manage#エージェントに新しい認証ファイルを渡す)の説明に従って、エージェントに新しい認証ファイルを渡します。 ## パーソナルダッシュボードが開かないのはなぜですか？ ユーザーが Workstation Agent からパーソナルダッシュボードを開けない場合は、次の原因を確認します。 - **End-User Services が無効になっている**: Windows では、インストーラーで **Use End-User Services** を選択した場合、またはサイレントインストールで `USE_ENDUSERS_SERVICES="true"` を指定した場合にのみ、インストーラーが **OpenLM Personal Dashboard** ショートカットを追加します。 - **インストール時にダッシュボードが開かなかった**: Windows のサイレントインストールでは、ダッシュボードは開きません。Linux のインストールでは、デスクトップセッションにサインインしているユーザーに対してのみ開きます。[Windows に Workstation Agent をインストールする](https://www.openlm.com/documentation/ja/cloud/getting-started/install-workstation-agent/windows#パーソナルダッシュボードを開く)または[Linux に Workstation Agent をインストールする](https://www.openlm.com/documentation/ja/cloud/getting-started/install-workstation-agent/linux#パーソナルダッシュボードを開く)の説明に従って、エージェントから開きます。 - **エージェントがダッシュボードのアドレスを取得できない**: ダッシュボードを開くために、エージェントは OpenLM Platform からアドレスを取得します。[エージェントが Agent Activity に表示されないのはなぜですか？](#エージェントが-agent-activity-に表示されないのはなぜですか)の説明に従って、エージェントが接続していることを確認します。 エージェントがアドレスを取得できない場合は、`SignInDashboard: Personal Dashboard address could not be retrieved from AgentsHub (empty response). Skipping dashboard open.` を記録します。ダッシュボードを開くプロセスはエージェントと並行して動作するため、[ログフォルダー](#エージェントのログはどこにありますか)にあるその日の 2 つ目のログファイル (`Agent.ALL._001.log` など) に書き込むことがあります。 ## macOS でエージェントが起動しないのはなぜですか？ (root ではなく) ユーザーコンテキストで LaunchAgent を再読み込みします。 ```bash launchctl bootout "gui/$(id -u)/com.openlm.agent" 2>/dev/null launchctl bootstrap "gui/$(id -u)" /Library/LaunchAgents/com.openlm.agent.plist ``` 次に、検疫属性が削除されていることを確認します。削除されている場合、このコマンドは何も返しません。 ```bash xattr -p com.apple.quarantine /Library/OpenLMAgent/OpenLM.Agent.macOS ``` まだ設定されている場合は、`sudo xattr -rd com.apple.quarantine /Library/OpenLMAgent` を実行します。また、Mac のプロセッサ (Intel または Apple Silicon) に合ったビルドをインストールしたことを確認します。 ## macOS でウィンドウタイトルが空になる、または画面収録のプロンプトが繰り返し表示されるのはなぜですか？ [必要な権限を付与する](https://www.openlm.com/documentation/ja/cloud/getting-started/install-workstation-agent/macos#必要な権限を付与する)の説明に従って画面収録の権限を付与し、エージェントを再起動します。プロンプトが繰り返し表示される場合は、通常、記録された権限の識別子が不安定であることを意味し、これはアドホック署名に関連しています。権限は Mac ごとに 1 回付与し、バイナリに再署名しないでください。 ## macOS で Safari の履歴が収集されないのはなぜですか？ [必要な権限を付与する](https://www.openlm.com/documentation/ja/cloud/getting-started/install-workstation-agent/macos#必要な権限を付与する)の説明に従って `OpenLM.Agent.macOS` にフルディスクアクセスを付与し、`settings.json` で `webmonitor.useWebMonitor` が `true` であることを確認します。フルディスクアクセスがないと、エージェントは Safari の履歴をエラーなしでスキップします。他のブラウザーは影響を受けません。 ## Linux でエージェントが再起動を繰り返すのはなぜですか？ Linux では、`systemctl --user status openlmagent` に `activating (auto-restart) (Result: core-dump)` と表示され、Workstation Agent はログを書き出しません。理由はジャーナルで確認します。 ```bash 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/` に書き出します。新しいアカウントにはまだ `.config` フォルダーがないため、エージェントはユーザーが書き込めない `/opt/openlmagent` にデータを保存しようとします。また、そこにはユーザーのログフォルダーもありません。 解決するには、両方のフォルダーを作成し、ユーザーのエージェントを再起動します。 ```bash sudo mkdir -p /opt/openlmagent/logs/ sudo chown /opt/openlmagent/logs/ sudo -u mkdir -p /home//.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. [エージェントの設定を変更する](https://www.openlm.com/documentation/ja/cloud/getting-started/install-workstation-agent/manage#エージェントの設定を変更する)の説明に従って、エージェントを再起動します。 2. [エージェントのログ](#エージェントのログはどこにありますか)を開き、`"Connected"` を含む行を探します。 3. OpenLM Platform で **Navigation** を開き、**Agents**、**Agent Activity** の順に選択して、**Refresh** アイコンを選択します。 4. マシンのホスト名の行を探します。エージェントが接続している間、**Online** にチェックマークが表示されます。 :::info[次のステップ] エージェントがまだ接続しない場合は、`logging.minimumLevel` を `Debug` に設定してログを収集し、OpenLM サポートに連絡してください。エージェントがオンラインになったら、[Directory Synchronization Agent (DSA) のインストール](https://www.openlm.com/documentation/ja/cloud/getting-started/install-dsa)に進んで設定を続けます。 :::