SaaS Agent の変更、アップグレード、アンインストール

OpenLM SaaS Agent のインストール後は、エージェントのアプリで監視するプラットフォームを管理し、Broker Hub またはホスト上でエージェントをアップグレードし、Windows から削除します。エージェントのインストールと接続については、SaaS Agent のインストールと接続を参照してください。

監視するサービスを管理する

Monitored Services の各行には、そのプラットフォームのステータスと操作が表示されます。この節の見出しから、目的の作業を探してください。

今すぐスキャンを実行する

次のスケジュールされたスキャンを待たずに収集するには、Synchronize を選択します。スキャンはバックグラウンドで実行されます。前回のスキャンから 1 分未満の場合、エージェントは実行を拒否します。

再度サインインする

パスワードの変更後や、認証情報の期限切れでスキャンが失敗する場合は、Relogin を選択します。エージェントがベンダーのサインインページを Chrome で開くので、再度サインインしてください。

失敗するスキャンを確認する

スキャンがどこで停止するかを確認するには、Run troubleshooting process を選択します。ブラウザーを表示した状態でスキャンを再実行します。サービスが Error のままになるのはなぜですか？を参照してください。

監視を一時停止または再開する

設定を削除せずに収集を止めるには、Monitoring を使用します。行には Active または Paused と表示されます。

エージェントが収集または制御する内容を変更する

• Usage Monitoring は、シートに加えて AI トークン使用量を収集します。対応するプラットフォームにのみ表示され、必要なベンダー側の権限がアプリ内に注記されます。
• License Allocation Control は、このプラットフォームの割り当てを OpenLM から操作できるようにします。対応するプラットフォームにのみ表示され、その場合は既定で有効です。
• Export data into a file for OpenLM Broker は、スキャン結果を OpenLM Platform に送信せず、ローカルファイルへ書き出します。OpenLM Version 26 で使用するを参照してください。

認証情報やオプションを変更する

プラットフォームの認証情報とオプションのダイアログを再度開くには、Edit を選択します。Autodesk Cloud では、収集対象を特定のチームに限定するで説明しているとおり、Edit Allow List で収集対象を指定したチームだけに限定できます。

サービスを削除する

プラットフォームの収集を停止して設定を削除するには、Delete を選択します。

プラットフォームを追加する、または一覧を更新する

別のプラットフォームを監視するには、監視するサービスを追加するの説明に従って Add Service を選択します。サービスやステータスの表示が古い場合は、Refresh List を選択して、一覧と現在のステータスを再読み込みします。

サービスのステータス

ステータス	意味
Ok	直近のスキャンが正常に完了しました。
Error	直近のスキャンが失敗しました。Message 列に理由が表示されます。
Synchronization under process	スキャンの実行中、または最初のスキャンが未完了です。
Paused	このサービスの監視が停止されています。

Error が 1 回だけ表示される場合は、ベンダーのサービスの応答が遅かった場合など、一過性の原因であることがよくあります。調査の前にもう一度 Synchronize を実行してください。自動再試行は行われません。失敗したスキャンは破棄され、そのサービスは次回のスケジュールまで待機します。

すべての失敗はアラートとしても発行され、監査証跡に記録されるため、この画面を監視していなくても気づくことができます。Alerts を参照してください。

データ収集の頻度

Sample Rate には 2 つのモードがあります。スケジュールはすべて UTC で実行されます。

• Daily: 設定した Execution Time に 1 日 1 回スキャンします。
• Hourly: Run Every (minutes) で指定した分間隔でスキャンします。新しいサービスの初期値は 360 分、つまり 6 時間ごとです。

エージェントは全サービスを通じて一度に 1 件のスキャンしか実行しません。監視対象の多いホストでは、実行時刻をずらすことで待ち行列の発生を防げます。

シングルサインオン

Autodesk Cloud と Siemens は、ベンダー独自のログインではなく Microsoft Entra ID を介してサインインします。方式はサービスの Single Sign On で選択します。

• Autodesk Cloud: None、Azure SSO with sessions、Azure SSO sessionless。
• Siemens: None または Azure SSO。

