Solución de problemas del agente privado Jitterbit

Introducción

Esta página ofrece consejos para solucionar diversos problemas que pueden surgir al ejecutar un agente privado. Póngase en contacto con el soporte de Jitterbit para cuestiones no enumeradas aquí.

El agente privado de Jitterbit no se está ejecutando o está detenido o no se puede acceder a él

El mensaje de error "Agente no en ejecución o inaccesible" puede deberse a estos factores:

• Estás usando una versión anterior del agente.

  • Solución: Actualizar a la última versión del agente.

• Los servicios Jitterbit no se están ejecutando.

  • Solución: Los servicios se pueden iniciar en %windir%\system32\services.msc; O

  

  

  • Solución: En el directorio de instalación encontrará un secuencia de comandos StartServices.bat que iniciará los servicios relevantes; O

  

  • Solución: Para Windows, encontrará una opción para Iniciar servicios Jitterbit en el menú Inicio.

  

  • Por lo general, si un servicio no se inicia, encontrará un error durante el reinicio.

    • Para Windows: Busque un error en C:\Program Files (x86)\Jitterbit Agent\log Asegúrese de que se estén ejecutando como sistema local y verifique el registro de eventos para ver si hay algún mensaje de error.

    • Para Linux: Busque un error en /opt/jitterbit/log.

    Nota

    Reemplace NOMBRE DE USUARIO con su nombre de usuario actual.

    Permisos: La cuenta bajo la cual se ejecutan los servicios Jitterbit debe ser un administrador local en la computadora y tener acceso completo a la carpeta Jitterbit.

• Los servicios se están ejecutando pero no pueden comunicarse con Jitterbit Cloud.

  • Solución: Verificar:

    • Si Internet está funcionando.

    • El archivo de registro, para ver si hay un mensaje de error obvio:

      • Para Windows: C:\Program Files (x86)\Jitterbit Agent\log\jitterbit-agent.log.

      • Para Linux: /opt/jitterbit/log/jitterbit-agent.log.

• Los problemas de proxy también pueden provocar el mensaje de error "El Agente no se está ejecutando o no se puede acceder a él". Solucionar este problema es un poco más difícil, ya que existen muchas configuraciones de red diferentes.

  • Solución: Durante la instalación, es posible que tengas que marcar o desmarcar la casilla Negotiate Ntlm Proxy. Esto depende del proxy que tengas. También es muy útil ver el registro de denegaciones del servidor proxy.

Agente privado de Jitterbit que muestra diferentes versiones o IP

Asunto

Los Agentes en la Management Console puede mostrar distintas versiones o direcciones IP para un agente privado. Después de reiniciar los servicios del agente, la página Agentes puede mostrar inicialmente la versión o dirección IP "correcta" y luego volver a mostrarse continuamente.

Causa del problema

Es probable que el servidor del agente haya sido clonado. El servidor clonado se ejecuta en paralelo y entra en conflicto con el servidor del agente principal. No se pueden ejecutar varios servidores con las mismas credenciales de agente.

Pasos para identificar y solucionar problemas y resolverlos

1. Apague el servidor principal que ejecuta la versión oficial, espere 10 minutos y luego actualice la página Agentes de la Management Console. Si el estado del agente cambió de detenido a en ejecución, significa que hay otra instancia del agente en ejecución. Los agentes están trabajando de manera alternada o simultánea.

2. Para resolver el problema, será necesario encontrar la instancia que se ejecuta bajo la versión anterior y apagar ese servidor.

3. Si no puede hacerlo, desinstale el agente oficial, cree un nuevo agente con un nombre diferente e instálelo en el servidor oficial.

4. Verifique que el nuevo agente se esté ejecutando, como se indica en la página Agentes en la Management Console.

5. Elimine el agente antiguo de la página Agentes usando el menú desplegable Acción > Eliminar.

Errores de conexión, websocket y E/S en agentes privados de Jitterbit que utilizan máquinas virtuales de Azure

Descripción general

Esta página proporciona instrucciones sobre cómo solucionar problemas de un agente privado de Linux o Windows ) instalado en una máquina virtual (VM) de Microsoft Azure. (Consulte Ajuste del rendimiento del agente privado para obtener información general sobre cómo ajustar el rendimiento).

Solucionar problemas de conexiones perdidas

