Agentes de Jitterbit

Descripción general

Los agentes Harmony de Jitterbit procesan las operaciones de sus proyectos de integración y envían y reciben datos de extremo. Hay dos tipos de agentes, en la nube y privados:

• Nube: Jitterbit administra agentes de la nube en su propia infraestructura de nube. No necesita configurar nada.

• Privado: Debe configurar y administrar agentes privados en su propia nube o infraestructura física.

Todos los agentes son miembros de un grupo. Los grupos de Agente son grupos de agentes del mismo tipo. Los agentes dentro de un grupo de agentes comparten el trabajo de procesamiento an Integration Studio o Design Studio operaciones del proyecto. El grupo de agentes y el tipo de agentes que utiliza un proyecto dependen del ambiente se implementa el proyecto.

La siguiente tabla compara los dos tipos de agente:

Agentes de la nube

Los agentes de nube son servicios de nube administrados por Jitterbit. Están configurados para adaptarse automáticamente a las cargas de trabajo de su proyecto. No necesita instalar, configurar, actualizar, iniciar ni detener los agentes de nube.

Grupos de agentes de la nube

Los grupos de agentes de la nube son grupos de agentes de la nube que ejecutan la misma versión. Están incluidos en todas las suscripciones de Harmony. Jitterbit ofrece dos grupos de agentes de la nube para cada región:

• Grupo de Agentes en Nube para Producción: Un grupo de agentes en la versión lanzada actualmente, completamente probados y listos para producción.

• Grupo de Agentes en Nube para Desarrollo: Un grupo de agentes en la próxima versión propuesta actualmente, adecuados para evaluación y pruebas.

Los grupos de agentes en la nube no necesitan configuración ni administración. A diferencia de los agentes privados, los agentes de nube individuales no son visibles en la Management Console.

Agentes privados

A diferencia de los agentes de la nube, que son administrados por Jitterbit, debe instalar y configurar agentes privados (en Windows, Linux) o Docker hosts que satisfacen los requisitos del sistema) y administrar tanto agentes como grupos mediante Management Console > Agentes página.

Grupos de agentes privados

Antes de poder instalar y ejecutar un agente privado, necesita al menos un grupo de agentes privados. (Los grupos de agentes privados son una adición que requiere licencia para su suscripción a Harmony). No se proporcionan grupos de agentes privados de forma predeterminada. Debe crearlos y asignarlos a los ambientes. Un grupo de agentes privados debe tener al menos un agente privado en él, y un agente solo puede estar en un grupo a la vez.

Cuando hay dos o más agentes en un grupo, los agentes se turnan para procesar cadenas de operación completas, incluidas las secundarias. Esto tiene las siguientes consecuencias:

• No hay forma de predecir en qué agente se ejecutará una cadena de operación. Los proyectos con extremos que requieren acceso a archivos locales deben ejecutarse en un ambiente donde todos los agentes del grupo tengan acceso a un sistema de archivos común o una unidad compartida.

• La carga de trabajo promedio de los hosts de agentes individuales puede variar significativamente.

• Si un agente falla, las operaciones pueden bloquearse y se pueden perder datos.

Para los conectores compatibles y una cantidad mínima de agentes activos, puede habilitar el servicio de escucha para los agentes de un grupo. El servicio de escucha permite que los agentes admitidos Integration Studio Los conectores escuchan los eventos de la API. También nombran a uno de los agentes como líder. El agente líder distribuye las tareas operación a los agentes según su estado y carga. Si un agente falla, se pueden recuperar los datos.

Calendario de lanzamiento y notas de lanzamiento

El calendario de lanzamiento para los agentes varía según el tipo de agente:

• Los grupos de agentes de nube se actualizan automáticamente en la Actualización del Grupo de Agentes en Nube para Desarrollo y Actualización del Grupo de Agentes en Nube para Producción horarios.

• Los instaladores de agentes privados actualizados están disponibles en Descargas página al concluir el lanzamiento del Grupo de Agentes en Nube para Producción.

• La imagen Docker del agente privado está disponible en Docker Hub al concluir el lanzamiento del Grupo de Agentes en Nube para Producción de la región América del Norte (NA).

En las notas de lanzamiento de Harmony, cada tipo de agente se incluye como un elemento de línea independiente en la tabla de fechas de lanzamiento en la parte superior de cada página de notas de lanzamiento. Las notas de lanzamiento individuales se enumeran bajo el encabezado Agentes, y cualquier aplicabilidad relevante a ciertos tipos de agentes se incluye dentro de las notas de lanzamiento.

Recopilaciones de notas de lanzamiento para Grupos de agentes en nube, Grupos de agentes en nube Sandbox, y agentes privados también están disponibles.

Problemas conocidos

En esta sección se enumeran los problemas conocidos que se han identificado con las versiones recientes de los agentes privados. Para conocer los problemas conocidos que se han identificado con otras aplicaciones Jitterbit Harmony, consulte Problemas conocidos.

Varias versiones de agentes privados

Agentes privados de Linux 11.31.1 y todas las versiones anteriores

