Instalar un Agente Privado de Windows¶

Introducción¶

Estas son las instrucciones para descargar e instalar Harmony Agente Privado en Windows. Antes de la instalación, recomendamos revisar Alta disponibilidad de grupos de Agente y equilibrio de carga y Charla técnica sobre mejores prácticas Agentes Privados.

Para obtener información sobre los requisitos del sistema, consulte Requisitos del sistema para Agentes Privados de Windows.

Una alternativa al uso del instalador estándar del Agente Privado de Windows es configurar y ejecutar una instalación silenciosa y desatendida de un Agente Privado. Para obtener más información, consulte Instalar un Agente silencioso de Windows.

Descargar un Agente Privado de Windows¶

Estas instrucciones sobre cómo descargar un Agente Privado de Windows suponen que ya ha creado un Grupo de Agentes y Agente Privado para su organización dentro de Management Console Grupos de Agente y Agentes páginas, respectivamente.

1. Inicie sesión en el Portal Harmony y vaya a Management Console > Agentes > Grupos de Agente.

2. En la parte superior de la pantalla, seleccione la fila Grupo de Agentes. La mitad inferior de la pantalla ahora debería enumerar los agentes disponibles dentro del Grupo de Agentes seleccionado.

3. En la parte inferior de la pantalla, seleccione la fila del agente. Luego haga clic en el menú desplegable Acción en el extremo derecho y seleccione Descargar para Windows EXE.

4. El ejecutable del agente de Windows se puede descargar, almacenar localmente y reutilizar según sea necesario para cualquier Agentes Privados adicional a medida que se agregue.

Instalar un Agente Privado¶

La instalación de más de un agente en un Grupo de Agentes permite automáticamente una alta disponibilidad. La instalación de varios agentes en un Grupo de Agentes también permite automáticamente el balanceo de cargas. Consulte Alta disponibilidad de grupos de Agente y equilibrio de carga para informacion adicional. Antes de instalar, verifique que todos los requisitos y avisos de software se han cumplido.

En cada agente dentro del Grupo de Agentes:

1. Ejecute el archivo ejecutable del agente de Windows descargado y siga las instrucciones.

2. Cuando se le solicite Credenciales de inicio de sesión, ingrese sus credenciales de Harmony (la dirección de correo y la contraseña que utiliza para iniciar sesión en https://login.jitterbit.com).

   Precaución

   Si su organización y su cuenta utilizan el inicio de sesión único (SSO), sus credenciales de SSO normales no funcionarán. Debe utilizar las credenciales de Harmony para instalar Agente Privado. Consulte Instalación de un Agente Privado en Registro e inicio de sesión usando Harmony SSO para más información.

3. Siga las indicaciones para seleccionar su organización, agente, etc. Las opciones disponibles son aquellas que ya ha configurado desde la Management Console.

   Nota

   Debe ser miembro de una rol de organización que tenga permisos Admin o Agent-Install. Vea Organizaciones y la sección sobre Administrar permisos, roles y miembros para más información.

4. En el mensaje Seleccione el modo de instalación, elija el modo dependiendo de si desea instalar la instancia de PostgreSQL incluida con el agente o si tiene una instalación existente de PostgreSQL que le gustaría usar:

   • Instalación rápida (recomendada): Instala todos los componentes necesarios para ejecutar un Agente Privado, incluida una base de datos y un controlador del agente PostgreSQL. Utilice esta opción si nunca antes ha instalado PostgreSQL o un Agente Privado en esta computadora, o si ha desinstalado correctamente todos los componentes siguiendo las instrucciones en Desinstalar un Agente Privado. Se proporciona más información sobre la base de datos PostgreSQL incluida con el agente en Requisitos de PostgreSQL en Requisitos del sistema para Agentes Privados.

     Nota

     Cuando se le solicite configurar su contraseña de PostgreSQL, tenga en cuenta que la contraseña debe cumplir con las políticas de contraseñas de su sistema en cuanto a longitud y complejidad.

   • Avanzado: Instala un Agente Privado y configura una base de datos de Agente Privado para usar una instalación de PostgreSQL existente. Deberá proporcionar sus credenciales de PostgreSQL. Es posible que desee utilizar esta opción si desea administrar las contraseñas por separado dentro de cada aplicación.

     La versión de la base de datos PostgreSQL existente debe coincidir con la esperada por la versión del agente:

     • Para Agentes Privados de Windows 11.0 y posteriores, se ha confirmado que funciona una base de datos PostgreSQL existente de la versión 14.5-1. Se espera que funcionen otras versiones 14.x de PostgreSQL, pero no se han probado.
     • Para Agentes Privados de Windows 10.x, la base de datos PostgreSQL existente debe ser la versión 9.6.x.

     Se debe configurar una base de datos PostgreSQL 14.x existente para utilizar cifrado de contraseña MD5:

     postgres=# set password_encryption TO 'md5';
     SET
     

5. Después de la instalación, el agente intentará iniciar y establecer una conexión con Harmony. Este proceso puede tardar más de un minuto en completarse.

   Importante

   Los Agentes Privados Harmony instalados en servidores Microsoft Azure requieren un intervalo de latidos del agente reducido.

   Puede verificar el estado del agente en la Management Console Agentes página. Una vez que se inicia un agente, su estado debe ser En ejecución.

   Nota

   En las versiones del agente 10.61, 10.62, 10.63 y 11.1, el estado será Detenido hasta que el Grupo de Agentes de un agente esté asociado con un ambiente.