Agentes privados de Jitterbit en Microsoft Windows

Introducción

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

Instalar

Para instalar un agente privado, consulte los Requisitos previos, luego siga los pasos en Descargar y Ejecutar instalador secciones.

Prerrequisitos

Debes tener lo siguiente:

• Un alojar que cumpla con los requisitos del sistema.

• Su nombre de usuario y contraseña de su cuenta Harmony.

• El nombre de su organización Harmony.

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

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

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

Las siguientes opciones son opcionales:

• Agregar un agente en la Management Console. Si no tiene ningún agente privado no registrado 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 utilizar el suyo, debe 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 de administrador de la base de datos.

Se recomiendan los siguientes:

• Deshabilite la compresión y el cifrado de Windows en las siguientes carpetas:

  Descripción	Ubicación predeterminada
  Carpeta de 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).

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

Descargar

Para descargar el software del agente privado, vaya al Portal Harmony Descargas página. (Si ya ha agregado un agente en la página Agentes de la Management Console, haga clic en el agente del agente Descargar Jitterbit Agente** icono.)

Descargue uno de los siguientes paquetes de agente privado de 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, puede establecer la ubicación de instalación y configurar su propio servidor de base de datos PostgreSQL.

• Instalador de Windows Quiet Agente (x64): El instalador silencioso (.zip archivo). Esto utiliza un archivo de configuración para permitir la instalación sin supervisión.

Ejecutar el instalador

Siga los pasos para el tipo de instalador:

Si los valores configurados son correctos, la instalación continúa sin más intervenciones y se inicia el agente privado. Puede comprobar su estado en la Management Console, o mirando el archivo de registro C:\Program Files\Jitterbit Agent\log\jitterbit-agent.log.

Si la instalación falla, verifique la log\Installer.logarchivo de registro para obtener más información.

Mejora

Para actualizar una versión secundaria del agente privado (10.x a 10.y o 11.x a 11.y) es necesario detener y reiniciar el agente.

Para actualizar una versión principal (10.x a 11.y), debe desinstalar y reinstalar el agente privado, el servidor de base de datos PostgreSQL y el controlador de base de datos PostgreSQL. También debe realizar copias de seguridad y restaurar manualmente los archivos de configuración del agente privado.

Actualización de versión menor

Para actualizar una versión menor, siga estos pasos:

1. Descargar un paquete de instalación.

2. Detener el agente.

3. Realice 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 .conf archivos
   C:\Program Files\Jitterbit Agent\apache\conf\ssl.crt\	Todos .crt archivos
   C:\Program Files\Jitterbit Agent\apache\conf\ssl.key\	Todos .key archivos

4. (Opcional) Si debe actualizar otros agentes del mismo grupo, puede minimizar el impacto del tiempo de inactividad del agente mediante un enfoque de actualización continua. Para ello, abra jitterbit-agent-config.properties archivo para editarlo y agregar o configurar 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.)

5. Ejecute el instalador:

   Instalador estándarInstalador silencioso

   Ejecute el instalador estándar descargado y responda a las indicaciones del asistente InstallShield.

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

   El agente se inicia automáticamente.

6. (Opcional) Si está realizando una actualización continua con el valor de la propiedad agent.starting.standby=true, y antes de actualizar otro agente en el mismo grupo, supervise 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 del ambiente Cuando aparezca, edite jitterbit-agent-config.properties Nuevamente, elimine la propiedad agent.starting.standby(o configúrelo en false), luego reinicie el agente.

7. Compare los siguientes archivos con sus copias de respaldo y restaure cualquier configuración modificada:

   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 .conf archivos

   Sugerencia

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

8. Si tienes una copia de seguridad .crt o .key archivos que aún no están en C:\Program Files\Jitterbit Agent\apache\conf\ssl.crt\ o C:\Program Files\Jitterbit Agent\apache\conf\ssl.key\respectivamente, cópielos en esas ubicaciones.

9. Detener y inicio el agente.

Actualización de versión principal

Para actualizar una versión principal, siga estos pasos:

1. Descargar un paquete de instalación.

2. Detener el agente.

3. Realice 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 .conf archivos
   C:\Program Files\Jitterbit Agent\apache\conf\ssl.crt\	Todos .crt archivos
   C:\Program Files\Jitterbit Agent\apache\conf\ssl.key\	Todos .key archivos

4. Desinstale los siguientes programas:

   • Jitterbit Agente: El software de agente privado Jitterbit.
   • PostgreSQL 9.6: El servidor de base de datos PostgreSQL del agente privado.
   • psqlodbc: El controlador de base de datos ODBC de PostgreSQL.

