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

OpenLM SaaS Agent のインストール、起動、接続、スキャンが期待どおりに動作しない場合は、次の回答を参照してください。インストール手順については、SaaS Agent をインストールするを参照してください。

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

インストールフォルダー内の bin\logs フォルダー（既定では C:\Program Files\OpenLM\OpenLM SaaS Agent\bin\logs）を開きます。エージェントは主要ログ saasagent-<yyyyMMdd>.log を 1 日 1 ファイル書き込み、10 MB を超えると新しいファイルに切り替え、最新の 10 ファイルを保持します。デバッグメッセージは saasagent-debug-.txt にも書き込まれます。

サービスが起動するたびに Start OpenLM.CloudBrokerAgent with version: <version> が記録され、続いてサービスを実行しているアカウントが User Name: <account> として記録されます。各プラットフォームのスキャンログは bin\logs\Plugin\Plugin_<platform>_LOG\ にあります。

エージェントのアプリは、自身のログを UI\logs\OpenLM.SaaSAgent.UI\ に書き込みます。ログには各レシーバーのクライアント ID が含まれますが、シークレットは含まれません。

インストーラーがサービスアカウントを拒否するのはなぜですか？

Agent Service Logon Configuration ページで Next を選択すると、インストーラーはアカウントを確認し、問題があれば Service configuration is not valid メッセージで報告します。

• Username must include domain and user name.: ドメイン部分を含めてアカウントを入力します。ローカルアカウントは .\<user> または <computer name>\<user>、ドメインアカウントは <domain>\<user> または <user>@<domain> です。
• User '<user>' not found on local machine '<computer name>' または User '<domain>\<user>' not found in domain '<domain>'.: 綴りと、ホストがドメインに到達できることを確認します。
• Both username and password must be provided or both must be empty: パスワードも入力します。

インストール後にサービスが起動しないのはなぜですか？

インストールの最後に、インストーラーは OpenLM SaaS Agent Service を開始し、最大 30 秒待機します。サービスが開始しなくても、インストールは完了します。次の原因を確認してください。

• パスワードの誤り。 インストーラーに Service Start Failed - Invalid Credentials が表示されます。Windows の サービス で OpenLM SaaS Agent Service を開き、ログオン タブでパスワードを入力してから、サービスを開始します。
• 起動に時間がかかる。 低速または負荷の高いホストでは、初回の起動に Windows の許容時間（既定で 30 秒）より長くかかることがあります。その場合、Windows のシステムログには OpenLM SaaS Agent Service のイベント 7009 と 7000 が記録され、エージェントのログは書き込まれません。サービス でサービスを開始してください。サービスは Windows の起動時にも、遅れて開始されます。

サービスが実行されるまで、エージェントのアプリには User Credentials Warning と Cannot Connect to SaaS Agent のメッセージが表示され、Loading... のままになります。

サービスが起動直後に停止するのはなぜですか？

サービスにはホストのポート 7572 が必要です。このポートを使用できない場合、サービスは停止し、主要ログに OpenLM SaaS Agent cannot start: failed to bind to port 7572 が、考えられる原因と確認用のコマンドとともに記録されます。

ポートを解放するか、別のポートでエージェントを実行します。bin\appsettings.json の Kestrel の下にある Port を設定し、UI\appsettings.json の ApiSettings の下にある BaseUrl に同じポートを設定してから、サービスを再起動します。アップグレードすると両方のファイルが置き換えられるため、アップグレードのたびにポートを設定し直してください。

エージェントに User Credentials Warning が表示されるのはなぜですか？

エージェントのアプリは起動するたびに、サービスを実行しているアカウントとサインイン中のアカウントを比較します。警告は数秒後に自動で閉じます。表示された原因に応じて対処します。

• The OpenLM SaaS Agent service is not running or has invalid configuration.: Windows の サービス で OpenLM SaaS Agent Service を開始します。
• The service LogOn is LocalSystem. It has to be reconfigured to run under a user account.: サービスがアカウントなしでインストールされています。サービスの ログオン タブでサインインに使用するアカウントを入力し、サービスを再起動します。
• The service is running as <account>. Configuration using different account (<account>) can lead to failures.: サービスアカウントでサインインするか、サービスの ログオン アカウントをサインインに使用するアカウントに設定し、サービスを再起動します。

