Linux Install Using the RPM Package
This page describes how to install the Machine Agent on Linux systems that support the RPM Package Manager:
- CentOS
- RHEL
- Fedora
- openSUSE
-
SUSE Linux Enterprise Server
- AARCH
For Linux systems that do not support RPM, use the JRE Bundled Zip Archive.
The RPM installer makes these changes to the host machine:
- Creates an
appdynamicsgroup and anappdynamicsuser - Assigns ownership of certain files in the machine-agent directory to the
appdynamicsuser
These changes are necessary to enable non-root users to configure and run an RPM-installed agent. To use a different user or group for the machine agent service, set the MACHINE_AGENT_USER and MACHINE_AGENT_GROUP environment variables in a shell for RPM installation.
sudo MACHINE_AGENT_USER=myuser MACHINE_AGENT_GROUP=mygroup rpm -ivh appdynamics-machine-agent.rpmIf the specified user or group does not exist, an error message appears and the RPM installation stops. To continue, you must define users and groups.If this is an issue in your environment, then you install the agent using the ZIP archive (see Linux Install Using ZIP with Bundled JRE).
Linux RPM Management (Combined Agent)
Starting from 26.3.0, the RPM package for the AppDynamics Machine Agent includes the Splunk OTel Collector. Unlike other installation methods, the Linux RPM deployment treats the Machine Agent and the Splunk OTel Collector as independent systemd units. This allows you to manage each service separately based on your specific observability requirements.
This integration streamlines the setup for unified observability by deploying both the AppDynamics Machine Agent and the OTel Collector in a single workflow.
After the RPM installation is complete, you must configure both services independently to ensure they function correctly:
- Configuration: Edit the controller information file located at
/etc/appdynamics/machine-agent/controller-info.xml. - Service Management: Start the agent using the command:
systemctl start appdynamics-machine-agent. - User Configuration: If you need to change the user under which the agent runs, edit
/etc/sysconfig/appdynamics-machine-agent.
- Configuration:
/etc/appdynamics/machine-agent/otel/agent_config.yaml. For For Pipeline Configuration, customize the OTel Collector pipeline by editing/opt/appdynamics/machine-agent/conf/otel/agent_config.yamlor/etc/appdynamics/machine-agent/otel/agent_config.yaml - Service Management: Start the collector using the command:
systemctl start splunk-otel-collector. - User Configuration: Configure your required credentials in the file located at
/etc/sysconfig/splunk-otel-collector.
Deployment Modes
You can choose from the following three deployment modes by managing the respective services:
- Start only the Machine Agent service:
systemctl start appdynamics-machine-agent - Do not configure or start the
splunk-otel-collectorservice.
- Start both services:
systemctl start appdynamics-machine-agentsystemctl start splunk-otel-collector
- Configure your credentials in the file located at:
/etc/sysconfig/splunk-otel-collector
- Start only the OTel Collector service:
systemctl start splunk-otel-collector - The Machine Agent service is not required and should not be started.
SPLUNK_OTEL_ENABLED=true within the Machine Agent's JAVA_OPTS (found in the Machine Agent service file). Setting this flag within the Machine Agent configuration causes the wrapper script to attempt to launch a second redundant OTel collector process, which results in a port conflict and prevent the services from starting correctly.
マシンエージェントのインストール
RPM パッケージ機能
RPM パッケージマネージャは、エージェントファイルを opt/appdynamics/machine-agent にインストールし、シンボリックリンクを作成し、環境変数を設定し、エージェントをサービスとして追加します。
シンボリックリンク
RPM パッケージマネージャは、/etc ディレクトリ内のエージェントスクリプトと設定ファイルへのシンボリックリンクを作成します。別のインストールディレクトリ、別の JRE、またはエージェントを実行する別のシステムユーザアカウントに対応する場合は、これらのリンクを編集できます。
SysV サービススクリプトのリンク
/etc/init.d/appdynamics-machine-agent >> /opt/appdynamics/machine-agent/etc/init.d/appdynamics-machine-agent
このスクリプトには、次のサービスコマンドが用意されています。
Start：サービスを開始し、エージェントを起動するスクリプトを実行します。Stop：サービスを停止します。Restart：サービスを再起動します。Status：サービスのステータスを返します。
例： service appdynamics-machine-agent start
環境変数のリンク
SysV：
/etc/sysconfig/appdynamics-machine-agent >> /opt/appdynamics/machine-agent/etc/sysconfig/appdynamics-machine-agentこのスクリプトは、環境変数を設定します。
MACHINE_AGENT_HOME=/opt/appdynamics/machine-agent：エージェントファイルが配置されている場所を指定します。JAVA_HOME=/opt/appdynamics/machine-agent/jre：エージェントが使用する JRE を指定します。独自の JRE を含む RPM パッケージインストーラを使用することを推奨しています。ただし、JRE の要件を満たしている限り、別の JRE を使用できます。MACHINE_AGENT_USER=root：エージェントを起動するためのシステムユーザーを指定します（デフォルトは root）。マシンエージェントを実行するための非ルートユーザーを作成することを推奨します。新しいユーザには、controller-info.xml の読み取りアクセス権とログファイルへの書き込みアクセス権が必要です。「マシンエージェントを実行するために必要な権限」を参照してください。
systemd：環境変数は次のサービスファイルにあります。
/etc/systemd/system/appdynamics-machine-agent.service >> /opt/appdynamics/machine-agent/etc/systemd/system/appdynamics-machine-agent.serviceエージェントからコントローラへの通信のリンク
エージェントからコントローラへの通信のプロパティを含む controller-info.xml ファイルへのリンクを設定します。
/etc/appdynamics/machine-agent/controller-info.xml >> /opt/appdynamics/machine-agent/conf/controller-info.xmlロギングの設定
log4j.xml ファイルは、エージェントによってログに記録される情報の詳細を制御します。デフォルトでは、ログレベルは info に設定されます。
/etc/appdynamics/machine-agent/logging/log4j.xml >> /opt/appdynamics/machine-agent/conf/logging/log4j.xmlエージェントをサービスとして追加する
パッケージがインストールされた後、appdynamics-machine-agent によって opt/appdynamics/machine-agent/bin/postInstall.sh が実行され、エージェントがサービスに追加されます。インストーラは、SysV スクリプトをコピーしてサービスを追加します。または、systemd が検出された場合は、インストーラはエージェント ユニット ファイルの /etc/systemd/system/appdynamics-machine-agent.service をコピーし、このユニットファイルを使用してエージェントをサービスに追加します。
エージェントサービスの systemd ユニットファイルをインストールする
RPM パッケージをインストールするとき、または postinstall.sh スクリプトを実行するときにシステムで systemcd が検出された場合、エージェントサービスの systemd ユニットファイルが次の場所にコピーされます。/etc/systemd/system/appdynamics-machine-agent.service
ExecStart：systemd サービスファイルのこのオプションは、エージェントをデーモンとして起動するスクリプトを指します。マシンエージェントを /opt/appdynamics/machine-agent, にインストールしていない場合は、パスを <machine-agent-home>/scripts/machine-agent-daemon に変更します。パスを編集していない場合は、デフォルトで正しい場所を指しています。
関連する systemctl コマンドを使用して、エージェントサービスを開始および停止できます。すべての systemctl コマンドの詳細については、systemctl の man ページを参照してください。
| コマンド | 形式 |
|---|---|
|
起動 停止 status 再起動 |
|
|
disable イネーブル化 （フルパスを使用） |
|