Al utilizar un agente privado instalado en una máquina virtual de Microsoft Azure, es posible que se pierdan las conexiones. Azure establece el tiempo de espera de inactividad de WebSocket en 4 minutos, mientras que el valor predeterminado del agente privado para hacer ping a Harmony está establecido en 5 minutos. Para resolver este problema, reduzca el intervalo del latido del agente:

1. Abra el jitterbit-agent-config.properties archivo en un editor de texto. Este archivo se puede encontrar en estos directorios:

   • Linux: <JITTERBIT_HOME>/Resources/

   • Windows: C:\Program Files\Jitterbit Agent\Resources

2. Encuentra el agent.heart.beat.interval Configuración:

   #Agent heart beat interval (IN MINUTES)
   agent.heart.beat.interval=5
   

3. Cambie la configuración a agent.heart.beat.interval=3.

4. Guarde los cambios y reinicie el agente.

Solucionar errores de E/S y de websocket

Los errores relacionados con WebSocket y E/S se pueden resolver con actualizaciones de los valores de tiempo de espera inactivo de IP asociado a la máquina virtual, tiempo de espera inactivo de TCP de la puerta de enlace de traducción de direcciones de red (NAT) y tiempo de espera de flujo de red virtual (VNET).

Los valores de tiempo de espera inactivo de IP, tiempo de espera inactivo de TCP de la puerta de enlace de NAT y tiempo de espera de flujo de VNET deben establecerse en 15 minutos.

Identificar errores relevantes

Los errores de WebSocket y de E/S se pueden identificar consultando los registros de operación y el jitterbit-agent.log archivo. Este archivo de registro se puede encontrar en una de las siguientes ubicaciones:

• Para Windows: C:\Program Files (x86)\Jitterbit Agent\log\jitterbit-agent.log.

• Para Linux: /opt/jitterbit/log/jitterbit-agent.log.

Errores del registro de operaciones

Si está presente cualquiera de los siguientes mensajes en los detalles del registro de operación para una operación con un estado Error puede ser indicativo de un error de WebSocket o de E/S:

The operation "Example Operation" completed successfully.

No message found while removing message in cache for: Message Info: AgentId: 000001 AgentGroupId: 000001 MessageId: XXX Message Version (Agent): XXXX Message Version (Harmony): XXX Counter (Harmony): 1 Submitted Timestamp (Harmony):2024-01-20 11:55:00.700, message will be retried later OperationInstanceGUID: XXX

Run message could not reach the agent.

Errores del archivo de registro del Agente

Si está presente alguno de los siguientes mensajes en el jitterbit-agent.log El archivo puede ser indicativo de un error de WebSocket o de E/S:

2024-01-20 12:00:00 request handler thread #10642  INFO org.jitterbit.integration.server.api.util.AgentRetryExecutor:53 - Agent Message Receipt (OperationInstanceGUID: XXX) failed. Retrying....
2024-01-20 12:00:00 request handler thread #10642 ERROR org.jitterbit.integration.server.api.util.AgentRetryExecutor:55 - org.springframework.web.client.ResourceAccessException: I/O error on PUT request for "https://na-east.jitterbit.com/jitterbit-cloud-restful-service/agent/ackmsgreceipt": Read timed out; nested exception is java.net.SocketTimeoutException: Read timed out

E:2024-01-20 12:00:00 request handler thread #884 ERROR org.jitterbit.integration.server.messaging.agent.listener.AgentMessageListener:231 - No message found while removing message in cache for: Message Info: AgentId: 000001 AgentGroupId: 000001 MessageId: XXX Message Version (Agent): XXXX Message Version (Harmony): XXX Counter (Harmony): 1 Submitted Timestamp (Harmony):2024-01-20 11:55:00.700, message will be retried later OperationInstanceGUID: XXX

Detener el drenaje del agente

Detención del drenaje el agente antes de actualizar cualquier configuración de tiempo de espera. Si tiene más de un agente en el grupo de agentes afectado, haga lo mismo para todos ellos.

Aislar recursos de agente

Se recomienda que la máquina virtual del agente y sus recursos asociados estén separados en su propio grupo de recursos en Azure. Esto incluye su red virtual, IP, puerta de enlace NAT, interfaz de red (NIC) y grupo de seguridad de red (NSG), si está presente.

