Agentes privados de Jitterbit en Microsoft Windows

Introducción

Esta página muestra cómo instalar y ejecutar un agente privado en Microsoft Windows. La sección de Solución de problemas proporciona una lista de problemas comunes y sus soluciones.

Instalar

Para instalar un agente privado, verifica los Requisitos previos, luego sigue los pasos en las secciones de Descarga y Ejecutar instalador.

Requisitos previos

Debes tener lo siguiente:

• Un host que cumpla con los requisitos del sistema.

• Tu nombre de usuario y contraseña de la cuenta de Harmony.

• El nombre de tu organización en Harmony.

• El nombre y ID de un grupo de agentes privados.

• Acceso a una cuenta de administrador de Microsoft Windows en el host. Úsala para todas las acciones en esta página.

• Si está habilitado, desactiva la autenticación de dos factores (TFA). Puedes volver a habilitar TFA después de la instalación.

Los siguientes son opcionales:

• Agregar un agente en la Consola de Administración. Si no tienes agentes privados no registrados en el grupo de agentes, se crea uno automáticamente con un nombre que incluye el nombre y la dirección IP del host.

• Un servidor de base de datos PostgreSQL se instala automáticamente. Para usar el tuyo, debes configurarlo antes de instalar el agente privado y tener listo su nombre o dirección IP, su número de puerto y los detalles de la cuenta del administrador de la base de datos.

Los siguientes son recomendados:

• Desactiva la compresión y encriptación de Windows en las siguientes carpetas:

  Descripción	Ubicación predeterminada
  Carpeta del agente privado	C:\Program Files\Jitterbit Agent\
  Carpeta temporal del sistema	C:\Windows\Temp\
  Carpeta de datos de PostgreSQL	C:\PostgreSQL\14\data\ (Agente privado 11, versión 11.0 y superior.)
  	C:\PostgreSQL\9.6\data\ (Agente privado 10, versión 10.37 y superior.)

• Sigue la guía de configuración de ajuste de rendimiento.

Descargar

Para descargar el software del agente privado, ve a la página de Descargas del Portal de Harmony. (Si ya has agregado un agente en la página Agentes de la Consola de Administración, haz clic en el ícono Descargar Agente Jitterbit del agente.)

Descarga uno de los siguientes paquetes de agente privado para Windows:

• Windows (x64): (Recomendado) El paquete de instalación estándar (.exe). El modo Instalación Rápida instala todos los componentes en sus ubicaciones predeterminadas. En el modo Avanzado, puedes establecer la ubicación de instalación y configurar tu propio servidor de base de datos PostgreSQL.

• Instalador Silencioso de Agente para Windows (x64): El instalador silencioso (.zip). Este utiliza un archivo de configuración para permitir una instalación desatendida.

Ejecutar instalador

Sigue los pasos según el tipo de instalador:

Si los valores configurados son correctos, la instalación avanza sin más intervención, y el agente privado se inicia. Puedes verificar su estado en la Consola de Administración, o revisando el archivo de registro C:\Program Files\Jitterbit Agent\log\jitterbit-agent.log.

Si la instalación falla, revisa el archivo de registro log\Installer.log para más información.

Upgrade

Debes detener y reiniciar un agente para actualizaciones menores (de 11.x a 11.y, o de 10.x a 10.y) y actualizaciones de versión mayor (de 10 a 11). Las actualizaciones de versión mayor también requieren una desinstalación completa y reinstalación, así como una sincronización completa de los entornos.

Si tiene dos o más agentes en un grupo de agentes, se recomienda actualizarlos uno a la vez, para que sus proyectos de integración siempre tengan al menos un agente para procesar operaciones. Si solo tiene un agente en el grupo, las operaciones se encolan en Estado Pendiente hasta que el agente esté en línea y listo para procesarlas.

Para actualizar un agente privado en Windows, siga estos pasos:

1. Descargue un paquete de instalación.

2. Si el agente aún está procesando operaciones, drain pause (pausar drenaje) el agente.

   O, si está seguro de que no hay nada en ejecución en el agente, drain stop (detener drenaje) el agente.

3. Monitoree el archivo de registro del agente. Continúe cuando todas las operaciones hayan terminado de procesarse.

4. Haga copias de seguridad de los siguientes archivos:

   Ubicación	Archivo
   C:\Program Files\Jitterbit Agent\	jitterbit.conf
   C:\Program Files\Jitterbit Agent\	JdbcDrivers.conf
   C:\Program Files\Jitterbit Agent\Resources\	jitterbit-agent-config.properties
   C:\Program Files\Jitterbit Agent\apache\conf\	httpd.conf
   C:\Program Files\Jitterbit Agent\apache\conf\extra\	Todos los archivos .conf
   C:\Program Files\Jitterbit Agent\apache\conf\ssl.crt\	Todos los archivos .crt
   C:\Program Files\Jitterbit Agent\apache\conf\ssl.key\	Todos los archivos .key

