Linux に Workstation Agent をインストールする

Linux マシンからアプリケーションの使用状況を収集するには、各マシンに Workstation Agent をインストールし、認証ファイルで OpenLM Platform に接続します。Linux 用エージェントには、64 ビット x86 マシン向けの DEB パッケージ、RPM パッケージ、tar.gz アーカイブがあります。

どの形式でも、エージェントは /opt/openlmagent にインストールされ、/home にホームフォルダーがある各ユーザーの systemd ユーザーサービス openlmagent として設定されます。エージェントはユーザーがサインインしている間動作し、次にユーザーがサインインすると再び起動します。

開始する前に

次の前提条件を確認します。

• 認証ファイル: コンポーネントの認証の説明に従って、Identity で種類が Agent のクライアントの認証ファイルを生成します。エージェントは、暗号化されていないファイルと Encrypted authorization client のファイルのどちらも受け付けます。Identity はファイルに agent-authorization.json という名前を付けます。
• 64 ビット x86 マシン: システム要件を満たし、sudo 権限があり、OpenLM Platform への送信 HTTPS (ポート 443) を許可したマシン。
• ICU ライブラリ libicu: Ubuntu には含まれています。Rocky Linux など Red Hat Enterprise Linux 系のディストリビューションでは、sudo dnf install libicu でインストールします。これがないと、Linux でエージェントが再起動を繰り返すのはなぜですか？で説明するように、エージェントは起動のたびに停止します。
• X11 スクリーンセーバーライブラリ: エージェントは、このライブラリを使って、ユーザーの X11 デスクトップセッションのアイドル時間を読み取ります。RPM パッケージは libXScrnSaver をインストールします。DEB パッケージまたは tar.gz アーカイブを使用する場合は、Ubuntu または Debian に libxss1 をインストールします。
• ユーザーサービスを利用できる systemd: 必須です。tar.gz アーカイブからアップグレードするには rsync も必要です。

ダウンロードページから、マシンに合ったパッケージまたはアーカイブをダウンロードします。

DEB パッケージをインストールする

Ubuntu または Debian に Workstation Agent をインストールするには:

1. パッケージ openlm-agent_<version>_amd64.deb をマシンにコピーします。

2. パッケージをインストールします。

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

   インストールでは、/home にホームフォルダーがある各ユーザーのエージェントが起動し、ユーザーごとに次のように報告されます。

   --- Processing user: <user> ---
   ✅ Success: openlmagent is ACTIVE for <user>

   マシンに openlm アカウントがない場合、出力にはファイルごとに chown: invalid user: 'openlm:openlm' という行も表示されます。これらの行は無視してかまいません。

3. エージェントを接続するの説明に従って、エージェントを OpenLM Platform に接続します。

RPM パッケージをインストールする

Rocky Linux、Red Hat Enterprise Linux、またはその系統のディストリビューションに Workstation Agent をインストールするには:

1. ICU ライブラリをインストールします。

   sudo dnf install libicu

2. パッケージ openlm_agent-<version>.x86_64.rpm をマシンにコピーします。

3. dnf でパッケージをインストールします。

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

   dnf は、エージェントに必要なライブラリもインストールします。インストールでは、/home にホームフォルダーがある各ユーザーのエージェントが起動し、ユーザーごとに ✅ Success: openlmagent is ACTIVE for <user> と報告されます。マシンに 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_<version>.tar.gz を、新しい空のフォルダーに展開します。アーカイブには独自のフォルダーがありません。

   mkdir openlm-agent
   tar -xzf openlm_agent_<version>.tar.gz -C openlm-agent

2. そのフォルダーの agent-authorization.json を、生成した認証ファイルに置き換えます。

   cp <path-to-file>/agent-authorization.json openlm-agent/agent-authorization.json

   <path-to-file> を、認証ファイルがあるフォルダーに置き換えます。

3. フォルダーからインストールスクリプトを実行します。

   cd openlm-agent
   sudo bash install.sh

   スクリプトはエージェントを /opt/openlmagent にコピーし、/home にホームフォルダーがある各ユーザーのエージェントを起動して、ユーザーごとに ✅ Success: openlmagent is ACTIVE for <user> と報告します。エージェントは最初の起動時に OpenLM Platform に接続します。

4. エージェントを確認するの説明に従って、エージェントを確認します。

エージェントを接続する

DEB パッケージと RPM パッケージは /opt/openlmagent にプレースホルダーの認証ファイルをインストールするため、ファイルを置き換えるまで、Workstation Agent は OpenLM Platform に接続できません。エージェントは起動時にファイルを読み取ります。

エージェントを接続するには:

1. 認証ファイルをプレースホルダーに上書きコピーします。

   sudo cp agent-authorization.json /opt/openlmagent/agent-authorization.json

