Saltar al contenido

Actualizar un Agente Privado de Windows

Introducción

La actualización de un agente privado de una versión anterior 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.

Pequeña Actualización

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, se utilizan las instrucciones para instalar un agente privado y siga las indicaciones para actualizar la instalación del agente existente.

Siga estas instrucciones para realizar actualizaciones menores del agente:

  1. Realice una copia de seguridad de los archivos de configuración y los certificados de seguridad para referencia (opcional; consulte Desinstalar un agente privado).

  2. Instale la nueva versión del agente (consulte Instalar un agente privado).

  3. Para utilizar los archivos de respaldo (opcional):

    1. Detenga los servicios del agente (consulte Reiniciar un agente privado).

    2. Coloque los 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 los 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 [[DbInfoSecció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 actualizar a los agentes privados de Windows 11.x.

Para actualizar de un agente privado de Windows 10.x a 11.x, siga estos pasos:

  1. 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).
  2. Desinstale el agente 10.x existente (consulte Desinstalar un agente privado).
  3. Elimine todos los archivos relacionados con Jitterbit (consulte Desinstalar un agente privado).

  4. 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 a continuación.

  5. 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 a continuación.

  6. 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 los 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 los 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 [[DbInfoSecció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 de Gran Tamaño

Si una interrupción del servicio es una preocupación durante la actualización de un agente, recomendamos utilizar alta disponibilidad (dos o más agentes) para que las solicitudes se dirijan 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 cuando se actualiza de una versión de agente 10.x a una 11.x, recomendamos un enfoque de actualización gradual, en el que se instalan nuevos agentes en modo de espera de a uno por vez en un grupo de agentes existente antes de dar de baja 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:

  1. Instale un nuevo agente en un grupo de agentes existente siguiendo las instrucciones para instalar un agente privado de Windows.

  2. En el nuevo agente jitterbit-agent-config.properties archivo, agregue el agent.starting.standby propiedad establecida en true para obligar al agente a permanecer en Inicio estado del agente y evitar que entre en un estado En ejecución donde pueda aceptar solicitudes.

  3. Reinicie el agente.

  4. A medida que se inicia el agente, puede monitorear el estado de sincronización en el jitterbit-agent.log archivo, buscando líneas similares a las que aparecen a continuación que indican cuándo se inició 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 ...

  5. Una vez que los registros indiquen que la sincronización está completa, elimine el agent.starting.standby propiedad o cambiar su valor a false y reinicie el agente.

  6. Cuando el nuevo agente informe el estado En ejecución, desactive un agente anterior del grupo de agentes.

  7. Repita este proceso para cada agente del grupo de agentes para garantizar que las solicitudes sigan enrutándose 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 que el controlador ODBC de PostgreSQL se actualice a PostgreSQL 13.2.0.0.

Revertir un Agente Privado

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

Pequeña Degradación

Siga estos pasos para cambiar de una versión 11.x a una versión 10.x anterior, o de una versión 10.x a una versión 10.x anterior:

  1. Realice una copia de seguridad de los archivos de configuración del agente y de los certificados de seguridad para referencia (opcional, consulte Desinstalar un agente privado).
  2. Desinstale el agente (consulte Desinstalar un agente privado).
  3. Elimine todos los archivos relacionados con Jitterbit (consulte Desinstalar un agente privado).

  4. Instale la versión seleccionada del agente (consulte Instalar un agente privado).

  5. 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 los 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 los 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 [[DbInfoSecció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).

Reducción Importante

Siga estos pasos para cambiar de un agente privado de Windows 11.x a un agente privado de Windows 10.x:

  1. 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).
  2. Desinstale el agente (consulte Desinstalar un agente privado).
  3. Elimine todos los archivos relacionados con Jitterbit (consulte Desinstalar un agente privado).

  4. Desinstale el controlador ODBC de PostgreSQL 13.2.0.0.

  5. Desinstale el controlador de Microsoft Visual C++.

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

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

  8. Para utilizar los archivos de copia de seguridad de la configuración del agente (opcional):

    1. Detener los servicios del agente (consulte Reiniciar un agente privado).

    2. Coloque los 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 los 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 [[DbInfoSecció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).