IKuznetsov: Новая страница: «Ключ-АСТРОМ поддерживает '''Oracle Solaris (x86 и SPARC)''' для '''Java''', '''Apache HTTP server''' и '''IBM HTTP server'''. Если...»

2025-06-01T21:04:09Z

Новая страница: «Ключ-АСТРОМ поддерживает '''Oracle Solaris (x86 и SPARC)''' для '''Java''', '''Apache HTTP server''' и '''IBM HTTP server'''. Если...»

Новая страница

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

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

=== Требования ===

==== Разрешения ====

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

==== Ресурсы ====

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

==== Ограничения ====

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

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

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

=== Установка ===

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

==== Мониторинг одного приложения ====
Чтобы контролировать одно приложение, выполните команду и добавьте к ней следующие команды.
{| class="wikitable"
|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
|}
Переменная <code>KA_HOME</code> указывает на папку установки ЕдиногоАгента. Вы можете пропустить запись '''32-bit''' или '''64-bit''', в зависимости от вашей среды.

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

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

==== Настройте Oracle WebLogic с помощью скрипта запуска ====
Для мониторинга '''Oracle WebLogic''' необходимо добавить следующие строки в скрипт запуска '''WebLogic''' (<code>startWebLogic.sh</code>)
{| class="wikitable"
|# 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

<nowiki>#</nowiki> 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''', в зависимости от вашей среды. Переменная <code>KA_HOME</code> должна указывать на папку установки ЕдиногоАгента.

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

===== ЕдиныйАгент версии 1.141 и выше =====
{| class="wikitable"
|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
|}
<code>LD_PRELOAD</code> не будет перенесен в <code>sudo</code> или <code>su</code> вызовы. Более того, вызов <code>sudo</code> в контексте выполнения <code>LD_PRELOAD</code>, который установлен, приведет к сообщению об ошибке, что библиотека находится в незащищенном месте. Это не имеет негативных последствий. Это сообщение можно игнорировать.

===== ЕдиныйАгент версий 1.137 - 1.139 =====
{| class="wikitable"
|DT_HOME=/opt/astromkey/oneagent

export DT_HOME

. $DT_HOME/astromkey-agent64.sh

. $DT_HOME/astromkey-agent32.sh
|}
<code>LD_PRELOAD</code> не будет перенесен в <code>sudo</code> или <code>su</code> вызовы. Более того, вызов <code>sudo</code> в контексте выполнения <code>LD_PRELOAD</code>, который установлен, приведет к сообщению об ошибке, что библиотека находится в незащищенном месте. Это не имеет негативных последствий. Это сообщение можно игнорировать.

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

==== Общие положения Java ====
Измените командную строку вашего приложения '''Java''':
{| class="wikitable"
|DT_HOME=/opt/astromkey/oneagent

. $DT_HOME/astromkey-java-env.sh 64

java $JAVA_OPTS <MainClass>
|}
Убедитесь, что вы включили переменную <code>$JAVA_OPTS</code> в свою команду. Для '''32-битных''' процессов '''Java''' опустите параметр <code>64</code>.

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

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

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

Если вы предпочитаете оставить без изменений <code>httpd.conf</code>, вы можете указать те же директивы с помощью командной строки:
{| class="wikitable"
|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
|}

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

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

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

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

==== Обзор хоста ====

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

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

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

Установка ЕдиногоАгента на Solaris - История изменений

IKuznetsov: Новая страница: «Ключ-АСТРОМ поддерживает '''Oracle Solaris (x86 и SPARC)''' для '''Java''', '''Apache HTTP server''' и '''IBM HTTP server'''. Если...»