Linux 系统上的安装前任务

您必须先完成所需的安装前任务，然后才能在 Linux 系统上安装代理程序。某些安装前任务特定于代理程序，而其他任务适用于多个代理程序。

注： 这些需求是对“系统产品兼容性报告”中所指示需求的补充。
要了解代理程序的当前版本需求及依赖关系，请参阅System requirements (APM Developer Center)，以获得指向软件产品兼容性报告的链接。

所有代理程序

以下安装前任务适用于所有代理程序：

测试连接
在安装代理程序之前，请确保系统可以与 Cloud APM 服务器进行通信。有关检查与 Cloud APM 服务器的连接的信息，请参阅网络连接。
非 root 用户安装
您必须具有安装目录的读取、写入和执行许可权。否则，将取消安装。有关非 root 用户安装的更多信息，请参阅以非 root 用户身份安装代理程序。
安装路径限长 70 个字符
安装目录及其路径不得超过 70 个字符。
设置 CANDLEHOME 环境变量
如果使用 ITM Agent Converter 以在与之前相同的受管系统上安装和配置代理程序，那么将 CANDLEHOME 环境变量更改为随 Agent Converter 一起安装的代理程序所在的目录。在安装和配置本机 Cloud APM 代理程序之前，必须将 CANDLEHOME 环境变量设置为其他目录，否则，本机 Cloud APM 代理程序无法启动。

特定操作系统

Red Hat Enterprise Linux (RHEL) 8
RHEL 8 上需要 libnsl.so.1 软件包
缺省情况下，libnsl.so.1 未安装在 Red Hat Enterprise Linux R8.0 中。如果没有此软件包，那么无法成功安装任何代理程序。请求管理员为您设置 yum 存储库，然后运行以下命令：
yum install libnsl
成功安装后，您可以查看 /usr/lib64/libnsl.so.1。
注： 仅代理程序需要 libnsl.so.1 软件包。您无需为数据收集器执行此步骤。
绕过某些代理程序的先决条件扫描程序
在将先决条件扫描程序更新为兼容最新需求之前，对于某些代理程序，您可以绕过先决条件扫描程序。有关适合的场景和指示信息，请参阅绕过先决条件扫描程序。
注： 您无需为数据收集器执行此步骤。

特定代理程序

以下安装前任务适用于指定的代理程序：

DataPower® 代理程序
您必须运行 ulimit -d unlimited 命令，以确保 max data segment size 系统环境变量设置为 unlimited。 此代理程序不能与所要监视的 DataPower 设备安装在同一台机器上。
DataStage® 代理程序
  1. 在 DSODBConfig.cfg 文件中启用参数。请完成下列步骤：
    1. 在编辑器中打开以下位置的 DSODBConfig.cfg 文件：
      • infosphere_information_server_install_dir/Server/DSODB
    2. 通过移除 # 符号取消注释下列参数：
      • MonitorLinks=1
      • JobRunUsage=1
      • ResourceMonitor=1
      • DSODBON=1
    3. 编辑这些参数的值，使其等于 1。
  2. 复制代理程序计算机上用于元数据存储库配置的数据库 JDBC 驱动程序。
    1. 第 4 类 JDBC 4 或更高版本。例如，db2jcc4.jar
    2. 适用于 Oracle 的第 4 类 JDBC 驱动程序。例如，ojdbc6.jar
    3. 适用于 MS SQL 的 JDBC 驱动程序：
      • Sqljdbc41.jar 需要 JRE 7 并支持 JDBC 4.1 API。
      • Sqljdbc42.jar 需要 JRE 8 并支持 JDBC 4.2 API。
