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

IKuznetsov в 09:11, 8 января 2025

2025-01-08T09:11:42Z

← Предыдущая версия		Версия от 09:11, 8 января 2025
Строка 61:		Строка 61:

	== Путь установки ==		== Путь установки ==
	Значение по умолчанию: <code>%PROGRAMFILES%\~~key-astrom~~\oneagent</code>		Значение по умолчанию: <code>%PROGRAMFILES%\AppOptima\oneagent</code>

	Параметр <code>INSTALL_PATH</code> позволяет установить один агент в каталог по вашему выбору.		Параметр <code>INSTALL_PATH</code> позволяет установить один агент в каталог по вашему выбору.
Строка 67:		Строка 67:
	Например:		Например:

	<code>.\~~Key-Astrom~~-OneAgent-Windows.exe INSTALL_PATH="C:\test dir"</code>.		<code>.\AppOptima-OneAgent-Windows.exe INSTALL_PATH="C:\test dir"</code>.

	Примечание: Этот параметр не поддерживается пользовательским интерфейсом установщика.		Примечание: Этот параметр не поддерживается пользовательским интерфейсом установщика.
Строка 79:		Строка 79:
	* Вы не должны совместно использовать или вкладывать друг в друга каталоги установки, хранения и журнала.		* Вы не должны совместно использовать или вкладывать друг в друга каталоги установки, хранения и журнала.
	* Значение должно быть абсолютным путем и не должно указывать на каталог корневого тома.		* Значение должно быть абсолютным путем и не должно указывать на каталог корневого тома.
	* Значение не должно быть дочерним каталогом %PROGRAMDATA%\~~key-astrom~~.		* Значение не должно быть дочерним каталогом %PROGRAMDATA%\AppOptima.

	== Путь к журналу ==		== Путь к журналу ==
	Значение по умолчанию: <code>%PROGRAMDATA%\~~key-astrom~~\oneagent\log</code>		Значение по умолчанию: <code>%PROGRAMDATA%\AppOptima\oneagent\log</code>

	Параметр <code>LOG_PATH</code> позволяет настроить каталог журналов одного агента.		Параметр <code>LOG_PATH</code> позволяет настроить каталог журналов одного агента.
Строка 88:		Строка 88:
	Например:		Например:

	<code>.\~~Key-Astrom~~-OneAgent-Windows.exe LOG_PATH=C:\~~key-astrom~~\logs</code>		<code>.\AppOptima-OneAgent-Windows.exe LOG_PATH=C:\AppOptima\logs</code>

	Примечание: Этот параметр не поддерживается пользовательским интерфейсом установщика.		Примечание: Этот параметр не поддерживается пользовательским интерфейсом установщика.
Строка 98:		Строка 98:
	* Вы не должны совместно использовать или вкладывать друг в друга каталоги установки, хранения и журнала.		* Вы не должны совместно использовать или вкладывать друг в друга каталоги установки, хранения и журнала.
	* Значение должно быть абсолютным путем и не должно указывать на каталог корневого тома.		* Значение должно быть абсолютным путем и не должно указывать на каталог корневого тома.
	* Значение не должно быть дочерним каталогом %PROGRAMDATA%\~~key-astrom~~.		* Значение не должно быть дочерним каталогом %PROGRAMDATA%\AppOptima.

	=== Изменение расположения ===		=== Изменение расположения ===
Строка 109:		Строка 109:
	ЕдиныйАгент версии 1.199		ЕдиныйАгент версии 1.199

	Значение по умолчанию: <code>%PROGRAMDATA%\~~key-astrom~~\oneagent\datastorage</code>		Значение по умолчанию: <code>%PROGRAMDATA%\AppOptima\oneagent\datastorage</code>

	Параметр <code>DATA_STORAGE</code> позволяет определить каталог, предназначенный для хранения больших данных во время выполнения, создаваемых ЕдинымАгентом в режиме мониторинга полного стека, таких как отчеты о сбоях или дампы памяти.		Параметр <code>DATA_STORAGE</code> позволяет определить каталог, предназначенный для хранения больших данных во время выполнения, создаваемых ЕдинымАгентом в режиме мониторинга полного стека, таких как отчеты о сбоях или дампы памяти.
Строка 115:		Строка 115:
	Для примера:		Для примера:

	<code>.\~~Key-Astrom~~-OneAgent-Windows.exe DATA_STORAGE=D:\data\key-astom\runtime</code>		<code>.\AppOptima-OneAgent-Windows.exe DATA_STORAGE=D:\data\key-astom\runtime</code>

	Примечание: Этот параметр не поддерживается пользовательским интерфейсом установщика.		Примечание: Этот параметр не поддерживается пользовательским интерфейсом установщика.
