Список переменных среды

Переменные среды управляют режимом работы агента в среде выполнения.

Переменные среды можно встроить в агент на странице Переменные среды. В системах Windows переменные указаны в файле агента KXXENV. В системах UNIX и Linux эти переменные можно задать в файле агента $CANDLEHOME/config/XX.ini. XX - это двухбуквенный код продукта. Для того, чтобы внесенные изменения вступили в силу, надо перезапустить агент.

Прим.: В удаленной системе, где работает C Shell, переменные среды задаются неправильно. Если вам нужны переменные среды, то используйте другую оболочку.

Табл. 1. Переменные среды. Таблица, в которой перечислены переменные среды, их значения по умолчанию, диапазоны допустимые значения и описания каждой переменной
Переменная среды	Значение по умолчанию	Допустимые значения	Описание
`CDP_ГРУППА_АТРИБУТОВ_REFRESH_INTERVAL`	Неприменимо	Любое неотриц. целое	Интервал в секундах обновления в фоновом режиме для заданной группы атрибутов. Переменная действует тем же способом, что и `CDP_DP_REFRESH_INTERVAL`, но только на указанную группу атрибутов. Имя группы атрибутов в имени переменной надо задавать в верхнем регистре, даже если само имя группы атрибутов задано иначе.
`CDP_DP_CACHE_TTL`	`55`	Любое целое число, большее или равное 1.	Данные, собранные для группы атрибутов, кэшируются на это время (в секундах). На многократные запросы одних и тех же данных в этот период времени отправляются кэшированные копии данных. Это значение применимо ко ко всем группам атрибутов агента.
`CDP_ГРУППА_АТРИБУТОВ_CACHE_TTL`	Значение `CDP_DP_CACHE_TTL`	Любое целое число, большее или равное 1.	Данные, собранные для особой указанной группы атрибута, кэшируются на это время в секундах. На многократные запросы одних и тех же данных в этот период времени отправляются кэшированные копии данных. Это значение перезаписывает параметр `CDP_DP_CACHE_TTL` для заданной группы. Имя группы атрибутов в имени переменной надо задавать в верхнем регистре, даже если само имя группы атрибутов задано иначе.
`CDP_DP_IMPATIENT_COLLECTOR_TIMEOUT`	`5`, если определены подузлы, иначе не задано.	Любое положительное целое	Время (в секундах) ожидания сбора данных до истечения срока ожидания и возврата кэшированных данных, даже если кэшированные данные устарели. Кэшированные данные считаются устаревшими, если их возраст превышает `CDP_DP_CACHE_TTL` секунд. Если эта переменная не задана, то агент ожидает, пока не будет завершен сбор данных. Ожидание может привести к истечению срока ожидания Tivoli Enterprise Portal и к прекращению ожидания. Если пул потоков не сконфигурирован, то эта переменная игнорируется и сбор данных выполняется синхронно.
`CDP_DP_REFRESH_INTERVAL`	`60`, если определены подузлы, иначе не задано.	Любое неотриц. целое	Интервал в секундах обновления в фоновом режиме групп атрибутов. Если эта переменная не задана или для нее задано нулевое значение, обновление в фоновом режиме не выполняется. Если сконфигурирован пул потоков (смотрите переменную `CDP_DP_THREAD_POOL_SIZE`), то группы атрибутов могут обновляться параллельно. Если пул потоков не сконфигурирован, то обновления производятся последовательно, что может занять много времени. Это логически эквивалентно пулу потоков размером 1.
`CDP_DP_THREAD_POOL_SIZE`	`15`, если определены подузлы, иначе не задано.	Любое неотриц. целое	Число потоков, создаваемых для сбора данных в фоновом режиме с интервалами, заданными переменной `CDP_DP_REFRESH_INTERVAL`. Если эта переменная не задана или для нее задано нулевое значение, пул потоков не используется. Если для `CDP_DP_THREAD_POOL_SIZE` задано большее 1 значение, а для `CDP_DP_REFRESH_INTERVAL` задано значение 0, значение `CDP_DP_THREAD_POOL_SIZE` будет игнорироваться и сбор данных будет выполняться по требованию. Группа атрибутов Состояние пула потоков показывает, как работает пул потоков. Используйте атрибуты Состояние пула потоков, чтобы настроить размер пула потоков и интервал обновления для получения оптимальных результатов. По умолчанию запрос для этой группы атрибутов не выводится в дереве навигатора агента. Вы можете забыть, что этот запрос включен в пользовательское рабочее пространство для агента. Однако его можно просмотреть, назначив запрос Состояние пула потоков для представления рабочего пространства на базовом уровне агента.
`CDP_JDBC_MAX_ROWS`	`1000`	Любое положительное целое	Максимальное число строк данных, возвращаемых провайдером данных JDBC. Набор результатов, содержащий большее число строк, обрабатывается только до этого максимального значения. Можно создать запросы, которые позволят избежать возвращения из IBM® Tivoli Monitoring слишком большого объема данных.
`CDP_NT_EVENT_LOG_GET_ALL_ENTRIES_FIRST_TIME`	`NO`	YES, NO	Если задано YES, то агент отправляет событие на каждое событие в журнале событий Windows. Если задано NO, то отправляются только новые события из журнала событий Windows.
`CDP_NT_EVENT_LOG_CACHE_TIMEOUT`	`3600`	Любое целое число, большее или равное 300.	Время в секундах, на которое агент кэширует события журнала Windows. Все кэшированные события возвращаются, если запрашивается группа атрибутов журнала событий. Прим.: Эта переменная больше не используется. Используйте переменную `CDP_PURE_EVENT_CACHE_SIZE`.
`CDP_PURE_EVENT_CACHE_SIZE`	`100`	Любое целое число, большее или равное 1.	Максимальное число подлежащих кэшированию событий для источника данных Файл журнала, который сконфигурирован для обработки новых записей для группы атрибутов Журнал событий Windows и для мониторов и уведомлений JMX. Каждая новая запись в журнале приведет к отправке события. Эта переменная среды определяет, сколько событий агент сохраняет в кэше. Кэшированные значения возвращаются, если запрашивается группа атрибутов.
`CDP_DP_ACTION_TIMEOUT`	`20` секунд	Любое целое число, большее или равное 1.	Время (в секундах), в течение которого ожидается завершение команды выполнения действий, обрабатываемой агентом.
`CDP_DP_SCRIPT_TIMEOUT`	`30` секунд	Любое положительное целое число, большее или равное 10.	Время (в секундах), в течение которого ожидается завершение программы, запущенной группой атрибутов, основанной на сценарии.
`CDP_DP_PING_TIMEOUT`	`30` секунд	Любое положительное целое число, большее или равное 10.	Время (в секундах), в течение которого ожидается завершение программы, запущенной кодом возврата команды. Прим.: Эта переменная не связана с провайдером данных ping ICMP.
`CDP_SNMP_MAX_RETRIES`	`2`	Любое положительное целое	Число повторов попыток отправки требований SNMP. Общее число отправленных требований агенту SNMP равно этому значению плюс единица, если не получены ответы.
`CDP_SNMP_RESPONSE_TIMEOUT`	`2` секунды	Любое положительное целое	Срок ожидания для каждого требования SNMP (в секундах). Каждая строка в группе атрибутов - это отдельное требование. Это значение срока ожидания представляет собой время в секундах, в течение которого ожидается ответ перед тем, как будет предпринята повторная попытка. Общий срок ожидания для отдельной строки данных равен (`CDP_SNMP_MAX_RETRIES` + 1) * `CDP_SNMP_RESPONSE_TIMEOUT`. Общее значение срока ожидания по умолчанию: (2+1) * 2 = 6 секунд.
`CDP_DP_HOSTNAME`	Имя первого установленного сетевого интерфейса	IP-адрес или имя хоста	Задает имя предпочтительного хоста (сетевого интерфейса) в системе с несколькими хостами. Используйте эту переменную среды, если агент связывает порты ожидания с адресом сетевого интерфейса, который не задан по умолчанию. Используется провайдером данных SNMP. Для источников данных Гнездо эта переменная применяется, если задана переменная `CDP_DP_ALLOW_REMOTE`.
`CDP_SNMP_ALLOW_DECREASING_OIDS`	`NO`	YES, NO	Если задано YES (Да) то провайдеры данных SNMP не проверяют, увеличиваются ли возвращаемые OID. Значение YES нужно задавать с осторожностью, так как в отслеживаемом агенте могут возникнуть ошибки, обычно определяемые этой проверкой.
`KUMP_DP_COPY_MODE_SAMPLE_INTERVAL`	`60`	Время ожидания (в секундах)	Указывает провайдеру данных файла журнала, сколько времени нужно ожидать до повторного чтения контента файла, если для агента задано Обработать все записи при выборке файла. Время задается в секундах.
`KUMP_MAXPROCESS`	`100%`	5-100%	Задает для провайдера данных журнала максимальное использование процессора для обработки данных файла. Диапазон значений - от 5 до 100 процентов. Значение по умолчанию - 100 процентов.
`KUMP_DP_SAMPLE_FACTOR`	`5`	Любое неотриц. целое	Задает для провайдера данных файла журнала коэффициент выборки, если в Agent Builder выбрано Обработать все записи при выборке файла. Это время ожидания гарантирует, что шаблоны, охватывающие несколько записей, будут записаны до внесения в журнал сканирований шаблона.
`KUMP_DP_EVENT`	`5`	Любое неотриц. целое	Задает для провайдера данных журнала периодичность выборки для данных события (в секундах).
`KUMP_DP_FILE_EXIST_WAIT`	`YES`	YES, NO	Для провайдера данных журнала указывает, нужно ли продолжать выполнение потока мониторинга файла, если поток обнаруживает, что отслеживаемый файл отсутствует или пуст. Поток ожидает появления файла, выполняя проверку каждые несколько секунд, и запускает или перезапускает мониторинг, как только файл станет доступен.
`KUMP_DP_FILE_SWITCH_CHECK_INTERVAL`	`600`	Любое неотриц. целое	Периодичность (в секундах) с которой провайдер данных файла журнала выполняет поиск файла для мониторинга, на который нужно переключиться, если используется поддержка динамических имен файлов.
`KUMP_DP_FILE_ROW_PAUSE_INCREMENT`	Нет	Любое неотриц. целое	Указывает провайдеру данных файла журнала, сколько записей файла будет прочитано, прежде чем поток мониторинга файла на некоторое время будет остановлен. Пауза требуется для обработки предыдущих изменений. Используйте эту переменную среды, только если отслеживаемый файл получает крупные пакеты новых записей и есть опасения, что некоторые изменения записей могут быть утеряны.
`CDP_COLLECTION_TIMEOUT`	`60` секунд	Любое положительное целое	Время (в секундах) в течение которого агент ожидает ответа от коллектора данных, запущенного в другом процессе. Примеры: сборщики данных JMX, JDBC, HTTP и SOAP.
`CDP_SSH_TEMP_DIRECTORY`	`.` (точка)	Любая допустимая строка пути в удаленной системе.	Для провайдера данных со сценарием с разрешенным соединением SSH указывает положение удаленной системы. Файлы сценария, предоставляемые с агентом, надо закачать в это положение. Каталог указывается относительно домашнего каталога пользователя. Значение по умолчанию `.` (точка) - это домашний каталог пользователя.
`CDP_SSH_DEL_COMMAND`	`rm -Rf`	Любая допустимая строка команды удаления в удаленной системе.	Для провайдера данных Сценарий с разрешенным соединением SSH указывает команду, запускаемую для удаления закачанных файлов сценариев, поставляемых с агентом.
`CDP_SNMP_SEND_DELAY_ FACTOR`	`0` миллисекунд	Любое положительное целое	Исходная отправка SNMP отложена на срок от 0 до указанного числа миллисекунд. Эта переменная разрешена только если разрешен пул потока. Отсрочка применяется не ко всем отправкам, а только к первой отправке, выполненной группой атрибутов. Эта переменная полезна, если отслеживаемое устройство временами не отвечает правильно при одновременном получении нескольких требований.
`CDP_ICMP_PING_REFRESH_INTERVAL`	`60` секунд	Любое целое число, большее или равное 1	Системы в списке устройств опрашиваются командой ping с этим интервалом. Если операции ping занимают слишком много времени, то перед началом новой операции ping всегда есть задержка минимум в `CDP_PING_MIN_INTERVAL_DELAY` секунд. Данные обновляются не чаще, чем это задано значение этого параметра. Данные можно обновлять реже, в зависимости от числа записей в файле списка устройств и от времени, требуемого для получения ответов.
`CDP_ICMP_PING_MIN_INTERVAL_DELAY`	`30` секунд	Любое целое число, большее или равное 1 и меньшее, чем интервал обновления `CDP` Ping	После выполнения операции ping на устройствах из файла списка устройств следующий интервал обновления операции ping не начинается, пока не пройдет указанное число секунд.
`CDP_ICMP_PING_BURST`	`10`	Любое целое число, большее или равное 0	Число команд ping, отправляемых перед паузой, указанной в переменной `CDP_ICMP_PING_BURST_DELAY`. Значение 0 отключает эту функцию.
`CDP_ICMP_PING_BURST_DELAY`	`10`	Любое целое число, большее или равное 0	Время (в миллисекундах) для ожидания после выполнения заданного числа команд ping, как указано в переменной `CDP_ICMP_PING_BURST`. Значение 0 отключает эту функцию.
`CDP_ICMP_PING_TIMEOUT`	`2000` миллисекунд	Любое целое число, большее или равное 1	Время (в миллисекундах) для ожидания ответа на команду ping. Это значение применяется к каждому выполнению команды ping. Для каждого хоста выполняется три попытки ping. Если ни для одной из 3 попыток не получен ответ, то общее время ожидания ответа равно значению `CDP_ICMP_PING_TIMEOUT`, умноженному на 3. Значение по умолчанию: 6000 миллисекунд. Если значение `CDP_ICMP_PING_TIMEOUT` изменено, то перечисляемое значение `TIMEOUT` по умолчанию для атрибута Текущее время ответа больше не применяется. Задайте для `TIMEOUT` новое перечисляемое значение, равное значению `CDP_ICMP_PING_TIMEOUT`, умноженному на 3.
`CDP_JDBC_CONNECTIONLESS`	`false`	true, false	Если задано true, то соединения JDBC закрываются после каждой попытки сбора данных. Это означает, что все группы атрибутов пытаются при каждом сборе данных установить собственное соединение. Если эта переменная разрешена, то соединения нельзя использовать повторно. Если задано false, то создается одно соединение с базой данных и группы атрибутов используют его совместно.
`CDP_SSH_EXCLUDED_ ENVIRONMENT_VARIABLES`	Нет	Список имен переменных сред, разделенных запятыми.	Для провайдера данных Сценарий с разрешенным соединением SSH указывает набор локальных переменных среды, которые не нужно задавать в среде удаленной системы.
`CDP_DP_EVENT_LOG_MAX_BACKLOG_TIME`	`0` секунд	0, 1 или любое целое число больше 1	Если задано 0 и для `CDP_DP_EVENT_LOG_MAX_BACKLOG_EVENTS` не задано 1 или любое целое число больше 1, то события, созданные в то время, когда агент был выключен, не обрабатываются. Значение по умолчанию - 0. Если задано 1 и для `CDP_DP_EVENT_LOG_MAX_BACKLOG_EVENTS` не задано целое число больше 1, то обрабатываются все события, созданные в то время, когда агент был выключен. Если задано значение больше 1 и для `CDP_DP_EVENT_LOG_MAX_BACKLOG_EVENTS` не задано целое число больше 1, то обрабатываются события, созданные в течение этого времени (в секундах текущего времени компьютера). Например, если задано 300, то при запуске агент обрабатывает все события, созданные в течение 300 секунд текущего времени. Если значение больше 1 задано как для `CDP_DP_EVENT_LOG_MAX_BACKLOG _TIME`, так и для `CDP_DP_EVENT_LOG_MAX _BACKLOG_EVENTS`, то обрабатывается либо соответствующий интервал времени событий, либо соответствующее число событий. Выбранная переменная зависит от того, какое совпадение произойдет первым.
`CDP_DP_EVENT_LOG_ журнал_событий_Windows_MAX_ BACKLOG_TIME`	`0` секунд (не обрабатывать пропущенные события, пока агент был выключен)	0, 1 или любое целое число больше 1	Если задано
`CDP_DP_EVENT_LOG_ MAX_BACKLOG_EVENTS`	`0` событий	0, 1 или любое целое число больше 1	Если задано 0, а для переменной `CDP_DP_EVENT_LOG_MAX_BACKLOG _TIME` не задано 1 или любое целое число больше 1, то события, созданные в то время, когда агент был выключен, не обрабатываются. Значение по умолчанию - 0. Если задано 1, а для переменной `CDP_DP_EVENT_LOG_MAX_BACKLOG _TIME` не задано целое число больше 1, то все события, созданные в то время, когда агент был выключен, обрабатываются. Если задано значение больше 1, а для переменной `CDP_DP_EVENT_LOG_MAX_BACKLOG _TIME` не задано число больше 1, то это значение задает максимальное число обрабатываемых событий, созданных в то время, когда агент был выключен. Например, если задано 200, то при запуске агента обрабатывается 200 событий, созданных непосредственно перед запуском. Если значение больше 1 задано как для `CDP_DP_EVENT_LOG_MAX_BACKLOG _EVENTS`, так и для `CDP_DP_EVENT_LOG_MAX_BACKLOG _TIME`, то обрабатывается либо соответствующее число событий, либо соответствующий интервал времени событий. Выбранная переменная зависит от того, какое совпадение произойдет первым.
`CDP_DP_EVENT_LOG_ журнал_событий_Windows_MAX_ BACKLOG_EVENTS`	`0` событий (не обрабатывать пропущенные события, пока агент был выключен)	0 или любое целое число, большее или равное 1	Если задано
`CDP_HTTP_READ_TIMEOUT`	`10`	Любое положительное целое	Срок ожидания ответа на требование HTTP (в секундах).
`CDP_JAT_THREAD_POOL_SIZE`	`15`	Любое положительное целое	Число потоков, используемых провайдерами Java™ для обработки требований сбора данных. Этими пулами потоков могут пользоваться провайдеры данных JMX, JDBC, HTTP и SOAP.
`CDP_HTML_OBJECTS_THREAD_ POOL_SIZE`	`10`	Любое положительное целое	Число потоков, используемых для скачивания объектов страниц, найденных в URL, которые отслеживаются провайдерами данных HTTP.
`CDP_HTTP_SOAP_MAX_ROWS`	`500`	Любое положительное целое	Максимальное число строк, возвращаемых провайдером данных SOAP HTTP.
`CDP_DP_ALLOW_REMOTE`	`NO`	`NO, YES`	Если задано Yes (Да), то агент разрешает соединения с удаленным гнездом. Если задано No (Нет), то агент разрешает только соединения с гнездом от локального хоста. Значение по умолчанию - No.
`CDP_DP_INITIAL_COLLECTION_ DELAY`	разное	Любое положительное целое	Время после запуска агента (в секундах), по истечении которого пул потоков начинает запланированные сборы данных.