Actualizar un Agente Privado de Windows¶

Introducción¶

La actualización de un Agente Privado de una versión anterior del Agente Privado a una posterior generalmente se puede realizar sin desinstalar la versión anterior del agente, como se describe en actualizaciones menores abajo.

Sin embargo, hay varios casos en los que se requiere una desinstalación completa del agente para poder actualizar. Estas se consideran actualizaciones importantes y se describen con más detalle en las siguientes secciones:

• Actualización de un Agente Privado de Windows 10.x a un Agente Privado de Windows 11.x
• Actualización de Agentes Privados de Windows de 32 bits a 64 bits

Los Agentes Privados también se pueden revertir a una versión anterior como se describe al final de esta página en Revertir un Agente Privado.

Actualización Menor¶

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

Un Agente Privado tarda muy poco tiempo en actualizarse, del orden de tres minutos, según el servidor. Si le preocupa tener una interrupción, puede usar alta disponibilidad (dos o más agentes) y no tienen tiempo de inactividad. Si su suscripción actual no tiene agentes adicionales disponibles para esto, comuníquese con su Gerente de Éxito del Cliente (CSM).

Siga estas instrucciones para actualizaciones de agentes menores:

1. Realice una copia de seguridad de los archivos de configuración y los certificados de seguridad como referencia (opcional; consulte Desinstalar un Agente Privado).

2. Compruebe si necesita desinstalar el agente primero después de la actualización principal instrucciones, según el tipo y la versión del agente instalado:

   • Si actualiza a una versión de 64 bits (ubicada en C:\Program Files\Jitterbit Agent) de una versión de 32 bits (ubicado en C:\Program Files (x86)\Jitterbit Agent).
   • Si actualiza a una versión 11.x desde una versión 10.x.

3. Instale la nueva versión del agente (consulte Instalar un Agente Privado).

4. Para utilizar los archivos de copia de seguridad (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, use herramientas como el complemento de comparación de Notepad ++ para ayudarlo 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 el 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¶

Esta sección describe las circunstancias e instrucciones bajo las cuales se requiere una desinstalación completa del Agente Privado existente para poder actualizar.

Actualización de un Agente Privado de Windows 10.x a un Agente Privado de Windows 11.x¶

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

1. Realice 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 enfáticamente 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.

5. Instale la versión 11.x del agente (consulte Instalar un Agente Privado). Al actualizar a una versión 11.x del agente, el controlador ODBC de PostgreSQL se actualizará a PostgreSQL ODBC 13.2.0.0. El agente volverá a descargar todos los proyectos.

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 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, use herramientas como el complemento de comparación de Notepad ++ para ayudarlo 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 el 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).

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 del registro y le advertirá que se desactivará.

Al reconocer la advertencia, la base de datos PostgreSQL 9.6 existente se detendrá, el servicio de Windows PostgreSQL 9.6 se deshabilitará para que no se ejecute automáticamente y la versión 14.5-1 de PostgreSQL se instalará con la instalación del agente 11.x.

Actualización de Agentes Privados de Windows de 32 Bits a 64 Bits¶

Al actualizar de un Agente Privado de Windows de 32 bits a uno de 64 bits, las versiones existentes del agente de 32 bits deben desinstalarse antes de la actualización (consulte las instrucciones para Desinstalación de Windows).

Además, se deben desinstalar las instalaciones existentes del controlador PostgreSQL y PostgreSQL (psqlODBC o pODBC).

Los controladores ODBC de 32 bits existentes no son compatibles con los Agentes Privados de 64 bits.

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

1. Realice 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. 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 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, use herramientas como el complemento de comparación de Notepad ++ para ayudarlo 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 el 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 Mayor¶

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

1. Realice 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. 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, use herramientas como el complemento de comparación de Notepad ++ para ayudarlo 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 el 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).