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 Solución de problemas proporciona una lista de problemas comunes y sus soluciones.

Instalar

Para instalar un agente privado, verifica los Requisitos previos y luego sigue los pasos en las secciones Descargar y Ejecutar el 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 Harmony.

• El nombre de tu organización Harmony.

• El nombre e 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á habilitada, desactiva la autenticación de dos factores (TFA). Puedes reactivar TFA después de la instalación.

Lo siguiente es opcional:

• Agregar un agente en la Consola de administración. Si no tienes agentes privados sin registrar en el grupo de agentes, se crea automáticamente uno 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 propio, 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.

Lo siguiente se recomienda:

• Desactiva la compresión y el cifrado 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 Descargas del Portal Harmony. (Si ya has agregado un agente en la página Agentes de la Consola de administración, haz clic en el icono Descargar Jitterbit Agent del agente.)

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

• Windows (x64): (Recomendado) El paquete instalador estándar (archivo .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 del agente de Windows (x64): El instalador silencioso (archivo .zip). Utiliza un archivo de configuración para permitir la instalación desatendida.

Ejecutar el instalador

Sigue los pasos según el tipo de instalador:

1. En el mensaje Select Install Mode, selecciona Quick Install o Advanced:

   -   **Quick Install:** Este modo instala el agente privado en la ubicación predeterminada (`C:\Program Files\Jitterbit Agent`), instala un servidor de base de datos PostgreSQL, instala el controlador psqlODBC, crea un usuario local de Microsoft Windows llamado `jitterbitpostgres` e instala paquetes de Microsoft Visual C++ Redistributable. Si se encuentra una instalación de PostgreSQL existente, el instalador cambia al modo avanzado.
   
       1.  Ingresa y verifica una [contraseña válida](/es/agent/postgresql/#password-character-restrictions) para el servidor de base de datos PostgreSQL que se está instalando. Esta contraseña también se utiliza para la cuenta de servicio `jitterbitpostgres`.
   
           !!! note "Versión del agente 12.8 y posterior: validación de contraseña de PostgreSQL"
               A partir de la versión 12.8 del agente privado, el instalador valida la contraseña de la cuenta de servicio de PostgreSQL (`jitterbitpostgres`) contra las [restricciones de caracteres](/es/agent/postgresql/#password-character-restrictions) y muestra un mensaje si contiene un carácter no permitido. Las versiones anteriores no validan la contraseña en este paso, y una contraseña inválida causa que la instalación falle con [Error 1722](/es/agent/troubleshooting/#win-error) después de que PostgreSQL ya haya sido instalado.
   
       2.  En cada paso de la instalación de PostgreSQL, haz clic en **Next >**.
   
       3.  En la última página del instalador, haz clic en **Finish**. Puedes confirmar la organización, el grupo de agentes y el registro del agente en la página **Installation Summary**.
   
   -   **Advanced:** Este modo te permite instalar el software del agente en una ubicación diferente y elegir un servidor PostgreSQL existente.
   
       4.  (Opcional) En la página **Choose Destination Folder**, haz clic en **Change** para establecer la ubicación de instalación.
   
       5.  En la página **Database administrative credentials**, ingresa los detalles de un servidor de base de datos PostgreSQL existente.
   

   1. En la última página del instalador, haz clic en Finish. (Si la instalación falla, habilita la opción Show the Windows Install log antes de hacer clic en Finish.)

1. Edita silent_install64.ps1, busca el parámetro $JitterbitArgList y luego verifica o cambia el valor de KO_INSTALL_MODE:

   • KO_INSTALL_MODE=\"1\": Instala un agente privado y un servidor de base de datos PostgreSQL.

   • KO_INSTALL_MODE=\"2\": (Predeterminado) Instala solo un agente privado. Para esta opción debes tener un servidor de base de datos PostgreSQL existente instalado.

2. En el símbolo del sistema, ejecuta los siguientes comandos:

   Set-ExecutionPolicy Unrestricted
   silent_install64.ps1
   

   • Línea 1: Permite la ejecución de scripts de PowerShell.
   • Línea 2: Ejecuta el instalador silencioso.

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

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

Actualización

Los lanzamientos de agentes privados utilizan versionamiento semántico, expresado en la forma X.Y, donde X es el número de versión principal e Y es el número de versión secundaria. Hay dos tipos de actualizaciones:

• Principal: Cuando actualizas 10.x → 11.x o 11.x → 12.x, se considera una actualización de versión principal. 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 se bloquea y no puede procesar operaciones. Si los proyectos en el entorno son grandes, esto puede tomar algún tiempo.

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

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

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

  Se te solicita que aceptes esto durante el proceso de actualización cuando utilizas 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 complementos para usar los complementos Multipart Pipeline o AWS S3 Create en agentes 12.x. Los conectores personalizados de Connector SDK también pueden necesitar actualizaciones.

Actualizaciones de complementos para agentes privados 12.x

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

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

1. Asocia la nueva versión del complemento al grupo de agentes privados en la página Customizations > Plugins de la Consola de Administración.
2. Desasigna el complemento incompatible de la actividad en tus proyectos de Studio o Design Studio.
3. Asigna la nueva versión compatible.
4. Prueba e implementa la operación.

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

Los conectores personalizados creados por terceros usando el SDK de Conectores pueden requerir cambios para ser compatibles con agentes privados 12.x. Se debe verificar la compatibilidad de conectores personalizados antes de actualizar agentes privados a 12.x.

Instrucciones de actualización

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

1. Descarga un paquete instalador.

2. Si el agente aún está procesando operaciones, pausa de drenaje.

   O, si estás seguro de que nada se está ejecutando en el agente, detención de drenaje.

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

4. Realiza 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. Realiza 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 de entorno, los agentes no aceptarán operaciones de proyectos de integración para procesamiento. Se puede minimizar el impacto de este tiempo de inactividad con un enfoque de actualización gradual.

7. Ejecuta el instalador:

   Instalador estándarInstalador silencioso

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

   Mensajes y comportamiento de PostgreSQL durante la actualización

   • 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 del agente existente no se ve afectada. Restablece la contraseña de la cuenta de servicio jitterbitpostgres antes de intentar la actualización nuevamente.
   • A partir del agente 12.5, si UseInternalPooling no está ya definido en jitterbit.conf, el instalador solicita: ¿Deseas habilitar el agrupamiento interno para optimizar y mejorar el rendimiento del agente privado de Jitterbit? Seleccionar Sí agrega UseInternalPooling=true a la sección [DbInfo]. Seleccionar No deja la clave sin establecer (deshabilitada). Si UseInternalPooling ya está definido, el instalador no cambia su valor.
   • Si PostgreSQL fue instalado previamente en una ubicación personalizada, la actualización aún instala la nueva versión de PostgreSQL en la ubicación predeterminada (C:\Program Files\PostgreSQL\<VERSION>\), en lugar de la ubicación personalizada existente.

   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.

8. (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 para el siguiente mensaje:

   Agent synchronization for environment <123456> and agent group ID <987654> completed at ...
   

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

9. Compara los siguientes archivos con tus copias de seguridad y restaura cualquier configuración que haya cambiado:

   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

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

10. Si tienes archivos de copia de seguridad .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.

11. Detén e inicia el agente.

Desinstalar

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

1. Detén 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 de base de datos ODBC de PostgreSQL.

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

   Ejemplo de comando de 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

Se administra un agente privado a través de entradas en el menú Inicio de Microsoft Windows, o con comandos ingresados en un símbolo del sistema. También puedes usar la Consola de administración para detener un agente de forma remota, pero solo puedes reiniciarlo 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 > Start Jitterbit Services.

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

• Detención de drenaje: el agente rechaza nuevas operaciones y permite que las operaciones en ejecución continúen durante un período de tiempo de espera configurable, controlado por agent.drain.stop.database.poll.no.of.retries y agent.drain.stop.database.poll.interval.in.millisec (por defecto, 100 sondeos a intervalos de 10,000 ms). Las operaciones basadas en API reciben hasta agent.drainstop.api.wait (por defecto, 180 segundos). Después del tiempo de espera, se cancelan las operaciones que no se hayan completado y su estado se sincroniza con la nube antes de que el agente se apague. Si las operaciones son operaciones programadas, se recrean automáticamente en otro agente del grupo (en caso de múltiples grupos de agentes), o se configuran para recrearse en el agente cuando se reanuda (en caso de grupos de agentes únicos).

• Detención forzada: el agente rechaza nuevas operaciones, termina las operaciones en ejecución y las marca como canceladas. Si las operaciones son operaciones programadas, se recrean automáticamente en otro agente del grupo (en caso de múltiples grupos de agentes), o se configuran para recrearse en el agente cuando se reanuda (en caso de grupos de agentes únicos).

  Precaución

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

Se debe 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 anula automáticamente el registro cuando se detiene.

Pausa de drenaje

Para hacer una pausa de drenaje en 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 pausado en Windows, usa el comando Iniciar.

Detención de drenaje

Durante una detención de drenaje, el agente rechaza nuevas operaciones y permite que las operaciones en ejecución continúen durante un período de tiempo de espera configurable, controlado por agent.drain.stop.database.poll.no.of.retries y agent.drain.stop.database.poll.interval.in.millisec (por defecto, 100 sondeos a intervalos de 10,000 ms). Las operaciones basadas en API reciben hasta agent.drainstop.api.wait (por defecto, 180 segundos). Después del tiempo de espera, se cancelan las operaciones que no se hayan completado y su estado se sincroniza con la nube antes de que el agente se apague.

Para hacer una detención de drenaje en un agente, usa una de estas opciones:

• En el menú del Portal de Harmony, selecciona Consola de Administración > Agentes. En la columna Acción del agente a detener, selecciona Acción > Detención de drenaje, luego haz clic en Aceptar en el 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
  

Detención forzada

Para hacer una detención forzada en un agente, usa una de estas opciones:

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

Se puede pausar un agente privado. En este estado, el agente termina cualquier operación que se esté procesando actualmente y no procesa operaciones adicionales. 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 pausado en Microsoft Windows, usa el comando Start.

Estado

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

• Desde el menú de Harmony Portal, selecciona Management Console > Agents.

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

  • Jitterbit Apache Server

  • Jitterbit Cleanup

  • Jitterbit Process Engine

  • Jitterbit Scheduler

  • Jitterbit Tomcat Server

  • JitterbitPgBouncer

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

Solución de problemas

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

• Agente sin conexión o inaccesible

• Agente mostrando diferentes versiones o direcciones IP

• Errores de conexión, websocket e I/O en agentes privados de Jitterbit que usan máquinas virtuales de Azure

• Problema de IPv6 en Windows

• Error del servidor Apache: ConfigArgs no instalado

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

• Error 1720 o 1722 en la instalación de Windows

• TFA impide la instalación del agente Windows de 64 bits

• Fallos de conexión de TranDb

• Recuperar una instalación de Windows fallida

• El servicio Cleanup no puede eliminar archivos de registro bloqueados en Windows