OneAgent настройка параметров установки в Linux - История изменений

Lobanov в 10:59, 22 января 2023

2023-01-22T10:59:57Z

Lobanov: Lobanov переименовал страницу ЕдиныйАгент настройка параметров установки в Linux в OneAgent настройка параметров установки в Linux

2023-01-22T10:56:53Z

Lobanov переименовал страницу ЕдиныйАгент настройка параметров установки в Linux в OneAgent настройка параметров установки в Linux

← Предыдущая

Версия 10:56, 22 января 2023

Lobanov: /* Непривилегированный режим */

2022-03-15T17:17:16Z

Непривилегированный режим

Lobanov: /* Изменение непривилегированного пользователя и группы */

2022-03-15T15:59:49Z

Изменение непривилегированного пользователя и группы

← Предыдущая		Версия 15:59, 15 марта 2022
Строка 99:		Строка 99:
	<code>--set-proxy=172.1.1.128:8080</code>		<code>--set-proxy=172.1.1.128:8080</code>

	~~Dynatrace~~ также поддерживает адреса IPv6.		Ключ-Астром также поддерживает адреса IPv6.

	Если вам нужно изменить адрес прокси-сервера после установки, используйте --set-proxy в интерфейсе командной строки ЕдиногоАгента.		Если вам нужно изменить адрес прокси-сервера после установки, используйте --set-proxy в интерфейсе командной строки ЕдиногоАгента.
Строка 364:		Строка 364:
	* Если указан параметр <code>USER=<username></code>, программа установки использует <code><username></code> в качестве имени непривилегированного пользователя.		* Если указан параметр <code>USER=<username></code>, программа установки использует <code><username></code> в качестве имени непривилегированного пользователя.

	В любом случае программа установки ~~Dynatrace~~ проверяет, существует ли уже в системе требуемый пользователь (<code>dtuser</code> или пользователь, указанный в параметре USER).		В любом случае программа установки Ключ-Астром проверяет, существует ли уже в системе требуемый пользователь (<code>dtuser</code> или пользователь, указанный в параметре USER).

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

Lobanov: добавил ссылку

2022-02-13T05:48:18Z

добавил ссылку

← Предыдущая		Версия 05:48, 13 февраля 2022
Строка 347:		Строка 347:
	Чтобы переключить установщик обратно на использование уровня разрешений суперпользователя для последующих обновлений, запустите его с параметром <code>DISABLE_ROOT_FALLBACK=0</code>.		Чтобы переключить установщик обратно на использование уровня разрешений суперпользователя для последующих обновлений, запустите его с параметром <code>DISABLE_ROOT_FALLBACK=0</code>.

	Дополнительные сведения см. в требованиях к разрешениям для установки и работы ЕдиногоАгента в Linux.		Дополнительные сведения см. в [[Непривилегированный режим работы ЕдиногоАгента в Linux\|требованиях к разрешениям для установки и работы ЕдиногоАгента в Linux]].

	'''Примечания:'''		'''Примечания:'''

Lobanov: /* Группа хостов */

2022-02-13T05:47:08Z

Группа хостов

Внесённые изменения

Lobanov: Новая страница: «Установщик для дистрибутивов Linux можно использовать с параметрами командной строки, есл...»

2022-02-07T15:23:28Z

Новая страница: «Установщик для дистрибутивов Linux можно использовать с параметрами командной строки, есл...»

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

Установщик для дистрибутивов Linux можно использовать с параметрами командной строки, если вы не можете использовать параметры по умолчанию. Обратите внимание, что все параметры, перечисленные ниже, являются необязательными.

==== '''Передача параметров установки''' ====
Чтобы передать параметры, добавьте их к команде установщика и разделите пробелами.

Например:

<code>Dynatrace-OneAgent-Linux.sh --set-host-group=my_host_group --set-infra-only=true</code>

==== '''Удаленные параметры установки''' ====
Преобразуйте в более новые параметры <code>--set-param=<value></code>. Эквивалентные параметры <code>PARAM=<value></code> не поддерживаются программой установки ЕдиногоАгента, начиная с версии 1.213.

