Установка ЕдиногоАгента на Solaris

Ключ-АСТРОМ поддерживает Oracle Solaris (x86 и SPARC) для Java, Apache HTTP server и IBM HTTP server. Если ваша инфраструктура основана на этих технологиях, вы можете использовать ЕдиныйАгент Ключ-АСТРОМ для эффективного мониторинга ваших хостов, служб и пользовательского опыта. Аналитическую информацию о поддерживаемых возможностях ЕдиногоАгента для Solaris см. в поддержке платформы и возможностей ЕдиногоАгента.

Установка ЕдиногоАгента на Solaris

Чтобы установить ЕдиныйАгент, если вы являетесь клиентом SaaS, перейдите на страницу Ключ-АСТРОМ и войдите в систему, используя имя пользователя и пароль, которые вы получили от Ключ-АСТРОМ в письме с подтверждением регистрации. Если вы являетесь клиентом Ключ-АСТРОМ Managed, откройте консоль управления кластером и выберите среду, которую вы хотите отслеживать. Затем продолжите установку, следуя шагам, приведенным ниже.

Требования

Разрешения

• Вам потребуются права администратора для серверов, на которых будет установлен ЕдиныйАгент, а также для изменения настроек брандмауэра (необходимо только в том случае, если ваша внутренняя политика маршрутизации может помешать программному обеспечению Ключ-АСТРОМ выйти в Интернет).
• Для перезапуска всех служб приложений вам потребуются разрешения и учетные данные.

Ресурсы

• Проверьте требования к свободному месту на диске .
• Все хосты, которые должны отслеживаться, должны иметь возможность отправлять данные в кластер Ключ-АСТРОМ. В зависимости от того, развернут ли ваш Ключ-АСТРОМ на SaaS или в управляемой среде, а также от вашей сетевой структуры и настроек безопасности, вы можете либо предоставить прямой доступ к кластеру Ключ-АСТРОМ, либо настроить АктивныйШлюз .

Ограничения

• Установка ЕдиногоАгента не поддерживается в точках монтирования сетевых хранилищ, которые управляются такими стандартами, как NFS или iSCSI.
• Режим мониторинга инфраструктуры не поддерживается на хостах Solaris.

Разрешить соединения через брандмауэр

Убедитесь, что настройки вашего брандмауэра разрешают связь с Ключ-АСТРОМ.

В зависимости от политики вашего брандмауэра вам может потребоваться разрешить определенные исходящие соединения. Удаленные адреса Ключ-АСТРОМ для добавления в список разрешенных указаны на странице установки ЕдиногоАгента.

Установка

1. В Ключ-АСТРОМ Hub выберите ЕдиныйАгент .
2. Выберите Настройка > Solaris .
3. Выберите архитектуру ЦП для вашей среды.
4. Предоставьте токен PaaS. Этот токен необходим для загрузки установщика ЕдиногоАгента из вашей среды. Если у вас нет токена PaaS, вы можете сгенерировать его прямо в пользовательском интерфейсе. Токен автоматически добавляется к команде загрузки, которую вы будете использовать позже.
5. Нажмите Копировать, чтобы скопировать команду wget.
6. Войдите в систему Solaris и выполните команду wget.
   • Команда wget не установлена ​​в Solaris по умолчанию. Установите ее или используйте альтернативный способ загрузки ЕдиногоАгента.
7. Создайте в локальной системе папку для ЕдиногоАгента (например, /opt/astromkey/oneagent) и распакуйте zip-архив в эту папку. В отличие от других платформ, для установки ЕдиногоАгента на Solaris не требуется root-доступ. ЕдиныйАгент можно установить в любую директорию.
   • Поскольку все контролируемые приложения должны иметь возможность читать библиотеку, убедитесь, что разрешения позволяют это.
     • Предоставьте глобальные права на чтение /opt/astromkey/oneagent
     • Предоставьте глобальные права на запись /opt/astromkey/oneagent/logs
   • Обязательно правильно указывайте папку на последующих этапах развертывания.
8. В Solaris Ключ-АСТРОМ поддерживает только приложения Java и Apache HTTP Server, поэтому вам нужно решить, какие приложения отслеживать. Вы можете сделать это только для одного приложения или для всей оболочки. Просто следуйте соответствующим инструкциям ниже.

Мониторинг одного приложения

Чтобы контролировать одно приложение, выполните команду и добавьте к ней следующие команды.

DT_HOME=/opt/astromkey/oneagent export DT_HOME LD_PRELOAD_64=$DT_HOME/agent/lib64/liboneagentproc.so export LD_PRELOAD_64 LD_PRELOAD=$DT_HOME/agent/lib/liboneagentproc.so export LD_PRELOAD

Переменная KA_HOME указывает на папку установки ЕдиногоАгента. Вы можете пропустить запись 32-bit или 64-bit, в зависимости от вашей среды.