HTTP Server 代理程序
如果以 root 用户身份安装此代理程序，必须使用该同一用户标识运行和配置此代理程序。
如果您以非 root 用户身份安装并运行代理程序，那么该非 root 用户必须与启动 IBM® HTTP Server 的用户具有相同的用户标识。否则，此代理程序在发现 IBM HTTP Server 时会遇到问题。您可以使用同一个用户标识来运行和配置代理程序。
Linux KVM 代理程序
Monitoring Agent for Linux KVM 是多实例、多连接的代理程序，它支持连接到基于 Enterprise Linux 的 KVM 系统管理程序以及 Red Hat Enterprise Virtualization Manager (RHEV-M) 环境。您可以创建此代理程序的多个实例，以用于监视 RHEV-M 或 KVM 系统管理程序环境中的多个系统管理程序。您还可以在不同虚拟机之间监视虚拟化工作负载并分析资源容量。要将代理程序连接到 KVM 管理程序环境中的虚拟机，必须安装必备软件：libvirt*.rpm 和 Korn Shell Interpreter (pdksh)。此代理程序将与用于管理虚拟机的 libvirt 系统管理程序建立远程连接，从而收集度量。
Microsoft SQL Server 代理程序
要监视 Microsoft SQL 环境，必须在安装 Monitoring Agent for Microsoft SQL Server 之前安装 Microsoft SQL Server 和 Microsoft SQL ODBC 驱动程序。例如，要在 Red Hat Enterprise Linux 上安装 ODBC 驱动程序，请使用以下命令：
sudo yum install unixODBC
sudo yum install msodbcsql17
要完成执行必备软件检查程序，需要在 Cloud Application Performance Management V8.1.4.0 服务器临时修订 15 (8.1.4.0-IBM-APM-SERVER-IF0015.tar) 或更高版本上配置代理程序。
MongoDB 代理程序
您必须在安装 MongoDB 数据库服务器的系统上安装和配置 MongoDB 代理程序。
MySQL 代理程序
要监视 MySQL 环境，必须先安装 MySQL 服务器和 MySQL JDBC 驱动程序，然后才能安装 Monitoring Agent for MySQL。例如，要在 Red Hat Enterprise Linux 上安装 JDBC 驱动程序，请使用以下命令：
yum install mysql-connector-java
启动代理程序安装后，在对 MySQL 程序包名称进行先决条件检查期间，如果使用的提供者不是 Red Hat（例如使用的是 Oracle），那么可能会看到一条警告。如果 MySQL 服务器和 JDBC 驱动程序可用，那么该警告不会导致安装失败，您可以忽略此消息。样本输出： 
Scenario: Prerequisite Scan
KSE - Monitoring Agent for MySQL Prerequisite Checker [version 01000005]:
Property                               Result   Found                                     Expected 
========                      ====== =====       ======== 
os.package.mysql-server         WARN  Unavailable  mysql-server-5.1.12+
os.package.mysql-connector-java WARN Unavailable mysql-connector-java-5.
1.12+
Node.js 代理程序
用于运行受监视应用程序的 Node.js 版本必须与缺省的安装版本相同。
当前不支持 Node.js v5。
OpenStack 代理程序
在可以使用 OpenStack 代理程序之前，必须具有安装代理程序的位置的服务器上的以下软件：
  • Python 2.6.0 或更高版本，或 Python 2.7.0 或更高版本
  • 最新的 OpenStack 客户机：
    • OpenStack
    • Keystone
    • Neutron
    • Swift

    要安装 OpenStack 命令行客户机，请参阅安装 OpenStack 命令行客户机。

  • Python 中用于远程访问的 Paramiko 库
    注： 如果想要在干净的 RedHat Linux 服务器上安装 OpenStack 代理程序，请在安装 Paramiko 库之前，运行以下命令来安装所需软件： 
    wget https://ftp.dlitz.net/pub/dlitz/crypto/pycrypto/pycrypto-2.6.1.tar.gz
yum install gcc/openssl-devel/libffi-devel
  • KornShell
