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. Utilízala 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 del host y la dirección IP.

• 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\*\data\

• 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

Las versiones del agente privado utilizan versionado semántico, expresado en la forma X.Y, donde X es el número de versión mayor, y Y es el número de versión menor. Hay dos tipos de actualizaciones:

• Mayor: Cuando actualizas de 10.x → 11.x, o de 11.x → 12.x, se considera una actualización de versión mayor. En estos casos, debes detener y reiniciar el agente, y esperar a que se complete una sincronización completa de los entornos. Durante una sincronización completa, el entorno está bloqueado y no puede procesar operaciones. Si los proyectos en el entorno son grandes, esto puede tardar un tiempo.

• Menor: Cuando actualizas de 10.x → 10.y, de 11.x → 11.y, o de 12.x → 12.y, es una actualización de versión menor. En estos casos, solo necesitas detener y reiniciar el agente.

  Las actualizaciones de 11.48 y anteriores a 11.49+ incluyen actualizaciones necesarias de conectores

  Las actualizaciones de agentes privados de 11.48 y anteriores a 11.49 y posteriores incluyen una actualización necesaria a Connector SDK-basados en conectores.

  Se le solicita aceptar esto durante el proceso de actualización al usar el instalador estándar. Las actualizaciones realizadas con el instalador silencioso aceptan automáticamente este requisito previo.

Actualizaciones de 11.x a 12.x

Se requieren actualizaciones de plugins para utilizar los plugins Multipart Pipeline o AWS S3 Create en agentes 12.x. Los conectores del SDK de Conectores personalizados también pueden necesitar actualizaciones.

Actualizaciones de plugins para agentes privados de 12.x

Si utiliza cualquiera de los siguientes plugins, debe reemplazar cualquier uso existente de los plugins incompatibles con las nuevas versiones requeridas para 12.x, o las operaciones que utilizan esos plugins comenzarán a fallar cuando actualice el agente:

Las versiones de plugin requeridas son compatibles hacia atrás con agentes 11.x, por lo que puede actualizar los plugins antes de la actualización del agente. Para actualizar un plugin, siga estos pasos:

1. Asocie la nueva versión del plugin al grupo de agentes privados en la Consola de Administración página de Personalizaciones > Plugins.
2. Desasigne el plugin incompatible de la actividad en sus proyectos de Studio o Design Studio.
3. Asigne la nueva versión compatible.
4. Pruebe y despliegue la operación.

Verificación de conectores personalizados para agentes privados de 12.x

Los conectores personalizados construidos por un tercero utilizando el SDK de Conectores pueden necesitar cambios para ser compatibles con agentes privados de 12.x. Debe verificar la compatibilidad de los conectores personalizados antes de actualizar los agentes privados a 12.x.

Instrucciones de actualización

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

1. Descarga un paquete de instalación.

2. Si el agente aún está procesando operaciones, drain pause (pausa el drenaje) de él.

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

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

4. 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

5. Haz una copia de seguridad de la siguiente entrada del registro:

   HKLM\SOFTWARE\WOW6432Node\Apache Software Foundation\Procrun 2.0\Jitterbit Tomcat Server\Parameters\Java
   

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

7. Ejecuta el instalador:

   Instalador estándarInstalador silencioso

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

   Nota

   Si el instalador solicita la contraseña de la cuenta de servicio del sistema operativo Windows jitterbitpostgres y no la conoces, puedes cancelar el instalador. La instalación existente del agente no se ve afectada. Restablece la contraseña de la cuenta de servicio jitterbitpostgres antes de intentar nuevamente la actualización.

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

   El agente se inicia automáticamente.

8. (Opcional) Si está realizando una actualización continua con el valor de propiedad agent.starting.standby=true, y antes de actualizar otro agente en el mismo grupo, monitoree 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, edite jitterbit-agent-config.properties nuevamente, elimine la propiedad agent.starting.standby (o establezca en false), y luego reinicie el agente.

9. Compare los siguientes archivos con sus copias de seguridad y restaure 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

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

10. Si tiene 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ópielos a esas ubicaciones.

11. Detenga y inicie el agente.

Desinstalar

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

1. Detener el agente.

2. Hacer 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. Desinstalar 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 de base de datos ODBC de PostgreSQL.

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

   Ejemplo de comando PowerShell

   net user /delete jitterbitpostgres
   

5. (Opcional) Eliminar 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. Reiniciar Windows.

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

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

9. (Opcional) Eliminar 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 gestiona 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.

Start

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"
  

Stop

Hay tres formas de detener un agente privado, cada una con un tratamiento diferente para las operaciones en ejecución:

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

• Drenar detener: el agente rechaza nuevas operaciones y permite que las operaciones en ejecución continúen hasta completarse durante un período establecido por el parámetro agent.drainstop.api.wait (por defecto, 180 segundos), momento en el cual se marcan como canceladas. Si las operaciones son operaciones programadas, se recrean automáticamente en otro agente del grupo (en el caso de grupos de múltiples agentes), o se configuran para ser recreadas en el agente cuando se reanude (en el caso de grupos de un solo agente).

• Detener forzosamente: el agente rechaza nuevas operaciones, termina las operaciones en ejecución y luego las marca como canceladas. Si las operaciones son operaciones programadas, se recrean automáticamente en otro agente del grupo (en el caso de grupos de múltiples agentes), o se configuran para ser recreadas en el agente cuando se reanude (en el caso de grupos de un solo agente).

  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.

Drain pause

Para drenar la pausa 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.

Drenar detener

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

• Desde el menú del Portal Harmony, selecciona Consola de Administración > Agentes. Desde la columna Acción del agente que se va a detener, selecciona Acción > Drenar Detener, 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

  • Jitterbit Scheduler

  • Jitterbit Tomcat Server

  • JitterbitPgBouncer

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

Solución de 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 o está detenido o es inalcanzable.

• 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.

• Servicio de PostgreSQL eliminado después de una actualización fallida en Windows.

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

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

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

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