Настройте WebSphere Application Server через админ консоль

Унифицированный подход работает так же хорошо для WebSphere, однако вы можете захотеть настроить WebSphere через Административную консоль. Это работает для ЕдиногоЕгента v1.141 и выше.

1. Запустите сервер WebSphere через WebSphere UI или командную строку. Например: /opt/ibm/WebSphere<version>/AppServer/bin/sh startServer.sh server1
2. Откройте Административную консоль через пользовательский интерфейс WebSphere или введите URL в веб-браузере. Например: http://localhost:9060/ibm/console. При удаленном доступе к серверу укажите имя хоста машины, а не localhost.
3. Введите свой идентификатор пользователя и пароль, а затем войдите в систему.
4. Перейдите в раздел Сервер > Серверы приложений > [yourprofilename]> Java и управление процессами > Определение процесса > Записи среды > Создать.
5. Добавьте 3 записи в список.
   • DT_HOME=/opt/astromkey/oneagent
   • LD_PRELOAD_64=/opt/astromkey/oneagent/agent/lib64/liboneagentproc.so
   • LD_PRELOAD=/opt/astromkey/oneagent/agent/lib/liboneagentproc.so Вы можете пропустить запись 32-bit или 64-bit, в зависимости от вашей среды. Переменная KA_HOME должна указывать на папку установки ЕдиногоАгента.
6. Примените изменения и сохраните конфигурацию.

Настройте Oracle WebLogic с помощью скрипта запуска

Для мониторинга Oracle WebLogic необходимо добавить следующие строки в скрипт запуска WebLogic (startWebLogic.sh)

# Monitor WebLogic with astromkey OneAgent DT_HOME=/opt/astromkey/oneagent export DT_HOME LD_PRELOAD_64=$DT_HOME/agent/lib64/liboneagentproc.so export LD_PRELOAD_64 LD_PRELOAD=$DT_HOME/agent/lib/liboneagentproc.so export LD_PRELOAD # WebLogic checks and startup, this is part of your script, add the 3 lines prior to this. echo "starting weblogic with Java version:" ${JAVA_HOME}/bin/java ${JAVA_VM} -version if [ "${WLS_REDIRECT_LOG}" = "" ] ; then    echo "Starting WLS with line:" echo "${JAVA_HOME}/bin/java ${JAVA_VM} ${MEM_ARGS} ${JAVA_OPTIONS} -Dweblogic.Name=${SERVER_NAME}          -Djava.security.policy=${WL_HOME}/server/lib/weblogic.policy ${PROXY_SETTINGS} ${SERVER_CLASS}"    ${JAVA_HOME}/bin/java ${JAVA_VM} ${MEM_ARGS} ${JAVA_OPTIONS} -Dweblogic.Name=${SERVER_NAME}          -Djava.security.policy=${WL_HOME}/server/lib/weblogic.policy ${PROXY_SETTINGS} ${SERVER_CLASS} else    echo "Redirecting output from WLS window to ${WLS_REDIRECT_LOG}"    ${JAVA_HOME}/bin/java ${JAVA_VM} ${MEM_ARGS} ${JAVA_OPTIONS} -Dweblogic.Name=${SERVER_NAME}          -Djava.security.policy=${WL_HOME}/server/lib/weblogic.policy ${PROXY_SETTINGS}          ${SERVER_CLASS} 2>&1 >"${WLS_REDIRECT_LOG}" fi

Вы можете пропустить запись 32-bit или 64-bit, в зависимости от вашей среды. Переменная KA_HOME должна указывать на папку установки ЕдиногоАгента.

Мониторинг каждой службы Java и Apache HTTP в вашем контексте выполнения

Вы можете настроить ЕдиныйАгент для мониторинга каждого приложения в текущем контексте приложения. Для этого добавьте следующие строки в скрипт запуска приложения, которое вы хотите отслеживать. Убедитесь, что они выполняются до самого приложения. Вам не следует делать это для всей системы или для пользователей, вошедших в систему.

ЕдиныйАгент версии 1.141 и выше

DT_HOME=/opt/astromkey/oneagent export DT_HOME LD_PRELOAD_64=$DT_HOME/agent/lib64/liboneagentproc.so export LD_PRELOAD_64 LD_PRELOAD=$DT_HOME/agent/lib/liboneagentproc.so export LD_PRELOAD

LD_PRELOAD не будет перенесен в sudo или su вызовы. Более того, вызов sudo в контексте выполнения LD_PRELOAD, который установлен, приведет к сообщению об ошибке, что библиотека находится в незащищенном месте. Это не имеет негативных последствий. Это сообщение можно игнорировать.

ЕдиныйАгент версий 1.137 - 1.139

DT_HOME=/opt/astromkey/oneagent export DT_HOME . $DT_HOME/astromkey-agent64.sh . $DT_HOME/astromkey-agent32.sh