Удален параметр PARAM=<value> Новый параметр --set-param=<value>
{| class="wikitable"
!Удаленные <code>PARAM=<value></code> параметры
!Новые <code>--set-param=<value></code> параметры
|-
|<code>SERVER</code>
|<code>--set-server</code>
|-
|<code>TENANT</code>
|<code>--set-tenant</code>
|-
|<code>TENANT_TOKEN</code>
|<code>--set-tenant-token</code>
|-
|<code>PROXY</code>
|<code>--set-proxy</code>
|-
|<code>HOST_GROUP</code>
|<code>--set-host-group</code>
|-
|<code>APP_LOG_CONTENT_ACCESS</code>
|<code>--set-app-log-content-access</code>
|-
|<code>DISABLE_SYSTEM_LOGS_ACCESS</code>
|<code>--set-system-logs-access-enabled</code>
|-
|<code>INFRA_ONLY</code>
|<code>--set-infra-only</code>
|}
Если вы смешиваете эквивалентные параметры <code>PARAM=<value></code> и <code>--set-param=<value></code>, параметр <code>--set-param=<value></code> переопределяет параметр <code>PARAM=<value></code>.

==== '''Конечная точка связи''' ====
Значение по умолчанию: <code>зависит от среды</code>

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

Чтобы установить конечную точку связи, передайте ее как значение параметра:

<code>--set-server=<nowiki>https://100.20.10.1:443</nowiki></code>

ЕдиныйАгент и Ключ-Астром Cluster автоматически поддерживают рабочее соединение. Если детали конечной точки изменяются, кластер уведомляет ЕдиныйАгент об изменении, и ЕдиныйАгент автоматически обновляет конечную точку, которую вы установили с помощью --set-server, до нового рабочего значения.

Если вам нужно изменить конечную точку после установки, используйте --set-server в интерфейсе командной строки ЕдиныйАгент.

==== '''Идентификатор среды''' ====
Значение по умолчанию: <code>зависит от среды</code>

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

Чтобы установить идентификатор среды, передайте его в качестве значения параметра:

<code>--set-tenant=mySampleEnv</code>

Если вам нужно изменить арендатора после установки, используйте <code>--set-tenant</code> в интерфейсе командной строки ЕдиногоАгента.

==== '''Токен''' ====
Значение по умолчанию: <code>зависит от среды</code>

Маркер клиента, который используется для проверки подлинности, когда ЕдиныйАгента подключается к конечной точке связи для отправки данных. Если вы устанавливаете ЕдиныйАгент с помощью страницы развертывания Ключ-Астром, для него уже установлено правильное значение.

Чтобы установить токен, передайте его как значение параметра:

<code>--set-tenant-token=abcdefghij123456</code>

См. Токены доступа, чтобы узнать, как получить токен.

Если вам нужно изменить токен клиента после установки, используйте <code>--set-tenant-token</code> в интерфейсе командной строки ЕдиногоАгента.

==== '''Сетевые зоны''' ====
Значение по умолчанию: <code>не установлено</code>

Чтобы узнать о правилах именования сетевых зон и другую справочную информацию, см. раздел Сетевые зоны.

Используйте параметр --set-network-zone, чтобы указать ЕдиномуАгенту обмениваться данными через указанную сетевую зону:

<code>--set-network-zone=ваша.сетевая.зона</code>

Если вам нужно изменить назначение сетевой зоны после установки, используйте --set-network-zone в интерфейсе командной строки ЕдиногоАгента.

==== '''Прокси''' ====
Значение по умолчанию: <code>не установлено</code>

Адрес прокси-сервера. Используйте IP-адрес или имя и добавьте номер порта после двоеточия. Для прокси-сервера с проверкой подлинности вы можете указать имя пользователя и пароль, например имя пользователя: пароль@172.1.1.128:8080, где имя пользователя и пароль должны быть указаны в URL-адресе.

Чтобы установить прокси, передайте его как значение параметра:

<code>--set-proxy=172.1.1.128:8080</code>

Dynatrace также поддерживает адреса IPv6.

Если вам нужно изменить адрес прокси-сервера после установки, используйте --set-proxy в интерфейсе командной строки ЕдиногоАгента.

==== '''Диапазон портов''' ====
Значение по умолчанию: <code>50000:50100</code>