5. (Opcional) Eliminar el directorio de datos de PostgreSQL C:\Program Files\PostgreSQL\9.6\data.

6. Instalar el nuevo agente privado. El agente se inicia automáticamente.

7. Compare los siguientes archivos con sus copias de seguridad y restaure las configuraciones modificadas:

   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 .conf archivos

8. Si tienes una copia de seguridad .crt o .key archivos que no estan en C:\Program Files\Jitterbit Agent\apache\conf\ssl.crt\ o C:\Program Files\Jitterbit Agent\apache\conf\ssl.key\respectivamente, cópielos en esas ubicaciones.

9. Detener y inicio el agente.

Desinstalar

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

1. Detenerse el agente.

2. Realice 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 .conf archivos
   C:\Program Files\Jitterbit Agent\apache\conf\ssl.crt\	Todos .crt archivos
   C:\Program Files\Jitterbit Agent\apache\conf\ssl.key\	Todos .key archivos

3. Desinstale los siguientes programas:

   • Jitterbit Agente: El software de agente privado 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 Jitterbit PostgreSQL:

   Example PowerShell command

   net user /delete jitterbitpostgres
   

5. Reinicie Windows.

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

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

8. (Opcional) Elimine las siguientes claves en el editor de registro de Windows:

   • HKEY_LOCAL_MACHINE\SOFTWARE\PostgreSQL

   • HKEY_LOCAL_MACHINE\SOFTWARE\PostgreSQL Global Development Group

Administrar

Un agente privado se administra mediante entradas en el menú Inicio de Microsoft Windows o con comandos ingresados en un símbolo del sistema. También puede usar la Management Console para detener un agente de forma remota, pero solo puede reiniciarlo nuevamente en el alojar o reiniciando el alojar.

Comenzar

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

Para iniciar un agente, utilice cualquiera de estas opciones:

• Desde el menú Inicio de Microsoft Windows, seleccione Jitterbit Agente > Iniciar servicios Jitterbit.

• En el símbolo del sistema, ejecute este comando:

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

Detener

Hay tres formas de detener un agente privado, cada una de las cuales se diferencia 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 su finalización.

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

• Parada brusca: el agente rechaza nuevas operaciones y finaliza las operaciones en ejecución.

  Precaución

  Detener bruscamente un agente privado puede provocar la pérdida de datos.

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

Si el agente comenzó con registro automático, se anula el registro automáticamente al detenerse.

Pausa de drenaje

Para drenar y pausar un agente privado en Windows, ejecute el siguiente comando en un símbolo del sistema:

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

En la Management Console, el estado se muestra como Deteniendo.

Para reanudar un agente en pausa en Windows, utilice Inicio dominio.

Tapón de drenaje

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

• En el menú del portal Harmony, seleccione Management Console > Agentes. En la columna Acción del agente que se va a detener, seleccione Acción > Detención de drenaje y, a continuación, haga clic en Aceptar en el cuadro de diálogo de confirmación.

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

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

Parada brusca

Para detener definitivamente a un agente, utilice cualquiera de estas opciones:

• Desde el menú Inicio de Microsoft Windows, seleccione Jitterbit Agente > Detener servicios Jitterbit.

• En el símbolo del sistema, ejecute este comando:

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

Pausa

Se puede pausar un agente privado. En este estado, el agente finaliza todas las operaciones que se estén procesando actualmente y no procesa más operaciones. En la Management Console, el estado se muestra como Deteniéndose.

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

JitterbitUtils.exe --drain-pause

Para reanudar un agente en pausa en Microsoft Windows, utilice Inicio dominio.

Estado

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

• Desde el menú del Portal Harmony, seleccione Management Console > Agentes.

• Busque 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 Jitterbit

  • Limpieza Jitterbit

  • Motor de procesos Jitterbit

  • Programador Jitterbit

  • Servidor Tomcat Jitterbit

  • JitterbitPgBouncer

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

Solucionar problemas

Estas secciones de la Página de solución de problemas puede ayudar a solucionar problemas de instalaciones de agentes privados en Windows:

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

• Agente privado Jitterbit que muestra diferentes versiones o IP.

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

• Error 1722 con agentes privados Jitterbit de Windows.

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

• Error del servidor Apache en los agentes privados de Jitterbit.

• Errores de PostgreSQL con agentes privados Jitterbit de Windows.

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

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

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