Actualizar un Agente Privado de Windows¶

Introducción¶

La actualización de un Agente Privado desde una versión anterior de Agente Privado a una posterior generalmente se puede realizar sin desinstalar la versión anterior del agente, como se describe en Actualizar un Agente abajo. Sin embargo, al actualizar de un Agente Privado de Windows 10.x a 11.x, se requiere una desinstalación completa del agente.

Revertir un agente a una versión anterior también se trata en esta página.

Actualizar un Agente¶

Las siguientes subsecciones proporcionan instrucciones para actualizaciones menores y mejoras importantes, junto con recomendaciones para implementaciones grandes.

Actualización Menor¶

Las actualizaciones menores de la misma versión principal (es decir, de 10.x a 10.x o de 11.x a 11.x) tardan solo unos minutos en completarse.

Para una actualización menor, generalmente, utiliza las instrucciones para instalar un Agente Privado y siga las indicaciones para actualizar la instalación del agente existente.

Siga estas instrucciones para actualizaciones menores de agentes:

Haga una copia de seguridad de los archivos de configuración y los certificados de seguridad como referencia (opcional; consulte Desinstalar un Agente Privado).
Instale la nueva versión del agente (consulte Instalar un Agente Privado).
Para usar los archivos de respaldo (opcional):
1. Detenga los servicios del agente (consulte Reiniciar un Agente Privado).
2. Coloque sus certificados de seguridad guardados en el directorio de instalación. Actualice manualmente los archivos de configuración recién instalados según la configuración de sus archivos guardados.
  
  Advertencia
  
  Copiar directamente los archivos de configuración guardados después de un cambio de versión del agente puede causar errores. En su lugar, utilice herramientas como el complemento Comparar Notepad++ para ayudarle a comparar y actualizar manualmente los ajustes de configuración. No cambie la configuración con contraseñas o puertos definidos como los que se encuentran en la credentials.txt archivo y bajo el [[DbInfo sección de la jitterbit.conf archivo]](/es/agent/private-agents/private-agent-how-tos/edit-the-configuration-file-jitterbit-conf/#editingtheconfigurationfilejitterbit.conf-db-info).
3. Inicie los servicios del agente (consulte Reiniciar un Agente Privado).

Actualización Importante de 10.x a 11.x¶

Se requiere una desinstalación completa de los Agentes Privados de Windows 10.x existentes para poder actualizar a la versión 11.x de los Agentes Privados de Windows.

Para actualizar de un Agente Privado de Windows 10.x a un 11.x, siga estos pasos:

Haga una copia de seguridad de los archivos de configuración del agente y los certificados de seguridad como referencia (opcional, consulte Desinstalar un Agente Privado).
Desinstale el agente 10.x existente (consulte Desinstalar un Agente Privado).
Elimine todos los archivos relacionados con Jitterbit (consulte Desinstalar un Agente Privado).
Además de desinstalar el agente, se recomienda encarecidamente desinstalar la base de datos PostgreSQL 9.6.x existente. Si no desea desinstalar la base de datos PostgreSQL, puede permanecer instalada pero se desactivará cuando se instale un Agente Privado de Windows 11.x. En este caso, consulte Instalaciones paralelas de PostgreSQL 9.6 y 14.5 abajo.
Instale la versión 11.x del agente (consulte Instalar un Agente Privado). Al actualizar a una versión 11.x del agente, ocurrirá lo siguiente:
- El controlador ODBC de PostgreSQL se actualizará a PostgreSQL ODBC 13.2.0.0.
- Se producirá una sincronización completa de los ambientes. Durante una sincronización completa, todos los proyectos y metadatos de cada ambiente se vuelven a descargar desde la nube de Harmony para completar la base de datos PostgreSQL.
  
  Precaución
  
  El tiempo que lleva realizar una sincronización completa depende del número y la complejidad de los proyectos en cada ambiente. Para un uso típico en un ambiente, una sincronización completa suele tardar hasta 10 minutos en completarse. Sin embargo, los ambientes con una gran cantidad de proyectos pueden tardar varias horas en sincronizarse. Si le preocupa tener una interrupción, consulte las recomendaciones para implementaciones grandes abajo.
Para utilizar los archivos de copia de seguridad de la configuración del agente (opcional):
1. Detenga los servicios del agente (consulte Reiniciar un Agente Privado).
2. Coloque sus certificados de seguridad guardados en el directorio de instalación. Actualice manualmente los archivos de configuración recién instalados según la configuración de sus archivos guardados.
  
  Advertencia
  
  Copiar directamente los archivos de configuración guardados después de un cambio de versión del agente puede causar errores. En su lugar, utilice herramientas como el complemento Comparar Notepad++ para ayudarle a comparar y actualizar manualmente los ajustes de configuración. No cambie la configuración con contraseñas definidas o puertos como los que se encuentran en la credentials.txt archivo y bajo el [[DbInfo sección de la jitterbit.conf archivo]](/es/agent/private-agents/private-agent-how-tos/edit-the-configuration-file-jitterbit-conf/#editingtheconfigurationfilejitterbit.conf-db-info).
3. Inicie los servicios del agente (consulte Reiniciar un Agente Privado).

Recomendaciones de Actualización para Implementaciones Grandes¶

Si le preocupa tener una interrupción durante la actualización de un agente, recomendamos usar alta disponibilidad (dos o más agentes) para que las solicitudes se enruten a otro agente disponible en el grupo de agentes. Si su suscripción actual no tiene agrupación de agentes, comuníquese con su Administrador de éxito del cliente (CSM).

Cuando se espera que se produzca una sincronización completa, como al actualizar de una versión de agente 10.x a 11.x, recomendamos un método de actualización gradual, en el que se instalan nuevos agentes en modo de espera, uno a la vez, en un grupo de agentes existente. antes de desmantelar los agentes existentes. Este enfoque proporciona una ruta de reversión limpia en caso de que surja la necesidad.

Iniciar agentes en modo de espera implica agregar una configuración al archivo de propiedades de un agente (jitterbit-agent-config.properties) para asegurarse de que el agente permanezca fuera de servicio y no comience a acumular una acumulación de solicitudes antes de que se complete la sincronización completa.

Para desplegar un enfoque de actualización continua:

Instale un nuevo agente en un grupo de agentes existente siguiendo las instrucciones para instalar un Agente Privado de Windows.
En el nuevo agente jitterbit-agent-config.properties archivo, agregue el agent.starting.standby propiedad establecida en true para forzar al agente a permanecer en Iniciando estado del agente y evitar que entre en un estado En ejecución donde pueda aceptar solicitudes.
Reinicie el agente.
A medida que se inicia el agente, puede monitorear el estado de sincronización en la página del agente. jitterbit-agent.log archivo, buscando líneas similares a las siguientes que indican cuándo comenzó y se completó la sincronización:
```
Agent synchronization for environment <123456> and agent group ID <987654> started at ...
. . .
Agent synchronization for environment <123456> and agent group ID <987654> completed at ...
```
Una vez que los registros indiquen que la sincronización se completó, elimine el agent.starting.standby propiedad o cambiar su valor a false y reinicie el agente.
Cuando el nuevo agente informe el estado En ejecución, retire a un agente anterior del grupo de agentes.
Repita este proceso para cada agente del grupo de agentes para garantizar que las solicitudes continúen enrutadas a un agente capaz durante el proceso de actualización.

Instalaciones Paralelas de PostgreSQL 9.6 y 14.5¶

Cuando instala un Agente Privado de Windows 11.x, la instalación detectará una instalación existente de PostgreSQL 9.6 en el registro y le advertirá que se deshabilitará.

Al reconocer la advertencia, se detendrá la base de datos PostgreSQL 9.6 existente, se desactivará la ejecución automática del servicio PostgreSQL 9.6 de Windows y se instalará la versión 14.5-1 de PostgreSQL con la instalación del agente 11.x.

Nota

Si las versiones 9.6.x y 14.5.x de PostgreSQL se instalan en paralelo, la instalación del Agente Privado de Windows 11.x obligará a actualizar el controlador ODBC de PostgreSQL a PostgreSQL 13.2.0.0.

Revertir un Agente Privado¶

No se espera que sea necesario volver a una versión anterior de Agente Privado. Sin embargo, si fuera necesario, los pasos se proporcionan a continuación para una rebaja menor y una rebaja importante.

Rebaja Menor¶

Siga estos pasos para cambiar de un agente 11.x a un agente 10.x anterior, o de un agente 10.x a un agente 10.x anterior:

Haga una copia de seguridad de los archivos de configuración del agente y los certificados de seguridad como referencia (opcional, consulte Desinstalar un Agente Privado).
Desinstale el agente (consulte Desinstalar un Agente Privado).
Elimine todos los archivos relacionados con Jitterbit (consulte Desinstalar un Agente Privado).
Instale la versión seleccionada del agente (consulte Instalar un Agente Privado).
Para utilizar los archivos de copia de seguridad de la configuración del agente (opcional):
1. Detenga los servicios del agente (consulte Reiniciar un Agente Privado).
2. Coloque sus certificados de seguridad guardados en el directorio de instalación. Actualice manualmente los archivos de configuración recién instalados según la configuración de sus archivos guardados.
  
  Advertencia
  
  Copiar directamente los archivos de configuración guardados después de un cambio de versión del agente puede provocar errores. En su lugar, utilice herramientas como el complemento Comparar Notepad++ para ayudarle a comparar y actualizar manualmente los ajustes de configuración. No cambie la configuración con contraseñas o puertos definidos como los que se encuentran en la credentials.txt archivo y bajo el [[DbInfo sección de la jitterbit.conf archivo]](/es/agent/private-agents/private-agent-how-tos/edit-the-configuration-file-jitterbit-conf/#editingtheconfigurationfilejitterbit.conf-db-info).
3. Inicie los servicios del agente (consulte Reiniciar un Agente Privado).

Rebaja Importante¶

Siga estos pasos para cambiar de un Agente Privado de Windows 11.x a un Agente Privado de Windows 10.x:

Haga una copia de seguridad de los archivos de configuración del agente y los certificados de seguridad como referencia (opcional, consulte Desinstalar un Agente Privado).
Desinstale el agente (consulte Desinstalar un Agente Privado).
Elimine todos los archivos relacionados con Jitterbit (consulte Desinstalar un Agente Privado).
Desinstale el controlador ODBC de PostgreSQL 13.2.0.0.
Desinstale el controlador de Microsoft Visual C++.
Instale PostgreSQL 9.6 antes de instalar el agente 10.x. La instalación de PostgreSQL 9.6 puede existir al mismo tiempo que la instalación de PostgreSQL 14.5; no es necesario desinstalar PostgreSQL 14.
Instale la versión 10.x del agente (consulte Instalar un Agente Privado). Durante la instalación, se detectará automáticamente la presencia de PostgreSQL 9.6 y el proceso de instalación le indicará que realice una instalación avanzada.
Para utilizar los archivos de copia de seguridad de la configuración del agente (opcional):
1. Detenga los servicios del agente (consulte Reiniciar un Agente Privado).
2. Coloque sus certificados de seguridad guardados en el directorio de instalación. Actualice manualmente los archivos de configuración recién instalados según la configuración de sus archivos guardados.
  
  Advertencia
  
  Copiar directamente los archivos de configuración guardados después de un cambio de versión del agente puede provocar errores. En su lugar, utilice herramientas como el complemento Comparar Notepad++ para ayudarle a comparar y actualizar manualmente los ajustes de configuración. No cambie la configuración con contraseñas definidas o puertos como los que se encuentran en la credentials.txt archivo y bajo el [[DbInfo sección de la jitterbit.conf archivo]](/es/agent/private-agents/private-agent-how-tos/edit-the-configuration-file-jitterbit-conf/#editingtheconfigurationfilejitterbit.conf-db-info).
3. Inicie los servicios del agente (consulte Reiniciar un Agente Privado).