Saltar al contenido

Editar el archivo de configuración del agente privado Jitterbit (jitterbit.conf)

Introducción

Si está utilizando un agente privado, puede cambiar ciertas configuraciones para su agente dentro del archivo de configuración de Jitterbit (jitterbit.conf). En esta página se describe cómo realizar dichos cambios, así como las configuraciones disponibles.

Realizar cambios de configuración

Puedes realizar cambios en jitterbit.conf de forma remota a través de la Management Console, o manualmente en el directorio donde está instalado el agente privado.

La edición remota es el método preferido y, al usar este método, es más fácil garantizar la sincronización entre varios agentes dentro de un grupo de agentes y ver los cambios en el archivo de configuración. Si no desea almacenar el contenido de su jitterbit.conf archivo en la nube a través de la Management Console, pero aún así desea realizar cambios en el archivo de configuración, puede hacerlo manualmente.

En cualquier caso, después de haber editado el archivo de configuración, todos los servicios Jitterbit deben reiniciarse para que se realice el cambio de configuración.

Editar de forma remota a través de la Management Console {: #editingtheconfigurationfilejitterbit.conf-remote }La configuración del agente remoto está disponible para los agentes privados versión 8.14 y versiones superiores. Además, debe tener habilitada la configuración del agente remoto para poder realizar cambios en el archivo de configuración de forma remota. Para habilitar la configuración del agente remoto:

  1. Inicie sesión en el portal Harmony y seleccione Management Console.
  2. Haga clic en el menú del portal Harmony en la parte superior izquierda y seleccione Organizaciones.
  3. Dentro de la tabla, seleccione la organización para la que desea habilitar la configuración del agente remoto.
  4. En el extremo derecho de la fila seleccionada, utilice el menú desplegable Acciones para seleccionar Editar políticas de la organización. Debe tener permiso de Administrador para la organización para poder ver esta opción.
  5. En la ventana emergente, marque la casilla de verificación junto a Habilitar configuración del Agente remoto, luego haga clic en Guardar.

Una vez habilitada la configuración del agente remoto, edite el archivo de configuración.

Consejo

Referencia Agentes para todas las opciones disponibles al editar el archivo de configuración de Jitterbit de forma remota.

Advertencia

Cuando habilita la configuración del agente remoto, la configuración actual del agente (excluyendo la información de la base de datos de caché PostgreSQL local y las variables globales predefinidas locales) se leerá y almacenará en la nube para que pueda verla y editarla de forma remota. Una vez que habilite la configuración del agente remoto, cualquier cambio que realice manualmente en la configuración local jitterbit.conf El archivo ubicado en el agente no tendrá efecto.

Para deshabilitar la configuración del agente remoto y poder volver a editar el archivo local jitterbit.conf archivo manualmente, abra Organizaciones, seleccione una organización, seleccione la pestaña Administración de Agente y, luego, deshabilite Configuración de agente remoto. Sin embargo, tenga en cuenta que perderá la configuración de agente remoto actual que se almacenó en la nube. Una vez que se reinicien los servicios de agente, su agente leerá desde la nube local. jitterbit.conf archivo.

Editar manualmente

Aunque es posible editar manualmente el archivo de configuración local de cada agente, este no es el método preferido para realizar cambios de configuración. Consulte Editar de forma remota a través de la Management Console arriba para el método preferido.

El archivo de configuración local se encuentra en el directorio de instalación de la máquina donde está instalado el agente privado. Normalmente se encuentra en una de estas ubicaciones:

  • Windows (Harmony): C:\Program Files (x86)\Jitterbit Agent\jitterbit.conf

  • Windows (v5.x): C:\Program Files (x86)\Jitterbit Integration Server\jitterbit.conf

  • Linux: /opt/jitterbit/jitterbit.conf

Para realizar cambios, abra jitterbit.conf En un editor de texto, edítelo y luego guarde el archivo. Debe tener permisos de administrador del sistema para poder editarlo. jitterbit.conf.

El formato del archivo de configuración es el siguiente:

  • Las secciones se definen mediante líneas individuales que contienen el nombre de la sección entre corchetes. Ejemplo:

    [Section]
    
  • Las claves y los valores se definen mediante un nombre de clave, seguido de un solo signo igual y, a continuación, del valor.

    No debe haber espacios entre la clave, el signo igual y el valor. Ejemplo:

    mykey=myvalue
    
  • Algunos valores pueden requerir comillas simples o dobles. Ejemplo:

    mykey="my value"
    
  • Las claves deben estar en la sección correcta, como se documenta aquí, para que se puedan encontrar y surtan efecto.

  • Los nombres de las secciones y de las claves no distinguen entre mayúsculas y minúsculas.

  • El orden de los elementos dentro de una sección no importa.

  • Los comentarios se pueden indicar con un solo símbolo hash (#) carácter. Cualquier cosa en la línea que sigue a la # Se ignorará.

  • No tiene ninguna línea que contenga un solo hash (#) carácter. Esto hará que se ignore la siguiente línea.

  • Todos los nombres de archivo son relativos a la carpeta del directorio de instalación de inicio a menos que se indique lo contrario.

    Importante

    Utilice barras diagonales para rutas de archivos o directorios incluso en Windows (como C:/Windows/Temp).

Reiniciar los servicios de Jitterbit

Todos los servicios de Jitterbit deben reiniciarse para que la nueva configuración surta efecto.

En la máquina donde está instalado cada agente privado, primero detenga los servicios y luego reinícielos.

Windows Linux
Desde el menú Inicio:

Detener servicios Jitterbit
Iniciar servicios Jitterbit

Desde el directorio de instalación del Agente Jitterbit:

> StopServices.bat
> StartServices.bat

De un mensaje:

$ sudo jitterbit stop
$ sudo jitterbit start

Utilice un archivo de configuración alternativo

Para utilizar un archivo de configuración alternativo, puede (en Windows) iniciar el agente privado desde una línea de comando:

> jitterbit.exe -f c:\config\alt-jitterbit.conf

Actualizar un agente privado

El archivo de configuración se conserva al actualizar un agente privado. Es decir, el archivo de configuración existente jitterbit.conf El archivo no se sobrescribe al instalar sobre una instalación de agente existente.

De vez en cuando, puede haber adiciones o cambios a jitterbit.conf como se anunció a través de las notas de lanzamiento de Harmony. Para aprovechar las mejoras o realizar ajustes, puede agregar manualmente nuevas configuraciones y valores a su archivo de configuración existente después de la actualización.

Otra opción es desinstalar y reinstalar el agente para obtener la última copia de jitterbit.conf, teniendo en cuenta que deberá volver a aplicar las personalizaciones realizadas anteriormente. Para fines de respaldo, recomendamos hacer una copia de seguridad de su archivo de configuración de agente privado existente antes de reinstalar.

Configuración y valores predeterminados

Estas secciones describen cada configuración disponible dentro del jitterbit.conf archivo y los valores predeterminados para cada configuración.

Nota

En la siguiente tabla, un valor de 0 es intercambiable con un valor de false y un valor de 1 es intercambiable con un valor de true.

Dentro de la jitterbit.conf archivo, líneas que comienzan con # significa que estas líneas son comentarios que se ignoran en la configuración actual. Varios parámetros opcionales se comentan de esta manera; para utilizar estos parámetros, debe eliminar el comienzo # para que el parámetro se lea como parte del archivo de configuración.

Advertencia

Al editar el archivo de configuración, tenga en cuenta que el resto de una línea que está comentada con # no debe dejarse en blanco, o la siguiente línea se leerá como un comentario incluso si no comienza con #.

[Settings]

Clave
Valor predeterminado Descripción
TempDir

De forma predeterminada, el TempDir La configuración se deja en blanco y se utilizará el directorio temporal proporcionado por el sistema operativo, y los archivos temporales de Jitterbit se ubicarán en %temp%\jitterbit o /tmp/jitterbit.

En Windows con el directorio temporal del sistema operativo predeterminado, esto sería C:\Windows\Temp\jitterbit.

En Linux con un directorio temporal del sistema operativo predeterminado de /tmp Esto sería /tmp/jitterbit.

Para utilizar un directorio temporal diferente, configure TempDir igual a su ruta absoluta. Use barras diagonales, incluso en Windows. El directorio debe existir y el agente privado Jitterbit debe poder leerlo y escribirlo.

CurlDebugDir

De forma predeterminada, el CurlDebugDir El parámetro se deja en blanco y no se crean registros de depuración detallados.

Para obtener registros de depuración detallados de solicitudes FTP y HTTP, puede cambiar el valor de este parámetro a cualquier ruta de directorio válida donde desee guardar los registros de depuración. Cada solicitud creará un nuevo archivo en este directorio.

Consulte también Registros de depurar de Curl.

EnableLocalFileLocation false

De forma predeterminada, EnableLocalFileLocation está configurado para false. Esto significa que el uso de archivos locales como fuentes o destinos está deshabilitado.

Para usar archivos locales en su agente privado, puede habilitar los archivos locales cambiando el valor de este parámetro a true Para obtener más información, consulte Habilitar la ubicación de archivos locales.

JavaScriptMaxIterations 50000

El número máximo de iteraciones de bucle permitidas en Harmony es 50 000. El número máximo de iteraciones de bucle en JavaScript es por secuencia de comandos, no por bucle.

Por ejemplo, una secuencia de comandos de JavaScript que contenga tres bucles, donde cada bucle ejecuta 25 000 iteraciones, sería un total de 75 000 iteraciones ejecutándose dentro de una secuencia de comandos.

Para aumentar el número máximo de iteraciones permitidas en cualquier secuencia de comandos de JavaScript, agregue manualmente JavaScriptMaxIterations=X dónde X es mayor que 50000.

RecoverableStatusCode 500,502,503,504

De forma predeterminada, RecoverableStatusCode se establece en la lista de códigos de error de 500,502,503,504 para la versión 10.34 y posteriores del agente privado.

Para los agentes privados 10.30 a 10.33, RecoverableStatusCode La configuración y la lista de códigos de error deben agregarse manualmente:

RecoverableStatusCode=500,502,503,504

Cuando RecoverableStatusCode está configurado y la opción Reintentar está seleccionada en una conexión HTTP, la actividad se recupera de los códigos de error enumerados y vuelve a intentar la actividad.

EnableAPITimeout false

De forma predeterminada, EnableAPITimeout no está presente en el jitterbit.conf archivo y debe agregarse manualmente.

Si EnableAPITimeout está configurado para true, las operaciones activadas por las APIs de API Manager utilizarán la configuración de tiempo de espera de operación establecida en Integration Studio o Design Studio.

[DBInfo]

Clave
Valor predeterminado
Descripción
User jitterbit

De manera predeterminada, cuando se instala un agente privado Jitterbit, se instala una base de datos PostgreSQL local. Esta sección proporciona el nombre de usuario del agente privado para esa base de datos PostgreSQL local.

No recomendamos cambiar la base de datos PostgreSQL local predeterminada. Sin embargo, para usar una base de datos PostgreSQL diferente, aquí es donde debe especificar su información y credenciales.

Nota

El instalador del agente silencioso de Windows versión 10.48 o posterior config64.ps1 El secuencia de comandos permite especificar un nombre de usuario de agente alternativo en su Postgres_agent_username campo, que actualizará el User valor aquí.

DisableOdataCount false Desactiva la $count y $inlinecount Configuraciones en las consultas OData entrantes. Establezca en true Si experimenta problemas de rendimiento en la base de datos en segundo plano como resultado de la función de recuento. Esto solo está disponible con un agente privado 9.6 o posterior.
Password generado durante la instalación
Driver 'PostgreSQL ODBC Driver(UNICODE)' Windows de 32 bits
'PostgreSQL Unicode(x64)' Windows de 64 bits
'PostgreSQL-jitterbit' Linux
SystemDbName 'postgres'
Server 127.0.0.1
Port 6432 Para la versión 10.60 o anterior del agente privado, el puerto predeterminado es 6543.

[APIInfo]

Clave
Valor predeterminado Descripción
DebugJDML false Establecer en true para agregar registros adicionales de llamadas OData en los registros de API, incluido el SQL real enviado a la base de datos. Esto solo está disponible con un agente privado 9.6 o posterior.

[ProcessEngine]

Clave
Valor predeterminado Descripción
MaxNumberOfWorkerThreads auto

De forma predeterminada, cuando MaxNumberOfWorkerThreads está configurado para auto, la cantidad de subprocesos de trabajo será el doble de la cantidad de núcleos.

Puede cambiar este valor a cualquier número desde un mínimo de 1 hasta un máximo de 200.

RunOperationsInSeparateProcess true

De forma predeterminada, cuando RunOperationsInSeparateProcess está configurado para true Las operaciones se ejecutarán en procesos separados. Cuando esta opción está activada true, el valor predeterminado es un tiempo de ejecución ilimitado para el tiempo durante el cual se permite que se ejecute una operación.

Para establecer un límite en el tiempo durante el cual se permite que se ejecute cada operación, puede configurar MaxOperationRuntimeSeconds al número de segundos permitidos. Opcionalmente, puede especificar un MaxOperationRuntimeMessage que se registrará en los casos en que se alcance el tiempo de ejecución.

No se recomienda desactivar RunOperationsInSeparateProcess Puedes hacerlo configurando RunOperationsInSeparateProcess como false En ese caso, MaxOperationRuntimeSeconds y MaxOperationRuntimeMessage no se aplicará.

MaxOperationRuntimeSeconds
MaxOperationRuntimeMessage
EnableDebugDump false

De forma predeterminada, EnableDebugDump es false y el volcado de depurar no está habilitado. Para habilitarlo, configure true.

Si está habilitado, puede configurar DebugDumpDir a la ruta a un directorio para el volcado de depurar. Si no se especifica, DebugDumpDir se establecerá de forma predeterminada en TempDir Ajuste bajo [Settings].

Para especificar un directorio, configure DebugDumpDir igual a su ruta absoluta. Use barras diagonales, incluso en Windows. El directorio debe existir y el agente privado Jitterbit debe poder leerlo y escribirlo.

DebugDumpDir

[PredefinedGlobalVariables]

En esta sección se proporcionan los valores predeterminados de las variables globales predefinidas, también conocidas como variables Jitterbit. Estas se pueden sobrescribir caso por caso configurando la variable correspondiente en un secuencia de comandos.

Para obtener documentación completa sobre todas las variables que se pueden configurar en esta sección, consulte Integration StudioVariables de Jitterbit o Design Studio Variables Jitterbit.

Clave
Valor predeterminado Descripción
jitterbit.source.db.preserve_char_whitespace false De manera predeterminada, los espacios en blanco iniciales y finales de una base de datos de origen no se conservan. Para conservar los espacios en blanco iniciales y finales, cambie el valor a true.
jitterbit.target.db.include_null_in_sql_statement false De manera predeterminada, no se incluye un valor nulo en una sentencia SQL de una base de datos de destino. Para incluir un valor nulo, cambie el valor a true.
jitterbit.scripting.nesting.max 10 De forma predeterminada, se permiten hasta 10 secuencias de comandos anidados. Para disminuir o aumentar este máximo, cambie el valor a otro número.
jitterbit.scripting.while.max_iterations 50000 De manera predeterminada, cada bucle while está limitado a 50 000 iteraciones en un secuencia de comandos escrito en lenguaje Jitterbit Script. Para disminuir o aumentar este máximo, cambie el valor a otro número.
jitterbit.scripting.db.auto_commit true De manera predeterminada, los secuencias de comandos de la base de datos se confirmarán automáticamente. Para utilizar transacciones de base de datos, puede cambiar este valor a false.
jitterbit.scripting.db.max_rows 10000 De manera predeterminada, la cantidad máxima de filas de la base de datos afectadas por un secuencia de comandos es 10 000. Este número limita la cantidad de filas que se devolverán para el script. DBExecute, DBLookup, y DBLookupAll funciones (ver Integration StudioFunciones de base de datos o Design Studio Funciones de base de datos). Para disminuir o aumentar este máximo, cambie el valor a otro número.
jitterbit.scripting.ldap.scope 1 De forma predeterminada, los secuencias de comandos permiten el uso de LDAP. Para desactivar esta opción, configure 0.
jitterbit.scripting.ldap.include_dn_in_results false De manera predeterminada, los secuencias de comandos no incluyen el nombre distintivo (DN) en Active Directory. Para incluir el DN, cambie esta opción a true.
jitterbit.scripting.ldap.use_paged_search false De manera predeterminada, la búsqueda paginada para LDAP está desactivada en los scripts. De manera predeterminada, Active Directory permite que sus consultas extraigan solo una cierta cantidad de registros a la vez. Si esta opción está configurada en false y ejecuta una consultar que excede este límite, la consultar fallará. Si configura esto en true Jitterbit recuperará los datos en páginas para que no se exceda el límite de Active Directory.
jitterbit.scripting.ldap.max_search_results 1 De manera predeterminada, el máximo de resultados de búsqueda devueltos de una búsqueda LDAP es 1 Para obtener más resultados, aumente este número.
jitterbit.scripting.ldap.return_null_if_no_results false Si se establece en true, entonces una consultar LDAP sin registros que coincidan con la consultar devolverá un solo NULL valor.
jitterbit.source.text.csv_nullable false De manera predeterminada, si se utiliza un archivo CSV de texto como archivo de origen, no se permiten valores nulos. Cambie este valor a true para permitir valores nulos.TABLEROWEND
jitterbit.target.http.remove_trailing_linebreaks true Si se establece en true Los saltos de línea finales se eliminarán antes de que se publiquen los datos de destino.
jitterbit.target.xml.num_for_bool false De forma predeterminada, los valores de destino booleanos XML se representan con valores de cadena: "falso" y "verdadero". Si se configura en true Los valores de destino booleanos XML se representarán con "0" o "1" para false y true valores respectivamente.
jitterbit.source.ftp.transfer_timeout 3600 De manera predeterminada, el tiempo de espera de transferencia para las fuentes FTP es de 3600 segundos. Para aumentarlo o disminuirlo, cambie el valor a otro número.
jitterbit.target.ftp.transfer_timeout 3600 De manera predeterminada, el tiempo de espera de transferencia para destinos FTP es de 3600 segundos. Para aumentarlo o disminuirlo, cambie el valor a otro número.
jitterbit.http.enable_cookies false De forma predeterminada, las cookies no están habilitadas para conexiones HTTP. Para habilitar las cookies, cambie este valor a true.

[TransformationEngine]

Clave
Valor predeterminado Descripción
WriteLog 0

De forma predeterminada, WriteLog está configurado para 0, lo que significa que el registro detallado de las transformaciones está desactivado.

Para activar el registro detallado de las transformaciones con fines de depuración, puede cambiar este valor a 1.

No se recomienda mantener el registro habilitado, ya que esta opción puede generar una gran cantidad de archivos. Además, tenga en cuenta que el registro detallado también se puede activar en el nivel de operación, lo cual es preferible.

Cuando WriteLog está habilitado y WriteLogDir se deja en blanco de forma predeterminada, los registros de depurar se escribirán en JITTERBIT_HOME/DataInterchange/Temp/Debug Si desea cambiar el directorio donde se guardan los registros, puede especificar el valor de WriteLogDir como la ubicación del directorio deseada.

Para obtener más información, consulte Registro de depurar de operaciones.

WriteLogDir
ValidateXML 1

De forma predeterminada, ValidateXML está configurado para 1, lo que significa que la validación XML está activada.

Para desactivar toda la validación XML a escala global, configure en 0 Sin embargo, no se recomienda hacerlo. Se recomienda configurarlo en el nivel de transformación.

LdapEnableAutoUpdateMode false

De manera predeterminada, el modo de actualización automática para LDAP no está habilitado.

Si se cambia a true El modo de actualización automática le permite buscar cada entrada para determinar si la entrada debe agregarse o actualizarse.

TimingOn 0

De forma predeterminada, TimingOn está configurado para 0, lo que significa que la creación de perfiles de archivos no está activada.

Para activar la creación de perfiles globalmente, cambie este valor a 1 Cuando está habilitado, los archivos de creación de perfiles se escriben en JITTERBIT_HOME/DataInterchange/Temp/LOG de forma predeterminada. No se puede cambiar el directorio de registro para este parámetro.

AutoStreaming 1

De forma predeterminada, AutoStreaming está configurado para 1, lo que significa que la transmisión automática está activada.

Para deshabilitar la transmisión, configure este parámetro igual a 0 Sin embargo, esto no se recomienda. Se recomienda hacerlo en transformaciones individuales.

Consulte también Integration Studio Procesamiento de Transformación o Design Studio transformaciones de flujo y lote.

UseOldRuleForLoopOneOfXmlNode 0

De forma predeterminada, este parámetro está configurado en 0, lo que significa que esta regla no está habilitada.

La única instancia en la que este parámetro debe establecerse en 1 es para garantizar la compatibilidad con versiones anteriores. Cuando se configura en 1, se utilizará una regla que estaba presente en versiones anteriores para crear uno de los nodos de destino XML.

AutoXsiNil 0

De forma predeterminada, este parámetro está configurado en 0.

Si este valor se establece en 1, entonces la transformación creará automáticamente un xsi:nil="true" atributo para un elemento que es obligatorio y no está asignado.

DefaultEntityResolution true De manera predeterminada, el análisis de tipos de IDoc está habilitado. Para deshabilitar este análisis adicional en un agente privado, añadir manualmente DefaultEntityResolution=false en el [TransformationEngine] sección en jitterbit.conf.

[OperationEngine]

Clave
Valor predeterminado Descripción
Debug false

De forma predeterminada, Debug está configurado para false y el modo de depurar no está habilitado.

Para habilitar el modo de depurar, configure el valor en true Esto hará que se escriban mensajes de proceso adicionales en el archivo de registro. Es posible que desee habilitar esta opción si tiene datos temporales que no se deben eliminar.

Nota

Ambos Debug valor y el WriteLog El valor debe establecerse en 1(verdadero) para que se generen los registros.

Ver Registro de depurar de operaciones para obtener información adicional.

AlwaysRunSuccessOperation false

De forma predeterminada, este parámetro está configurado en false.

Si se establece en true, entonces las operaciones se configurarían para que siempre se ejecuten correctamente incluso si no hay datos. Esta opción puede ser útil cuando no hay archivos de origen disponibles para una fuente basada en archivos, pero desea que la operación se ejecute como si fuera exitosa.

TemporaryStorageRootDirectory

De manera predeterminada, cuando no se especifica, el directorio raíz de almacenamiento temporal será TemporaryStorage y bajo el directorio temporal del sistema operativo, o bajo el directorio temporal especificado por el TempDir Ajuste bajo [Settings].

En Windows con el directorio temporal del sistema operativo predeterminado, esto sería

C:\Windows\Temp\jitterbit\TemporaryStorage

En Linux con un directorio temporal del sistema operativo predeterminado de /tmp, esto sería

/tmp/jitterbit/TemporaryStorage

Para especificar un directorio de almacenamiento temporal diferente, configure TemporaryStorageRootDirectory igual a su ruta absoluta. Use barras diagonales, incluso en Windows. El directorio debe existir y el agente privado Jitterbit debe poder leer y escribir; de lo contrario, se ignora la configuración.

Consulte Ubicaciones de los archivos de registro para obtener información adicional.

MaxNumberOfOperationThreads

De forma predeterminada, cuando no se especifica este parámetro, la cantidad de subprocesos de operación es ilimitada.

Para establecer una cantidad máxima de subprocesos, puede usar un número como valor aquí.

MaxOperationStackDepth 50

De manera predeterminada, el número máximo de llamadas de operación sincrónicas anidadas permitidas es 50.

Para aumentar o disminuir este máximo, establezca el número deseado. Para que este parámetro sea ilimitado, establezca el valor en 0 o un número negativo. Sin embargo, tenga en cuenta que no se recomienda configurar este parámetro como ilimitado, ya que puede causar inestabilidad en el sistema.

MaxAsyncOperationChainLength 50

De manera predeterminada, la cantidad máxima de operaciones asincrónicas permitidas en una sola cadena es 50.

Esto es para protegerse contra bucles de operación infinitos. Para aumentar o disminuir este máximo, establezca el número deseado. Para que este parámetro sea ilimitado, establezca el valor en 0 o un número negativo.

MaxAsyncOperationChainLengthOverrideAllowed true

De forma predeterminada, este parámetro está configurado en true, lo que significa que es posible anular la longitud máxima de la cadena de operación asincrónicas. Cuando esta opción está habilitada, puede anular la longitud máxima de la cadena configurando la variable global $jitterbit.operation.max_async_chain_length (ver Integration StudioVariables de operación Jitterbit o Design Studio Operación variables Jitterbit).

Si esta opción se cambia a false, no será posible anular la longitud de la cadena utilizando la variable global.

AlwaysDeleteTempDir false

De forma predeterminada, este parámetro está configurado en false, lo que significa que los archivos de operación temporales se conservan hasta que se limpien de forma asincrónica.

Para eliminar siempre los archivos de operación temporales incluso en caso de errores, configure en true.

WriteLog 0

De forma predeterminada, WriteLog está configurado en 0(falso).

Para habilitar WriteLog modo, establezca el valor en 1 (verdadero). Esto hará que se escriban mensajes de proceso adicionales tanto para la API como para las operaciones programadas en el archivo de registro. Es posible que desee habilitar esta opción si tiene datos temporales que no se deben eliminar.

[APIOperation]

Clave
Valor predeterminado Descripción
EnableErrorLogging true

De forma predeterminada, EnableErrorLogging es true, es decir, solo operaciones de API (configuradas para APIs personalizadas o servicios OData) con errores se registran en los registros de operación.

Si esta opción está configurada en false, registro de errores en los registros de operación está deshabilitado.

EnableLogging false

De forma predeterminada, EnableLogging es false, es decir, todas las operaciones de API (configuradas para APIs personalizadas o servicios OData) no se registran en los registros de operación. Tenga en cuenta que aún puede ver los registros de procesamiento de API en el API Manager Registros de API página.

Si EnableLogging está configurado para true, luego todas las operaciones de API se registran en los registros de operación. Tenga en cuenta que cuando EnableLogging está configurado para true, el escenario para EnableErrorLogging se ignora (ya que se registrarían todos los registros de operación de API).

EnableOperationIdLogging false

De forma predeterminada, EnableOperationIdLogging es false, lo que significa que no se registrará el ID de una operación que cause un bloqueo.

Si esta opción se configuró en true, luego se registra el ID de la operación que causa el bloqueo y se puede usar para determinar la causa raíz.

APIOperationLogging false

De forma predeterminada, APIOperationLogging no está presente en el jitterbit.conf archivo y debe agregarse manualmente.

Si APIOperationLogging está configurado para true, un registro registrará el inicio de una llamada API y el tiempo transcurrido.

Precaución

Activar esta configuración generará al menos cuatro líneas adicionales para cada operación de API, lo que puede generar archivos de registro muy grandes.

[HttpEndPoints]

Importante

[HttpEndPoints] La configuración se aplica únicamente a Design Studio extremos HTTP alojados.

Clave
Valor predeterminado Descripción
EnableErrorLogging true

De forma predeterminada, EnableErrorLogging es true, es decir, solo extremo alojado en HTTP las llamadas con errores se registran en el registro de actividades.

Si esta opción estuviera configurada en false, el registro de errores en el registro de actividad se desactivará.

EnableLogging true

De forma predeterminada, EnableLogging se establece como verdadero para extremos alojados en HTTP, lo que significa que todas las llamadas de extremo alojados en HTTP se registran en el registro de actividad. Para deshabilitar el registro de operación para extremos alojados en HTTP, puede cambiar este valor a false Es posible que desee desactivar el registro para lograr una mayor eficiencia y rendimiento bajo carga.

Tenga en cuenta que cuando EnableLogging está configurado para true, entonces el ajuste para EnableErrorLogging se ignora (ya que se registrarían todas las llamadas HTTP).

Si ambos EnableLogging y EnableErrorLogging Se establecieron para false, entonces no se habilitará ningún registro.

[AutoScaling]

Clave
Valor predeterminado Descripción
DeregisterAgentOnJVMShutdown true

Si DeregisterAgentOnJVMShutdown está configurado para true (o no está presente), entonces la anulación del registro del agente debería ocurrir, incluso al detener el agente (a menos que se detenga usando el comando "Drain Stop" desde la Management Console).

Si DeregisterAgentOnJVMShutdown está configurado para false entonces la anulación del registro del agente no ocurre al detener el agente (a menos que no se detenga usando el comando "Drain Stop" desde la Management Console).

[ResultFiles]

Clave
Valor predeterminado Descripción
DisableSuccess false

De forma predeterminada, DisableSuccess es false, lo que significa que la creación de archivos de éxito está habilitada.

Es posible que desee activar esta opción configurando true Si no desea que se creen archivos de éxito, lo que puede ahorrar espacio en disco.

TABLEROWEND
DisableFailure false

De forma predeterminada, DisableFailure es false, lo que significa que la creación de archivos de error está habilitada.

Es posible que desee activar esta opción configurando true Si no desea que se creen archivos de error, lo que puede ahorrar espacio en disco.

[PredefinedServerGlobalDataElement]

Clave
Valor predeterminado
Descripción
definido por el usuario definido por el usuario

Esta sección se utiliza para crear variables globales predefinidas personalizadas que se inicializan para cualquier operación que se inicie en el agente. Si especifica bubble='gum', esto agregará una variable global predefinida llamada bubble con el valor inicial de "gum" que se puede referenciar en secuencias de comandos como $bubble o mediante el uso Get("bubble").

Ver Integration StudioVariables de Jitterbit o Design Studio Variables globales.

[Scheduler]

Clave
Valor predeterminado Descripción
AutoStart 1 De forma predeterminada, este parámetro se establece igual a 1, significado AutoStart está habilitado.
SleepTimeInSeconds 5

De forma predeterminada, el tiempo de suspensión se establece en 5 segundos.

Este valor se puede aumentar o disminuir según sus necesidades.

WriteLog 0

De forma predeterminada, este parámetro está configurado en 0 y el registro de depurar del programador está desactivado. Esta es la configuración recomendada, ya que activar el registro de depurar del programador podría generar un gran volumen de registros y podría causar una degradación del rendimiento.

Para activar el registro de depurar del programador, cambie este valor a 1 El registro se escribe en el directorio temporal y se llama scheduler_debug.log.

[FileCleanup]

Clave
Valor predeterminado Descripción
AutoStart 1

De forma predeterminada, este parámetro se establece igual a 1, significado AutoStart está habilitado.

Si cambia esta opción a 0, entonces la limpieza de archivos no se ejecutará automáticamente, lo que deshabilitará efectivamente la limpieza de archivos.

SleepTimeInSeconds 5

De forma predeterminada, el tiempo de suspensión se establece en 5 segundos.

Este valor se puede aumentar o disminuir según sus necesidades.

FrequencyInHours 24.0

De forma predeterminada, la limpieza de archivos se ejecutará una vez cada 24 horas.

Este valor se puede aumentar o disminuir según sus necesidades.

[SMTPClient]

Clave
Valor predeterminado Descripción
DefaultSMTPServers

Especifica los servidores SMTP predeterminados que se utilizarán cuando se envíe un mensaje de correo y el usuario no especificó ningún servidor SMTP.

Agrega los servidores SMTP en una lista separada por comas.

DefaultFromEmail Especifica una dirección de correo predeterminada para usar en el campo "De" si el usuario no especificó ninguna.
DefaultAccount
DefaultAccountPassword
UseSSL
Si sus servidores SMTP necesitan autenticación, especifique la cuenta y la contraseña aquí. UseSSL a true si el servidor SMTP requiere SSL/TLS.

[SSH]

¡Asegúrese de que estos archivos puedan ser leídos por la aplicación Jitterbit y por nadie más!

Clave
Valor predeterminado Descripción
PublicKeyFile

No hay ningún valor predeterminado PublicKeyFile. Puede especificar la ruta absoluta a su clave pública aquí si corresponde. Por ejemplo:

PublicKeyFileMe='/usr/local/ssh/id_dsa.pub'

PrivateKeyFile

No hay ningún valor predeterminado PrivateKeyFile Aquí puede especificar la ruta absoluta a su clave privada. Por ejemplo:

PrivateKeyFile='/usr/local/ssh/id_dsa'

PrivateKeyPassphrase No hay ningún valor predeterminado PrivateKeyPassphrase Puede especificar aquí la contraseña de su clave privada si es necesario.TABLEROWEND
Configurado por el usuario para múltiples conjuntos

Se pueden configurar múltiples conjuntos de claves mediante la configuración, por ejemplo:

$jitterbit.source.sftp.ssh_key_id="Me"

o

$jitterbit.target.sftp.ssh_key_id="Me"

Con una entrada como:

PublicKeyFileMe='/usr/local/ssh/id_dsa.pub'
PrivateKeyFileMe='/usr/local/ssh/id_dsa'
PrivateKeyPassphraseMe=

[SSL]

¡Asegúrese de que Jitterbit pueda leer estos archivos, pero nadie más! Solo se admiten certificados y claves con formato PEM.

Clave
Valor predeterminado Descripción
CertificateFile

No hay ningún valor predeterminado CertificateFile Aquí puede especificar la ruta absoluta al archivo de certificado de cliente SSL. Por ejemplo:

CertificateFile='C:/Certs/default.crt'

PrivateKeyFile

No hay ningún valor predeterminado PrivateKeyFile Aquí puede especificar la ruta absoluta a su clave privada. Por ejemplo:

PrivateKeyFile='C:/Certs/default.key'

PrivateKeyPassphrase No hay ningún valor predeterminado PrivateKeyPassphrase Puede especificar la contraseña de su clave privada aquí si es necesario.TABLEROWEND
Configurado por el usuario para múltiples conjuntos

Se pueden configurar múltiples conjuntos de certificados y claves mediante la siguiente configuración, por ejemplo:

$jitterbit.target.http.ssl_cert_id = "Me";

o

$jitterbit.source.http.ssl_cert_id = "Me";

o

$jitterbit.web_service_call.ssl_cert_id = "Me";

Con una entrada como:

CertificateFileMe='C:/Usuarios/Mi Nombre/Certs/me.crt'
PrivateKeyFileMe='C:/Usuarios/Mi Nombre/Certs/me.key'
PrivateKeyPassphraseMe=mysecret

[Settings/XMLSchemas]

Estas configuraciones definen los esquemas XML disponibles.

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

[DbDrivers]

Algunos controladores de bases de datos requieren caracteres especiales para delimitar los nombres de tablas y columnas. Si su aplicación requiere configuraciones diferentes, puede modificar estas entradas.

Muchos controladores ODBC requieren que los nombres de tablas y campos se escriban entre comillas si distinguen entre mayúsculas y minúsculas o contienen caracteres especiales. Configure los caracteres de comillas para su controlador en esta sección si aún no están incluidos. Los caracteres especiales que se admiten como delimitadores incluyen / . * = ? | ( ) [ ] { y } Estos delimitadores se definen especificando el Quote Begin y Quote Enden esta sección.

PostgreSQL

'PostgreSQL Quote Begin'='\"'
'PostgreSQL Quote End'='\"'

'PostgreSQL-psql Quote Begin'='\"'
'PostgreSQL-psql Quote End'='\"'

'PostgreSQL ANSI Quote Begin'='\"'
'PostgreSQL ANSI Quote End'='\"'

'PostgreSQL Unicode Quote Begin'='\"'
'PostgreSQL Unicode Quote End'='\"'

SQL Server

Para SQL Server, Quote Begin y Quote End son necesarios solo para tablas o columnas que contienen caracteres especiales.

'SQL Server Quote Begin'='['
'SQL Server Quote End'=']'

MySQL

Para MySQL, Quote Begin y Quote End son necesarios para las tablas que contienen espacios.

'MySQL Quote Begin'='`'
'MySQL Quote End'='`'

Controlador MySQL 3.51

'MySQL ODBC 3.51 Driver Quote Begin'='`'
'MySQL ODBC 3.51 Driver Quote End'='`'

Controlador MySQL 5.1

'MySQL ODBC 5.1 Driver Quote Begin'='`'
'MySQL ODBC 5.1 Driver Quote End'='`'

Oracle

'Oracle Quote Begin'='\"'
'Oracle Quote End'='\"'

Oracle XE

'Oracle in XE Quote Begin'='\"'
'Oracle in XE Quote End'='\"'

Microsoft ODBC para Oracle

'Microsoft ODBC for Oracle Quote Begin'='\"'
'Microsoft ODBC for Oracle Quote End'='\"'

Controlador ODBC de Oracle

'Oracle ODBC Driver Quote Begin'='\"'
'Oracle ODBC Driver Quote End'='\"'

Oracle en OraClient10g_home2

'Oracle in OraClient10g_home2 Quote Begin'='\"'
'Oracle in OraClient10g_home2 Quote End'='\"'

Acceso

'Microsoft Quote Begin'='['
'Microsoft Quote End'=']'

MS Access

'Microsoft Access Driver (*.mdb) Quote Begin'='['
'Microsoft Access Driver (*.mdb) Quote End'=']'

Excel

'Excel Quote Begin'='['
'Excel Quote End'=']'

MS Excel

'Microsoft Excel Driver (*.xls) Quote Begin'='['
'Microsoft Excel Driver (*.xls) Quote End'=']'

MS Excel - Nombre alternativo

'Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb) Quote Begin'='['
'Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb) Quote End'=']'

FileMaker Pro

'DataDirect 32-BIT SequeLink 5.4 Quote Begin'='\"'
'DataDirect 32-BIT SequeLink 5.4 Quote End'='\"'

DB2

'IBM DB2 (AS400) Quote Begin'='\"'
'IBM DB2 (AS400) Quote End'='\"'

[HttpConnectionPool]

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

Clave
Valor predeterminado Descripción
MaxConnections 50 Número máximo de conexiones totales que se mantendrán en el grupo. Si se establece en 0 o menos, se utiliza el valor predeterminado definido por la biblioteca Apache HttpClient (actualmente 20).
MaxConnectionsPerRoute 5 Número máximo de conexiones por enrutar. Si se establece en 0 o menos, se utiliza el valor predeterminado definido por la biblioteca Apache HttpClient (actualmente 2).
TimeoutInSeconds 60 Tiempo de espera, en segundos, para esperar una conexión del grupo. Si se establece en 0 o menos, se utiliza el valor predeterminado definido por la biblioteca Apache HttpClient (actualmente no hay tiempo de espera, lo que significa que el tiempo de espera será indefinido mientras se espera que haya una conexión disponible).
HttpSocketTimeoutInSeconds 180 Tiempo de espera, en segundos, después de establecer la conexión, que el socket del cliente espera para recibir una respuesta después de enviar la solicitud. Este es el tiempo transcurrido desde que el cliente envió la solicitud al servidor antes de que el servidor responda. Si se establece en 0 o menos, se utiliza el valor predeterminado definido por la biblioteca Apache HttpClient (actualmente 60 segundos).
HttpConnectionTimeoutInSeconds 180 Tiempo de espera, en segundos, para esperar la conexión con el alojar remoto.

[HttpConnectionPoolLocal]

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

Clave
Valor predeterminado Descripción
MaxConnections 50 Número máximo de conexiones totales que se mantendrán en el grupo. Si se establece en 0 o menos, se utiliza el valor predeterminado definido por la biblioteca Apache HttpClient (actualmente 20). Este valor se puede establecer en 100. Consulte la nota.
MaxConnectionsPerRoute 50 Número máximo de conexiones por enrutar. Si se establece en 0 o menos, se utiliza el valor predeterminado definido por la biblioteca Apache HttpClient (actualmente 2). Este valor se puede establecer en 100. Ver nota.
TimeoutInSeconds 60 Tiempo de espera, en segundos, para esperar una conexión del grupo. Si se establece en 0 o menos, se utiliza el valor predeterminado definido por la biblioteca Apache HttpClient (actualmente no hay tiempo de espera, lo que significa que el tiempo de espera será indefinido mientras se espera que haya una conexión disponible).
HttpSocketTimeoutInSeconds 180 Tiempo de espera, en segundos, después de establecer la conexión, que el socket del cliente espera para recibir una respuesta después de enviar la solicitud. Este es el tiempo transcurrido desde que el cliente envió la solicitud al servidor antes de que el servidor responda. Si se establece en 0 o menos, se utiliza el valor predeterminado definido por la biblioteca Apache HttpClient (actualmente 60 segundos).
HttpConnectionTimeoutInSeconds 180 Tiempo de espera, en segundos, para esperar la conexión con el alojar remoto.

Nota

Estos solo se aplican a [HttpConnectionPoolLocal] ajustes.

Si configura MaxConnections y MaxConnectionsPerRoute hasta 100, realice estos cambios adicionales:

  1. Edite el jitterbit-agent-config.properties archivo y conjunto:

    max.concurrent.requests=100
    

    No configurar max.concurrent.requests superior a 100. Esto revertirá el valor al valor predeterminado de 16.

  2. Edite el httpd.conf archivo y conjunto:

    ThreadsPerChild 101
    

[Debug]

Clave
Valor predeterminado Descripción
WebServiceDebugFile ''

De manera predeterminada, la escritura en un archivo de depurar de servicio web está deshabilitada.

Cuando está habilitada, los servicios web de backend escribirán información de depurar en este archivo mientras estén en modo de depurar.

[ErrorHandling]

Esta sección proporciona opciones de configuración para manejar posibles situaciones de error en el backend. Los valores posibles son:

  • Ok: La situación se considera normal; continúe como siempre.
  • Warning: Registrar una advertencia y continuar.
  • Error: La situación se considera fatal.
Clave
Valor predeterminado Descripción
NoRowsAffectedOnDbUpdates Ok Una declaración de actualización en un objetivo de base de datos que no afecta ninguna fila es Ok según la definición anterior.
NoTargetDataGenerated Ok No se generaron datos de destino 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 Una fuente de base de datos plana está vacía y genera una Warning según la definición anterior.

[JavaBackend]

Clave
Valor predeterminado Descripción
DebugLogLevel No hay ningún valor predeterminado DebugLogLevel Los valores aceptables son SEVERE(más alto), WARNING, INFO, CONFIG, FINE, FINER, FINEST(más bajo), OFF, o ALL como se define en https://docs.oracle.com/javase/8/docs/api/java/util/logging/Level.html.

[JavaUiBackend]

Clave
Valor predeterminado Descripción
LogLevel OFF El valor predeterminado para LogLevel es OFF, lo que indica que el registro está desactivado. Los valores aceptables son SEVERE(más alto), WARNING, INFO, CONFIG, FINE, FINER, FINEST(más bajo), OFF, o ALL como se define en https://docs.oracle.com/javase/8/docs/api/java/util/logging/Level.html.

[JDBCEngine]

Clave
Valor predeterminado Descripción
SessionTimeout 60 El valor predeterminado para SessionTimeout es 60, que es el número de minutos de inactividad después de los cuales se agotará el tiempo de espera de una sesión JDBC abierta. Esto se utiliza como medida de seguridad, ya que normalmente el servidor cerrará las sesiones después de su uso. Puede cambiar el tiempo de espera de la sesión ajustando el número.
ClientSessionTimeout 180 El valor predeterminado para ClientSessionTimeout es 180, que es el número máximo de minutos que se permite que dure una operación JDBC. Después de este tiempo, la operación fallará. Si cree que una operación JDBC (como un proceso de escritura de destino JDBC) demorará más que esto, debe aumentar este número.
LogLevel INFO El valor predeterminado para LogLevel es INFO, lo que indica que se están registrando mensajes informativos. Los valores aceptables son SEVERE(más alto), WARNING, INFO, CONFIG, FINE, FINER, FINEST(más bajo), OFF, o ALL como se define en https://docs.oracle.com/javase/8/docs/api/java/util/logging/Level.html.

[LDAP]

El [LDAP] La sección de un archivo de configuración de agente privado se puede utilizar para agregar compatibilidad con UTF-8 para Microsoft Windows y Active Directory con agentes privados de Windows que sean versión 9.5 o superior.

Clave Valor Descripción
CharacterEncoding ISO-8859-1 Admite codificación UTF-8.

Esto puede estar justificado si utiliza el LDAPReplace() función para reemplazar un valor en un Active Directory como se ve a continuación, y encontrar que el texto se convierte en un resultado diferente al de la entrada, como François que se reemplaza con FrançOis:

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

Para evitar problemas con caracteres especiales, agregue el [LDAP] sección de la siguiente manera y luego reinicie el agente:

  1. Actualice el jitterbit.conf archivo con las siguientes líneas:

    [LDAP]
    CharacterEncoding=ISO-8859-1
    
  2. Reinicie el agente.

Para obtener más información, consulte Integration Studio Funciones LDAP o Funciones LDAP de Design Studio.

[ConnectorsInfo]

Clave
Valor predeterminado
Descripción
MSAXUrl http://127.0.0.1:8002/AX/ Esto lo utiliza el conector de Microsoft Dynamics AX (Design Studio o Integration Studio) y no debe modificarse a menos que lo indique el soporte de Jitterbit.
MSCrmUrl http://127.0.0.1:8000/CRM/ Esto lo utiliza el conector Microsoft Dynamics CRM (Design Studio o Integration Studio) y no debe modificarse a menos que lo indique el soporte de Jitterbit.
jitterbit.connectorcall.timeout 300 Valor de tiempo de espera en segundos. Esto lo utilizan ciertos conectores y no se debe cambiar a menos que lo indique el soporte de Jitterbit.

[VerboseLogging]

Esta sección está presente en los agentes privados 10.48 y posteriores y se utiliza para la generación de datos de entrada y salida de componentes cuando registro de depurar de operación está habilitado en un individuo Integration Studio operación que se ejecuta en un agente privado 10.48 o posterior.

Al actualizar una versión anterior del agente privado a 10.48 o posterior, la generación de datos de entrada y salida se habilita automáticamente de forma predeterminada, incluso si el [VerboseLogging] La sección y sus claves no están presentes en el archivo de configuración.

La generación de datos de entrada y salida de componentes no se ve afectada por la configuración del grupo de agentes Registro en la nube habilitado. Los datos de entrada y salida de los componentes se registrarán en la nube Harmony incluso si el registro en la nube está deshabilitado, a menos que verbose.logging.enable está configurado explícitamente para false Esto anula la generación de datos de entrada y salida de componentes cuando se configura Habilitar modo de depuración hasta en un componente individual. Integration Studio operación, pero no impide que se generen archivos de registro de depurar de operación. Ambos tipos de registros de depurar de operación se tratan en Registro de depurar de operaciones.

Clave
Valor predeterminado
Descripción
verbose.logging.enable true

Cuando true o cuando esta configuración no está presente en el archivo de configuración, los datos de entrada y salida del componente se escriben en el Integration Studio registro de operación cuando registro de depurar de operación está habilitado en un individuo Integration Studio operación que se ejecuta en un agente privado 10.48 o posterior. Establecido en false para evitar que los datos de entrada y salida de los componentes se registren en la nube de Harmony.

Precaución

Cuando esta configuración no está presente en el archivo de configuración de un agente privado 10.48 o posterior, la configuración se trata como si estuviera presente y se establece en true Es decir, la generación de datos de entrada y salida de componentes está habilitada de manera predeterminada en todos los agentes 10.48 y posteriores, a menos que esta configuración se establezca explícitamente en false.

verbose.logging.commpress.folder.path De manera predeterminada, esta configuración está comentada y no se utiliza. No se debe cambiar a menos que lo indique el soporte de Jitterbit.
verbose.logging.log.folder.path De manera predeterminada, esta configuración está comentada y no se utiliza. No se debe cambiar a menos que lo indique el soporte de Jitterbit.
verbose.logging.log.file.extension .verbose Esto se utiliza para registro de depurar de operación y no se debe cambiar a menos que lo indique el soporte de Jitterbit. No es necesario que esta configuración esté presente en el archivo de configuración para que se generen los datos de entrada y salida del componente.
verbose.logging.use.dynamic.host.for.collector.url true Esto se utiliza para registro de depurar de operación y no se debe cambiar a menos que lo indique el soporte de Jitterbit. No es necesario que esta configuración esté presente en el archivo de configuración para que se generen los datos de entrada y salida del componente.