5. (Opcional) Durante el período de sincronización del entorno, los agentes no aceptarán operaciones de proyectos de integración para su procesamiento. Puede minimizar el impacto de este tiempo de inactividad con un enfoque de actualización continua.

   Para hacer esto, abra el archivo jitterbit-agent-config.properties para editarlo y agregue o establezca la propiedad agent.starting.standby=true. (Esto mantiene al agente en estado Iniciando y evita que procese operaciones hasta que el valor de la propiedad se establezca en false.)

6. Ejecuta el instalador:

   Instalador estándarInstalador silencioso

   Ejecuta el instalador estándar descargado y responde a los mensajes del asistente de InstallShield.

   Sigue los pasos de instalación para el instalador silencioso, pero en el archivo silent_install64.ps1, establece KO_INSTALL_MODE=0.

   El agente se inicia automáticamente.

7. (Opcional) Si estás realizando una actualización gradual con el valor de propiedad agent.starting.standby=true, y antes de actualizar otro agente en el mismo grupo, monitorea el archivo de registro del agente en busca del siguiente mensaje:

   La sincronización del agente para el entorno <123456> y el ID del grupo de agentes <987654> se completó en ...
   

   Este mensaje indica que el agente ha completado la sincronización del entorno. Cuando aparezca, edita jitterbit-agent-config.properties nuevamente, elimina la propiedad agent.starting.standby (o configúralo en false), y luego reinicia el agente.

8. Compara los siguientes archivos con tus copias de seguridad y restaura cualquier configuración cambiada:

   Ubicación	Archivo
   C:\Program Files\Jitterbit Agent\	jitterbit.conf
   C:\Program Files\Jitterbit Agent\	JdbcDrivers.conf
   C:\Program Files\Jitterbit Agent\Resources\	jitterbit-agent-config.properties
   C:\Program Files\Jitterbit Agent\apache\conf\	httpd.conf
   C:\Program Files\Jitterbit Agent\apache\conf\extra\	Todos los archivos .conf

   Consejo

   Usa una herramienta de comparación y fusión, como WinMerge.

9. Si tienes archivos de respaldo .crt o .key que no están ya en C:\Program Files\Jitterbit Agent\apache\conf\ssl.crt\ o C:\Program Files\Jitterbit Agent\apache\conf\ssl.key\ respectivamente, cópialos a esas ubicaciones.

10. Detener y iniciar el agente.

Desinstalar

Para desinstalar completamente un agente privado y su servidor de base de datos PostgreSQL, sigue estos pasos:

1. Detener el agente.

2. Haz copias de seguridad de los siguientes archivos:

   Ubicación	Archivo
   C:\Program Files\Jitterbit Agent\	jitterbit.conf
   C:\Program Files\Jitterbit Agent\	JdbcDrivers.conf
   C:\Program Files\Jitterbit Agent\Resources\	jitterbit-agent-config.properties
   C:\Program Files\Jitterbit Agent\apache\conf\	httpd.conf
   C:\Program Files\Jitterbit Agent\apache\conf\extra\	Todos los archivos .conf
   C:\Program Files\Jitterbit Agent\apache\conf\ssl.crt\	Todos los archivos .crt
   C:\Program Files\Jitterbit Agent\apache\conf\ssl.key\	Todos los archivos .key

3. Desinstala los siguientes programas:

   • Jitterbit Agent: El software del agente privado de Jitterbit.

   • PostgreSQL: El servidor de base de datos PostgreSQL del agente privado. (La versión depende de la versión del agente privado.)

   • psqlodbc: El controlador ODBC de PostgreSQL.

4. Elimina la cuenta de usuario del servicio PostgreSQL de Jitterbit:

   Ejemplo de comando PowerShell

   net user /delete jitterbitpostgres
   

5. (Opcional) Elimina los servicios de Jitterbit:

   sc delete Jitterbit Apache Server
   sc delete Jitterbit Cleanup
   sc delete Jitterbit Process Engine
   sc delete Jitterbit Scheduler
   sc delete Jitterbit Tomcat Server
   sc delete JitterbitPgbouncer
   sc delete Jitterbit-Verbose-Log-Shipper
   

6. Reinicia Windows.

7. Elimina el directorio de datos de PostgreSQL C:\Program Files\PostgreSQL\<VERSION>\data para la versión de base de datos desinstalada.

8. (Opcional) Elimina el directorio de inicio de la cuenta de servicio C:\Users\jitterbitpostgres.

9. (Opcional) Elimina las siguientes claves en el editor del registro de Windows:

   • HKEY_LOCAL_MACHINE\SOFTWARE\PostgreSQL

   • HKEY_LOCAL_MACHINE\SOFTWARE\PostgreSQL Global Development Group

Administrar