Oracle Database 代理程序
在 Red Hat Enterprise Linux V5 和 V6 以及 SUSE Linux Enterprise Server V11 和 V12 x64 上，如果 Oracle Database 代理程序远程监视 Oracle 数据库，那么必须先安装 Oracle 即时客户机。请安装 Oracle Technology Network - Instant Client Downloads 处提供的 Oracle 即时客户机。
Oracle Database 代理程序支持即时客户机 V10.x、V11.x 和 V12.x。
PHP 代理程序
如果使用 root 用户部署 PHP 应用程序，那么必须使用 root 用户来安装、配置、启动或停止代理程序。如果使用非 root 用户部署 PHP 应用程序，那么可以使用 root 用户或相同的非 root 用户来安装、配置、启动或停止代理程序。
必须已安装现有的 WordPress 应用程序。PHP 代理程序监视 WordPress V3.7.1 或更高版本
代理程序仅评估 WordPress 应用程序中 PHP 请求的性能。不会对 CSS 和 JS 装入进行评估。
代理程序不会使用 URL 参数来标识 URL。
Python 数据收集器
Python 数据收集器用于监视 Django 应用程序。
Response Time Monitoring Agent

在安装 Response Time Monitoring 代理程序之前，请查看安装规划部分：规划安装。

SAP HANA Database 代理程序
  1. 在 Linux 系统上安装 SAP HANA 数据库客户机 HDBSQL V1.00.102.06 或更高版本。
    要点： 对于 RHEL 5.x 64 位操作系统，安装 Linux SUSE 9 on x86_64 64 位 SAP HANA 数据库客户机，而不是 Linux on x86_64 64 位。对于 RHEL 6.x 或更高版本的 64 位操作系统，安装 Linux on x86_64 64 位 SAP HANA 数据库客户机。
  2. 运行以下命令以将安装目录的路径添加到 LD_LIBRARY_PATH 环境变量：

    export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:install_directory_path

    示例： export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/sap/hdbclient，其中，/usr/sap/hdbclient 表示 SAP HANA 数据库客户机的安装路径。

要点：

如果 SAP HANA 数据库客户机的安装路径未添加到 LD_LIBRARY_PATH 环境变量中，先决条件扫描程序将返回 FAIL 结果。

使用导出命令添加的环境变量仅存在于终端的特定会话中。因此，请确保从用于添加环境变量的同一终端运行代理程序安装脚本。

Synthetic Playback 代理程序
要安装 Synthetic Playback 代理程序，操作系统用户需要以下许可权：
  • 为安装映像启用读取和执行许可权
  • 为代理程序主页启用写许可权
要运行 Synthetic Playback 代理程序，操作系统用户需要以下许可权：
  • 为代理程序安装位置及其子目录和文件启用读、写和执行许可权。
  • 启用许可权以运行 Mozilla Firefox。
  • 请确保 Mozilla Firefox 执行二进制位于用户概要文件的 PATH 环境变量中。
在安装 Synthetic Playback 代理程序之前，必须完成以下步骤：
  1. 将代理程序安装位置与 Cloud APM 控制台同步。
  2. 安装 Mozilla Firefox 和 Xvfb 显示服务器。
  3. 验证 Xvfb 显示服务器是否正在工作。运行以下命令：
    # Xvfb -ac

    不应有错误输出。

  4. 检查 Xvfb 进程是否正在运行。运行以下命令：
    # ps -ef|grep Xvfb

    样本输出：

    root 7192 1 0 Jan14 ? 00:00:14 Xvfb -ac
root 20393 17900 0 02:05 pts/0 00:00:00 grep -i xvfb
  5. 停止 Xvfb 进程。运行以下命令：
    # kill -9 7192
  6. 导航到 install_dir/etc/hosts 并编辑 hosts 文件开头以包含下列参数： 
    127.0.0.1 localhost

    然后，保存并关闭 hosts 文件。

WebSphere® Applications 代理程序
安装代理程序之前，先决条件检查程序将检查 ulimit 在 Linux 系统上是否设置为 524000。必须运行 ulimit -d 524000 命令来确保 max data segment size 系统环境变量设置为 524000。