Строка 124:		Строка 124:
	* Вы не должны совместно использовать или вкладывать друг в друга каталоги установки, хранения и журнала.		* Вы не должны совместно использовать или вкладывать друг в друга каталоги установки, хранения и журнала.
	* Значение должно быть абсолютным путем и не должно указывать на каталог корневого тома.		* Значение должно быть абсолютным путем и не должно указывать на каталог корневого тома.
	* Значение не должно быть дочерним каталогом %PROGRAMDATA%\~~key-astrom~~.		* Значение не должно быть дочерним каталогом %PROGRAMDATA%\AppOptima.

	=== Изменение расположения ===		=== Изменение расположения ===
Строка 325:		Строка 325:
	Используйте параметр <code>USER</code>, чтобы указать пользователя, запускающего процесс, отвечающий за функциональность расширений АппОптима ЕдиныйАгент. Например:		Используйте параметр <code>USER</code>, чтобы указать пользователя, запускающего процесс, отвечающий за функциональность расширений АппОптима ЕдиныйАгент. Например:

	<code>.\~~Key-Astrom~~-OneAgent-Windows.exe USER=LocalService</code>		<code>.\AppOptima-OneAgent-Windows.exe USER=LocalService</code>

	Примечание. Этот параметр не поддерживается пользовательским интерфейсом установщика.		Примечание. Этот параметр не поддерживается пользовательским интерфейсом установщика.
Строка 354:		Строка 354:

	==== Command shell ====		==== Command shell ====
	<code>msiexec /i C:\some\path\~~Key-Astrom~~-OneAgent-Windows.msi ADDITIONAL_CONFIGURATION="--set-server=<nowiki>https://someserver.com</nowiki> --set-tenant=xxx --set-tenant-token=xxx --set-host-group=myGroup" /quiet /qn</code>		<code>msiexec /i C:\some\path\AppOptima-OneAgent-Windows.msi ADDITIONAL_CONFIGURATION="--set-server=<nowiki>https://someserver.com</nowiki> --set-tenant=xxx --set-tenant-token=xxx --set-host-group=myGroup" /quiet /qn</code>

	==== PowerShell 3.0+ ====		==== PowerShell 3.0+ ====
	<code>msiexec /i C:\some\path\~~Key-Astrom~~-OneAgent-Windows.msi --% ADDITIONAL_CONFIGURATION="--set-server=<nowiki>https://someserver.com</nowiki> --set-tenant=xxx --set-tenant-token=xxx --set-host-group=myGroup" /quiet /qn</code>		<code>msiexec /i C:\some\path\AppOptima-OneAgent-Windows.msi --% ADDITIONAL_CONFIGURATION="--set-server=<nowiki>https://someserver.com</nowiki> --set-tenant=xxx --set-tenant-token=xxx --set-host-group=myGroup" /quiet /qn</code>
	Обратите внимание на символ <code>--%</code> stop-parsing, используемый в команде PowerShell.		Обратите внимание на символ <code>--%</code> stop-parsing, используемый в команде PowerShell.

	=== EXE-установщик — тихая установка ===		=== EXE-установщик — тихая установка ===
	Чтобы настроить тихую установку из командной строки для EXE-версии установщика, добавьте <code>--quiet</code>, как в этом примере:		Чтобы настроить тихую установку из командной строки для EXE-версии установщика, добавьте <code>--quiet</code>, как в этом примере:
	<code>.\~~Key-Astrom~~-OneAgent-Windows.exe --set-host-group="myGroup" --quiet</code>		<code>.\AppOptima-OneAgent-Windows.exe --set-host-group="myGroup" --quiet</code>

	== Драйвер захвата пакетов (pcap) ==		== Драйвер захвата пакетов (pcap) ==
Строка 380:		Строка 380:

	Например:		Например:
	<code>.\~~Key-Astrom~~-OneAgent-Windows.exe PCAP_DRIVER=npcap</code>		<code>.\AppOptima-OneAgent-Windows.exe PCAP_DRIVER=npcap</code>
	Примечание:		Примечание:

IKuznetsov в 07:46, 8 января 2025

2025-01-08T07:46:57Z

