在Linux上安装代理

单行脚本接受以下参数：

要下载 Instana 代理程序包，请按照以下步骤操作：

1. 在 Instana 用户界面的首页上，点击 “代理与收集器 ”。 在 “ Instana ”的“代理”选项卡中，选择 “安装代理 ”。

   如果您正在启动一个新的 Instana 试用实例，系统会显示代理目录，并提示您选择要安装的主机代理。

2. 在代理部署目录页面上，单击磁贴Linux- 软件包（DEB、RPM）。

3. 选择代理配置。

   • 在打包部分，选择要部署的代理类型（Dynamic或 "Static）。 要了解静态代理和动态代理的区别，请参阅主机代理类型。

   • 在运行时部分，选择Azul Zulu 11或Eclipse OpenJ911运行时。

   • 在 "模式"部分，选择要使用的软件包模式（RPM或 "DEM）。

4. 在平台架构部分，选择要安装主机代理的Linux机器的架构。

5. 单击下载图标，从网络浏览器下载主机代理软件包（DEB 或 RPM）。

现在代理软件包已下载完毕。 Go 请转到下一节以安装代理程序包。

指示软件包管理器安装代理软件包或手动安装代理软件包。

要使用软件包管理器安装代理软件包，请根据您的Linux发行版使用以下方法之一：

openSUSE/SLES (zypp 包管理器)

对于openSUSE和SUSE Linux Enterprise Server，路径为 "/etc/zypp/yum.repos.d/Instana-Agent.repo，但内容可以与基于 RPM 的发行版保持一致。

现在代理软件包已安装完毕。 刷新软件包管理器的源代码后，转到下一节继续。

1. 配置主机代理端点和代理密钥。

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

   请参见以下脚本示例：

   curl -o setup_agent.sh https://setup.instana.io/agent && chmod 700 ./setup_agent.sh && sudo -E ./setup_agent.sh -a aGeNTKEY0vaLuO0Eu1ABc -d n3asffgkg -t dynamic -e ingress-green-saas.instana.io:443

2. 在安装主机代理之前设置环境变量。

   export INSTANA_AGENT_KEY=$agentkey
   export INSTANA_AGENT_ENDPOINT=$endpoint
   export INSTANA_AGENT_ENDPOINT_PORT=$endpoint_port

   注意： 在代理配置中使用 INSTANA_AGENT_PORT 环境变量 INSTANA_AGENT_HOST 和 已弃用。 这些环境变量专用于配置 Instana 追踪器以连接到代理。 如果这些设置是全局性的， Instana 追踪器将无法连接到代理。 在 Instana 的未来版本中，将不再支持使用这些环境变量来配置代理。

   设置环境变量的选项摘要：

   • Git配置管理：在文件中放置环境变量是一种不错的方法。 如需了解更多信息，请参阅 Git -based configuration management。

   • Systemd： 使用“drop-in ”是覆盖服务环境配置的最简单方法。

   • SysVinit:将文件放入/etc/sysconfigRed Hat衍生版本）或/etc/defaultDebian衍生版本）。

   有关环境变量选项的更多信息，请参阅《 设置和覆盖环境变量》。

现在，代理安装的准备工作已经完成。 Go 请转至 “安装代理 ”部分继续操作。

刷新软件包管理器的源代码，然后运行以下命令之一，在所选架构上安装代理：

• Debian衍生工具

  • 要安装静态代理，请运行以下命令：

    apt-get install instana-agent-static

  • 要安装动态代理，请运行以下命令：

    apt-get install instana-agent-dynamic

• Red Hat衍生产品

  • 要安装静态代理，请运行以下命令：

    yum install instana-agent-static

  • 要安装动态代理，请运行以下命令：

    yum install instana-agent-dynamic

• Eclipse OpenJ911 捆绑软件包

  使用以下软件包名称之一安装主机代理："instana-agent-static-j9或 "instana-agent-dynamic-j9。

现在主机代理已安装完毕。 关于安装后的操作，请转到下一步操作部分。

安装主机代理之前，请确保满足以下前提条件：