Используйте параметр <code>--set-watchdog-portrange=<arg></code>, чтобы изменить диапазон портов прослушивания на <code><arg></code>. <code><arg></code> должен содержать два номера порта, разделенных двоеточием (:). Например <code>50000:50100</code>. Максимальный поддерживаемый диапазон портов — от 1024 до 65535. Диапазон портов должен охватывать не менее 4 портов. Номер порта, начиная с диапазона, должен быть меньше. Например:

<code>--set-watchdog-portrange=50000:50100</code>

Если вам нужно изменить диапазон портов после установки, используйте --set-watchdog-portrange в интерфейсе командной строки ЕдиногоАгента.

==== '''Группа хостов''' ====
Значение по умолчанию: <code>не установлено</code>

Имя группы, к которой вы хотите привязать хост. Дополнительные сведения см. в разделе Организация среды с помощью групп хостов. Требования к строке группы хостов:

* Может содержать только буквенно-цифровые символы, дефисы, символы подчеркивания и точки.
* Не должен начинаться с <code>dt</code>.
* Максимальная длина – 100 символов.

Чтобы назначить хост группе хостов, передайте имя группы хостов в качестве значения параметра:

<code>--set-host-group=My.HostGroup_123-456</code>

Чтобы удалить узел из группы, необходимо удалить ЕдиныйАгент или передать пустое значение <code>--set-host-group=""</code> при запуске обновления ЕдиногоАгента. Вы не можете удалить хост из группы с помощью параметра <code>HOST_GROUP</code> при обновлении ЕдиногоАгента. Дополнительные сведения см. в разделе Настройка ЕдиногоАгента через интерфейс командной строки.

← Предыдущая		Версия 17:17, 15 марта 2022
Строка 6:		Строка 6:
	Например:		Например:

	<code>~~Dynatrace-~~OneAgent-Linux.sh --set-host-group=my_host_group --set-infra-only=true</code>		<code>OneAgent-Linux.sh --set-host-group=my_host_group --set-infra-only=true</code>

	==== '''Удаленные параметры установки''' ====		==== '''Удаленные параметры установки''' ====
Строка 217:		Строка 217:
	'''Значение по умолчанию:''' <code>14449</code>		'''Значение по умолчанию:''' <code>14449</code>

	Вы можете использовать параметр <code>--set-extensions-ingest-port=<arg></code>, чтобы изменить порт связи по умолчанию, используемый для локального приема метрик. Порт используется следующими модулями: ЕдиныйАгент REST API, интеграции сценариев ~~(<code>dynatrace_ingest</code>)~~ и Telegraf.		Вы можете использовать параметр <code>--set-extensions-ingest-port=<arg></code>, чтобы изменить порт связи по умолчанию, используемый для локального приема метрик. Порт используется следующими модулями: ЕдиныйАгент REST API, интеграции сценариев и Telegraf.

	Дополнительные сведения см. в разделе Прием метрик.		Дополнительные сведения см. в разделе Прием метрик.
Строка 231:		Строка 231:

	==== '''Путь установки''' ====		==== '''Путь установки''' ====
	'''Значение по умолчанию:''' <code>/opt/~~dynatrace~~/oneagent</code>		'''Значение по умолчанию:''' <code>/opt/<namespace>/oneagent</code>

	'''Необходимое условие:''' использование этого параметра при включенном SELinux требует, чтобы в вашей системе была доступна утилита semanage.		'''Необходимое условие:''' использование этого параметра при включенном SELinux требует, чтобы в вашей системе была доступна утилита semanage.