← Предыдущая версия		Версия от 07:46, 8 января 2025
Строка 1:		Строка 1:

			'''''[[Установка и настройка]] / [[Установка и настройка\|Основные элементы АппОптима]] / [[ЕдиныйАгент АппОптима]] / [[ЕдиныйАгент АппОптима\|Установка и эксплуатация]] / [[ЕдиныйАгент АппОптима#:~:text%3D%D0%9E%D0%BF%D0%B5%D1%80%D0%B0%D1%86%D0%B8%D0%BE%D0%BD%D0%BD%D1%8B%D0%B5%20%D1%81%D0%B8%D1%81%D1%82%D0%B5%D0%BC%D1%8B\|Операционные системы]]/ [[ЕдиныйАгент в Windows]] / [[ЕдиныйАгент в Windows\|Установка]] / Настройка установки ЕдиногоАгента в Windows'''''

	Установщик ЕдиногоАгента для Windows предоставляется и используется в виде самораспаковывающегося EXE-файла. Установщик также можно извлечь и использовать напрямую — в виде пакета MSI. Этот более поздний подход в основном используется при развертывании групповой политики.		Установщик ЕдиногоАгента для Windows предоставляется и используется в виде самораспаковывающегося EXE-файла. Установщик также можно извлечь и использовать напрямую — в виде пакета MSI. Этот более поздний подход в основном используется при развертывании групповой политики.

IKuznetsov в 10:41, 11 ноября 2024

2024-11-11T10:41:01Z

Lobanov: /* Proxy */

2022-07-30T16:32:39Z

Proxy

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

Lobanov: Новая страница: « Установщик ЕдиногоАгента для Windows предоставляется и используется в виде самораспаковы...»

2022-07-29T17:15:18Z

Новая страница: « Установщик ЕдиногоАгента для Windows предоставляется и используется в виде самораспаковы...»

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

← Предыдущая версия		Версия от 10:41, 11 ноября 2024
Строка 134:		Строка 134:
	Значение по умолчанию: <code>зависит от окружения</code>		Значение по умолчанию: <code>зависит от окружения</code>

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

	Чтобы задать конечную точку связи, передайте ее в качестве значения параметра:		Чтобы задать конечную точку связи, передайте ее в качестве значения параметра:
	<code>--set-server=<nowiki>https://100.20.10.1:443</nowiki></code>		<code>--set-server=<nowiki>https://100.20.10.1:443</nowiki></code>
	ЕдиныйАгент и кластер ~~Ключ-Астром~~ автоматически поддерживают рабочее соединение. Если сведения о конечной точке изменяются, кластер уведомляет ЕдиногоАгента об изменении, и ЕдиныйАгент автоматически обновляет конечную точку, заданную с помощью --set-server, до нового рабочего значения.		ЕдиныйАгент и кластер АппОптима автоматически поддерживают рабочее соединение. Если сведения о конечной точке изменяются, кластер уведомляет ЕдиногоАгента об изменении, и ЕдиныйАгент автоматически обновляет конечную точку, заданную с помощью --set-server, до нового рабочего значения.

	Если вам нужно изменить конечную точку после установки, используйте --set-server в интерфейсе командной строки ЕдиногоАгента.		Если вам нужно изменить конечную точку после установки, используйте --set-server в интерфейсе командной строки ЕдиногоАгента.
Строка 145:		Строка 145:
	Значение по умолчанию: <code>зависит от окружения</code>		Значение по умолчанию: <code>зависит от окружения</code>

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

	Чтобы задать идентификатор среды, передайте его в качестве значения параметра:		Чтобы задать идентификатор среды, передайте его в качестве значения параметра:
Строка 154:		Строка 154:
	Значение по умолчанию: <code>зависит от окружения</code>		Значение по умолчанию: <code>зависит от окружения</code>

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

	Чтобы установить токен, передайте его в качестве значения параметра:		Чтобы установить токен, передайте его в качестве значения параметра:
Строка 178:		Строка 178:
	Чтобы установить прокси, передайте его в качестве значения параметра:		Чтобы установить прокси, передайте его в качестве значения параметра:
	<code>--set-proxy=172.1.1.128:8080</code>		<code>--set-proxy=172.1.1.128:8080</code>
	~~Ключ-Астром~~ также поддерживает IPv6-адреса.		АппОптима также поддерживает IPv6-адреса.

	Если вам нужно изменить адрес прокси-сервера после установки, используйте <code>--set-proxy</code> в интерфейсе командной строки ЕдиногоАгента.		Если вам нужно изменить адрес прокси-сервера после установки, используйте <code>--set-proxy</code> в интерфейсе командной строки ЕдиногоАгента.