Actualizar el tiempo de espera inactivo de la IP

1. En el portal de Azure, navegue hasta el grupo de recursos asociado con la máquina virtual del agente.

2. Identifique y haga clic en el elemento IP asociado con la máquina virtual:

   

3. Haga clic en Configuración y cambie el valor de Tiempo de espera de inactividad (minutos) a 15 minutos:

   

Actualizar el tiempo de espera inactivo de TCP de la puerta de enlace NAT

1. En el portal de Azure, navegue hasta el grupo de recursos asociado con la máquina virtual del agente.

2. Identifique y haga clic en el elemento de puerta de enlace NAT asociado con la máquina virtual y la IP, si está presente. También se incluirá una puerta de enlace NAT asociada en la Descripción general del elemento IP junto al campo Asociado a.

3. Haga clic en Configuración y cambie el valor de Tiempo de espera inactivo de TCP (minutos) a 15 minutos.

Actualizar el tiempo de espera del flujo de VNET

1. En el portal de Azure, navegue hasta el grupo de recursos asociado con la máquina virtual del agente.

2. Identifique y haga clic en el elemento VNET asociado con la máquina virtual:

   

3. En Descripción general, haga clic en Configurar junto a Tiempo de espera de flujo:

   

4. En el panel Tiempo de espera de flujo, habilite la configuración Habilitar tiempo de espera de flujo y cambie el valor Tiempo de espera de flujo (minutos) a 15 minutos:

   

5. Haga clic en Guardar.

Reiniciar el agente

1. En el portal de Azure, reinicie la máquina virtual del agente.

2. Reinicie el agente detenido. Consulte Reiniciar un agente de Windows o Reiniciar un agente de Linux para obtener información detallada.

Error 1722 con agentes privados Jitterbit de Windows

Asunto

La instalación del agente privado de Windows falla con este mensaje de error:

Error 1722. There is a problem with this Windows Installer package. A program run as part of the setup did not finish as expected. Contact your support personnel or package vendor. ...

Causa y resolución del problema

Existen múltiples razones por las que la instalación del agente privado podría fallar con este mensaje de error. Dos de las razones más comunes son un conflicto con Microsoft Visual C++ Redistributable o tener caracteres no permitidos en la contraseña de PostgreSQL.

Microsoft Visual C++ Redistribuible

Un conflicto con una versión existente de Microsoft Visual C++ Redistributable puede provocar el error 1722.

Los agentes privados requieren Microsoft Visual C++ Redistributable para Visual Studio 2015, 2017, 2019 que se debe instalar antes de instalar un agente privado. Microsoft incluye los mismos archivos redistribuibles para Visual Studio C++ 2015, 2017 y 2019. Instale la versión de Windows de 64 bits mediante vc_redist.x64.exe.

Caracteres de contraseña de PostgreSQL no permitidos

Una contraseña de PostgreSQL que utiliza caracteres no permitidos puede provocar el error 1722.

Para resolver este problema, no utilice un signo más (+) como parte de la contraseña de PostgreSQL al instalar un agente privado. La cantidad mínima de caracteres para una contraseña de PostgreSQL es ocho (8). Le recomendamos que no utilice caracteres acentuados (como é) o cualquiera de estos caracteres en la contraseña de PostgreSQL: + @ $ % & [] {} (), ; ? ^ = £.

Problema de IPv6 en los agentes privados Jitterbit de Windows

Descripción general

Algunos clientes han experimentado problemas cuando el Protocolo de Internet versión 6 (IPv6) está habilitado. En estos casos, recomendamos deshabilitar IPv6 e IP Helper.

Deshabilitar IPv6

Para deshabilitar IPv6:

1. En Windows, abra Panel de control > Redes e Internet > Conexiones de red.

2. Abra las Propiedades de una conexión.

3. Desmarque la casilla de verificación Protocolo de Internet versión 6 (TCP/IPv6):

   

Deshabilitar el asistente de IP

Para deshabilitar IP Helper:

1. En Windows, abra Servicios.

2. Localice IP Helper en la lista de servicios. A continuación, haga clic derecho en IP Helper y seleccione Propiedades.

3. En Propiedades de IP Helper, haga clic en Detener para detener el servicio y cambie el Tipo de inicio a Deshabilitado:

   

Error del servidor Apache en los agentes privados de Jitterbit

