Lista de variables de entorno

Utilice las variables de entorno para controlar el comportamiento del agente en tiempo de ejecución.

Las variables de entorno pueden crearse en el agente mediante la página Variables de entorno. En los sistemas Windows, las variables de entorno se definen en el archivo KXXENV del agente. En los sistemas UNIX y Linux, estas variables se pueden definir en el archivo $CANDLEHOME/config/XX.ini del agente. XX es el código de producto de dos letras. Para que los valores nuevos tengan efecto, el agente se debe reiniciar.

Nota: Las variables de entorno no se han establecido correctamente en un sistema remoto que ejecuta C Shell. Utilice un shell distinto si desea utilizar las variables de entorno.

Tabla 1. Variables de entorno. Una tabla que lista las variables de entorno, sus valores predeterminados, los rangos de valores válidos y las descripciones para cada variable
Variable de entorno	Valor predeterminado	Valores válidos	Descripción
`CDP_GRUPO_ATRIBUTOS_REFRESH_INTERVAL`	No aplicable	Un entero no negativo	Intervalo en segundos durante el cual un grupo de atributos especificado concreto se actualiza en segundo plano. Esta variable funciona del mismo modo que `CDP_DP_REFRESH_INTERVAL`, excepto en que tiene como destino únicamente el grupo de atributos especificado. El nombre de grupo de atributos del nombre de variable debe estar en mayúsculas, aunque el nombre de grupo de atributos real no esté en mayúsculas.
`CDP_DP_CACHE_TTL`	`55`	Un entero superior o igual a 1.	Los datos se recopilan para un grupo de atributos almacenados en la memoria caché por este número de segundos. Cuando se realizan varias solicitudes de los mismos datos en este intervalo de tiempo, éstas reciben una copia de los datos almacenada en la memoria caché. Este valor se aplica a todos los grupos de atributos del agente.
`CDP_GRUPO_ATRIBUTOS_CACHE_TTL`	Valor de `CDP_DP_CACHE_TTL`	Un entero superior o igual a 1.	Los datos que se recopilan para el grupo de atributos especificado se almacenan en la memoria caché durante este número de segundos. Cuando se realizan varias solicitudes de los mismos datos en este intervalo de tiempo, éstas reciben una copia de los datos almacenada en la memoria caché. Este valor altera temporalmente `CDP_DP_CACHE_TTL` para el grupo especificado. El nombre de grupo de atributos del nombre de variable debe estar en mayúsculas, aunque el nombre de grupo de atributos real no esté en mayúsculas.
`CDP_DP_IMPATIENT_COLLECTOR_TIMEOUT`	`5` si se definen subnodos, de lo contrario no se establece	Un entero positivo	El número de segundos a esperar por una recopilación de datos antes de un tiempo de espera excedido y la devolución de los datos almacenados en caché, incluso si los datos de caché son obsoletos. (Los datos de la memoria caché están obsoletos si son anteriores a `CDP_DP_CACHE_TTL` segundos). Si esta variable no se establece, el agente espera hasta que la recopilación de datos se completa. A veces la espera puede hacer que Tivoli Enterprise Portal exceda el tiempo de espera y deje de esperar. Si no hay ninguna agrupación de hebras configurada, esta variable se ignora y la recopilación de datos se realiza de forma síncrona.
`CDP_DP_REFRESH_INTERVAL`	`60` si se definen subnodos, de lo contrario no se establece	Un entero no negativo	Intervalo en segundos durante el cual se actualizan en segundo plano grupos de atributos. Si esta variable no se establece o se establece en 0, las actualizaciones en segundo plano se inhabilitan. Si está configurada una agrupación de hebras (consulte la variable `CDP_DP_THREAD_POOL_SIZE`), los grupos de atributos se renuevan en paralelo. Si no existe ninguna agrupación de hebras, las actualizaciones se producirán en serie y pueden tardar más bastante tiempo. Es lógicamente equivalente a un tamaño de agrupación de hebras de 1.
`CDP_DP_THREAD_POOL_SIZE`	`15` si hay subnodos definidos, de lo contrario no se establece	Un entero no negativo	El número de hebras que se crean para ejecutar las colecciones de datos en segundo plano en un intervalo que define `CDP_DP_REFRESH_INTERVAL`. Si esta variable no se establece o se establece en 0, no existe ninguna agrupación de hebras. Si `CDP_DP_THREAD_POOL_SIZE` se establece en un valor mayor que 1 y `CDP_DP_REFRESH_INTERVAL` se establece en 0, el valor de `CDP_DP_THREAD_POOL_SIZE` se ignora y la recopilación de datos se realiza a petición. El grupo de atributos Estatus de agrupación de hebras muestra cómo se ejecuta la agrupación de hebras. Utilice Estatus de agrupación de hebras para ajustar el tamaño de la agrupación de hebras y el intervalo de renovación para obtener los mejores resultados. De forma predeterminada, la consulta para este grupo de atributos no se visualiza en el árbol de Navigator de agente. Es posible que no recuerde que debe incluir la consulta en un espacio de trabajo personalizado para el agente. Sin embargo, puede verlo fácilmente asignando la consulta Estatus de agrupación de hebras a una vista del espacio de trabajo de nivel de agente básico.
`CDP_JDBC_MAX_ROWS`	`1000`	Un entero positivo	El número máximo de filas de datos que devuelve el proveedor de datos JDBC. Un conjunto de resultados que contiene más de este número de filas solo se procesa hasta este valor máximo. Se pueden desarrollar consultar para evitar que se devuelvan demasiados datos a IBM® Tivoli Monitoring.
`CDP_NT_EVENT_LOG_GET_ALL_ENTRIES_FIRST_TIME`	`NO`	YES, NO	Si se establece YES como valor, el agente enviará un suceso para por cada suceso del registro de sucesos de Windows. Si se establece NO como valor, sólo se enviarán los sucesos nuevos del registro de sucesos de Windows.
`CDP_NT_EVENT_LOG_CACHE_TIMEOUT`	`3600`	Un entero superior o igual a 300.	Número de segundos durante los cuales el agente almacena en la memoria caché los sucesos del registro de sucesos de Windows. Todos los sucesos almacenados en la memoria caché se devuelven cuando se consulta el grupo de atributos de registro cronológico de sucesos. Nota: Esta variable ya no se utiliza. Utilice la variable `CDP_PURE_EVENT_CACHE_SIZE`.
`CDP_PURE_EVENT_CACHE_SIZE`	`100`	Un entero positivo superior o igual a 1	Número máximo de sucesos a almacenar en la memoria caché de un archivo de registro que se configura para procesar nuevos registros, para el grupo de atributos de Windows Event Log. Y también para notificaciones y supervisores de JMX. Cada nuevo registro del registro hará que se envíe un suceso. Esta variable de entorno define cuántos sucesos recuerda el agente en una memoria caché. Los valores almacenados en la memoria caché se devuelven cuando se consulta el grupo de atributos.
`CDP_DP_ACTION_TIMEOUT`	`20` segundos	Un entero positivo superior o igual a 1	El número de segundos que se debe esperar para que se complete una actuación que el agente está manejando.
`CDP_DP_SCRIPT_TIMEOUT`	`30` segundos	Un entero positivo superior o igual a 10	El número de segundos que se debe esperar a que el programa iniciado por un grupo de atributos basado en script se complete.
`CDP_DP_PING_TIMEOUT`	`30` segundos	Un entero positivo superior o igual a 10	El número de segundos que se debe esperar a que el programa iniciado por un código de retorno de mandato se complete. Nota: Esta variable no está relacionada con el proveedor de datos de ping de ICMP.
`CDP_SNMP_MAX_RETRIES`	`2`	Un entero positivo	El número de veces que se debe intentar enviar la solicitud de SNMP de nuevo. El número total de solicitudes que se envían al agente SNMP es este valor más uno si no se reciben respuestas.
`CDP_SNMP_RESPONSE_TIMEOUT`	`2` segundos	Un entero positivo	El número de segundos a esperar para que cada solicitud de SNMP alcance el tiempo de espera excedido. Cada fila de un grupo de atributos es una solicitud independiente. Este valor de tiempo de espera es el número de segundos que se debe esperar una respuesta antes de intentarlo nuevamente. El tiempo de espera total para una única fila de datos es (`CDP_SNMP_MAX_RETRIES` + 1) * `CDP_SNMP_RESPONSE_TIMEOUT`. El valor total predeterminado de tiempo de espera es (2+1) * 2 = 6 segundos.
`CDP_DP_HOSTNAME`	Nombre de la primera interfaz de red instalada	Una dirección IP o nombre de host	Establece el nombre de host preferido (interfaz de red) en un sistema de varias interfaces. Utilice esta variable de entorno si el agente enlaza sus puertos de escucha a una dirección de interfaz de red que no sea la predeterminada. Se utiliza por el proveedor de datos SNMP. Para los orígenes de datos de socket, esta variable se aplica si `CDP_DP_ALLOW_REMOTE` también se ha establecido.
`CDP_SNMP_ALLOW_DECREASING_OIDS`	`NO`	YES, NO	Si tiene el valor YES, los proveedores de datos SNMP no comprueban si los IOD devueltos son ascendentes. Establezca el valor YES con precaución ya que el agente supervisado puede tener problemas que normalmente esta comprobación detectaría.
`KUMP_DP_COPY_MODE_SAMPLE_INTERVAL`	`60`	Tiempo de espera en segundos	Para un proveedor de datos de archivo de registro, especifica cuánto tiempo se debe esperar antes de volver a leer el contenido de un archivo cuando el agente está definido para Procesar todos los registros cuando se muestra el archivo. El tiempo se especifica en segundos.
`KUMP_MAXPROCESS`	`100%`	5-100%	Para un proveedor de datos de archivo de registro, especifica el uso de procesador máximo que se debe utilizar para procesar los datos de archivo. Los valores van del 5 al 100 por ciento. El valor predeterminado es el 100 por ciento.
`KUMP_DP_SAMPLE_FACTOR`	`5`	Un entero no negativo	Para un proveedor de datos de archivo de registro, establece el factor de muestreo cuando selecciona Procesar todos los registros cuando se muestra el archivo en Agent Builder. Este tiempo asegura que los patrones que abarquen varios registros se escriban antes que se registren las extensiones del patrón.
`KUMP_DP_EVENT`	`5`	Un entero no negativo	Para un proveedor de datos de archivo de registro, establece la frecuencia de muestreo para los datos de sucesos, en segundos.
`KUMP_DP_FILE_EXIST_WAIT`	`SÍ`	YES, NO	Para un proveedor de datos de archivo de registro, especifica que la hebra de supervisión de archivos continúa ejecutándose si detecta que el archivo supervisado está ausente o vacío. La hebra espera hasta que detecta el archivo, vuelve a realizar la comprobación cada pocos segundos e inicia o reinicia la supervisión cuando el archivo pasa a estar disponible.
`KUMP_DP_FILE_SWITCH_CHECK_INTERVAL`	`600`	Un entero no negativo	La frecuencia en segundos con que el proveedor de datos de archivo de registro busca un archivo de supervisión diferente al conmutar cuando el soporte de nombres de archivo dinámicos está habilitado.
`KUMP_DP_FILE_ROW_PAUSE_INCREMENT`	Ninguno	Un entero no negativo	Para un proveedor de datos de archivo de registro, especifica cuántos registros de archivo se leen antes de la pausa en la hebra de supervisión de archivos. La pausa es para que se puedan procesar las actualizaciones anteriores. Utilice esta variable de entorno solo si el archivo supervisado recibe ráfagas de gran volumen de registros nuevos y está preocupado de que algunas actualizaciones de registros puedan perderse.
`CDP_COLLECTION_TIMEOUT`	`60` segundos	Un entero positivo	El número de segundos que el agente espera una respuesta de un recopilador de datos que se ha iniciado en otro proceso. Los recopiladores de datos JMX, JDBC, HTTP y SOAP son algunos ejemplos.
`CDP_SSH_TEMP_DIRECTORY`	`.` (punto)	Una cadena de vía de acceso válida en el sistema remoto	Para un proveedor de datos de script SSH habilitado especifica una ubicación en el sistema remoto. Los archivos de script que se proporcionan con el agente se deben cargar en esta ubicación. Una ubicación relativa es relativa para el directorio de inicio del usuario. El valor predeterminado `.` (punto) indica el directorio de inicio del usuario.
`CDP_SSH_DEL_COMMAND`	`rm -Rf`	Una cadena de mandato de supresión válida en el sistema remoto	Para un proveedor de datos de script de SSH habilitado, especifica el mandato para iniciar la supervisión de los archivos de script que se han cargado, proporcionados con el agente con el agente.
`CDP_SNMP_SEND_DELAY_ FACTOR`	`0` milisegundos	Un entero positivo	El envío de SNMP inicial se retrasa de 0 al número de milisegundos especificado. Esta variable sólo está habilitada si la agrupación de hebras también está habilitada. El retardo no se aplica a todos los envíos, sólo al primer envío realizado por un grupo de atributos. Esta variable es útil si el dispositivo que se está supervisando a veces puede no responder correctamente si recibe varias solicitudes a la vez.
`CDP_ICMP_PING_REFRESH_INTERVAL`	`60` segundos	Un entero mayor o igual a 1	El ping se ejecuta en los sistemas de un archivo de lista de dispositivos a este intervalo. Si los pings utilizan demasiado tiempo, siempre hay un retraso de por lo menos `CDP_PING_MIN_INTERVAL_DELAY` segundos antes de que los pings se inicien otra vez. Los datos no se renuevan con más frecuencia que este valor. Los datos se pueden renovar con menos frecuencia en función del número de entradas del archivo de lista de dispositivos y el tiempo que se tarda en recibir respuestas.
`CDP_ICMP_PING_MIN_INTERVAL_DELAY`	`30` segundos	Cualquier entero mayor o igual a 1 y menor que el intervalo de renovación de ping `CDP`	Después que se ejecuta el ping de los dispositivos en un archivo de lista de dispositivos, el siguiente intervalo de actualización de ping no se inicia hasta que transcurra al menos esta cantidad de segundos.
`CDP_ICMP_PING_BURST`	`10`	Un entero mayor o igual a 0	El número de pings que se envían antes que el agente se pause por el tiempo que se especifica la variable `CDP_ICMP_PING_BURST_DELAY`. Un valor de 0 inhabilita esta función.
`CDP_ICMP_PING_BURST_DELAY`	`10`	Un entero mayor o igual a 0	La cantidad de tiempo en milisegundos a esperar después que un número establecido de pings se envíen, tal como lo define la variable `CDP_ICMP_PING_BURST`. Un valor de 0 inhabilita esta función.
`CDP_ICMP_PING_TIMEOUT`	`2000` milisegundos	Un entero mayor o igual a 1	Número de milisegundos de espera de una respuesta de ping. Este valor se aplica a cada intento de ping que se realice. Los intentos de ping se realizan tres veces para cada host. Si no se recibe ninguna respuesta de cualquiera de los tres intentos, el tiempo total de espera para una respuesta es `CDP_ICMP_PING_TIMEOUT` multiplicado por 3. De manera predeterminada, este valor es 6000 milisegundos. Si cambia el valor para `CDP_ICMP_PING_TIMEOUT`, la enumeración predeterminada `TIMEOUT` para el atributo del tiempo de respuesta actual ya no se aplica. Cambie la enumeración `TIMEOUT` por el nuevo valor de `CDP_ICMP_PING_TIMEOUT` multiplicado por 3.
`CDP_JDBC_CONNECTIONLESS`	`falso`	true, false	Si se establece en true, las conexiones JDBC se cierran después de cada intento de recopilación de datos. Es decir, todos los grupos de atributos intentan crear su propia conexión cada vez que se recopilan datos. Las conexiones no se vuelven a utilizar si esta variable está habilitada. Si se establece en false, se realiza una conexión a la base de datos y dicha conexión se comparte entre los grupos de atributos.
`CDP_SSH_EXCLUDED_ ENVIRONMENT_VARIABLES`	Ninguno	Una lista separada por comas de los nombres de variable de entorno	Para un proveedor de datos de script con SSH habilitado, especifica el conjunto de variables de entorno locales que no deben establecerse en el entorno del sistema remoto.
`CDP_DP_EVENT_LOG_MAX_BACKLOG_TIME`	`0` segundos	0, 1 o un entero mayor que 1	Si se establece en 0 y `CDP_DP_EVENT_LOG_MAX_BACKLOG_EVENTS` no está establecido en 1 o un entero mayor, no procesa los sucesos que se generan mientras el agente se cierra. 0 es el valor predeterminado. Si está establecido en 1 y `CDP_DP_EVENT_LOG_MAX_BACKLOG_EVENTS` no se ha establecido en un entero mayor a 1, procesa todos los sucesos que se genera mientras que el agente se cierra. Si está establecido en un valor mayor a 1 y `CDP_DP_EVENT_LOG_MAX_BACKLOG_EVENTS` no se ha establecido en un valor mayor a 1, procesa los sucesos que se generan en el valor en segundos de la hora actual del sistema. Por ejemplo, si el valor se establece en 300, en el inicio, el agente procesa todos los sucesos que se generan en los 300 segundos de la hora actual. Cuando se especifique un valor mayor que 1 para las variables `CDP_DP_EVENT_LOG_MAX_BACKLOG _TIME` y `CDP_DP_EVENT_LOG_MAX _BACKLOG_EVENTS`, se procesa el intervalo de tiempo de sucesos o el número de sucesos. La variable que se elige es la que coincide primero.
`CDP_DP_EVENT_LOG_ Reg_Sucesos_Windows_MAX_BACKLOG_TIME`	`0` segundos (No procesar sucesos que faltan mientras el agente esté cerrado)	0, 1 o un entero mayor que 1	Si se establece en
`CDP_DP_EVENT_LOG_ MAX_BACKLOG_EVENTS`	`0` sucesos	0, 1 o un entero mayor que 1	Si se establece en 0 y la variable `CDP_DP_EVENT_LOG_MAX_BACKLOG _TIME` no se ha establecido en 1 o un entero mayor, no procesa los sucesos que genera mientras el agente se cierra. 0 es el valor predeterminado. Si se establece en 1, y la variable `CDP_DP_EVENT_LOG_MAX_BACKLOG _TIME` no se ha establecido en un entero mayor a 1, procesa todos los sucesos que se generan mientras el agente se cierra. Si se establece mayor que 1 y `CDP_DP_EVENT_LOG_MAX_BACKLOG _TIME` no es mayor a 1, procesa como máximo ese número de sucesos que se generan mientras el agente se cierra. Por ejemplo, si el valor se establece en 200, entonces se procesan en el inicio del agente los 200 sucesos que se generaron antes del inicio. Cuando se especifique un valor mayor que 1 para las variables `CDP_DP_EVENT_LOG_MAX_BACKLOG _EVENTS` y `CDP_DP_EVENT_LOG_MAX_BACKLOG _TIME`, se procesa ese número de sucesos o ese intervalo de tiempo de sucesos. La variable que se elige es la que coincide primero.
`CDP_DP_EVENT_LOG_ Reg_Sucesos_Windows_MAX_BACKLOG_EVENTS`	`0` sucesos (No procesar los sucesos que faltan mientras el agente está cerrado)	0 o un entero mayor o igual a 1	Si se establece en
`CDP_HTTP_READ_TIMEOUT`	`10`	Un entero positivo	El número de sucesos que se debe esperar por una respuesta a la solicitud de HTTP.
`CDP_JAT_THREAD_POOL_SIZE`	`15`	Un entero positivo	El número de hebras que utilizan los proveedores de Java™ para gestionar solicitudes de recopilación de datos. Los proveedores de datos JMX, JDBC, HTTP y SOAP son los proveedores que se pueden beneficiar de esta agrupación de hebras.
`CDP_HTML_OBJECTS_THREAD_ POOL_SIZE`	`10`	Un entero positivo	El número de hebras que se utilizan para descargar objetos de páginas que se encuentran en URL supervisadas con el proveedor de datos HTTP.
`CDP_HTTP_SOAP_MAX_ROWS`	`500`	Un entero positivo	El número máximo de filas que son devueltas por el proveedor de datos de SOAP de HTTP.
`CDP_DP_ALLOW_REMOTE`	`NO`	`NO, YES`	Si se establece en Sí, el agente permite conexiones de socket remotas. Si se establece en No, el agente permite solo conexiones de socket desde el host local. No es el valor predeterminado.
`CDP_DP_INITIAL_COLLECTION_ DELAY`	varía	Un entero positivo	El número de segundos, después de que el agente se inicia, hasta que la agrupación de hebras empieza su recopilaciones de datos planificadas.