---
title: Workstation Agent の変更、アップグレード、アンインストール
description: OpenLM Platform 用 Workstation Agent の設定を変更し、新しい認証ファイルを渡し、Windows、Linux、macOS でアップグレードまたはアンインストールします。
product: OpenLM Platform
---

Workstation Agent をインストールした後は、各マシンでエージェントの設定と認証ファイルを変更し、インストールした方法でアップグレードまたは削除します。エージェントが監視する内容のほとんどは、[Agents Hub](https://www.openlm.com/documentation/ja/cloud/data-collection/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. [コンポーネントの認証](https://www.openlm.com/documentation/ja/cloud/getting-started/authorize-components)の説明に従って、**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** を選択します。サイレントインストールは設定を保持します。サイレントにインストールするには、次のコマンドを実行します。

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

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

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

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

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

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

  ```bash
  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 の[エージェントのアップグレード](https://www.openlm.com/documentation/ja/cloud/data-collection/agent_activity_manager/#エージェントのアップグレード)を参照してください。展開ツールでアップグレードするには、[多数のマシンに展開する](https://www.openlm.com/documentation/ja/cloud/getting-started/install-workstation-agent/windows#多数のマシンに展開する)のコマンドで、アップグレード先のバージョンの MSI を展開します。

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

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

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

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

  `<msi-path>` を MSI ファイルのフルパスに置き換えます。
- **DEB パッケージ**: 次のコマンドを実行します。

  ```bash
  sudo apt remove openlm-agent
  ```

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

  ```bash
  sudo apt purge openlm-agent
  ```

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

  ```bash
  sudo dnf remove openlm_agent
  ```

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

  ```bash
  sudo bash /opt/openlmagent/uninstall.sh
  ```

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

  ```bash
  sudo sh /Library/OpenLMAgent/uninstall.sh
  ```

  詳細については、[エージェントをアンインストールする](https://www.openlm.com/documentation/ja/cloud/getting-started/install-workstation-agent/macos#エージェントをアンインストールする)を参照してください。

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 にオフラインとして残ります。そちらからも削除するには、[エージェントの削除](https://www.openlm.com/documentation/ja/cloud/data-collection/agent_activity_manager/#エージェントの削除)を参照してください。

## 結果を確認する

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

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

エージェントが表示されない場合は、[Workstation Agent のトラブルシューティング](https://www.openlm.com/documentation/ja/cloud/getting-started/install-workstation-agent/troubleshooting)を参照してください。各リリースの変更点については、[Workstation Agent の変更履歴](https://www.openlm.com/documentation/ja/cloud/changelog/components/workstation-agent/)を参照してください。

:::info[次のステップ]
エージェントがレポートするアプリケーションを、[Process Manager](https://www.openlm.com/documentation/ja/cloud/automations/process-manager/) で選択します。その後、[Directory Synchronization Agent (DSA) のインストール](https://www.openlm.com/documentation/ja/cloud/getting-started/install-dsa)に進みます。
:::