2. サインインしている各ユーザーのエージェントを再起動します。そのユーザーとして、次を実行します。

   systemctl --user restart openlmagent

   後でサインインするユーザーのエージェントは、新しいファイルで起動します。

3. エージェントを確認するの説明に従って、エージェントを確認します。

セルフホストの OpenLM Platform に接続する

クラウドの OpenLM Platform では、接続先のアドレスは認証ファイルに含まれています。セルフホストの OpenLM Platform では、/opt/openlmagent の settings.json に、Agents Hub のアドレスも設定します。

1. sudo で /opt/openlmagent/settings.json を開き、agentsHub を設定します。

   {
     "agentsHub": {
       "address": "<your-openlm-server-host>",
       "port": 443,
       "useSSL": true
     }
   }

   <your-openlm-server-host> は、セルフホストの OpenLM Platform のホスト名に置き換えます。https:// やパスは含めません。OpenLM Platform が別のポートや SSL なしで接続を受け付ける場合を除き、port と useSSL はそのままにします。

2. サインインしている各ユーザーのエージェントを再起動します。そのユーザーとして、次を実行します。

   systemctl --user restart openlmagent

3. エージェントを確認するの説明に従って、エージェントを確認します。

生成したファイルがクラウドの OpenLM Platform 用の場合、エージェントは agentsHub を無視し、認証ファイルに含まれるアドレスに接続します。

インストール後にユーザーを追加する

インストールでは、その時点で /home にホームフォルダーがあるユーザーに対してだけ Workstation Agent が設定されます。後で追加するユーザーを含め、すべてのユーザーに対してエージェントを設定するには、次を実行します。

sudo bash /opt/openlmagent/start-logged-in.sh

このスクリプトは、現在と今後のすべてのユーザーに対してエージェントを有効にし、サインインしているユーザーのエージェントをすぐに起動します。サインインしていないユーザーは、次回のサインイン時にエージェントが起動します。新しいユーザーのエージェントが再起動を繰り返す場合は、新しいユーザーのエージェントが再起動を繰り返すのはなぜですか？を参照してください。

エージェントを確認する

インストール後、Workstation Agent が動作し、OpenLM Platform に報告していることを確認します。

1. サインインしているユーザーとして、エージェントが動作していることを確認します。

   systemctl --user status openlmagent

   状態は active (running) と表示されます。activating (auto-restart) と表示される場合は、Linux でエージェントが再起動を繰り返すのはなぜですか？を参照してください。

2. エージェントが接続したことを確認します。エージェントのログ /opt/openlmagent/logs/<user>/Agent.ALL.<yyyymmdd>.log に、"Connected" と OpenLM Platform のアドレスを含む行があります。

   $ grep Connected /opt/openlmagent/logs/$USER/Agent.ALL.*.log
   [INF] "AgentConnectionsHubClient"; SENDING: Agent details: https://<your-openlm-platform-address>/api/agents-hub/AgentsHub, "Connected", <connection-id>

   <your-openlm-platform-address> は OpenLM Platform のアドレス、<connection-id> は接続の ID です。

3. OpenLM Platform で、Navigation、Agents、Agent Activity の順に選択します。

4. Refresh アイコンを選択します。

5. マシンのホスト名の行を探します。

   エージェントが接続している間、Online にチェックマークが表示されることを確認します。

この一覧の詳細については、Agent Activity でエージェントを確認するを参照してください。エージェントが表示されない場合は、エージェントが Agent Activity に表示されないのはなぜですか？を参照してください。

パーソナルダッシュボードを開く

ユーザーは Workstation Agent からパーソナルダッシュボードを開きます。インストールでは、デスクトップセッションにサインインしている各ユーザーのためにダッシュボードが開きます。それ以外のユーザーについては、出力に ❌ Skip Opening Personal Dashboard for <user> (No active GUI session found) という行が表示されます。

後でパーソナルダッシュボードを開くには、そのユーザーとして、そのユーザーのデスクトップセッションで次のコマンドを実行します。

/opt/openlmagent/OpenLM.Agent.Linux --signin

ダッシュボードは既定のブラウザーで開きます。ユーザーは、パーソナルダッシュボードの前提条件の説明に従って、Identity のアカウントでサインインします。ダッシュボードが開かない場合は、パーソナルダッシュボードが開かないのはなぜですか？を参照してください。

次のステップ

エージェントは、OpenLM Platform が監視を指示したアプリケーションを報告します。監視するアプリケーションを選択するには、Navigation を開き、Agents、Process Manager の順に選択して、Process Manager の説明に従って、ライセンスを管理するアプリケーションのプロセスを追加します。

その後、Directory Synchronization Agent (DSA) のインストールに進み、ディレクトリからユーザーとグループのデータを同期してください。