Предварительный этап установки в системах Linux

Прежде чем устанавливать агенты в системах Linux, вы должны выполнить необходимые предварительные задачи. Некоторые предварительные задачи связаны с агентом, а другие задачи относятся к нескольким агентам.

Прим.: Эти требования действуют в дополнение к требованиям, указанным в отчетах о совместимости программных продуктов (Software Product Compatibility Report).
Информацию о требованиях и зависимостях текущей версии для вашего агента смотрите в документе Требования к системе (Центр разработчиков APM) ссылку на отчеты о совместимости программных продуктов (Software Product Compatibility Reports).

Все агенты

Описанные ниже необходимые задачи применимы ко всем агентам:

Проверить соединение
Перед установкой агентов убедитесь, что ваш компьютер может взаимодействовать с сервер 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 8.0. Без этого пакета успешная установка агентов невозможна. Попросите администратора сконфигурировать для вас репозиторий yum, после чего введите команду:
yum install libnsl
После успешной установки можно увидеть /usr/lib64/libnsl.so.1.
Прим.: Пакет libnsl.so.1 требуется только для агентов. Этот шаг не требуется для сборщиков данных.
Обход программы просмотра необходимых компонентов для некоторых агентов
Прежде чем программа просмотра необходимых компонентов будет обновлена для совместимости с последними требованиями, для некоторых агентов можно обойти вызов этой программы. Подходящие сценарии и инструкции смотрите в разделе Обход программы просмотра необходимых компонентов.
Прим.: Этот шаг не требуется для сборщиков данных.

Конкретные агенты

Описанные ниже необходимые задачи применимы к указанным агентам:

DataPower agent
Введите команду 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. JDBC 4 тип 4 или новее. Пример: db2jcc4.jar
    2. Драйвер JDBC тип 4 для Oracle. Пример: ojdbc6.jar
    3. Драйвер JDBC для MS SQL:
      • Sqljdbc41.jar требует JRE 7 и поддерживает API JDBC 4.1.
      • Sqljdbc42.jar требует JRE 8 и поддерживает API JDBC 4.2.
агент HTTP Server
При установке этого агента от имени пользователя root надо использовать тот же самый идентификатор пользователя, чтобы выполнить и сконфигурировать агента.
Если агент устанавливается и запускается от имени пользователя не-root, то у пользователя не-root должен быть ID пользователя, который запускал IBM® HTTP Server. В противном случае у агента возникнут проблемы с обнаружением компонента IBM HTTP Server. Можно использовать тот же самый идентификатор пользователя, чтобы запустите и сконфигурировать агент.
агент Linux KVM
Monitoring Agent for Linux KVM - это агент с несколькими экземплярами и несколькими соединениями, поддерживающий соединения со средами гипервизоров KVM на основе Enterprise Linux и средами Red Hat Enterprise Virtualization Manager (RHEV-M). Можно создать несколько экземпляров этого агента для мониторинга нескольких гипервизоров в среде гипервизоров RHEV-M или KVM. Можно выполнять мониторинг виртуализованных рабочих нагрузок и анализировать емкость ресурсов в разных виртуальных машинах. Для соединения агента с виртуальной машиной в среде гипервизоров KVM необходимо установить обязательные компоненты: libvirt*.rpm и Korn Shell Interpreter (pdksh). Агент собирает показатели, удаленно подключаясь к гипервизору libvirt, который управляет виртуальными машинами.
Microsoft SQL Server agent
Для мониторинга среды Microsoft SQL перед установкой агента мониторинга для Microsoft SQL нужно установить драйвер Microsoft SQL Server и Microsoft SQL ODBC. Например, чтобы установить драйвер ODBC в Red Hat Enterprise Linux, введите следующую команду:
sudo yum install unixODBC
sudo yum install msodbcsql17 
Чтобы завершить выполнение проверки обязательных компонентов, агент нужно сконфигурировать на сервере Cloud Application Performance Management версии 8.1.4.0 Server Interim Fix 15 (8.1.4.0-IBM-APM-SERVER-IF0015.tar) или новее.
агент MongoDB
Установите и сконфигурируйте агент агент MongoDB на компьютере, на котором установлен сервер базы данных MongoDB.
агент MySQL
Для мониторинга среды MySQL перед установкой агента Monitoring Agent for MySQL нужно установить сервер MySQL и драйвер JDBC MySQL. Например, чтобы установить драйвер JDBC в Red Hat Enterprise Linux, введите следующую команду:
yum install mysql-connector-java
После запуска установки агента и во время проверки обязательных компонентов для пакета MySQL вы можете получить предупреждение, если используется провайдер, отличный от Red Hat (например, Oracle). Если сервер MySQL Server и драйвер 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.

  • Библиотека Paramiko для удаленного доступа в Python.
    Прим.: Если вы хотите установить компонент агент OpenStack на чистом сервере Redhat Linux до установки библиотеки 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 версии 5 и версии 6, а также в SUSE Linux Enterprise Server версии 11 и версии 12 x64, если агент Oracle Database дистанционно отслеживает базу данных Oracle, вы сначала должны установить клиенты Oracle Instant Client. Установите клиенты Oracle Instant Client из Сетевые технологии Oracle - Мгновенные скачивания клиента.
Клиенты Instant Client v10.x ,v11.x и v12.x поддерживаются агент Oracle Database.
агент PHP
Если программа PHP внедрена от имени пользователя root, устанавливать, конфигурировать, запускать и останавливать агент нужно от имени пользователя root. Если программа PHP внедрена от имени обычного пользователя (не root), устанавливать, конфигурировать, запускать и останавливать агент можно от имени пользователя root или от имени того же обычного пользователя (не root).
Должна быть установлена существующая программа WordPress. агент PHP отслеживает WordPress V3.7.1 или новее.
Агент оценивает только производительность требований PHP в программах WordPress. Загрузка CSS и JS не оценивается.
Агент не использует аргументы URL для определения URL.
Сборщик данных Python
Сборщик данных Python отслеживает приложения Django.
Response Time Monitoring Agent

Прежде чем устанавливать агент Response Time Monitoring, ознакомьтесь со следующим разделом планирования: Планирование установки.

агент SAP HANA Database
  1. Установите клиент базы данных SAP HANA, HDBSQL версии 1.00.102.06 или новее на компьютере Linux.
    Важное замечание: Для 64-битной операционной системы RHEL 5.x установите клиент базы данных SAP HANA в Linux SUSE 9 on x86_64 64bit вместо Linux on x86_64 64bit. Для RHEL 6.x или более новых 64-битных операционных систем установите клиент базы данных SAP HANA в Linux on x86_64 64bit.
  2. Введите следующую команду, чтобы добавить путь каталога установки в переменную среды LD_LIBRARY_PATH:

    export LD_LIBRARY_PATH=$LD_LIBRARY_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. Перейдите к каталогу каталог_установки /etc/hosts и измените начало файла хостов, чтобы включить следующие параметры:
    127.0.0.1 localhost

    Затем сохраните и закройте файл хостов.

WebSphere Applications agent
Перед установкой агента средство проверки обязательных компонентов проверяет, задано ли в Linux для ulimit значение 524000. Введите команду ulimit -d 524000, чтобы задать для переменной среды max data segment size значение 524000.