Строка 237:		Строка 237:
	Параметр <code>INSTALL_PATH</code> разрешает установку в другой каталог. Например:		Параметр <code>INSTALL_PATH</code> разрешает установку в другой каталог. Например:

	<code>/bin/sh ~~Dynatrace-~~OneAgent-AIX-1.0.0.sh INSTALL_PATH=/data/~~dynatrace~~/agent</code>		<code>/bin/sh OneAgent-AIX-1.0.0.sh INSTALL_PATH=/data/<namespace>/agent</code>

	Программа установки создает символическую ссылку <code>/opt/~~dynatrace~~/oneagent</code> > <code>/data/~~dynatrace~~/agent</code>, и файлы установки ЕдиногоАгента будут помещены в указанный каталог (в данном примере <code>/data/~~dynatrace~~/agent</code>). Обратите внимание, что эту символическую ссылку необходимо удалить вручную после удаления ЕдиногоАгента.		Программа установки создает символическую ссылку <code>/opt/<namespace>/oneagent</code> > <code>/data/<namespace>/agent</code>, и файлы установки ЕдиногоАгента будут помещены в указанный каталог (в данном примере <code>/data/<namespace>/agent</code>). Обратите внимание, что эту символическую ссылку необходимо удалить вручную после удаления ЕдиногоАгента.

	'''Примечание'''. Параметр INSTALL_PATH не управляет каталогами журналов и файлов конфигурации OneAgent. Чтобы настроить путь журнала, используйте параметр LOG_PATH.		'''Примечание'''. Параметр INSTALL_PATH не управляет каталогами журналов и файлов конфигурации OneAgent. Чтобы настроить путь журнала, используйте параметр LOG_PATH.
Строка 250:		Строка 250:
	* Значение должно быть абсолютным путем и не должно указывать на корневой каталог тома.		* Значение должно быть абсолютным путем и не должно указывать на корневой каталог тома.
	* Значение не должно быть уже существующей символической ссылкой.		* Значение не должно быть уже существующей символической ссылкой.
	* Значение не должно быть дочерним каталогом <code>/var/lib/~~dynatrace~~</code>.		* Значение не должно быть дочерним каталогом <code>/var/lib/<namespace></code>.

	==== '''Путь журнала''' ====		==== '''Путь журнала''' ====
	'''Значение по умолчанию:''' <code>/var/log/~~dynatrace~~/oneagent</code>		'''Значение по умолчанию:''' <code>/var/log/<namespace>/oneagent</code>

	'''Необходимое условие:''' использование этого параметра при включенном SELinux требует, чтобы в вашей системе была доступна утилита semanage.		'''Необходимое условие:''' использование этого параметра при включенном SELinux требует, чтобы в вашей системе была доступна утилита semanage.
Строка 259:		Строка 259:
	Параметр LOG_PATH позволяет настроить каталог журналов OneAgent. Например:		Параметр LOG_PATH позволяет настроить каталог журналов OneAgent. Например:

	<code>/bin/sh ~~Dynatrace-~~OneAgent-Linux-1.0.0.sh LOG_PATH=/data/~~dynatrace~~/logs</code>		<code>/bin/sh OneAgent-Linux-1.0.0.sh LOG_PATH=/data/<namespace>/logs</code>

	===== '''Требования к пользовательскому каталогу''' =====		===== '''Требования к пользовательскому каталогу''' =====
Строка 268:		Строка 268:
	* Значение должно быть абсолютным путем и не должно указывать на корневой каталог тома.		* Значение должно быть абсолютным путем и не должно указывать на корневой каталог тома.
	* Значение не должно быть уже существующей символической ссылкой.		* Значение не должно быть уже существующей символической ссылкой.
	* Значение не должно быть дочерним каталогом <code>/var/lib/~~dynatrace~~</code>.		* Значение не должно быть дочерним каталогом <code>/var/lib/<namespace></code>.
	* Значение не должно указывать на <code>/opt/~~dynatrace~~/oneagent/log</code>, который является расположением журнала по умолчанию для версий ЕдиногоАгента до 1.203.		* Значение не должно указывать на <code>/opt/<namespace>/oneagent/log</code>, который является расположением журнала по умолчанию для версий ЕдиногоАгента до 1.203.

	===== '''Изменение местоположения''' =====		===== '''Изменение местоположения''' =====
Строка 280:		Строка 280:
	<code>ЕдиныйАгент версии 1.199</code>		<code>ЕдиныйАгент версии 1.199</code>

	'''Значение по умолчанию:''' <code>/var/lib/~~dynatrace~~/oneagent/datastorage</code>		'''Значение по умолчанию:''' <code>/var/lib/<namespace>/oneagent/datastorage</code>

	'''Необходимое условие:''' использование этого параметра при включенном SELinux требует, чтобы в вашей системе была доступна утилита semanage.		'''Необходимое условие:''' использование этого параметра при включенном SELinux требует, чтобы в вашей системе была доступна утилита semanage.
