--- title: Linux に Workstation Agent をインストールする description: Linux に OpenLM Platform 用の Workstation Agent を DEB パッケージ、RPM パッケージ、tar.gz アーカイブからインストールし、認証ファイルで OpenLM Platform に接続します。 product: OpenLM Platform --- Linux マシンからアプリケーションの使用状況を収集するには、各マシンに Workstation Agent をインストールし、認証ファイルで OpenLM Platform に接続します。Linux 用エージェントには、64 ビット x86 マシン向けの DEB パッケージ、RPM パッケージ、tar.gz アーカイブがあります。 どの形式でも、エージェントは `/opt/openlmagent` にインストールされ、`/home` にホームフォルダーがある各ユーザーの `systemd` ユーザーサービス `openlmagent` として設定されます。エージェントはユーザーがサインインしている間動作し、次にユーザーがサインインすると再び起動します。 ## 開始する前に 次の前提条件を確認します。 - **認証ファイル**: [コンポーネントの認証](https://www.openlm.com/documentation/ja/cloud/getting-started/authorize-components)の説明に従って、**Identity** で種類が **Agent** のクライアントの認証ファイルを生成します。エージェントは、暗号化されていないファイルと **Encrypted authorization client** のファイルのどちらも受け付けます。Identity はファイルに `agent-authorization.json` という名前を付けます。 - **64 ビット x86 マシン**: [システム要件](https://www.openlm.com/documentation/ja/cloud/deployment-operations/system-requirements/?component=workstation-agent)を満たし、`sudo` 権限があり、OpenLM Platform への送信 HTTPS (ポート 443) を許可したマシン。 - **ICU ライブラリ `libicu`**: Ubuntu には含まれています。Rocky Linux など Red Hat Enterprise Linux 系のディストリビューションでは、`sudo dnf install libicu` でインストールします。これがないと、[Linux でエージェントが再起動を繰り返すのはなぜですか？](https://www.openlm.com/documentation/ja/cloud/getting-started/install-workstation-agent/troubleshooting#linux-でエージェントが再起動を繰り返すのはなぜですか)で説明するように、エージェントは起動のたびに停止します。 - **X11 スクリーンセーバーライブラリ**: エージェントは、このライブラリを使って、ユーザーの X11 デスクトップセッションのアイドル時間を読み取ります。RPM パッケージは `libXScrnSaver` をインストールします。DEB パッケージまたは tar.gz アーカイブを使用する場合は、Ubuntu または Debian に `libxss1` をインストールします。 - **ユーザーサービスを利用できる `systemd`**: 必須です。tar.gz アーカイブからアップグレードするには `rsync` も必要です。 [ダウンロードページ](https://www.openlm.com/downloads/)から、マシンに合ったパッケージまたはアーカイブをダウンロードします。 ## DEB パッケージをインストールする Ubuntu または Debian に Workstation Agent をインストールするには: 1. パッケージ `openlm-agent__amd64.deb` をマシンにコピーします。 2. パッケージをインストールします。 ```bash sudo apt install ./openlm-agent__amd64.deb ``` インストールでは、`/home` にホームフォルダーがある各ユーザーのエージェントが起動し、ユーザーごとに次のように報告されます。 ```console --- Processing user: --- ✅ Success: openlmagent is ACTIVE for ``` マシンに `openlm` アカウントがない場合、出力にはファイルごとに `chown: invalid user: 'openlm:openlm'` という行も表示されます。これらの行は無視してかまいません。 3. [エージェントを接続する](#エージェントを接続する)の説明に従って、エージェントを OpenLM Platform に接続します。 ## RPM パッケージをインストールする Rocky Linux、Red Hat Enterprise Linux、またはその系統のディストリビューションに Workstation Agent をインストールするには: 1. ICU ライブラリをインストールします。 ```bash sudo dnf install libicu ``` 2. パッケージ `openlm_agent-.x86_64.rpm` をマシンにコピーします。 3. `dnf` でパッケージをインストールします。 ```bash sudo dnf install ./openlm_agent-.x86_64.rpm ``` `dnf` は、エージェントに必要なライブラリもインストールします。インストールでは、`/home` にホームフォルダーがある各ユーザーのエージェントが起動し、ユーザーごとに `✅ Success: openlmagent is ACTIVE for ` と報告されます。マシンに `openlm` アカウントがない場合、出力にはファイルごとに `warning: user openlm does not exist - using root` と `warning: group openlm does not exist - using root` という行も表示されます。これらの行は無視してかまいません。 4. [エージェントを接続する](#エージェントを接続する)の説明に従って、エージェントを OpenLM Platform に接続します。 ## tar.gz アーカイブからインストールする その他のディストリビューションの場合や、パッケージマネージャーを使わずにインストールする場合は、tar.gz アーカイブを使用します。インストールスクリプトはアーカイブのフォルダーから認証ファイルをコピーするため、スクリプトを実行する前に認証ファイルを追加します。 tar.gz アーカイブから Workstation Agent をインストールするには: 1. アーカイブ `openlm_agent_.tar.gz` を、新しい空のフォルダーに展開します。アーカイブには独自のフォルダーがありません。 ```bash mkdir openlm-agent tar -xzf openlm_agent_.tar.gz -C openlm-agent ``` 2. そのフォルダーの `agent-authorization.json` を、生成した認証ファイルに置き換えます。 ```bash cp /agent-authorization.json openlm-agent/agent-authorization.json ``` `` を、認証ファイルがあるフォルダーに置き換えます。 3. フォルダーからインストールスクリプトを実行します。 ```bash cd openlm-agent sudo bash install.sh ``` スクリプトはエージェントを `/opt/openlmagent` にコピーし、`/home` にホームフォルダーがある各ユーザーのエージェントを起動して、ユーザーごとに `✅ Success: openlmagent is ACTIVE for ` と報告します。エージェントは最初の起動時に OpenLM Platform に接続します。 4. [エージェントを確認する](#エージェントを確認する)の説明に従って、エージェントを確認します。 ## エージェントを接続する DEB パッケージと RPM パッケージは `/opt/openlmagent` にプレースホルダーの認証ファイルをインストールするため、ファイルを置き換えるまで、Workstation Agent は OpenLM Platform に接続できません。エージェントは起動時にファイルを読み取ります。 エージェントを接続するには: 1. 認証ファイルをプレースホルダーに上書きコピーします。 ```bash sudo cp agent-authorization.json /opt/openlmagent/agent-authorization.json ``` 2. サインインしている各ユーザーのエージェントを再起動します。そのユーザーとして、次を実行します。 ```bash systemctl --user restart openlmagent ``` 後でサインインするユーザーのエージェントは、新しいファイルで起動します。 3. [エージェントを確認する](#エージェントを確認する)の説明に従って、エージェントを確認します。 ## セルフホストの OpenLM Platform に接続する クラウドの OpenLM Platform では、接続先のアドレスは認証ファイルに含まれています。セルフホストの OpenLM Platform では、`/opt/openlmagent` の `settings.json` に、Agents Hub のアドレスも設定します。 1. `sudo` で `/opt/openlmagent/settings.json` を開き、`agentsHub` を設定します。 ```json { "agentsHub": { "address": "", "port": 443, "useSSL": true } } ``` `` は、セルフホストの OpenLM Platform のホスト名に置き換えます。`https://` やパスは含めません。OpenLM Platform が別のポートや SSL なしで接続を受け付ける場合を除き、`port` と `useSSL` はそのままにします。 2. サインインしている各ユーザーのエージェントを再起動します。そのユーザーとして、次を実行します。 ```bash systemctl --user restart openlmagent ``` 3. [エージェントを確認する](#エージェントを確認する)の説明に従って、エージェントを確認します。 生成したファイルがクラウドの OpenLM Platform 用の場合、エージェントは `agentsHub` を無視し、認証ファイルに含まれるアドレスに接続します。 ## インストール後にユーザーを追加する インストールでは、その時点で `/home` にホームフォルダーがあるユーザーに対してだけ Workstation Agent が設定されます。後で追加するユーザーを含め、すべてのユーザーに対してエージェントを設定するには、次を実行します。 ```bash sudo bash /opt/openlmagent/start-logged-in.sh ``` このスクリプトは、現在と今後のすべてのユーザーに対してエージェントを有効にし、サインインしているユーザーのエージェントをすぐに起動します。サインインしていないユーザーは、次回のサインイン時にエージェントが起動します。新しいユーザーのエージェントが再起動を繰り返す場合は、[新しいユーザーのエージェントが再起動を繰り返すのはなぜですか？](https://www.openlm.com/documentation/ja/cloud/getting-started/install-workstation-agent/troubleshooting#新しいユーザーのエージェントが再起動を繰り返すのはなぜですか)を参照してください。 ## エージェントを確認する インストール後、Workstation Agent が動作し、OpenLM Platform に報告していることを確認します。 1. サインインしているユーザーとして、エージェントが動作していることを確認します。 ```bash systemctl --user status openlmagent ``` 状態は `active (running)` と表示されます。`activating (auto-restart)` と表示される場合は、[Linux でエージェントが再起動を繰り返すのはなぜですか？](https://www.openlm.com/documentation/ja/cloud/getting-started/install-workstation-agent/troubleshooting#linux-でエージェントが再起動を繰り返すのはなぜですか)を参照してください。 2. エージェントが接続したことを確認します。エージェントのログ `/opt/openlmagent/logs//Agent.ALL..log` に、`"Connected"` と OpenLM Platform のアドレスを含む行があります。 ```console $ grep Connected /opt/openlmagent/logs/$USER/Agent.ALL.*.log [INF] "AgentConnectionsHubClient"; SENDING: Agent details: https:///api/agents-hub/AgentsHub, "Connected", ``` `` は OpenLM Platform のアドレス、`` は接続の ID です。 3. OpenLM Platform で、**Navigation**、**Agents**、**Agent Activity** の順に選択します。 4. **Refresh** アイコンを選択します。 5. マシンのホスト名の行を探します。 エージェントが接続している間、**Online** にチェックマークが表示されることを確認します。 この一覧の詳細については、[Agent Activity でエージェントを確認する](https://www.openlm.com/documentation/ja/cloud/getting-started/install-workstation-agent/index#agent-activity-でエージェントを確認する)を参照してください。エージェントが表示されない場合は、[エージェントが Agent Activity に表示されないのはなぜですか？](https://www.openlm.com/documentation/ja/cloud/getting-started/install-workstation-agent/troubleshooting#エージェントが-agent-activity-に表示されないのはなぜですか)を参照してください。 ## パーソナルダッシュボードを開く ユーザーは Workstation Agent から[パーソナルダッシュボード](https://www.openlm.com/documentation/ja/cloud/users/personal-dashboard/)を開きます。インストールでは、デスクトップセッションにサインインしている各ユーザーのためにダッシュボードが開きます。それ以外のユーザーについては、出力に `❌ Skip Opening Personal Dashboard for (No active GUI session found)` という行が表示されます。 後でパーソナルダッシュボードを開くには、そのユーザーとして、そのユーザーのデスクトップセッションで次のコマンドを実行します。 ```bash /opt/openlmagent/OpenLM.Agent.Linux --signin ``` ダッシュボードは既定のブラウザーで開きます。ユーザーは、[パーソナルダッシュボードの前提条件](https://www.openlm.com/documentation/ja/cloud/users/personal-dashboard/#はじめに)の説明に従って、Identity のアカウントでサインインします。ダッシュボードが開かない場合は、[パーソナルダッシュボードが開かないのはなぜですか？](https://www.openlm.com/documentation/ja/cloud/getting-started/install-workstation-agent/troubleshooting#パーソナルダッシュボードが開かないのはなぜですか)を参照してください。 :::info[次のステップ] エージェントは、OpenLM Platform が監視を指示したアプリケーションを報告します。監視するアプリケーションを選択するには、**Navigation** を開き、**Agents**、**Process Manager** の順に選択して、[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)に進み、ディレクトリからユーザーとグループのデータを同期してください。 :::