• 代理必须能够使用以下任一选项获取 Java 开发工具包（JDK）：

  • 将 JDK 放入或链接到 "<instana-agent-install-dir>/jvm（以便 "<instana-agent-install-dir>/jvm/bin/java存在）。

  • 可定制的方法是导出一个环境变量JAVA_HOME，指向该 JDK（该环境变量也可设置为 "instana-agent-install-dir>/bin/setenv）。

  运行代理支持以下 JDK：

  • IBM OpenJ9 JDK 11（推荐）
  • Azul Zulu JDK 11
  • OpenJDKJDK 11
  • Oracle热点 JDK 11
  • 亚马逊 Corretto JDK 11
  • IBM J911

  JVM 必须对系统上的所有用户具有可执行权限。 建议您使用所选择的 Java 分发的最新可用补丁发行版。 该代理需要一个支持 TLSv1.3 的JDK（所有当前的JDK 11版本均支持此功能）。 由于出口管制的原因，操作系统发行商提供的软件包可能不包含强大的加密支持，具体取决于操作系统的发行情况。 如果您使用此类软件包，可能会遇到诸如“ java.lang.RuntimeException: 无法生成DH密钥对 ”之类的错误。

• 要减少文件系统更改时代理占用的资源，必须在Linux发行版上安装 inotify-tools 软件包。

• 确保用于运行代理的用户可以在代理目录及其所有子目录中写入内容。 代理根据自动检测功能下载所需的传感器，并在其 "data子目录下创建日志文件。

• 确保有大约 100 MB 的可用磁盘空间。

• 代理从以下主机下载更新和传感器。 确保可以访问以下主机和端口：

  • DNS 姓名 ： artifact-public.instana.io
  • 目的地端口："tcp/80和 "tcp/443

• 目前， Instana 服务在两个不同的区域提供。 您的个人实例在地理位置上最靠近您的大多数代理和用户。 代理在下载时已预先配置，但某些安装方法需要配置 Instana 后端。 请查阅产品内的“代理管理”部分，或通过 IBM 联系您的技术支持人员，以了解您的实例所在的区域。

• 如果您使用的是自托管（本地部署）的 Instana ，请使用在 Instana 后端安装过程中定义的端点。 您还可以在 Instana 用户界面中查看代理向其报告的端点。 在 Instana 用户界面的首页上，点击 “代理与收集器 ”。 在 “ Instana ”的“代理”选项卡中，选择 “安装代理 ”，并勾选部署代码或 YAML 配置。

• 如果您使用的是 Instana SaaS, ，请使用 “主机代理端点 ”中所述的端点。

您可以通过以下任一方式下载主机代理：

• 请按照以下步骤从 Instana 用户界面下载代理：

  1. 在 Instana 用户界面的首页上，点击 “代理与收集器 ”。 在 “ Instana ”的“代理”选项卡中，选择 “安装代理 ”。

     如果您正在启动一个新的 Instana 试用实例，系统会显示代理目录，并提示您选择要安装的主机代理。

  2. 在代理部署目录页面上，单击磁贴Linux- Archive (tar.gz)。

  3. 在打包部分，选择要部署的代理类型（Dynamic或 "Static）。 要了解静态代理和动态代理的区别，请参阅主机代理类型。

  4. 在下拉列表中，选择平台架构（操作系统）。

     该存档文件已根据您的 Instana 账户设置自动预配置，因此您只需解压并启动代理程序即可。

  5. 点击下载图标，从网络浏览器下载主机代理软件包文件tar.gz），然后解压该文件。

• 运行以下命令，用 wget 下载代理：

  wget --save-cookies {{agent_folder_name}}/instana-cookies.txt --post-data 'email={{instana_username}}&password={{instana_password}}' https://{{instana_tenant_unit}}-{{instana_tenant}}.instana.io/auth/signIn

  wget --content-disposition --load-cookies {{agent_folder_name}}/instana-cookies.txt --post-data 'type=linux64' https://instana.io/ump/{{instana_tenant}}/{{instana_tenant_unit}}/agent/download -O {{opt_folder}}/{{name_of_agent_archive.tar.gz}}

现在已下载主机代理。 Go 请转到下一节以启动代理。

将提取的代理软件包文件放到系统范围内可访问的位置，并以根用户身份运行代理。

要启动代理程序，请运行以下命令：

INSTANA_AGENT_FOLDER/bin/start

现在，主机代理已安装并启动。 有关安装后的操作，请参阅下一步操作。