Строка 286:		Строка 286:
	Параметр <code>DATA_STORAGE</code> позволяет определить каталог, предназначенный для хранения больших данных во время выполнения, созданных ЕдинымАгентом в режиме мониторинга полного стека, таких как отчеты о сбоях или дампы памяти. Например:		Параметр <code>DATA_STORAGE</code> позволяет определить каталог, предназначенный для хранения больших данных во время выполнения, созданных ЕдинымАгентом в режиме мониторинга полного стека, таких как отчеты о сбоях или дампы памяти. Например:

	<code>/bin/sh ~~Dynatrace-~~OneAgent-Linux.sh DATA_STORAGE=/data/~~dynatrace~~/runtime</code>		<code>/bin/sh OneAgent-Linux.sh DATA_STORAGE=/data/<namespace>/runtime</code>

	===== '''Требования к пользовательскому каталогу''' =====		===== '''Требования к пользовательскому каталогу''' =====
Строка 295:		Строка 295:
	* Значение должно быть абсолютным путем и не должно указывать на корневой каталог тома.		* Значение должно быть абсолютным путем и не должно указывать на корневой каталог тома.
	* Значение не должно быть уже существующей символической ссылкой.		* Значение не должно быть уже существующей символической ссылкой.
	* Значение не должно быть дочерним каталогом <code>/var/lib/~~dynatrace~~</code>.		* Значение не должно быть дочерним каталогом <code>/var/lib/<namespace></code>.

	===== '''Изменение местоположения''' =====		===== '''Изменение местоположения''' =====
Строка 329:		Строка 329:
	Начиная с версии 1.193, ЕдиныйАгент по умолчанию устанавливается в непривилегированном режиме. Существующие установки не переключаются в непривилегированный режим.		Начиная с версии 1.193, ЕдиныйАгент по умолчанию устанавливается в непривилегированном режиме. Существующие установки не переключаются в непривилегированный режим.

	Чтобы переключить установленный ЕдиныйАгент в непривилегированный режим, вам необходимо вручную добавить параметр <code>NON_ROOT_MODE=1</code> к команде установки. Пример: <code>sudo /bin/sh ~~Dynatrace-~~Agent-Linux-1.0.0.sh NON_ROOT_MODE=1</code>		Чтобы переключить установленный ЕдиныйАгент в непривилегированный режим, вам необходимо вручную добавить параметр <code>NON_ROOT_MODE=1</code> к команде установки. Пример: <code>sudo /bin/sh Agent-Linux-1.0.0.sh NON_ROOT_MODE=1</code>

	Чтобы переключить установщик обратно в режим по умолчанию для последовательных обновлений, запустите его с <code>NON_ROOT_MODE=0</code>.		Чтобы переключить установщик обратно в режим по умолчанию для последовательных обновлений, запустите его с <code>NON_ROOT_MODE=0</code>.
Строка 343:		Строка 343:
	Используется вместе с параметром <code>NON_ROOT_MODE</code> для блокировки уровня разрешений суперпользователя для запуска ЕдиногоАгента в непривилегированном режиме. Привилегии суперпользователя требуются для автоматических обновлений и отдельных операций с версиями ядра между 2.6.26 и 4.3, то есть версиями без поддержки Linux ambient capabilities.		Используется вместе с параметром <code>NON_ROOT_MODE</code> для блокировки уровня разрешений суперпользователя для запуска ЕдиногоАгента в непривилегированном режиме. Привилегии суперпользователя требуются для автоматических обновлений и отдельных операций с версиями ядра между 2.6.26 и 4.3, то есть версиями без поддержки Linux ambient capabilities.

	<code>sudo /bin/sh ~~Dynatrace-~~OneAgent-Linux-1.0.0.sh NON_ROOT_MODE=1 DISABLE_ROOT_FALLBACK=1</code>		<code>sudo /bin/sh OneAgent-Linux-1.0.0.sh NON_ROOT_MODE=1 DISABLE_ROOT_FALLBACK=1</code>

	Чтобы переключить установщик обратно на использование уровня разрешений суперпользователя для последующих обновлений, запустите его с параметром <code>DISABLE_ROOT_FALLBACK=0</code>.		Чтобы переключить установщик обратно на использование уровня разрешений суперпользователя для последующих обновлений, запустите его с параметром <code>DISABLE_ROOT_FALLBACK=0</code>.