Saltar al contenido

Archivo de configuración del agente privado de Jitterbit jitterbit.conf

Introducción

Esta página describe el archivo de configuración principal para agentes privados, jitterbit.conf. Se encuentra en el directorio de instalación (JITTERBIT_HOME), por defecto C:\Program Files\Jitterbit Agent\ en Microsoft Windows, /opt/jitterbit/ en Linux y Docker.

El archivo utiliza el formato INI file, en el que los nombres de sección están entre corchetes, y cada sección es una lista de pares clave-valor. Las secciones pueden estar en cualquier orden dentro del archivo. (Esta página ordena las secciones alfabéticamente, pero no es así en el archivo predeterminado). Si hay secciones o claves que no se encuentran en tu archivo, debes añadirlas; algunas no se proporcionan en el archivo predeterminado. Para claves no presentes o comentadas (con un # al inicio), se aplica el valor predeterminado. Los valores booleanos se pueden proporcionar como 0/1 o false/true. Las rutas utilizan barras diagonales hacia adelante, incluso cuando se especifican ubicaciones de Windows.

Importante

Los cambios realizados en el archivo no se aplican hasta que se reinicia el agente, y no se sobrescriben al actualizar.

[AgentCapability]

Estos parámetros se aplican tanto a las características de observabilidad de agentes privados nativos como de terceros.

Las métricas de uso de memoria se recopilan solo en agentes Windows. En agentes Linux, el uso de memoria no se utiliza en el cálculo de capacidad, y los parámetros de memoria en esta sección no tienen efecto.

Apache solo sirve solicitudes de API, por lo que los parámetros de subprocesos de Apache en esta sección son relevantes solo en un agente que maneja APIs.

Cuando se habilitan las métricas de uso de CPU o memoria, anulan las otras entradas de capacidad: si alguna cruza su umbral, el agente se reporta como incapaz independientemente de la disponibilidad de subprocesos de Apache o de subprocesos de trabajo del motor de procesos.

Importante

No cambies ningún valor en esta sección a menos que el soporte de Jitterbit te lo indique.

Clave Predeterminado Descripción
ApacheThreadBuffer 10 Buffer de límite de subprocesos de Apache.
ApacheThreadCapabilityDebugOutput false Si es true, genera registros de solución de problemas adicionales de Apache.
ApacheThreadCapabilityEnabled false Si es true, habilita la métrica de uso de subprocesos de Apache para determinar el estado de capacidad del agente.
ApacheThreadCapabilityReportInterval 2 Con qué frecuencia se verifica el uso de subprocesos de Apache (segundos).
CapabilityDebugOutput false Si es true, genera registros de solución de problemas de capacidad adicionales.
CapabilityRefreshCooldown 1 Después de que un agente entra en estado incapaz, el período de enfriamiento (segundos) antes de actualizar el estado de capacidad. El valor predeterminado cambió de 2 a 1 en la versión 12.7 del agente.
CpuConsecutiveFailureThreshold 3 Número de violaciones consecutivas del umbral de CPU requeridas antes de que el agente cambie de capaz a incapaz. Se aplica solo cuando CpuUsageCapabilityEnabled es true. El valor predeterminado cambió de 1 a 3 en la versión 12.7 del agente.
CpuUsageCapabilityDebugOutput false Si es true, habilita registros de depuración de capacidad de CPU en el archivo de registro del motor de procesos. Si es false, solo registra cambios en el estado de capacidad de CPU.
CpuUsageCapabilityEnabled false Si es true, habilita la métrica IncapableCpuUsage para determinar el estado de capacidad del agente.
CpuUsageCapabilityReportInterval 1 Con qué frecuencia se verifica el porcentaje de CPU (segundos).
EnhancedCapabilityMetricsEnabled false Si es true, habilita la lógica de métrica de capacidad del agente.
EnhancedCapabilityMetricsJMXEnabled true Si es true, habilita la métrica JMX para capacidad.
EnhancedCapabilityMetricsSubmissionEnabled false Si es true, establece EnhancedCapabilityMetricsEnabled en true y envía métricas de capacidad a Harmony.
IncapableCpuUsage 95 Porcentaje de CPU en el que el agente se vuelve incapaz. Se ignora a menos que CpuUsageCapabilityEnabled sea true.
IncapableMemoryUsage 95 Porcentaje de memoria en el que el agente se vuelve incapaz. Se ignora a menos que MemoryUsageCapabilityEnabled sea true.
MemoryUsageCapabilityDebugOutput false Si es true, genera registros de solución de problemas de memoria adicionales.
MemoryUsageCapabilityEnabled false Si es true, habilita la métrica IncapableMemoryUsage para determinar el estado de capacidad del agente.
MemoryUsageCapabilityReportInterval 1 Con qué frecuencia se verifica el porcentaje de memoria (segundos).

[AgentMetrics]

Estos parámetros se aplican solo a la función de observabilidad nativa.

Clave Predeterminado Descripción
Enabled false Si es true, permite el uso de otras claves en esta sección. Si es false, se ignoran los valores de otras claves en esta sección.
JitterbitMetricsServiceEnabled false Si es true, inicia el servicio de recopilación de métricas.
UserIntentFileWatcherEnabled true Si es true, y tanto Enabled como JitterbitMetricsServiceEnabled son true, inicia un servicio de vigilancia de archivos que captura la acción más reciente del usuario.
OperationStatusLogToFileEnabled false Si es true, registra el estado de las operaciones en un archivo. (Movido y renombrado desde EnableAgentMetricLogging en [MetricLogging].)
OperationStatusLogToFileAsyncEnabled true Si es true, y OperationStatusLogToFileEnabled es true, registra de forma asincrónica usando subprocesos separados. (Movido y renombrado desde EnableAgentMetricLogging en [MetricLogging]) No cambies a menos que el soporte de Jitterbit te lo indique.
AgentEnvSyncProgressToFileEnabled false Si es true, registra el proceso de sincronización del agente en un archivo. (Movido y renombrado desde EnableAgentSyncMetricLogging en [MetricLogging].)
SchedulerMetricThreads 100 Tamaño del grupo de subprocesos del planificador de métricas.
ProcessEngineMetricThreads Valor de MaxNumberOfWorkerThreads en [ProcessEngine] Tamaño del grupo de subprocesos del motor de procesos de métricas.
OperationEngineMetricThreads (Ninguno) Si RunOperationsInSeparateProcess=true, usa esta cantidad de subprocesos del grupo de subprocesos.

[APIInfo]

Este parámetro se aplica a las operaciones activadas por una API OData de API Manager.

Clave Predeterminado Descripción
DebugJDML false Si es true, permite un registro adicional de las llamadas de API OData en API Manager, incluido el SQL enviado a la base de datos.

[APIOperation]

Estas configuraciones se aplican a operaciones activadas por un API personalizada o API OData del Administrador de API.

Clave Predeterminado Descripción
EnableErrorLogging true Registra solo errores de operaciones de API en los registros de operaciones. Se ignora si EnableLogging es true.
EnableLogging false Registra todas las operaciones activadas por API (tanto exitosas como fallidas) en los registros de operaciones. Esto proporciona control a nivel de agente similar a habilitar registro de depuración de operaciones en operaciones individuales. Si es true, tiene prioridad sobre EnableErrorLogging. Para más detalles sobre el registro de operaciones de API, consulta Datos de solicitud y respuesta de API.
EnableOperationIdLogging false Registra el ID de una operación que causa un bloqueo.
APIOperationLogging false Registra la hora de inicio y el tiempo transcurrido de una llamada de API.

Caution

Turning on this setting generates at least four additional lines for each API operation, which can result in very large log files.

[AutoScaling]

Clave Predeterminado Descripción
DeregisterAgentOnDrainstop false Anula el registro cuando el agente se detiene. Equivalente a deregisterAgentOnDrainstop en register.json.
DeregisterAgentOnJVMShutdown true Desactiva la anulación del registro al apagar la JVM si la anulación del registro está habilitada mediante registro automático o DeregisterAgentOnDrainstop.

[ConnectorsInfo]

Clave Predeterminado Descripción
MSAXUrl http://127.0.0.1:8002/AX/ Utilizado por el conector Conector de Microsoft Dynamics AX. No cambies a menos que el soporte de Jitterbit te lo indique.
MSCrmUrl http://127.0.0.1:8000/CRM/ Utilizado por el conector Conector de Microsoft Dynamics CRM. No cambies a menos que el soporte de Jitterbit te lo indique.
jitterbit.connectorcall.timeout 300 Tiempo de espera de llamada de conector (segundos) para ciertos conectores. No cambies a menos que el soporte de Jitterbit te lo indique.
jitterbit.connector.disable.file.watcher false Si es true, desactiva el monitor de archivos del conector. No cambies a menos que el soporte de Jitterbit te lo indique.
jitterbit.connector.max.recent.connector.lookup 15 Número máximo de sumas de verificación md5 de conectores a mantener. (Si la suma de verificación de un nuevo conector coincide con una existente, se omite la descarga.)
jitterbit.connector.max.temp.file.write.attempts 30 Número máximo de intentos para mover un archivo temporal de conector.

[DbDrivers]

Esta sección especifica los caracteres especiales predeterminados utilizados para delimitar nombres en algunos controladores utilizados por el conector de Base de datos. Los delimitadores admitidos incluyen: / . \* = ? | ( ) [ ] { }.

Las claves y los valores se citan entre comillas simples, y los caracteres especiales se escapan con \.

Clave Predeterminado
DataDirect 32-BIT SequeLink 5.4 Quote Begin \"
DataDirect 32-BIT SequeLink 5.4 Quote End \"
Excel Quote Begin [
Excel Quote End ]
IBM DB2 (AS400) Quote Begin \"
IBM DB2 (AS400) Quote End \"
Microsoft Access Driver (*.mdb) Quote End ]
Microsoft Excel Driver (*.xls) Quote Begin [
Microsoft Excel Driver (*.xls) Quote End ]
Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb) Quote Begin [
Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb) Quote End ]
Microsoft ODBC for Oracle Quote Begin \"
Microsoft ODBC for Oracle Quote End \"
Microsoft Quote Begin [
MySQL ODBC 3.51 Driver Quote Begin `
MySQL ODBC 3.51 Driver Quote End `
MySQL ODBC 5.1 Driver Quote Begin `
MySQL ODBC 5.1 Driver Quote End `
MySQL Quote Begin `
MySQL Quote End `
Oracle ODBC Driver Quote Begin \"
Oracle ODBC Driver Quote End \"
Oracle Quote Begin \"
Oracle Quote End \"
Oracle in OraClient10g_home2 Quote Begin \"
Oracle in OraClient10g_home2 Quote End \"
Oracle in XE Quote Begin \"
Oracle in XE Quote End \"
PostgreSQL ANSI Quote Begin \"
PostgreSQL ANSI Quote End \"
PostgreSQL Quote Begin \"
PostgreSQL Quote End \"
PostgreSQL Unicode Quote Begin \"
PostgreSQL Unicode Quote End \"
PostgreSQL-psql Quote Begin \"
PostgreSQL-psql Quote End \"
SQL Server Quote Begin [
SQL Server Quote End ]

[DbInfo]

Key Default Description
User jitterbit Nombre de usuario para la base de datos PostgreSQL local.
DisableOdataCount false Desactiva la configuración $count e $inlinecount en consultas OData entrantes. Establece en true si la funcionalidad de conteo de la base de datos causa problemas de rendimiento.
Password None Contraseña para la base de datos PostgreSQL local. Cada instalación genera una contraseña nueva, incluso en el mismo host. La contraseña en la imagen de Docker Hub cambia entre versiones y es la misma para todos los contenedores basados en una imagen.
Driver 'PostgreSQL Unicode(x64)' Valor predeterminado de Windows.
'PostgreSQL-jitterbit' Valor predeterminado de Linux.
SystemDbName 'postgres' Nombre de la base de datos del sistema PostgreSQL.
Server 127.0.0.1 Nombre de host o dirección IP del servidor PostgreSQL.
Port 6432 Puerto predeterminado del servidor PostgreSQL. (6543 en agentes privados versión 10.60 o anterior.)
UseInternalPooling true Si es true, habilita la agrupación de conexiones de base de datos interna para optimizar el rendimiento del agente. (Esto agrupa solo la base de datos interna del agente; para la agrupación de conexiones de base de datos de origen y destino, consulta [SourceTargetPooling].)
  • Windows, instalación nueva (agente 12.5 y posterior): El instalador escribe esta clave con un valor de true.
  • Windows, actualización (a agente 12.5 y posterior): Si la clave no está ya definida en el archivo, el instalador pregunta si deseas habilitarla.
  • Linux (agente 12.9 y posterior): Si la clave no está en el archivo, el valor predeterminado es true.
  • Todos los demás casos: Si la clave no está presente, se aplica false.

[Debug]

Key Default Description
WebServiceDebugFile '' Ruta absoluta al archivo de depuración de servicios web de backend. Si es una cadena vacía, el registro se desactiva. La ruta debe usar barras diagonales hacia adelante, incluso en Windows. El directorio debe existir y tener permisos de lectura-escritura para el agente.

[ErrorHandling]

Esta sección configura cómo manejar posibles situaciones de error en el backend. Los valores posibles son:

  • Ok: La situación es normal; continúa como de costumbre.
  • Warning: Registra una advertencia y continúa.
  • Error: La situación es fatal.
Key Default Description
NoRowsAffectedOnDbUpdates Ok Una sentencia de actualización en un destino de base de datos que no afecta ninguna fila es Ok según la definición anterior.
NoTargetDataGenerated Ok No se generó datos de destino es Ok según la definición anterior.
NoWebServiceRequestData Warning No hay datos disponibles para generar una solicitud de servicio web válida genera una Warning según la definición anterior.
EmptyDatabaseSource Warning Un origen de base de datos plano vacío genera una Warning según la definición anterior.

[FileCleanup]

Key Default Description
AutoStart true Inicia las rutinas de limpieza de archivos.
SleepTimeInSeconds 5 Tiempo de espera de limpieza de archivos (segundos).
FrequencyInHours 24.0 Intervalo de limpieza de archivos (horas).

[HttpConnectionPool]

Esta sección se utiliza con configuración de proxy para llamar a recursos externos.

Key Default Description
MaxConnections 50 Número máximo de conexiones totales a mantener en el grupo. Si es 0 o menor, se utiliza el valor predeterminado de la biblioteca Apache HttpClient.
MaxConnectionsPerRoute 5 Número máximo de conexiones por ruta. Si es 0 o menor, se utiliza el valor predeterminado de la biblioteca Apache HttpClient.
TimeoutInSeconds 60 Tiempo de espera de conexión del grupo (segundos). Si es 0 o menor, se utiliza el valor predeterminado de la biblioteca Apache HttpClient.
HttpSocketTimeoutInSeconds 180 Tiempo de espera del socket del cliente (segundos), el tiempo que el socket del cliente espera una respuesta después de establecer la conexión y enviar una solicitud. Si es 0 o menor, se utiliza el valor predeterminado de la biblioteca Apache HttpClient.
HttpConnectionTimeoutInSeconds 180 Tiempo de espera (segundos) para esperar la conexión con el host remoto.

[HttpConnectionPoolLocal]

Esta sección se utiliza con recursos locales (servicios SOAP, API).

Key Default Description
MaxConnections 50 Número máximo de conexiones totales a mantener en el grupo. Si es 0 o menor, se utiliza el valor predeterminado de la biblioteca Apache HttpClient.
MaxConnectionsPerRoute 50 Número máximo de conexiones por ruta. Si es 0 o menor, se utiliza el valor predeterminado de la biblioteca Apache HttpClient.
TimeoutInSeconds 60 Tiempo de espera de conexión del grupo (segundos). Si es 0 o menor, se utiliza el valor predeterminado de la biblioteca Apache HttpClient.
HttpSocketTimeoutInSeconds 180 Tiempo de espera del socket del cliente (segundos) (tiempo que el socket del cliente espera una respuesta después de establecer la conexión y enviar una solicitud). Si es 0 o menor, se utiliza el valor predeterminado de la biblioteca Apache HttpClient.
HttpConnectionTimeoutInSeconds 180 Tiempo de espera (segundos) para esperar la conexión con el host remoto.

Consejo

Si estableces MaxConnections y MaxConnectionsPerRoute en 100, realiza estos cambios adicionales:

  1. Edita el archivo jitterbit-agent-config.properties y establece:

    max.concurrent.requests=100

  2. Edita el archivo httpd.conf y establece:

    ThreadsPerChild 101

[HttpEndPoints]

Clave Predeterminado Descripción
EnableErrorLogging true Registra errores de llamadas de punto de conexión HTTP alojado en el registro de operaciones. Se ignora cuando EnableLogging es true.
EnableLogging true Registra todas las llamadas de punto de conexión HTTP alojado en el registro de actividades.

[JavaBackend]

Clave Predeterminado Descripción
DebugLogLevel (Ninguno) Nivel de registro de depuración de Tomcat (SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST, OFF, ALL). Los registros del servidor Tomcat se escriben en JITTERBIT_HOME/tomcat/logs. Consulta CleanupRules.xml para los períodos de purga de archivos de registro.

[JavaUiBackend]

Clave Predeterminado Descripción
LogLevel OFF Nivel de registro de Java (Tomcat) UI (SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST, OFF, ALL). Los registros del servidor Tomcat se escriben en JITTERBIT_HOME/tomcat/logs. Consulta CleanupRules.xml para los períodos de purga de archivos de registro.

[JDBCEngine]

Clave Predeterminado Descripción
SessionTimeout 60 Tiempo de espera de sesión JDBC abierta (minutos).
ClientSessionTimeout 180 Tiempo máximo de operación JDBC (minutos).
LogLevel INFO Nivel de registro del motor JDBC (SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST, OFF, ALL). Los registros del servidor Tomcat se escriben en JITTERBIT_HOME/tomcat/logs. Consulta CleanupRules.xml para los períodos de purga de archivos de registro.

[JdbcSecurity]

Esta sección se agregó en la versión 12.10 del agente. Restringe las cadenas de conexión JDBC y las conexiones del conector de base de datos por seguridad.

Clave Predeterminado Descripción
block.localhost.connections true Bloquea una conexión de base de datos a localhost o 127.0.0.1 cuando es true. Establece en false para permitir una conexión de base de datos a una base de datos que se ejecuta en el mismo host que el agente.
mysql.blocked.params Ver abajo Parámetros de cadena de conexión JDBC de MySQL que siempre se rechazan.
mysql.forced.false.params Ver abajo Parámetros de cadena de conexión JDBC de MySQL que se rechazan si se establecen en true en la cadena de conexión.
postgresql.blocked.params Ver abajo Parámetros de cadena de conexión JDBC de PostgreSQL que siempre se rechazan.
oracle.blocked.params Ver abajo Parámetros de cadena de conexión JDBC de Oracle que siempre se rechazan.
sqlserver.blocked.params Ver abajo Parámetros de cadena de conexión JDBC de SQL Server que siempre se rechazan.

Lo siguiente muestra la sección completa con sus valores predeterminados. Para permitir una conexión o parámetro específico mientras se mantiene el resto restringido, cópialo y elimina ese parámetro del valor de la clave correspondiente:

[JdbcSecurity]
block.localhost.connections=true
mysql.blocked.params=queryinterceptors,statementinterceptors,propertiestransform,socketfactory,socksproxyhost
mysql.forced.false.params=allowLoadLocalInfile,allowLocalInfile,allowUrlInLocalInfile,autoDeserialize,allowMultiQueries
postgresql.blocked.params=socketfactory,socketfactoryarg,sslfactory,sslfactoryarg,sslhostnameverifier,sslpasswordcallback,authenticationpluginclassname,loggerfile,loggerlevel
oracle.blocked.params=oracle.net.tns_admin,oracle.net.wallet_location
sqlserver.blocked.params=socketfactoryclass

Para permitir todos los parámetros de una clave, establece su valor como vacío (por ejemplo, mysql.blocked.params=).

Advertencia

Comentar una de las cinco claves *.blocked.params o *.forced.false.params (con un # al inicio) no restaura su restricción predeterminada. Tiene el mismo efecto que establecer la clave en un valor vacío: todos los parámetros de esa clave se permiten. Para restaurar la restricción predeterminada después de agregar esta sección, elimina la línea de la clave por completo, o comenta la línea [JdbcSecurity] en sí, lo que restaura todas las claves de la sección a sus valores predeterminados.

[JsonParser]

Esta sección se agregó en la versión 12.5 del agente.

Clave Predeterminado Descripción
MaxStringLength 20000000 Número máximo de caracteres permitidos en un valor de cadena JSON individual. Las operaciones que procesan cadenas JSON que exceden este límite fallan con un error StreamConstraintsException. Aumenta este valor si necesitas procesar cargas JSON más grandes (por ejemplo, establécelo en 50000000 para un límite de 50 MB).

[LDAP]

Usa esta sección para agregar compatibilidad UTF-8 para Microsoft Windows y Active Directory con agentes privados de Windows.

Clave Predeterminado Descripción
CharacterEncoding ISO-8859-1 Codificación de caracteres LDAP.

Consejo

Si usas la función LDAPReplace() para reemplazar un valor en Active Directory como se muestra a continuación, es posible que encuentres que el texto se convierte a un resultado diferente al de la entrada, como que François se reemplace con FrançOis:

LdapReplace("givenName", "François");

En casos como este, agrega esta sección y reinicia el agente.

Para más información, consulta Funciones LDAP de Studio o Funciones LDAP de Design Studio.

[Masking]

Esta sección se agregó en la versión 11.59 / 12.3 del agente. Estos parámetros se pueden usar para enmascarar encabezados de solicitud personalizados en actividades HTTP de Studio y orígenes HTTP de Design Studio y destinos. Cuando se enmascara un encabezado de solicitud, los valores enmascarados aparecen como ***REDACTED*** dentro de los registros de tiempo de ejecución.

Clave Predeterminado Descripción
HttpRequestHeaders true Si es false, los encabezados de solicitud proporcionados en RequestHeaders no se enmascaran.
RequestHeaders Lista separada por comas de encabezados de solicitud personalizados a enmascarar (por ejemplo, security_key,test_header,test_header2).

Ten en cuenta que los siguientes encabezados de solicitud ya están enmascarados de forma predeterminada en los registros de tiempo de ejecución y no requieren usar estos parámetros:

Categoría Nombre del encabezado
Autenticación y tokens authorization
proxy-authorization
x-api-key
x-auth-token
x-access-token
x-refresh-token
x-session-token
x-id-token
x-client-secret
Cookies y CSRF cookie
x-csrf-token
x-xsrf-token
PII (GDPR / CCPA) x-user-id
x-user-email
x-user-name
x-user-phone
x-user-address
x-customer-id
x-employee-id
x-national-id
x-date-of-birth
x-ip-address
x-forwarded-for
x-real-ip
x-originating-ip
Pago (PCI-DSS) x-card-number
x-card-cvv
x-card-expiry
x-bank-account
x-payment-token
Salud (HIPAA) x-patient-id
x-medical-record
x-health-plan-id
x-diagnosis-code
Enrutamiento interno y rastreo x-internal-ip
x-backend-server
x-cluster-node
x-request-id
x-correlation-id

[MetricLogging]

Importante

Esta sección está deprecada a partir de la versión 11.41 del agente privado y se eliminará en una versión posterior. Las claves se han movido a la sección [AgentMetrics], y algunas claves han sido renombradas. Consulta esa sección para más detalles.

Clave Predeterminado Descripción
EnableAgentMetricLogging false Si es true, se habilita el registro de métricas del agente.
EnableAgentMetricAsyncLogging true Si es true, el registro se realiza de forma asincrónica. No cambies a menos que el soporte de Jitterbit te lo indique.
EnableAgentSyncMetricLogging Si es true, se habilita el registro de métricas sincrónicas.
SchedulerMetricThreads 100 Tamaño del grupo de subprocesos del programador de métricas.
ProcessEngineMetricThreads Valor de MaxNumberOfWorkerThreads en [ProcessEngine] Tamaño del grupo de subprocesos del motor de procesos de métricas.
OperationEngineMetricThreads (Ninguno) Si RunOperationsInSeparateProcess=true, utiliza esta cantidad de subprocesos del grupo de subprocesos.

[OperationEngine]

Clave Predeterminado Descripción
Debug false Habilita el modo de depuración. Tanto el valor Debug como WriteLog deben establecerse en 1 para que se generen registros.
AlwaysRunSuccessOperation false Ejecuta siempre las operaciones correctamente incluso si no hay datos.
TemporaryStorageRootDirectory (Ninguno) Ruta absoluta al directorio raíz de almacenamiento temporal. Si no se especifica, se utiliza TemporaryStorage anexado al valor de TempDir (C:\Windows\Temp\jitterbit\TemporaryStorage para Windows, /tmp/jitterbit/TemporaryStorage para Linux). La ruta debe usar barras diagonales hacia adelante, incluso en Windows. El directorio debe existir y tener permisos de lectura-escritura para el agente.
MaxNumberOfOperationThreads (Ninguno) Número máximo de subprocesos de operación. Si no se especifica, el número de subprocesos de operación es ilimitado.
MaxOperationStackDepth 50 Número máximo de llamadas de operación sincrónica anidadas. Si es 0 o un número negativo, el máximo es ilimitado.
MaxAsyncOperationChainLength 50 Número máximo de operaciones asincrónicas permitidas en una sola cadena (para evitar bucles de operación infinitos). Si es 0 o un número negativo, el máximo es ilimitado.
MaxAsyncOperationChainLengthOverrideAllowed true Anula la longitud máxima de la cadena de operación asincrónica estableciendo la variable Jitterbit jitterbit.operation.max_async_chain_length.
MaxSynchronousRunOperationCallsInLoop 50 (Agregado en 12.11.) Número máximo de llamadas sincrónicas a RunOperation permitidas desde dentro de un solo bucle While. Si es 0 o un número negativo, el máximo es ilimitado.
MaxSynchronousRunOperationCallsInLoopOverrideAllowed true (Agregado en 12.11.) Anula el número máximo de llamadas sincrónicas a RunOperation permitidas en un bucle estableciendo la variable Jitterbit jitterbit.operation.max_sync_runop_calls_in_loop. Establécelo en false para bloquear el límite a nivel de configuración del agente.
MaxSynchronousRunOperationCallsInLoopCustomError (Ninguno) (Agregado en 12.11.) Texto de error personalizado para mostrar en lugar del mensaje generado predeterminado cuando se alcanza el límite. Encierra el mensaje entre comillas simples; de lo contrario, se trunca en el primer carácter de espacio en blanco.
AlwaysDeleteTempDir false Elimina archivos temporales, incluso en caso de error.

Precaución

Cuando se habilita el registro de depuración de operaciones, establecer este valor en true causará que los datos de entrada y salida de componentes no se generen, ya que los archivos temporales de operaciones se eliminarán antes de que el servicio Verbose Log Shipper pueda capturarlos.
WriteLog 0 Habilita (1) o deshabilita (0) mensajes de proceso adicionales tanto para operaciones de API como programadas para escribirse en el archivo de registro.

[PredefinedGlobalVariables]

Cualquier variable de Jitterbit se puede configurar en esta sección para aplicarse en todo el grupo de agentes de forma predeterminada. Para configurar una variable de Jitterbit a nivel de operación, consulta Establecer variables de Jitterbit en scripts o transformaciones.

La tabla siguiente enumera ejemplos de variables de Jitterbit que se pueden configurar en esta sección. Esta lista no es exhaustiva; consulta la documentación de variables de Jitterbit para cada variable individual para obtener la descripción de cada una.

Clave Predeterminado Descripción
jitterbit.http.enable_cookies false Habilita cookies para conexiones HTTP.
jitterbit.scripting.db.auto_commit true Confirma automáticamente scripts de base de datos. Si es false, utiliza transacciones de base de datos.
jitterbit.scripting.db.max_rows 10000 Número máximo de filas de base de datos afectadas. Se aplica a DBExecute, DBLookup y DBLookupAll funciones de base de datos de Studio o funciones de base de datos de Design Studio.
jitterbit.scripting.ldap.include_dn_in_results false Si es true, incluye el nombre distinguido (DN) en Active Directory.
jitterbit.scripting.ldap.max_search_results 1 Número máximo de resultados de búsqueda LDAP devueltos.
jitterbit.scripting.ldap.return_null_if_no_results false Si es true, las consultas LDAP sin registros coincidentes devuelven un único valor NULL.
jitterbit.scripting.ldap.scope 1 Habilita (1) o deshabilita (0) LDAP.
jitterbit.scripting.ldap.use_paged_search false Habilita búsqueda LDAP paginada en scripts. Si es true, Jitterbit recupera datos en páginas y evita exceder los límites de Active Directory.
jitterbit.scripting.nesting.max 10 Número máximo de scripts anidados.
jitterbit.scripting.while.max_iterations 50000 Límite de iteración de scripts de Jitterbit.
jitterbit.source.db.preserve_char_whitespace false Preserva los espacios en blanco de caracteres iniciales y finales de la base de datos de origen.
jitterbit.source.ftp.transfer_timeout 3600 Tiempo de espera de transferencia FTP de origen (segundos).
jitterbit.source.text.csv_nullable false Permite valores nulos en archivos de texto CSV.
jitterbit.target.db.include_null_in_sql_statement false Incluye nulo en las sentencias SQL de la base de datos de destino.
jitterbit.target.ftp.transfer_timeout 3600 Tiempo de espera de transferencia FTP de destino (segundos).
jitterbit.target.http.remove_trailing_linebreaks true Elimina saltos de línea finales antes de publicar datos de destino.
jitterbit.target.xml.num_for_bool false Si es true, representa valores booleanos XML como 0 y 1. Si es false, utiliza false y true.

[PredefinedServerGlobalDataElement]

Clave Predeterminado Descripción
(Definido por el usuario) (Definido por el usuario) Variables globales predefinidas personalizadas que se inicializan para cualquier operación que se inicia en el agente.

[ProcessEngine]

Clave Predeterminado Descripción
MaxNumberOfWorkerThreads auto Número de subprocesos de trabajo (1 a 200). Cuando es auto, el número es el doble del número de núcleos del procesador.
RunOperationsInSeparateProcess true Si es true, el tiempo de ejecución de la operación es ilimitado. Usa MaxOperationRuntimeSeconds para establecer un límite de tiempo de ejecución.
MaxOperationRuntimeSeconds (Ninguno) Tiempo máximo de ejecución de la operación (segundos). Se ignora si RunOperationsInSeparateProcess es false.
MaxOperationRuntimeMessage (Ninguno) Mensaje que se muestra cuando se alcanza el límite de tiempo de ejecución. Se ignora si RunOperationsInSeparateProcess es false.
EnableDebugDump false Si no se especifica, DebugDumpDir usará de forma predeterminada la configuración TempDir en [Settings].
DebugDumpDir (Ninguno) Ruta absoluta al directorio de volcado de depuración. Si no se establece, se usa el valor de TempDir. Se ignora a menos que EnableDebugDump sea true. La ruta debe usar barras diagonales hacia adelante, incluso en Windows. El directorio debe existir y tener permisos de lectura-escritura para el agente.

[ResultFiles]

Clave Predeterminado Descripción
DisableSuccess false Crear archivos de éxito.
DisableFailure false Crear archivos de error.

[Scheduler]

Clave Predeterminado Descripción
AutoStart 1 Habilitar (1) o deshabilitar (0) el inicio automático del programador.
SleepTimeInSeconds 5 Tiempo de espera (segundos).
WriteLog 0 Habilitar (1) o deshabilitar (0) el registro de depuración del programador. El archivo de registro está en scheduler_debug.log en el directorio especificado por el valor de TempDir.

[Settings]

Clave Predeterminado Descripción
TempDir (Ninguno) Ruta absoluta a un directorio temporal. Si está en blanco, los archivos temporales usan el directorio temporal del sistema operativo (%temp%\jitterbit en Windows, /tmp/jitterbit en Linux). La ruta debe usar barras diagonales hacia adelante, incluso en Windows. El directorio debe existir y tener permisos de lectura-escritura para el agente.
CurlDebugDir (Ninguno) Ruta absoluta al archivo de registro de curl para solicitudes FTP, SFTP, HTTP y HTTPS. Se crea un archivo por solicitud. Los nombres de archivo de registro son GUID con extensión .txt. La ruta debe usar barras diagonales hacia adelante, incluso en Windows. El directorio debe existir y tener permisos de lectura-escritura para el agente.
CurlDefaultSSLVersionMax true Si es true, usa la opción --tls-max (se aplica a curl 7.54.0 y superior).
EnableLocalFileLocation false Permitir la creación de archivos locales. Necesario para el conector Almacenamiento local, archivos de activación o carpetas de éxito/error configuradas en otros conectores.
JavaScriptMaxIterations 50000 Número máximo de iteraciones de bucle permitidas por script.
RecoverableStatusCode 500, 502, 503, 504 Cuando se establece y se selecciona la opción Reintentar en una conexión HTTP, la actividad se recupera de los códigos de error listados e intenta nuevamente la actividad.
EnableAPITimeout false Si es true, las operaciones activadas por API Manager usarán la configuración de tiempo de espera de operación.
TargetHttpRemoveTrailingLinebreaks false Si es true, elimina el CR/LF al final de las líneas en las transformaciones posteriores del conector HTTP.
AllowUnsafeLegacyRenegotiation false Si es true, permite la renegociación TLS heredada no segura durante el protocolo de enlace de conexión con el servidor. Necesario para evitar el error error:0A000152:SSL routines::unsafe legacy renegotiation disabled. Compatible con agentes versión 11.39 y posterior.
RollbackRetryEnabled true Si es true, el agente reintenta una inserción de base de datos interna incluso después de una reversión fallida, coincidiendo con el comportamiento predeterminado usado antes de que esta configuración se introdujera en la versión 11.49 del agente. Si es false, la inserción no se reintenta después de una reversión fallida, evitando la reinserción de datos de la transacción rota. No cambies a menos que el soporte de Jitterbit te lo indique.

[Settings/XMLSchemas]

Estas configuraciones definen las ubicaciones de los esquemas XML disponibles.

Clave Predeterminado
Schema_2001 JITTERBIT_HOME/DataInterchange/xml_dtd/Schemas/XMLSchema_2001.xsd
Schema_1999 JITTERBIT_HOME/DataInterchange/xml_dtd/Schemas/XMLSchema_1999.xsd
SoapEncoding JITTERBIT_HOME/DataInterchange/xml_dtd/Schemas/SOAP_Encoding.xsd
WSDL JITTERBIT_HOME/DataInterchange/xml_dtd/Schemas/WSDL.xsd
SoapEncoding_v11 JITTERBIT_HOME/DataInterchange/xml_dtd/Schemas/SOAP_Encoding_v11.xsd
SoapEncoding_v12 JITTERBIT_HOME/DataInterchange/xml_dtd/Schemas/SOAP_Encoding_v12.xsd

[SMTPClient]

Clave Predeterminado Descripción
DefaultSMTPServers (Ninguno) Lista separada por comas de servidores SMTP a usar cuando se envía un mensaje de correo electrónico y el usuario no especifica servidores SMTP.
DefaultFromEmail (Ninguno) Dirección de correo electrónico a usar en el campo De si el usuario no especifica ninguna.
DefaultAccount (Ninguno) Nombre de usuario para servidores SMTP que requieren autenticación.
DefaultAccountPassword (Ninguno) Contraseña para servidores SMTP que requieren autenticación.
UseSSL (Ninguno) Si es true, el servidor SMTP requiere SSL/TLS.

Nota

Los puntos de conexión creados mediante la función SendSystemEmail con DefaultSMTPServers se incluyen en reportes de uso de puntos de conexión y cuentan hacia tu licencia.

[SourceTargetPooling]

Estas configuraciones establecen el agrupamiento de conexiones para conexiones de base de datos de origen y destino, utilizadas por una conexión de base de datos en Studio o un origen y destino de base de datos en Design Studio. El agrupamiento reutiliza conexiones JDBC en todas las operaciones en lugar de abrir y cerrar una nueva conexión cada vez, lo que reduce la sobrecarga de conexión y el riesgo de tiempo de espera bajo carga concurrente. Esto es independiente del agrupamiento de la propia base de datos interna del agente (consulta [DbInfo] UseInternalPooling). Disponible con la versión del agente 12.11 y posteriores.

Clave Predeterminado Descripción
jdbc.hikari.enabled false Si es true, habilita el agrupamiento de conexiones. Si es false, las conexiones usan el mismo comportamiento que las versiones del agente anteriores a 12.11: abrir y cerrar una nueva conexión para cada operación.
jdbc.hikari.maximumPoolSize 5 Máximo de conexiones por grupo.
jdbc.hikari.minimumIdle 0 Número mínimo de conexiones inactivas que HikariCP intenta mantener en el grupo. Con el valor predeterminado de 0, se crean conexiones bajo demanda en lugar de precalentarlas.
jdbc.hikari.connectionTimeout 30000 Tiempo máximo (milisegundos) para esperar una conexión del grupo antes de fallar. Esto es independiente de la configuración Tiempo de espera (seg) en una conexión de base de datos en Studio o un origen y destino de base de datos en Design Studio, que continúa limitando el intento de conexión subyacente siempre que el grupo crea una nueva conexión física.
jdbc.hikari.idleTimeout 300000 Tiempo máximo (milisegundos) que una conexión puede permanecer inactiva en el grupo antes de ser retirada.
jdbc.hikari.maxLifetime 1800000 Tiempo de vida máximo (milisegundos) de una conexión agrupada antes de ser retirada, incluso si está en uso.
jdbc.hikari.connectionTestQuery (Ninguno) Consulta utilizada para validar una conexión antes de que se devuelva del grupo. Se deja en blanco de forma predeterminada, lo que utiliza el método de validación propio del controlador JDBC en lugar de una consulta fija. Anular esto aplica la misma consulta a todas las bases de datos que usan este grupo.
jdbc.hikari.validationTimeout 5000 Tiempo máximo (milisegundos) para esperar a que se complete jdbc.hikari.connectionTestQuery.
jdbc.hikari.leakDetectionThreshold 0 Si se establece por encima de 0, milisegundos que una conexión puede estar extraída antes de que HikariCP registre una posible advertencia de fuga de conexión con un seguimiento de pila. 0 desactiva la detección de fugas.
jdbc.hikari.poolEvictionThresholdMinutes 60 Minutos que un grupo puede permanecer inactivo sin conexiones activas antes de ser elegible para evicción. 0 desactiva la evicción.
jdbc.hikari.poolNamePrefix JitterbitSourceTarget Prefijo utilizado para nombrar grupos en registros y monitoreo JMX.
jdbc.hikari.poolStatsEnabled true Si es true, registra estadísticas por grupo (conexiones activas, inactivas, totales y en espera) en el cronograma de mantenimiento periódico establecido por jdbc.hikari.statsInitialDelayMinutes y jdbc.hikari.statsIntervalMinutes. Esta configuración solo controla las líneas por grupo; una línea de estadísticas de grupo de conexión agregada separada se registra en el mismo cronograma independientemente de esta configuración.
jdbc.hikari.statsInitialDelayMinutes 5 Minutos después del inicio del agente antes de la primera ejecución de mantenimiento periódico (registro de estadísticas y evicción de grupos inactivos).
jdbc.hikari.statsIntervalMinutes 5 Minutos entre ejecuciones de mantenimiento periódico después de la primera. Debe ser un número positivo; 0 o un número negativo vuelve al valor predeterminado en lugar de desactivar el cronograma.
jdbc.hikari.connStatsSampleRate 1 Registra 1 de cada \(N\) solicitudes de conexión exitosas por entidad de base de datos, para reducir el volumen de registro. 1 registra cada solicitud. Las solicitudes de conexión fallidas siempre se registran, independientemente de esta configuración.

[SSH]

Clave Predeterminado Descripción
PublicKeyFile (Ninguno) Ruta absoluta a tu clave pública. La ruta debe usar barras diagonales hacia adelante, incluso en Windows. El directorio debe existir y tener permisos de lectura-escritura para el agente. Establece los permisos del archivo como solo lectura para el usuario de Jitterbit.
PrivateKeyFile (Ninguno) Ruta absoluta a tu clave privada. La ruta debe usar barras diagonales hacia adelante, incluso en Windows. El directorio debe existir y tener permisos de lectura-escritura para el agente. Establece los permisos del archivo como solo lectura para el usuario de Jitterbit.
PrivateKeyPassphrase (Ninguno) Frase de contraseña de la clave privada. Establece los permisos del archivo como solo lectura para el usuario de Jitterbit.
Conjuntos adicionales (Ninguno) Configurado por el usuario.

Conjuntos adicionales

Para conjuntos adicionales, agrega un sufijo (por ejemplo XXX) a estas claves (para crear PublicKeyFileXXX, PrivateKeyFileXXX, PrivateKeyPassphraseXXX), luego haz referencia a ellas en variables de script de Jitterbit con $jitterbit.source.sftp.ssh_key_id="XXX" o $jitterbit.target.sftp.ssh_key_id="XXX".

[SSL]

Clave Predeterminado Descripción
CertificateFile (Ninguno) Ruta absoluta a tu archivo de certificado de cliente SSL. La ruta debe usar barras diagonales hacia adelante, incluso en Windows. El directorio debe existir y tener permisos de lectura-escritura para el agente. Solo se admiten certificados y claves en formato PEM. Establece los permisos del archivo como solo lectura para el usuario de Jitterbit.
PrivateKeyFile (Ninguno) Ruta absoluta a tu clave privada. La ruta debe usar barras diagonales hacia adelante, incluso en Windows. El directorio debe existir y tener permisos de lectura-escritura para el agente. Solo se admiten certificados y claves en formato PEM. Establece los permisos del archivo como solo lectura para el usuario de Jitterbit.
PrivateKeyPassphrase (Ninguno) Frase de contraseña de la clave privada. La ruta debe usar barras diagonales hacia adelante, incluso en Windows. El directorio debe existir y tener permisos de lectura-escritura para el agente. Solo se admiten certificados y claves en formato PEM. Establece los permisos del archivo como solo lectura para el usuario de Jitterbit.
Conjuntos adicionales (Ninguno) Configurado por el usuario.

Conjuntos adicionales

Para conjuntos adicionales, agrega un sufijo (por ejemplo YYY) a estas claves (para crear CertificateFileYYY, PrivateKeyFileYYY, PrivateKeyPassphraseYYY), luego haz referencia a ellas en variables de script de Jitterbit con $jitterbit.target.http.ssl_cert_id = "YYY";, $jitterbit.source.http.ssl_cert_id = "YYY";, o $jitterbit.web_service_call.ssl_cert_id = "YYY";.

[TraceLogging]

Clave Predeterminado Descripción
tracelog.shipper.enabled false Si es true, habilita el registro de seguimiento del motor de operaciones en el agente.

[TransformationEngine]

Clave Predeterminado Descripción
WriteLog false Registro de depuración de transformación detallado. Si es true, se establece Debug en [OperationEngine] en true.
WriteLogDir (Ninguno) Ruta absoluta al directorio de registro. Si no se especifica, los registros se escriben en JITTERBIT_HOME/DataInterchange/Temp/Debug. Se ignora a menos que WriteLog sea 1. La ruta debe usar barras diagonales hacia adelante, incluso en Windows. El directorio debe existir y tener permisos de lectura-escritura para el agente.
ValidateXML true Validación XML.
LdapEnableAutoUpdateMode false Habilitar modo de actualización automática de LDAP.
TimingOn false Habilitar (1) o deshabilitar (0) globalmente la generación de perfiles de archivo. Los archivos se escriben en JITTERBIT_HOME/DataInterchange/Temp/LOG.
AutoStreaming true Transmisión automática de transformación.
UseOldRuleForLoopOneOfXmlNode false (Usar para compatibilidad con versiones anteriores.)
AutoXsiNil false Establece el atributo xsi:nil="true" para elementos que son obligatorios y no están asignados en transformaciones.
DefaultEntityResolution true Habilitar análisis de tipos de IDoc.

[VerboseLogging]

Esta sección se utiliza para la generación de datos de entrada y salida de componentes cuando el registro de depuración de operaciones está habilitado en una operación individual de Studio.

Los datos de entrada y salida de componentes se registran en la nube de Harmony, a menos que verbose.logging.enable esté configurado en false. La configuración para el registro en la nube no tiene efecto en este tipo de registro.

Esto anula la generación de datos de entrada y salida de componentes cuando Enable Debug Logging Until está configurado en una operación individual de Studio, pero no impide que se generen archivos de registro de depuración de operaciones.

Clave Predeterminado Descripción
verbose.logging.enable true Cuando el registro de depuración de operaciones está habilitado en una operación individual de Studio, escribe datos de entrada y salida de componentes en el registro de operaciones de Studio.
verbose.logging.commpress.folder.path (Ninguno) Comentado. No cambies a menos que el soporte de Jitterbit te lo indique. commpress (dos 'm') es una falta de ortografía conocida de esta propiedad.
verbose.logging.log.folder.path (Ninguno) Comentado. No cambies a menos que el soporte de Jitterbit te lo indique.
verbose.logging.log.file.extension .verbose Se utiliza para el registro de depuración de operaciones. No cambies a menos que el soporte de Jitterbit te lo indique.
verbose.logging.use.dynamic.host.for.collector.url true Se utiliza para el registro de depuración de operaciones. No cambies a menos que el soporte de Jitterbit te lo indique.
verbose.logging.collector.url (Ninguno) URL del servicio de recopilador de registros.

[XsltEngine]

Esta sección se agregó en la versión 12.11 del agente. Restringe las declaraciones DOCTYPE y la resolución de entidades externas al procesar la función RunXSLT, por seguridad.

Clave Predeterminado Descripción
BlockExternalEntities true Bloquea declaraciones de entidades generales y de parámetros externas (por ejemplo, <!ENTITY name SYSTEM "...">) cuando es true.
BlockDtdDeclarations true Bloquea entrada XML que contiene una declaración DOCTYPE cuando es true.
BlockExternalDtd true Bloquea la carga de archivos DTD externos cuando es true.
BlockUriSchemes true Bloquea llamadas document('file://...') y otros esquemas de URI externos dentro de hojas de estilo XSLT cuando es true.

Para permitir este procesamiento, establece la clave correspondiente en false.