在Linux上管理主机代理

安装主机代理时，会启用它在系统启动时自动启动。 您可以在安装代理时通过设置环境变量 "INSTANA_AGENT_AUTOSTART=false来关闭此行为。

• 要启动主机代理，请运行以下命令：

  /opt/instana/agent/bin/start
   

• 如果操作系统使用 "systemd作为初始系统，请运行以下命令：

  systemctl start instana-agent.service
   

• 如果操作系统使用 "SysVinit作为初始系统，请运行以下命令：

  service instana-agent start
   

要停止代理，请运行以下命令：

 /opt/instana/agent/bin/stop
 

• 如果操作系统使用 "systemd作为初始系统，请运行以下命令：

  systemctl stop instana-agent.service
   

• 如果操作系统使用 "SysVinit作为初始系统，请运行以下命令：

  service instana-agent stop
   

您可以使用操作系统的软件包管理器升级机器上的代理软件包。 要更新和管理系统的软件包和补丁，请运行以下命令：

yum update // apt-get upgrade
 

instana-agent-static或instana-agent-dynamic软件包已升级。

如果操作系统使用 "SysVinit作为启动系统，主机代理会在 "/etc/default/目录Debian及其衍生版本）或 "/etc/sysconfig/目录Red Hat及其衍生版本）中获取相应的 shell 脚本。

如果不更改服务名称，SysVinit脚本将从 "/etc/default/instana-agent文件或 "/etc/sysconfig/instana-agent文件获取资源。

例如，在 Debian 中，你可以通过使用 /etc/default/instana-agent （当该文件 PATH 可读时）来更新 Instana 变量：

INSTANA_AGENT_KEY=$agentkey
INSTANA_AGENT_ENDPOINT=$endpoint
INSTANA_AGENT_ENDPOINT_PORT=$endpoint_port
PATH=/usr/local/bin:${PATH}
 

要查找端点、端口和代理密钥的值，请转到 Instana 用户界面的主页，然后单击 “代理部署 ”。 在代理部署目录页面上，单击“ Linux - 自动安装（单行命令） ”磁贴。 然后，就可以在部署脚本中看到端点、端口和代理键值。

如果操作系统使用 "Systemd作为初始系统，则可以通过以下可用选项设置或覆盖环境变量。 推荐使用 "插入单元 "方法，因为您无需修改服务单元文件，而其他方法则需要修改文件。 这些更改也可能在更新过程中被删除。 插入式单元方法可确保即使在更新后也能保留所设置的更改和环境变量。

• drop-in 单元
• EnvironmentFile 伪指令
• 全局环境设置

在基于 "system.d的系统中，"systemd-tmpfiles守护进程可能会删除 "/tmp/.instana目录中主机代理需要的文件，从而导致难以排除故障的更新失败。

自 181 版起，DEB 和 RPM 代理包会自动安装以下配置脚本， /usr/lib/tmpfiles.d 该脚本可调整行为，避免删除必需文件，从而确保不影响 Instana 主机代理的功能。

# Instana files in /tmp cannot be deleted when the agent is running,
# or it may lead to issues on agent update
R! /tmp/.java_pid*
R! /tmp/.instana/*
 

此配置允许仅在主机 tmpdfiles.d 重启后删除 Instana 代理所需的文件。 新启动的 Instana 主机代理会在启动时重新创建这些文件。

Red Hat Enterprise Linux和CentOS,的第 6 版和第 7 版包含默认的 "tmpdfiles.d策略，每 10 天删除整个 "/tmp目录，而不管软件包可以指定哪些策略。 这意味着像 Instana 这样的包可以定义自定义策略，以控制系统或该包本身的行为。

#  This file is part of systemd.
#
#  systemd is free software; you can redistribute it and/or modify it
#  under the terms of the GNU Lesser General Public License as published by
#  the Free Software Foundation; either version 2.1 of the License, or
#  (at your option) any later version.

# See tmpfiles.d(5) for details
# Clear tmp directories separately, to make them easier to override
v /tmp 1777 root root 10d
v /var/tmp 1777 root root 30d

...
 

除了编辑默认的 "tmpfiles.d策略外，没有其他已知的解决方法。 有问题的 tmpfiles.d 策略位于 /usr/lib/tmpfiles.d/tmp.conf 中。

许多 Debian 的派生版本（包括 Ubuntu ）都包含默认 tmpdfiles.d 策略，这些策略会删除整个 /tmp 目录，无论像 Instana 这样的软件包指定了哪些策略。 安装时，DEB 和 RPM 软件包会运行一个测试，以验证临时文件 "tmpfiles.d的行为，并运行命令 "systemd-tmpfiles --remove。

在那些策略覆盖了 Instana 代理包所指定的必需行为的系统上，您可能会看到以下警告：

WARNING: The tmpfiles.d policies of this system may cause the Instana agent to malfunction by deleting the /tmp/.instana directory; refer https://www.instana.com/docs/setup_and_manage/host_agent/on/linux#tmpfiles.d for more information.
 

您可以通过编辑默认的 "tmpfiles.d策略来解决这个问题。 有问题的 tmpfiles.d 策略位于 /usr/lib/tmpfiles.d/tmp.conf 中。

Red Hat Enterprise Linux6 和CentOS6 包含 tmpwatch 工具，该工具会删除 "/tmp/.instana中不必要的文件。 不过，在这些发行版中使用 tmpwatch 有时会导致主机代理出现更新问题。 有关更多信息，请参阅删除临时文件。

# Deal with tmpwatch, found in RHEL 6 and CentOS 6.
# It is a cronjob, installed in /etc/cron.d/daily, with pretty much hardcoded
# configurations to wipe data the Instana agent needs.
readonly TMPWATCH_CRONJOB='/etc/cron.d/daily/tmpwatch'
if [ -f "${TMPWATCH_CRONJOB}" ]; then
  # Let's check if we already touched the file and, if not, add our excludes
  if ! grep "${TMPWATCH_CRONJOB}" Instana 2&>1 > /dev/null; then
    echo "tmpwatch discovered in '${TMPWATCH_CRONJOB}': adding the exclude flags for Instana"
    # Edit in place with `sed`
    sed -i '/^flags=/a flags="${flags} -x /tmp/instana -x /tmp/.javapid* # Added by Instana"' "${TMPWATCH_CRONJOB}"
  fi
fi