版本：3.7.0

在 Linux 上以 root 用户安装 SmartAgent

概述

本文介绍如何在 Linux 系统上以 root 用户 安装 SmartAgent。

信息

如果没有 root 权限，请参考 非 root 安装方式。

安装前准备

在开始安装之前，请确保满足以下条件：

拥有 root 用户 权限，或者可使用 sudo 提权执行安装命令
网络可以访问 SmartAgent 下载源
已安装必要的系统工具（如 wget、tar）
技术类型支持矩阵
主机资源要求

安装与升级

下载最新的 SmartAgent-Linux 对应 CPU 架构的安装包：

wget -O Bonree-SmartAgent-Linux-<version>.sh \
'https://one.bonree.com/agent/down/Bonree-SmartAgent-Linux-<version>.sh' \
--header='Authorization:<token>'

执行安装命令，并根据需要设置参数（详细安装参数）：

/bin/sh Bonree-SmartAgent-Linux-<version>.sh config \
  -a "<accountGUID>" \
  -u "https://oneupload.bonree.com/APM" \
  -t "java,php,go,dotnet" \
  -l "https://oneupload.bonree.com/controller/logs" \
  --set-env-id "default"

验证安装结果

检查进程是否启动成功：
```
ps -ef | grep bonree/apm
```

通过日志确认与平台通信：

tail -f /opt/bonree/apm/logs/machine/machine.log

重启需监控的应用，确保探针生效。

服务管理

CentOS 7+ (Systemd)

# 启动
systemctl start bonree-agent
# 停止
systemctl stop bonree-agent
# 重启
systemctl restart bonree-agent

CentOS 6及以下 (SysV)

# 启动
service bonree-agent start
# 停止
service bonree-agent stop
# 重启
service bonree-agent restart

非 root 用户

若使用非 root 运行模式安装，可使用指定用户来管理探针服务：

# 启动
/opt/bonree/apm/bin/agentconfig --start-service
# 停止
/opt/bonree/apm/bin/agentconfig --stop-service
# 重启
/opt/bonree/apm/bin/agentconfig --restart-service

卸载

sudo bash /opt/bonree/apm/scripts/uninstall.sh

注意

卸载后，在所有已监控的应用或容器完成重启前，不要立即删除探针目录，否则可能导致业务异常。

概述​

安装前准备​

安装与升级​

验证安装结果​

服务管理​

卸载​

概述

安装前准备

安装与升级

验证安装结果

服务管理

卸载