• Las operaciones programadas no se ejecutan después de reiniciar un agente privado de Linux

  • Resumen: Después de reiniciar un agente privado de Linux, el agente Scheduler El servicio no se inicia, lo que provoca que las operaciones programadas no se ejecuten como se esperaba. Este problema no ocurre con los agentes privados de Windows.

  • Información adicional: El agente de Linux Scheduler El servicio utiliza una biblioteca que descarga los archivos de datos de huso horario más recientes. A partir del 4 de septiembre de 2024, el proveedor de esta biblioteca introdujo un error de sintaxis que provoca que Scheduler El servicio no se inicia.

  • Recomendación: Este problema se resuelve con la versión 11.31.2, que ya no descarga automáticamente la biblioteca que causa el problema. Recomendamos actualizar los agentes privados de Linux a la versión 11.31.2 o posterior para evitar que se produzca este problema y, en los casos en que ya se esté produciendo, solucionarlo.

    Como alternativa, si está utilizando una versión anterior del agente, puede aplicar la siguiente solución alternativa o pasos de recuperación a agentes que no sean Docker:

    • Solución alternativa: Si aún no se ha reiniciado un agente privado de Linux, para evitar que ocurra este problema, edite el version archivo en /opt/jitterbit/TimeZoneDB/version y cambiar su valor a 2024b Esto evitará que el agente descargue la versión de la biblioteca de fechas con el problema.

    • Recuperación: Si un agente privado de Linux ya está experimentando este problema, para solucionarlo, edite el northamerica archivo en /opt/jitterbit/TimeZoneDB/northamerica para reemplazar el valor April con Apr En cualquier caso, reinicie el agente.

Todas las versiones recientes

Estos problemas se aplican a todas las versiones recientes:

• La instalación del agente privado de Windows muestra una advertencia de Microsoft Defender SmartScreen

  • Resumen: Al instalar un agente privado 10.69 o posterior (para agentes 10.x) o 11.8 o posterior (para agentes 11.x) en Windows 2019 o Windows 10, puede aparecer un mensaje de advertencia.

  • Información adicional: El mensaje de advertencia dice "Windows protegió su PC" con una nota que indica que Microsoft Defender SmartScreen impidió que se iniciara una aplicación no reconocida.

  • Solución alternativa: Dentro del cuadro de diálogo del mensaje de advertencia, haga clic en Más información para mostrar la opción Ejecutar de todos modos. Luego, haga clic en Ejecutar de todos modos para continuar con la instalación del agente.

• Agentes privados de Windows : no se puede instalar el agente de 64 bits con autenticación de dos factores (TFA)

  • Resumen: La instalación de un agente privado de Windows de 64 bits falla si TFA está activo.

  • Información adicional: El instalador muestra un cuadro de diálogo de error.

  • Solución alternativa: Desactive temporalmente TFA e instale el agente privado de Windows de 64 bits. Después de la instalación, active TFA.

• Las conexiones ODBC no manejan correctamente los caracteres extendidos

  • Resumen: Al conectarse a una base de datos mediante un controlador ODBC, algunas operaciones que actualizan e insertan datos no manejan correctamente algunos caracteres extendidos, como el guión largo.

  • Información adicional: Las operaciones de inserción y actualización pueden fallar o tener éxito con consecuencias no deseadas al afectar los datos incorrectos. Tenga en cuenta que las operaciones de inserción y actualización no se ven afectadas por este problema.

  • Solución alternativa: Utilice un controlador JDBC para la conexión a la base de datos (consulte las instrucciones para Design Studio o Integration Studio).

• Los directorios SFTP a veces no se crean automáticamente

  • Resumen: Al escribir en SFTP como destino mediante Design Studio o Integration Studio, la creación automática de directorios funciona de manera inconsistente.

  • Información adicional: Dependiendo del servidor FTP particular involucrado, es posible que no se cree el directorio.

  • Solución alternativa: Confirme que el directorio se haya creado antes del uso de producción.

• SetSalesforceSession La función no funciona

  • Resumen: La función Jitterbit Script SetSalesforceSession no funciona correctamente y no debe utilizarse en Design Studio o Integration Studio.

  • Información adicional: Si se utiliza, el secuencia de comandos puede generar o no un error. Incluso si el secuencia de comandos no genera un error, la función no funcionará correctamente. Como la función no funciona, se utilizará el manejo de sesiones integrado del conector de Salesforce.

• Los agentes privados tienen requisitos de sistema específicos y problemas conocidos

  • Resumen: Los agentes privados tienen requisitos de sistema diferentes y específicos y problemas conocidos, según el sistema operativo que se utilice.

  • Solución alternativa: Consulte los Requisitos del sistema para agentes privados para más detalles.

• La instalación del Agente falla debido a que la contraseña de PostgreSQL incluye un signo más (+)

  • Resumen: La instalación del agente privado falla si la contraseña de PostgreSQL contiene un signo más (+). No se muestra ningún mensaje de error.

  • Información adicional: Este es un problema con el instalador del agente privado, no con PostgreSQL.

  • Solución alternativa: Utilice una contraseña sin el signo más (+). Una vez completada la instalación, la contraseña se puede cambiar a cualquier contraseña aceptable para usar con PostgreSQL.

