メインコンテンツまでスキップ

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

Workstation Agent をインストールした後は、各マシンでエージェントの設定と認証ファイルを変更し、インストールした方法でアップグレードまたは削除します。エージェントが監視する内容のほとんどは、Agents Hub を介して OpenLM Platform から届きます。

エージェントの設定を変更する​

Workstation Agent は、インストールフォルダーにある settings.json から設定を、agent-authorization.json から認証情報を読み取ります。

  • Windows: C:\Program Files\OpenLM\Agent\。ファイルは管理者として編集します。
  • Linux: /opt/openlmagent/。
  • macOS: /Library/OpenLMAgent/。

エージェントは起動時に両方のファイルを読み取ります。ファイルを変更したら、エージェントを再起動します。

  • Windows: Windows からサインアウトし、もう一度サインインします。または、タスクマネージャーで OpenLM.Agent.Windows.Core.exe を終了し、スタートメニューで Start OpenLM Agent を選択します。
  • Linux: サインインしている各ユーザーとして systemctl --user restart openlmagent を実行します。
  • macOS: サインインしている各ユーザーとして launchctl kickstart -k "gui/$(id -u)/com.openlm.agent" を実行します。

settings.json で最もよく変更する設定は、エージェントのログの詳細度を表す logging.minimumLevel です。値は Verbose、Debug、Information (既定値)、Warning、Error、Fatal です。

エージェントに新しい認証ファイルを渡す​

Identity でクライアントのシークレットをリセットした場合や、クライアントを削除して新しいクライアントのファイルを生成した場合は、Workstation Agent に新しい認証ファイルが必要です。新しいファイルを渡すまで、エージェントは OpenLM Platform に接続できません。

インストール済みのエージェントに新しい認証ファイルを渡すには:

  1. コンポーネントの認証の説明に従って、Identity で種類が Agent のクライアントのファイルを生成します。
  2. エージェントのインストールフォルダーにある agent-authorization.json を新しいファイルに置き換えます。インストールフォルダーは、Windows では C:\Program Files\OpenLM\Agent\、Linux では /opt/openlmagent/、macOS では /Library/OpenLMAgent/ です。
  3. エージェントの設定を変更するの説明に従って、エージェントを再起動します。

エージェントをアップグレードする​

Workstation Agent をアップグレードするには、インストール済みのエージェントにアップグレード先のバージョンをインストールします。インストール方法に合った手順を使います。

  • Windows: アップグレード先のバージョンの MSI を実行します。Upgrade Detected ページで、設定を保持するには Upgrade using existing settings を選択したままにし、構成ページをもう一度確認するには Customize configuration settings を選択します。サイレントインストールは設定を保持します。サイレントにインストールするには、次のコマンドを実行します。

    msiexec /i "<msi-path>" /qn

  • DEB パッケージ: 次のコマンドを実行します。

    sudo apt install ./openlm-agent_<version>_amd64.deb

  • RPM パッケージ: 次のコマンドを実行します。

    sudo dnf upgrade ./openlm_agent-<version>.x86_64.rpm

  • tar.gz アーカイブ: アップグレード先のバージョンのアーカイブを新しい空のフォルダーに展開し、そのフォルダーから次のコマンドを実行します。

    sudo bash install.sh

    スクリプトは settings.json、agent-authorization.json、ログを保持します。

  • macOS: アップグレード先のバージョンのパッケージをインストールします。settings.json と agent-authorization.json は保持されます。

これらのコマンドでは、<msi-path> を MSI ファイルのフルパスに、<version> をアップグレード先のバージョンに置き換えます。

Windows では、アップグレードしてもインストールフォルダー、settings.json、認証ファイルは保持されます。エージェントがオフラインの間に保存したデータは削除されるため、アップグレードの前に、エージェントを接続してデータを送信させてください。インストーラーは、新しいバージョンの上に古いバージョンをインストールせず、A newer version of OpenLM Agent is already installed. と報告します。

Linux では、パッケージでアップグレードする前に settings.json と agent-authorization.json をバックアップし、アップグレード後に確認します。パッケージには、両方のファイルの独自のコピーが含まれています。

OpenLM Platform から Windows の Workstation Agent をアップグレードするには、Agent Activity のエージェントのアップグレードを参照してください。展開ツールでアップグレードするには、多数のマシンに展開するのコマンドで、アップグレード先のバージョンの MSI を展開します。

エージェントをアンインストールする​

Workstation Agent は、インストールした方法で削除します。

  • Windows: コントロールパネルで、Programs、Uninstall a program の順に選択します。OpenLM Agent、Uninstall の順に選択します。サイレントにアンインストールするには、インストールに使用したインストーラーを指定して、次のコマンドを実行します。

    msiexec /x "<msi-path>" /qn

    <msi-path> を MSI ファイルのフルパスに置き換えます。

  • DEB パッケージ: 次のコマンドを実行します。

    sudo apt remove openlm-agent

    その後、次のコマンドを実行してパッケージの記録を消去します。

    sudo apt purge openlm-agent

  • RPM パッケージ: 次のコマンドを実行します。

    sudo dnf remove openlm_agent

  • tar.gz アーカイブ: 次のコマンドを実行します。

    sudo bash /opt/openlmagent/uninstall.sh

  • macOS: 次のコマンドを実行します。

    sudo sh /Library/OpenLMAgent/uninstall.sh

    詳細については、エージェントをアンインストールするを参照してください。

Windows では、アンインストールするとエージェントが停止し、OpenLM Agent Updater Service が削除されますが、C:\Program Files\OpenLM\Agent の settings.json と認証ファイル agent-authorization.json は残ります。認証ファイルにはエージェントの資格情報が含まれるため、エージェントを完全に削除するには、アンインストール後にこのフォルダーを削除してください。各ユーザーのデータとログは %APPDATA%\OpenLM\Agent に、アップデーターのデータとログは %ProgramData%\OpenLM\Agent に残ります。

Linux では、エージェントを削除すると、すべてのユーザーのエージェントが停止し、settings.json、認証ファイル、ログを含む /opt/openlmagent が削除されます。各ユーザーのためにエージェントが保存したデータは ~/.config/OpenLM/Agent に残ります。

アンインストールしても、エージェントは Agent Activity にオフラインとして残ります。そちらからも削除するには、エージェントの削除を参照してください。

結果を確認する​

設定の変更、新しいファイルの適用、アップグレードの後に、エージェントがレポートしていることを確認します。

  1. OpenLM Platform で Navigation を開き、Agents、Agent Activity の順に選択して、Refresh アイコンを選択します。
  2. マシンのホスト名の行を探します。エージェントが接続している間、Online にチェックマークが表示され、Agent Version にはインストールしたバージョンが表示されます。

エージェントが表示されない場合は、Workstation Agent のトラブルシューティングを参照してください。各リリースの変更点については、Workstation Agent の変更履歴を参照してください。

次のステップ

エージェントがレポートするアプリケーションを、Process Manager で選択します。その後、Directory Synchronization Agent (DSA) のインストールに進みます。

にtestが最終更新

ドキュメントチームは、大規模言語モデルを使ってこのページを下書きすることがあります。公開前に、テクニカルライターがすべてのページをレビューし、製品と照らし合わせて検証します。最終的な判断は人間が行います。