Instalar un Agente Privado Silencioso de Windows¶

Introducción¶

El instalador de Windows Quiet Agente le permite configurar y ejecutar una instalación silenciosa y desatendida de un Agente Privado. Esta página proporciona instrucciones sobre cómo descargar, instalar y configurar un Agente Privado utilizando el instalador de Agente silencioso Windows Harmony.

Para obtener instrucciones sobre cómo utilizar el instalador estándar del Agente Privado de Windows, consulte Instalar un Agente de Windows.

Para obtener más información sobre los requisitos del sistema, reiniciar, revertir y desinstalar un Agente Privado, consulte Instalación de un Agente de Windows Harmony.

Estas instrucciones asumen y requieren que ya haya creado un Grupo de Agentes y Agente Privado para su organización dentro de la Management Console. Consulte Agentes > Grupos de Agente y Agentes > Agentes para más información.

Descargue el Instalador del Agente Silencioso de Windows¶

Para descargar el instalador de Windows Quiet Agente, siga estas instrucciones:

Inicie sesión en el Portal Harmony y navega hasta Descargas página.
En la fila Jitterbit Agente, haga clic en Windows Quiet Agente Installer (x64) en la columna Descargar. Se descargará un archivo ZIP para el instalador de Windows Quiet Agente. El archivo ZIP contiene varios secuencias de comandos que se deben editar para instalar el agente (consulte Instalación y configuración de un Agente abajo).

Nota

El archivo ZIP del instalador de Windows Quiet Agente se puede descargar, almacenar localmente y reutilizar según sea necesario para cualquier Agentes Privados adicional a medida que se agregue.

Instalar y Configurar un Agente¶

Para instalar y configurar un Agente Privado utilizando el instalador de Agente silencioso de Windows, siga estos pasos:

Descomprimir jitterbit-agent-x64-XX.XX.X.XX.zip.

abrir config64.ps1 y complete los parámetros entre comillas dobles para cada campo:

config64.ps1

$Jitterbit_user_name = "example@jbexample.com"
$Jitterbit_password = "Jitterbit4Ever!"
$Postgres_super_user = "postgres"
$Postgres_super_password = "Ea$yAs123"
Postgres_service_account = "postgres"
$Postgres_service_password = "humTdumt$@t0nAwa11"
Postgres_agent_username = ""
Postgres_agent_password = ""
$Agent_group_id = "123321"
$Agent_id = "987789"
$Agent_install_file = "jitterbit-agent-x64-XX.XX.X.XX.exe"
[booleano] $Postgres_listen_address_localhost = 0
$Postgres_config_dir = "C:\Program Files\PostgreSQL\14\data\postgresql.conf"