最初のサインイン前に設定してください。後から変更した場合は Relogin を実行し、新しい方式でセッションを取得し直します。

多要素認証を強制している場合は、エージェントが使用するアカウントの認証要求の間隔を延長してください。エージェントは多要素認証の要求に応答できないため、間隔が短いと、次に要求が表示された時点でスキャンが失敗します。Autodesk Cloud の場合は、Autodesk ポータルにサインインした後、多要素認証の有効期間を 30 日に延長してください。

収集対象を特定のチームに限定する

Autodesk Cloud のアカウントはチームに分割されていることがよくあります。Edit Allow List は、OpenLM が収集する範囲を選択したチームに限定します。

1. Autodesk Cloud のサービスを選択し、Edit Allow List を選択します。
2. Import Teams を選択し、サインイン中のアカウントから参照できるチームを読み込みます。読み込んだチームは Available Tenants に表示されます。
3. Add で対象のチームを Allowed Tenants に移動します。取り消すには Remove を使用します。
4. Save を選択します。

Allowed Tenants を空のままにすると制限は適用されず、そのアカウントから参照できるすべてのチームが収集対象になります。

エージェントの設定

Settings には、個々のサービスではなくエージェント全体に適用される 2 つのスイッチがあります。

• Debug Mode: ポータルへのサインインが失敗する場合に有効化すると、Chrome 自身の内部ログを含む詳細なトレースを収集します。問題が解決したら無効に戻してください。大量のデータが生成されます。
• Skip Chrome Profile Picker: Chrome のプロファイル選択画面を抑止します。誰もサインインしないホストで役立ちます。この設定はマシン全体の Chrome ポリシーを書き込むため管理者権限が必要です。エージェントが書き込めない場合は、実行すべきコマンドがアプリに表示されます。

SaaS Agent をアップグレードする

エージェントをアップグレードするには、エージェントのマシンを操作せずに Broker Hub から更新するか、マシン上で新しいインストーラーを実行します。

ホスト上でアップグレードする

1 台のエージェントをそのマシン上でアップグレードするには、サービスを実行しているアカウントで Windows にサインインし、新しいバージョンのインストーラーを実行します。

1. 新しいインストーラー OpenLM_SaaSAgent_<version>.msi を、Downloads ページの Platform タブからダウンロードします。

2. 新規インストールと同じようにインストーラーを開くか、サイレントインストールのコマンドでサイレントに実行します。

   インストーラーは、インストール済みのエージェントをその場でアップグレードします。古い OpenLM Cloud Broker Agent もアップグレードします。サイレントアップグレードでは、サービスがすでに使用しているアカウントが LocalSystem でない限り、SERVICE_USER を指定しないことで、そのアカウントが維持されます。

3. インストールが完了したら、Windows の サービス で OpenLM SaaS Agent Service が動作していることを確認します。

   msiexec は、サービスが起動しなくても成功を報告します。

インストーラーは同じバージョンを受け付けるため、アップグレードを繰り返せます。古いバージョンは、メッセージ A newer version of OpenLM SaaS Agent is already installed. を表示して拒否されます。アップグレードでは bin\appsettings.json と UI\appsettings.json が置き換えられるため、ポートを変更していた場合は、サービスが起動直後に停止するのはなぜですか？の説明に従って、もう一度設定してください。

Platform からエージェントを管理する

SaaS Agent が動作しているマシンを確認したり、各マシンを操作せずにエージェントを更新したりするには、Broker Hub の SaaS Agents ページを開きます。このページには、報告しているすべてのエージェントが、マシンのホスト名、ステータス、ID、IP アドレス、バージョンとともに一覧表示されます。エージェントが報告しているサービスを確認するには、そのホスト名を選択します。

エージェントに新しいバージョンを展開するには:

1. SaaS Agents ページで Update SaaS Agents を選択します。

2. Custom Version で Choose file を選択し、インストーラー OpenLM_SaaSAgent_<version>.msi を選択します。

   インストーラーのファイル名は変更しないでください。Broker Hub とエージェントが受け付けるのは、openlm、saas、agent と 4 つの部分からなるバージョンを名前に含む、署名済みの OpenLM SaaS Agent インストーラーだけです。SaaS Agent では Latest Version は使用できません。