Si recibe este mensaje de error:

No Installed ConfigArgs for the Service "Jitterbit Apache Server"

Significa que el usuario bajo el cual se ejecuta el servidor Apache Jitterbit no tiene acceso completo a la carpeta Jitterbit.

Errores de PostgreSQL con agentes privados Jitterbit de Windows

Asunto

En ciertos casos, después de desinstalar un agente privado de Windows y luego intentar reinstalarlo, los usuarios pueden recibir un error relacionado con la base de datos PostgreSQL.

Causa del problema

Se sabe que este error ocurre en sistemas donde la instalación de PostgreSQL asociada con el agente privado no se ha eliminado por completo.

Resolución

Para resolver el error, los usuarios deben seguir los pasos descritos en Desinstalar un agente privado de Windows para eliminar por completo la cuenta de usuario Jitterbit PostgreSQL.

Una vez hecho esto, debería poder completar la instalación de un nuevo agente. Si sigue teniendo problemas, comuníquese con el servicio de asistencia.

No se pueden instalar agentes privados Jitterbit de Windows de 64 bits con autenticación de dos factores (TFA)

Asunto

Es un problema conocido que los agentes privados de Windows de 64 bits no se pueden instalar con la autenticación de dos factores (TFA) habilitada. Si la TFA está activa, la instalación de un agente privado de Windows de 64 bits fallará y aparecerá un cuadro de diálogo de error.

Solución alternativa

Para solucionar este problema, deshabilite temporalmente TFA e instale el agente privado de Windows de 64 bits. Después de la instalación, habilite TFA.

TFA se puede deshabilitar y habilitar desde la configuración de la organización a los que se accede desde la Management Console Organizaciones página.

Error de ranuras de conexión con agentes privados Jitterbit de Windows de 64 bits

Asunto

Se sabe que este error ocurre con agentes privados de Windows de 64 bits instalados antes del lanzamiento de Harmony 10.14:

Failed to connect to back-end database "TranDb"
FATAL: remaining connection slots are reserved for non-replication superuser
connections
(0) SQL Error! SQLSTATE = 53300 Native err = 210 msg = FATAL: remaining connection slots are reserved for non-replication superuser connections
(1) SQL Error! SQLSTATE = IM006 Native err = 0 msg = [Microsoft][Administrador de controladores ODBC] Driver's SQLSetConnectAttr failed
Details:
Unable to connect to database using connection string:
UID=jitterbit;PWD=<REMOVED>;SERVER=127.0.0.1;DRIVER={PostgreSQL ODBC
Driver(UNICODE)};DATABASE=TranDb;Port=6543;!

Resolución

Para resolver este problema, aumente el max_connections y checkpoint_timeout configuraciones en el postgresql.conf archivo en el agente privado de Windows de 64 bits siguiendo estos pasos:

1. Haz una copia de seguridad de tu postgresql.conf y guárdelo en otra ubicación. Este archivo se puede encontrar en el C:\Program Files\PostgreSQL\9.x\data directorio.

2. Abra el postgresql.conf archivo en un editor de texto.

3. Busque el max_connections configuración.

   # - Connection Settings -
   
   listen_addresses = '*'      # what IP address(es) to listen on;
                       # comma-separated list of addresses;
                       # defaults to 'localhost'; use '*' for all
                       # (change requires restart)
   port = 6543             # (change requires restart)
   max_connections = 100           # (change requires restart)
   #superuser_reserved_connections = 3 # (change requires restart)
   #unix_socket_directories = ''   # comma-separated list of directories
   

4. Cambie esta configuración a max_connections = 400.

5. Encuentra el checkpoint_timeout configuración.

   # - Checkpoints -
   
   #checkpoint_timeout = 5min      # range 30s-1d
   #max_wal_size = 1GB
   #min_wal_size = 80MB
   

6. Cambie esta configuración a checkpoint_timeout = 1h y eliminar el marcador de comentario (#) el comienzo de la línea.

7. Guarde los cambios y reinicie el agente.

Recuperar una instalación fallida de un agente privado en Windows

Asunto

La instalación o actualización de un agente privado en Windows falla.

Resolución

Debido a la cantidad de causas posibles, la solución más sencilla es desinstalar luego reinstalar el software del agente privado si falla alguna parte del proceso de instalación o actualización.