エージェントに Cannot Connect to SaaS Agent が表示されるのはなぜですか？

エージェントのアプリは、ポート 7572 でサービスと通信します。このメッセージは、サービスが実行されていないときに表示されます。Windows の サービス で OpenLM SaaS Agent Service を開始し、実行されるのを待ってから、アプリを開き直してください。

エージェントが認可ファイルを拒否するのはなぜですか？

エージェントは、ファイルを選択した時点でファイルを確認します。

• Failed to read the authorization file. It may be empty, corrupt, or encrypted with an unknown key.: ファイルが変更されたか、OpenLM Identity の認可ファイルではありません。ダウンロードし直してください。
• The authorization file is missing the <value>. Both are required to connect.: ファイルにクライアント ID またはクライアントシークレットがありません。SaaSAgent クライアントのファイルをダウンロードし直してください。

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

Check Connection は、クライアント ID とシークレットで OpenLM Platform にトークンを要求し、続いて Broker Hub を呼び出します。確認に失敗した場合は、主要ログを確認します。

• Token request failed for ClientId: <ID>: Identity でクライアントが削除されたか、シークレットがリセットされています。新しい認可ファイルを生成し、レシーバーを選択して Edit を選択し、新しいファイルをインポートします。
• Error sending request to Server for <URL>: ホストが OpenLM Platform に到達できません。URL のアドレスへの送信 HTTPS（ポート 443）を許可してください。

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

エージェントは、レシーバーを保存したときと、サービスが起動するたびに Broker Hub に報告します。SaaS Agents の一覧は自動では更新されないため、まずページを再読み込みしてください。

それでも表示されない場合は、レシーバーで Check Connection を選択します。報告に成功すると Successfully sent configuration to broker hub receiver with ID: <number> が記録されます。報告に失敗すると、ログに Failed to send configuration request to receiver <number>. Adding to buffer. が記録され、エージェントは毎正時に再送します。

再インストールしたエージェントが Broker Hub で古い ID のままなのはなぜですか？

Broker Hub は、ホスト名ごとに 1 つのエージェントを表示します。インストールフォルダーを削除してから同じマシンにインストールし直すと新しい ID になりますが、Broker Hub はそのホストに表示済みのエージェントと照合するため、表示は古い ID のままです。その項目は更新されなくなり、Broker Hub からの更新コマンドも新しいエージェントに届きません。

最初からインストールし直す場合は、新しいインストールのレシーバーを保存する前に、Broker Hub の SaaS Agents ページでエージェントを削除してください。新しいインストールは、新しいエージェントとして報告します。

サービスが Error のままになるのはなぜですか？

まず Synchronize を 1 回実行し、一過性の失敗でないことを確認します。次に Relogin を実行します。認証情報の期限切れが最も多い原因です。いずれも解決しない場合は Run troubleshooting process を使用します。ブラウザーを表示した状態でスキャンを再実行するため、どこで停止するかを確認できます。ブラウザーは自動的に開閉するので、そのまま完了させてください。

エージェントが Chrome プロファイルを使用中と表示するのはなぜですか？

The Shared User Data Directory of Chrome is already being used by the Windows Service. というメッセージは、スケジュールされたスキャンがエージェントの Chrome プロファイルを使用していることを示します。エージェントは 1 つの Chrome プロファイルを使用します。スキャンの完了を待って再試行してください。プロファイルが使用中であることを検出したスキャンは、数分後に自動で再スケジュールされます。

意図しないユーザーとして認証されるのはなぜですか？

共有プロファイルに別のアカウントのサインインが残っています。該当サービスで Relogin を実行し、正しいアカウントでサインインしてください。

何も変更していないのに、認証情報を保存するサービスが一斉に失敗したのはなぜですか？

サービスのログオンアカウントが変更されていないか確認してください。保存された SaaS 認証情報は、それを書き込んだアカウントだけが読み取れます。新しいアカウントで、各サービスの認証情報を Edit から再入力してください。

参考

• SaaS Agent のインストールと接続: インストールと接続の手順です。
• SaaS Agent の変更、アップグレード、アンインストール: エージェント、そのサービス、ファイルを管理します。
• Broker Hub: すべての Broker と SaaS Agent を Platform から監視・更新します。
• SaaS Agent の変更履歴: 各リリースの変更点です。