3. Broker Hub によるファイルの確認が完了したら、Continue を選択します。

4. 更新するエージェントを選択し、Continue を選択します。

更新はコマンドとして送られ、エージェントは 30 秒ほどで受け取ります。エージェントはインストーラーをダウンロードし、自身を停止して、インストール時に保存されたサービスアカウントでサイレントに再インストールし、再び起動します。SaaS Agents の一覧は自動では更新されないため、新しいバージョンを確認するにはページを再読み込みしてください。

ファイルとディレクトリ

パスはインストールフォルダー（既定では C:\Program Files\OpenLM\OpenLM SaaS Agent）からの相対パスです。

パス	内容
bin\	Windows サービス。
UI\	デスクトップアプリケーション。
Shared User Data Directory\	エージェントがサインインに使用する Chrome プロファイル。保存されたベンダーのパスワードを含みます。
bin\logs\saasagent-<yyyyMMdd>.log	エージェントの主要ログ。1 日 1 ファイルです。
bin\logs\saasagent-debug-.txt	エージェントのデバッグメッセージ。
bin\logs\Plugin\Plugin_<platform>_LOG\	プラットフォームごとのスキャンログ。その中の screenshots フォルダーに、失敗したスキャンのスクリーンショットが保存されます。
bin\logs\Screenshots\	Siemens のスキャン失敗時に取得されたスクリーンショット。
bin\DB\	エージェントのローカルデータベース。レシーバー、監視するサービス、送信バッファ、保存された認証情報を含みます。
bin\CloudBrokerAgentID.txt	Broker Hub に表示されるエージェントの ID。
bin\appsettings.json	ローカルポートを含むサービスの構成。
UI\appsettings.json	サービスのアドレスを含むアプリの設定。
UI\logs\OpenLM.SaaSAgent.UI\	アプリ自身のログ。1 日 1 ファイルです。

サポートに問い合わせる際は、主要ログと、対象プラットフォームのログフォルダーを送付してください。

アンインストール

サービスアカウントでサインインし、次のいずれかの方法で Windows から SaaS Agent を削除します。

• インストールされているアプリ: Windows の 設定 で OpenLM SaaS Agent をアンインストールします。

• サイレントアンインストール: インストールに使用したインストーラーを指定して msiexec /x を実行します。

  msiexec /x "<full path>\OpenLM_SaaSAgent_<version>.msi" /qn

アンインストールすると、サービスが停止・削除され、エージェントのアプリが閉じ、プログラムファイル、ショートカット、2 つの Chrome ポリシー値、アンインストールしたアカウントの資格情報マネージャーに保存されたアカウントが削除されます。次の項目はインストールフォルダーに残ります。

• bin\DB\: クライアント ID と暗号化されたシークレットを含むレシーバー、監視するサービス、送信バッファ、保存されたベンダーの認証情報。
• bin\CloudBrokerAgentID.txt: エージェントの ID。
• bin\logs\ と UI\logs\: クライアント ID を含むログ。
• Shared User Data Directory\: エージェントがポータルにサインインした場合は、保存されたベンダーのパスワードを含む Chrome プロファイル。

同じフォルダーにインストールし直すと、これらのファイルが再利用されます。エージェントは ID とレシーバーを引き継ぎ、インポートし直さなくても再び報告します。ホストを廃止する場合は、インストールフォルダーを削除し、サービスアカウントに付与された「サービスとしてログオン」の権利と、有効にした場合は Windows ターミナルの設定も確認してください。

アンインストールしても、エージェントは Broker Hub にステータス Up のまま表示されます。Broker Hub は 4 時間ごとにエージェントを確認し、1 時間を超えて報告がないエージェントについてアラートを発行し、24 時間連絡がないと Warning、48 時間連絡がないと Not Reporting と表示します。一覧から削除するには、SaaS Agents ページでエージェントを選択し、Delete を選択します。