Saltar al contenido

Agentes privados de Jitterbit en Microsoft Windows

Introducción

Esta página 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.

  • 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. Úsela para todas las acciones de 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:

  • Añadir un agente en la Management Console. Si no tiene ningún agente privado sin registrar 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 suyo, debe configurarlo antes de instalar el agente privado y tener listos su nombre o dirección IP, su número de puerto y los datos 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.)

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

Descargar

Para descargar el software del agente privado, vaya al Portal Harmony Descargas. (Si ya ha agregado un agente en la página Agentes de la Management Console, haga clic en el 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 Agente de Windows (x64): El instalador silencioso (.zip este archivo utiliza un archivo de configuración para permitir la instalación automática.

Ejecutar el instalador

Sigue los pasos para el tipo de instalador:

  1. Ejecuta el archivo descargado .exe archivo.

  1. Realice las siguientes tareas cuando se le solicite. Haga clic en Siguiente > para avanzar por cada página del asistente:

    1. **Acuerdo de licencia:** Acepte el acuerdo de licencia.

2. **Credenciales de inicio de sesión:** Ingrese su nombre de usuario y contraseña de Harmony.

    - **Habilitar proxy:** (opcional) Haga clic para ingresar a su [servidor proxy](/es/agent/proxy/) información.

3. **Seleccionar organización:** Seleccione su [organización](/es/management-console/organizations/).

4. **Seleccionar Grupo de agentes/ambiente:** Seleccione su grupo de agentes. Si ha asociado un [ambiente](/es/management-console/environments/) A él se le muestra el nombre del ambiente entre paréntesis.

  2. Seleccionar Agente: (Opcional) Si hay un agente sin registrar en el grupo, se selecciona automáticamente. Si hay dos o más agentes en el grupo, se le pedirá que seleccione con cuál registrarse.

    1. En el mensaje Seleccionar modo de instalación, seleccione Instalación rápida o Avanzada:

      • Instalación rápida: 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 jitterbitpostgres Usuario local de Microsoft Windows e instala los paquetes redistribuibles de Microsoft Visual C++. Si se encuentra una instalación de PostgreSQL, el instalador cambia al modo avanzado.

        1. Ingrese y verifique una contraseña para el servidor de base de datos PostgreSQL que se va a instalar.

          Importante

          La contraseña no debe contener caracteres acentuados (como é) o cualquiera de los siguientes:

          txt + @ $ % &`[] `{ } ( ), ; ? ^ = £

        2. En cada paso de la instalación de PostgreSQL, haga clic en Siguiente >.

  3. En la última página del instalador, haga clic en Finalizar. Puede confirmar la organización, el grupo de agentes y el registro del agente en la página Resumen de la instalación.

    - **Avanzado:** Este modo le permite instalar el software del agente en una ubicación diferente y elegir un servidor PostgreSQL existente.

    4. (Opcional) En la página **Elegir carpeta de destino**, haga clic en **Cambiar** para establecer la ubicación de instalación.

    5. En la página **Credenciales administrativas de la base de datos**, ingrese los detalles de un servidor de base de datos PostgreSQL existente.

  4. En la última página del instalador, haga clic en Finalizar. (Si la instalación falla, active la opción Mostrar el registro de instalación de Windows antes de hacer clic en Finalizar).

  1. Extraiga el contenido del archivo descargado .zip archivo.

  1. En la carpeta extraída, edite config64.ps1 y establezca valores para los siguientes parámetros:

    | Parámetro | Predeterminado | Descripción |
|-------------------------------|----------------------|------------------------------------------------------------------------------------------------------|
| `$Jitterbit_user_name`| `""`                 | Nombre de usuario de la cuenta Harmony. |
| `$Jitterbit_password`| `""`                 | Contraseña de la cuenta Harmony. |
| `$Postgres_super_user`| `"postgres"`         | Nombre de usuario de la cuenta de superusuario de PostgreSQL. |
| `$Postgres_super_password`| `""`| Contraseña de la cuenta de superusuario. |
| `$Postgres_service_account`| `"postgres"`         | Nombre de usuario de la cuenta de servicio para PostgreQSL en Windows. |
| `$Postgres_service_password`| `""`| Contraseña de la cuenta de servicio. |
| `$Postgres_agent_username`| `""`| Nombre de usuario de la cuenta para el proceso del agente privado. |
| `$Postgres_agent_password`| `""`| Contraseña de la cuenta para el proceso del agente privado. |
| `$Agent_group_id`| `""`| Número de identificación del grupo de agentes privados.
| `$Agent_id`| `""`| Número de identificación del agente privado. |
| `$Agent_install_dir`| `"C:\Program Files"`| Ubicación de instalación. |
| `$Organization_id`| `""`| (Opcional) ID de la organización. Cuando se configura, [Jitterbit private agent metrics] se configura automáticamente. |

!!! important "Importante"
    Las contraseñas no deben contener caracteres acentuados (como `é`) o cualquiera de los siguientes:

    ```txt
    + @ $ % &`[] `{ } ( ), ; ? ^ = £
    ```

!!! tip "Consejo"
    Hay más información sobre cada parámetro en el archivo.

    1. Editar silent_install64.ps1, encuentra el $JitterbitArgList parámetro, luego verifique o cambie el valor de KO_INSTALL_MODE:

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

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

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

      Set-ExecutionPolicy Unrestricted
silent_install64.ps1
      • Línea 1: Permitir la ejecución del secuencia de comandos de PowerShell.
      • Línea 2: Ejecuta el instalador silencioso.

Si los valores configurados son correctos, la instalación continúa sin intervención y el agente privado se inicia. 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 el log\Installer.log archivo de registro para más información.

Mejora

Debe detener y reiniciar un agente para las actualizaciones de versiones menores (11.x a 11.y, o 10.x a 10.y) y mayores (10 a 11). Las actualizaciones mayores también requieren una desinstalación completa y reinstalar, y una sincronización completa de ambientes.

Consejo

Si tiene dos o más agentes en un grupo, actualícelos uno a la vez para que sus proyectos de integración siempre tengan al menos un agente para procesar las operaciones. Si solo hay un agente en el grupo, las operaciones se ponen en cola en Estado pendiente hasta que el agente esté en línea y listo para procesarlos.

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

  1. Descargar un paquete de instalación.

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

    O, si está seguro de que no hay nada ejecutándose en el agente, detener el drenaje eso.

  3. Supervise el archivo de registro del agente continúe cuando se hayan completado todas las operaciones.

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

  5. (Opcional) Durante la sincronización del ambiente durante este período, 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 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.)

  6. Ejecute el instalador:

    Ejecute el instalador estándar descargado y siga las instrucciones del asistente de 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.

  7. (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, edita jitterbit-agent-config.properties nuevamente, elimine la propiedad agent.starting.standby(o configúrelo en false) y, a continuación, reinicie el agente.

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

    Consejo

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

  9. 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\Copiarlos a esas ubicaciones respectivamente.

  10. Alto y inicio el agente.

Desinstalar

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

  1. Alto 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. (Opcional) Eliminar los servicios 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. Reinicie 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) 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 introducidos en el símbolo del sistema. También puede usar la Management Console para detener un agente de forma remota, pero solo puede reiniciarlo en el alojar o reiniciando el alojar.

Comenzar

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

Nota

Un agente privado puede tardar varios minutos en completar la sincronización y estar en estado de ejecución.

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 maneras de detener un agente privado, cada una con un tratamiento diferente para 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 que están 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 automáticamente el registro al detenerse.

Pausa de drenaje

Para drenar y pausar un agente privado en Windows, ejecute el siguiente comando en el 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.

Tope de drenaje

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

En el menú del Portal de Harmony, seleccione Management Console > Agentes. En la columna Acción del agente que desea 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

Un agente privado puede estar en pausa. En este estado, el agente finaliza cualquier operación que se esté procesando y no procesa más operaciones. En la Management Console, el estado se muestra como Deteniendo.

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 de 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 la hora de solucionar problemas de instalaciones de agentes privados en Windows:

  1. Minor upgrades are Private Agent 10, version 10.x to 10.y, or Private Agent 11, version 11.x to 11.y. Major upgrades are Private Agent 10 to Private Agent 11. ↩

OSZAR »