Un agente privado se administra a través de entradas en el menú Inicio de Microsoft Windows, o con comandos ingresados en un símbolo del sistema. También se puede usar la Consola de Administración para detener un agente de forma remota, pero solo se puede reiniciar nuevamente en el host, o reiniciando el host.

Iniciar

Un agente privado se inicia automáticamente con el host.

Para iniciar un agente, utiliza cualquiera de estas opciones:

• Desde el menú Inicio de Microsoft Windows, selecciona Jitterbit Agent > Iniciar Servicios de Jitterbit.

• En un símbolo del sistema, ejecuta este comando:

  "C:\Program Files\Jitterbit Agent\StartServices.bat"
  

Detener

Hay tres formas de detener un agente privado, cada una difiriendo en cómo se tratan las operaciones en ejecución:

• Pausa de drenaje: el agente rechaza nuevas operaciones y permite que las operaciones en ejecución continúen hasta completarse.

• Detener drenaje: el agente rechaza nuevas operaciones y permite que las operaciones en ejecución continúen hasta completarse hasta un período establecido por el parámetro agent.drainstop.api.wait (por defecto, 180 segundos).

• Detención forzada: el agente rechaza nuevas operaciones y termina las operaciones en ejecución.

  Precaución

  Detener forzosamente un agente privado puede resultar en pérdida de datos.

Debes iniciar un agente privado detenido iniciando sesión en el servidor y ejecutando un comando, o reiniciando el host. Los agentes no se pueden iniciar de forma remota.

Si el agente se inició con registro automático, se desregistra automáticamente cuando se detiene.

Pausa de drenaje

Para pausar el drenaje de un agente privado en Windows, ejecuta el siguiente comando en un símbolo del sistema:

"C:\Program Files\Jitterbit Agent\bin\JitterbitUtils.exe" --drain-pause

En la Consola de Administración, el estado se muestra como Deteniendo.

Para reanudar un agente en pausa en Windows, utiliza el comando Iniciar.

Detener drenaje

Para detener el drenaje de un agente, utiliza cualquiera de estas opciones:

• Desde el menú del Portal Harmony, selecciona Consola de Administración > Agentes. En la columna Acción del agente que se va a detener, selecciona Acción > Detener Drenaje, luego haz clic en Aceptar en el cuadro de diálogo de confirmación.

• En un símbolo del sistema, ejecuta el siguiente comando:

  "C:\Program Files\Jitterbit Agent\bin\JitterbitUtils.exe" --drain-stop
  

Detener forzosamente

Para detener forzosamente un agente, utiliza cualquiera de estas opciones:

• Desde el menú Inicio de Microsoft Windows, selecciona Jitterbit Agent > Detener Servicios de Jitterbit.

• En un símbolo del sistema, ejecuta este comando:

  "C:\Program Files\Jitterbit Agent\StopServices.bat"
  

Pausar

Un agente privado puede ser pausado. En este estado, el agente finaliza cualquier operación que se esté procesando actualmente y no procesa más operaciones. En la Consola de Administración, el estado se muestra como Deteniendo.

Para pausar un agente privado en Microsoft Windows, ejecuta este comando en un símbolo del sistema:

JitterbitUtils.exe --drain-pause

Para reanudar un agente en pausa en Microsoft Windows, utiliza el comando Iniciar.

Estado

Para ver el estado del agente, utiliza cualquiera de estas opciones:

• Desde el menú del Portal Harmony, selecciona Consola de Administración > Agentes.

• Busca los siguientes servicios en la utilidad Administración de Equipos de Microsoft Windows, o en un símbolo del sistema con sc.exe query "<SERVICE>":

  • Servidor Apache de Jitterbit

  • Limpieza de Jitterbit

  • Motor de Procesos de Jitterbit

  • Programador de Jitterbit

  • Servidor Tomcat de Jitterbit

  • JitterbitPgBouncer

  • JitterbitVerboseLogShipper (nombre del servicio Jitterbit-Verbose-Log-Shipper)

Solucionar problemas

Estas secciones en la página de Solución de problemas pueden ayudar al solucionar instalaciones de agentes privados en Windows:

• Agente privado de Jitterbit no se está ejecutando, está detenido o es inaccesible.

• Agente privado de Jitterbit mostrando diferentes versiones o IPs.

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

• Error 1722 con agentes privados de Jitterbit en Windows.

• Problema de IPv6 en agentes privados de Jitterbit en Windows.

• Error de servidor Apache en agentes privados de Jitterbit.

• Errores de PostgreSQL con agentes privados de Jitterbit en Windows.

• No se puede instalar agentes privados de Jitterbit en Windows de 64 bits con autenticación de dos factores (TFA).

• Error de slots de conexión con agentes privados de Jitterbit en Windows de 64 bits.

• Recuperar una instalación fallida de agente privado en Windows.