Строка 192:		Строка 192:
	Используйте <code>--set-auto-update-enabled=<arg></code>, чтобы включить или отключить автоматическое обновление ЕдиногоАгента. Например:		Используйте <code>--set-auto-update-enabled=<arg></code>, чтобы включить или отключить автоматическое обновление ЕдиногоАгента. Например:
	<code>--set-auto-update-enabled=true</code>		<code>--set-auto-update-enabled=true</code>
	После того, как вы используете эту команду для отключения автоматического обновления, вы не сможете управлять автоматическими обновлениями ЕдиногоАгента с помощью веб-интерфейса ~~Ключ-Астром~~ в разделе Настройки > Настройки > Обновления ЕдиногоАгента.		После того, как вы используете эту команду для отключения автоматического обновления, вы не сможете управлять автоматическими обновлениями ЕдиногоАгента с помощью веб-интерфейса АппОптима в разделе Настройки > Настройки > Обновления ЕдиногоАгента.

	== Группа хостов ==		== Группа хостов ==
Строка 259:		Строка 259:

	Чтобы '''определить источник для генерации идентификатора хоста''', выберите user <code>--set-host-id-source</code> и установите для него одно из предопределенных значений:		Чтобы '''определить источник для генерации идентификатора хоста''', выберите user <code>--set-host-id-source</code> и установите для него одно из предопределенных значений:
	* <code>auto</code> — Пусть ~~Ключ-Астром~~ автоматически сгенерирует идентификатор хоста		* <code>auto</code> — Пусть АппОптима автоматически сгенерирует идентификатор хоста
	* <code>ip-addresses</code> — Генерировать идентификатор хоста на основе IP-адреса хоста		* <code>ip-addresses</code> — Генерировать идентификатор хоста на основе IP-адреса хоста
	* <code>mac-address</code> — Сгенерируйте идентификатор хоста на основе MAC адреса сетевой карты хоста		* <code>mac-address</code> — Сгенерируйте идентификатор хоста на основе MAC адреса сетевой карты хоста
Строка 322:		Строка 322:
	Значение по умолчанию: <code>LocalSystem</code> (ЕдиныйАгент версия 1.195+. Для более ранних версий - <code>dtuser</code>)		Значение по умолчанию: <code>LocalSystem</code> (ЕдиныйАгент версия 1.195+. Для более ранних версий - <code>dtuser</code>)

	Используйте параметр <code>USER</code>, чтобы указать пользователя, запускающего процесс, отвечающий за функциональность расширений ~~Ключ-Астром~~ ЕдиныйАгент. Например:		Используйте параметр <code>USER</code>, чтобы указать пользователя, запускающего процесс, отвечающий за функциональность расширений АппОптима ЕдиныйАгент. Например:

	<code>.\Key-Astrom-OneAgent-Windows.exe USER=LocalService</code>		<code>.\Key-Astrom-OneAgent-Windows.exe USER=LocalService</code>
Строка 342:		Строка 342:
	* '''<code>Устарело</code>''' <code>dtuser</code> был учетной записью пользователя по умолчанию, которая использовалась для запуска расширений ЕдиногоАгента до версии 1.195. Это заставляло установщика создавать локальную учетную запись пользователя с таким же именем в системе. Начиная с версии 1.209, при использовании параметра <code>dtuser</code> программа установки ЕдиногоАгента применяет параметр <code>LocalSystem</code> без предупреждения. Начиная с версии 1.239, параметр <code>dtuser</code> преобразуется в <code>LocalSystem</code> для существующих установок при запуске обновления.		* '''<code>Устарело</code>''' <code>dtuser</code> был учетной записью пользователя по умолчанию, которая использовалась для запуска расширений ЕдиногоАгента до версии 1.195. Это заставляло установщика создавать локальную учетную запись пользователя с таким же именем в системе. Начиная с версии 1.209, при использовании параметра <code>dtuser</code> программа установки ЕдиногоАгента применяет параметр <code>LocalSystem</code> без предупреждения. Начиная с версии 1.239, параметр <code>dtuser</code> преобразуется в <code>LocalSystem</code> для существующих установок при запуске обновления.

	При развертывании ~~Ключ-Астром~~ на контроллере домена Windows Server убедитесь, что для параметра <code>USER</code> установлено значение <code>LocalSystem</code> или, в качестве альтернативы, <code>LocalService</code>, чтобы избежать распространения <code>dtuser</code> по всему домену, что может вызвать помехи для существующих учетных записей <code>dtuser</code> на хостах, на которых установлен ~~Ключ-Астром~~.		При развертывании АппОптима на контроллере домена Windows Server убедитесь, что для параметра <code>USER</code> установлено значение <code>LocalSystem</code> или, в качестве альтернативы, <code>LocalService</code>, чтобы избежать распространения <code>dtuser</code> по всему домену, что может вызвать помехи для существующих учетных записей <code>dtuser</code> на хостах, на которых установлен АппОптима.

	== Тихая установка ==		== Тихая установка ==