Campo	Descripción
`Jitterbit_user_name`	Ingrese el nombre de usuario asociado con su cuenta Harmony.
`Jitterbit_password`	Ingrese la contraseña de su cuenta Harmony.
`Postgres_super_user`	Si corresponde, ingrese un nombre de usuario para la cuenta de superusuario de PostgreSQL. De lo contrario, deje este campo configurado con el valor predeterminado `postgres`. Esta configuración está disponible solo para la versión 10.48 o posterior del agente.
`Postgres_super_password`	Ingrese una contraseña que se utilizará para la base de datos PostgreSQL. La contraseña debe cumplir con las políticas de contraseñas de su sistema en cuanto a longitud y complejidad. Si está utilizando una instalación existente de PostgreSQL, ingrese la súper contraseña para la base de datos PostgreSQL existente.
`Postgres_service_account`	Si corresponde, ingrese el nombre de usuario de la cuenta de servicio de Windows para que se ejecute el servicio PostgreSQL. De lo contrario, deje este campo configurado con el valor predeterminado `postgres`. Esta configuración está disponible solo para la versión 10.48 o posterior del agente.
`Postgres_service_password`	Ingrese una contraseña que se utilizará para la base de datos PostgreSQL. La contraseña debe cumplir con las políticas de contraseñas de su sistema en cuanto a longitud y complejidad. Si está utilizando una instalación existente de PostgreSQL, ingrese la súper contraseña para la base de datos PostgreSQL existente.
`Postgres_agent_username`	De forma predeterminada, el instalador utiliza el nombre de usuario del agente PostgreSQL especificado con el `User` clave en el `[DbInfo]` sección del archivo de configuración del Agente Privado. Si desea que el agente utilice un nombre de usuario alternativo, especifíquelo aquí para anular la configuración del Agente Privado. De lo contrario, deje este campo en blanco. Esta configuración está disponible solo para la versión 10.48 o posterior del agente.
`Postgres_agent_password`	Si corresponde, ingrese la contraseña de la cuenta especificada en el `Postgres_agent_username` campo. De lo contrario, deje este campo en blanco. Esta configuración está disponible solo para la versión 10.48 o posterior del agente.
`Agent_group_id`	Ingrese su ID de Grupo de Agentes Privados. Su ID de Grupo de Agentes Privados está disponible en la Management Console Agentes > Grupos de Agente, colocando el cursor sobre el nombre del Grupo de Agentes para ver el ID del Grupo de Agentes.
`Agent_id`	Ingrese su ID de Agente Privado. Su ID de Agente Privado está disponible en la Management Console Agentes > Grupos de Agente, colocando el cursor sobre el nombre del Agente para ver el ID del Agente.
`Agent_install_file`	Este campo se completa automáticamente y no requiere modificación. El valor predeterminado de este campo apunta a la versión del ejecutable del agente de Windows descargado. Nota El valor de este campo debe coincidir con el valor del archivo ZIP descargado. Recibirá errores y la instalación fallará si `Agent_install_file` no apunta al ejecutable correcto del agente de Windows.
`Postgres_listen_address_locahost`	Introduzca un valor booleano que indique si la base de datos PostgreSQL `listen_address` se establece en `localhost`. Cualquier valor distinto de cero se corresponde con `true` y `0` corresponde con `false`. El valor predeterminado es `0` (`false`).
`Postgres_config_dir`	Si está utilizando una base de datos PostgreSQL existente, ingrese el directorio de su archivo de configuración de la base de datos PostgreSQL. Si está utilizando la base de datos PostgreSQL empaquetada con Agente Privado, no es necesario modificar esta línea.

Abrir silent_install64.ps1 y establecer KO_INSTALL_MODE al modo de instalación apropiado dependiendo de si desea instalar la base de datos PostgreSQL empaquetada con el Agente Privado o si tiene una instalación existente de una base de datos PostgreSQL que le gustaría usar:

Modo de instalación

Descripción

KO_INSTALL_MODE=\"0\

Avanzado: Instala un Agente Privado y configura una base de datos de Agente Privado para usar una instalación de PostgreSQL existente. Este modo se puede utilizar para actualizar un Agente Privado solo cuando se actualiza desde una versión de agente 11.x a una versión 11.x posterior, o desde una versión de agente 10.x a una versión 10.61 o anterior.

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 otras versiones 14.x de PostgreSQL funcionen, pero no se han probado.
Para los 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 usar cifrado de contraseña MD5:

postgres=# set password_encryption TO 'md5';
SET

KO_INSTALL_MODE=\"1\ Rápido: Instala todos los componentes necesarios para ejecutar el Agente Privado, incluida una base de datos y un controlador del agente PostgreSQL. Utilice esta opción si nunca antes ha instalado una base de datos PostgreSQL o el Agente Privado en esta computadora, o si ha desinstalado correctamente todos los componentes (consulte Desinstalar un Agente Privado).

Ejecute Windows PowerShell como administrador. Dentro de PowerShell, navegue hasta el archivo descargado y descomprimido llamado jitterbit-agent-x64-XX.XX.X.XX y ejecutar el silent_install64 secuencia de comandos usando el comando ./silent_install64.
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.