11.26 agentes privados

• El VerifyJwtClaims funciones claims El parámetro no tiene el valor correcto predeterminado cuando se deja vacío

  • Resumen: Al usar la versión 11.26 del agente, dejar el campo opcional claims parámetro vacío con el VerifyJwtClaims La función de Jitterbit Script generará un error.

  • Solución alternativa: Actualice a la versión del agente 11.27 o posterior o ingrese "{}" para claims. Por ejemplo, VerifyJwtClaims("AxE9qm4aTZiXvA2G8sblAxjeL...", "RS256", "Secret", "{}");.

10.87 / 11.25 y agentes privados anteriores

• Entradas de registro excesivas para el conector de Microsoft Azure Service Bus

  • Resumen: Al utilizar el conector Microsoft Azure Service Bus con la versión del agente 10.87 / 11.25 o anterior, una cantidad excesiva de INFO Los registros se generan en un corto período de tiempo, lo que genera problemas de espacio en disco como resultado del tamaño de los registros. catalina.out archivo.

  • Solución alternativa: Se recomienda una actualización a la versión 11.26 o posterior del agente. Como alternativa, este problema se puede resolver en la versión 10.87/11.25 o anterior del agente agregando las siguientes configuraciones a la logback.xml archivo ubicado en C:\Program Files\Jitterbit Agent\tomcat\shared\lib (Windows) o /opt/jitterbit/tomcat/shared/lib (Linux):

    <logger name="com.azure.core.amqp" level="ERROR"/>
    <logger name="com.azure.messaging.servicebus" level="ERROR"/>
    <logger name="com.azure.core.implementation" level="ERROR"/>
    

10.84 / 11.22 y agentes privados anteriores

• Se omitió el programa de una vez al día durante el cambio de horario de verano

  • Resumen: Cuando se utiliza la versión 10.84/11.22 o anterior del agente y el agente utiliza una huso horario que respeta el horario de verano, estos problemas conocidos ocurren durante un cambio de horario de verano:

    • Cuando se establece un cronograma de una vez al día entre la 1 y las 2 a. m., la operación programada no se ejecutará el primer domingo de noviembre debido al horario de verano.

    • Cuando se establece un cronograma de una vez al día entre las 2 y las 3 a. m., la operación programada no se ejecutará el segundo domingo de marzo debido al horario de verano.

  • Solución alternativa: Actualice a la versión del agente 10.85/11.23 o posterior o configure la huso horario del agente a UTC mediante la Anular Huso horario del Agente programado política de la organización y seleccionando Etc/UTC.

10.45 y agentes privados anteriores

• Las vulnerabilidades JNDI de Apache Log4j2 afectan a los agentes privados

  • Resumen: Vulnerabilidades de Apache Log4j2 CVE-2021-44228 y CVE-2021-45046 afectan a los agentes privados que utilizan Integration Studio Conectores construidos con el Integration Studio SDK del conector.

  • Mitigación: Se realizó un mantenimiento de emergencia para solucionar las vulnerabilidades. Después del mantenimiento, fue necesario reiniciar los agentes privados y ejecutar una operación para cada conector afectado para que la actualización surtiera efecto. Para obtener información e instrucciones detalladas, consulte Mitigar la vulnerabilidad JNDI de Apache Log4j2.

10.38 Agentes privados de Linux

• La base de datos PostgreSQL se reinicializa al actualizar de la versión 10.37 a la 10.38

  • Antecedentes: Al actualizar un agente privado de Linux de una versión anterior a la 10.37 a una versión 10.37 o posterior, la base de datos PostgreSQL se reiniciará a medida que se actualice a la versión 9.6. Esta actualización recreará la base de datos en su agente privado y sus datos se recuperarán durante este proceso de actualización. Después de la actualización, las copias de seguridad creadas con una versión anterior de PostgreSQL no serán compatibles. El proceso de actualización puede tardar más de 30 minutos según la cantidad de proyectos y el tamaño de los ambientes asociados con su grupo de agentes privados. Todos los trabajos pendientes se colocarán en una cola pendiente para ejecutarse una vez que se complete la actualización. Esta actualización no involucra al agente privado de Windows.

  • Problema conocido: Es un problema conocido que al actualizar un agente privado de Linux de la versión 10.37 a la 10.38, la base de datos PostgreSQL se reinicializa.

  • Solución alternativa: Actualice a un agente privado de Linux que sea la versión 10.39 o posterior.

10.0 agentes privados

• El Integration Studio El conector Cherwell no funciona

  • Resumen: A partir del lanzamiento de Harmony 10.1, un cambio realizado en el conector Cherwell en Integration Studio significa que ya no es compatible con los agentes 10.0.

  • Solución alternativa: Si usa el conector Cherwell, actualice a agentes 10.1 o superior.

9.8 agentes privados

• Los complementos no se ejecutan

  • Resumen: Un problema con los complementos que no se ejecutaban provocó que la descarga del agente privado 9.8 se retirara poco después del lanzamiento.

  • Solución alternativa: Si aún tiene un agente privado 9.8, actualícelo a una versión posterior.