LD_PRELOAD не будет перенесен в sudo или su вызовы. Более того, вызов sudo в контексте выполнения LD_PRELOAD, который установлен, приведет к сообщению об ошибке, что библиотека находится в незащищенном месте. Это не имеет негативных последствий. Это сообщение можно игнорировать.

ЕдиныйАгент версии 1.137 и старше

Если версия вашего ЕдиногоАгента старше v1.137 или у вас возникли проблемы с унифицированным подходом к мониторингу, вы можете внедрить ЕдиныйАгент вручную.

Общие положения Java

Измените командную строку вашего приложения Java:

DT_HOME=/opt/astromkey/oneagent . $DT_HOME/astromkey-java-env.sh 64 java $JAVA_OPTS <MainClass>

Убедитесь, что вы включили переменную $JAVA_OPTS в свою команду. Для 32-битных процессов Java опустите параметр 64.

Apache HTTP сервер

Для настройки Ключ-АСТРОМ для мониторинга сервера Apache HTTP или работы на Solaris необходимо выполнить следующие шаги:

Отредактируйте свой файл httpd.conf и добавьте следующие две строки в любом месте по вашему выбору:

• LoadModule oneagent_module /opt/astromkey/oneagent/agent/bin/solaris-<arch>-<bitness>/liboneagentloader.so
• OneAgentConfig tenant=<tenant-id>,tenantToken=<tenant-token>,server=https://<server-url>/communication

Если вы предпочитаете оставить без изменений httpd.conf, вы можете указать те же директивы с помощью командной строки:

apachectl -c "LoadModule oneagent_module /opt/astromkey/oneagent/agent/bin/solaris-<arch>-<bitness>/liboneagentloader.so"         -c "OneAgentConfig tenant=<tenantUUID>,tenantToken=<tenant-token>,server=<communicationEndpoints>"         -k start

• tenantUUID— это идентификатор среды вашей среды Ключ-АСТРОМ, из которой следует извлечь astromkey-env.sh (расположен в корневом каталоге установки ЕдиногоАгента). Параметр tenantUUID представлен в скрипте как KA_TENANT.
• tenantToken— это токен, который ЕдиныйАгент использует для подключения к Ключ-АСТРОМ Server. Его следует извлечь из astromkey-env.sh (расположенного в корневой директории установки ЕдиногоАгента). Параметр tenantToken представлен в скрипте как KA_TENANTTOKEN. Этот токен не следует путать с токенами Ключ-АСТРОМ API или PaaS. Эти токены здесь использовать нельзя.
• communicationEndpoints соответствует одному или нескольким HTTP-адресам, представляющим Ключ-АСТРОМ Servers или АктивномуШлюзу. Параметр communicationEndpoints представлен в скрипте как DT_CONNECTION_POINT. Например, astromkey-env.sh (расположенный в корневой директории установки ЕдиногоАгента) может содержать следующее:
  • export DT_CONNECTION_POINT="https://x1.live.astromkey.com/communication;https://x2.live.astromkey.com/communication;https://x3.live.astromkey.com/communication" В этом случае параметр будет иметь вид:
  • server=https://x1.live.astromkey.com/communication;https://x2.live.astromkey.com/communication;https://x3.live.astromkey.com/communication

Обновление ЕдиногоАгента на Solaris

Чтобы обновить установленный экземпляр ЕдиногоАгента в Solaris (x86 и SPARC), следуйте инструкциям ниже:

1. Повторите все шаги первоначальной установки, но установите ЕдиныйАгент в новую директорию.
2. Остановите все контролируемые процессы.
3. Переименуйте текущую диреторию установки ЕдиногоАгента (например, /opt/astromkey/oneagent-old), используя следующую команду: mv /opt/astromkey/oneagent /opt/astromkey/oneagent-old. Эту папку можно удалить после обновления ЕдиногоАГента.
4. Переименуйте обновленную папку ЕдиногоАгента так, чтобы она указывала на исходную директорию установки (например, /opt/astromkey/oneagent), используя следующую команду: mv /opt/astromkey/oneagent-update /opt/astromkey/oneagent
5. Перезапустите все процессы, которые необходимо отслеживать.

Проверьте установленную версию ЕдиногоАгента

Используйте один из этих методов, чтобы проверить, какая версия ЕдиногоАгента у вас установлена.

Обзор хоста

1. Перейдите в раздел Хосты.
2. Нажмите на интересующий вас хост.
3. Разверните Свойства под именем хоста. Установленная версия ЕдиногоАгента включена в перечисленные свойства.

Статус развертывания

1. Перейти к статусу развертывания.
2. Нажмите вкладку Все хосты или Недавно подключенные хосты.
3. Разверните интересующую вас запись хоста. Установленная версия ЕдиногоАгента включена в отображаемую информацию.