Actualizar o Desinstalar un Agente Privado de Linux¶

Introducción¶

Se puede actualizar un Agente Privado desde una versión anterior de Agente Privado a una posterior sin desinstalar la versión anterior del agente, como se describe en Actualizar un Agente abajo. Sin embargo, existen consideraciones adicionales al actualizar de un Agente Privado de Linux 10.x a 11.x.

Revertir un agente y desinstalar un agente también se tratan en esta página.

Actualizar un Agente¶

La actualización de un Agente Privado en Linux se puede realizar utilizando los mismos comandos utilizados durante la instalación inicial. No es necesario ejecutar el secuencia de comandos de configuración al actualizar un Agente Privado existente.

Para obtener más información, consulte Debian o RPM instrucciones para instalar un Agente Privado.

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.

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

Los Agentes Privados de Linux se pueden actualizar a 11.x desde cualquier versión de agente 10.x compatible sin ningún comando adicional. Una actualización de la base de datos PostgreSQL y una actualización del controlador ODBC de PostgreSQL se completarán automáticamente cuando se actualice el agente, siempre que se cumplan los requisitos de PostgreSQL se cumplan.

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 de la cantidad 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.

• El planificador tiene un inicio retrasado de 10 minutos, como se indica en Scheduler.log. Durante este tiempo, no se activará la ejecución de las operaciones programadas. Una vez que se completa el retraso, se activarán las operaciones programadas que se habrían activado para ejecutarse durante el retraso.

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:

1. Instale un nuevo agente en un grupo de agentes existente siguiendo las instrucciones de Debian o RPM instrucciones para instalar un Agente Privado de Linux.

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

3. Reinicie el agente.

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

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

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

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

Revertir un Agente¶

No se espera que sea necesario volver a una versión anterior de un Agente Privado. Sin embargo, en caso de ser necesario, estos son los pasos:

1. Haga una copia de seguridad de los archivos de configuración y los certificados de seguridad como referencia (opcional; consulte Desinstalar Agente abajo).
2. Desinstale el agente (consulte Desinstalar Agente abajo).
3. Elimine todos los archivos relacionados con Jitterbit (consulte Desinstalar Agente abajo).
4. Instale la versión seleccionada del agente. Consulte Instalar un Agente Harmony Linux (Debian o RPM).

5. Para usar sus archivos de respaldo (opcional):

   1. Detenga los servicios del agente (consulte Reiniciar un Agente Privado de Linux).

   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 de Linux).

Desinstalar un Agente¶

Antes de desinstalar, se recomienda guardar los archivos de configuración y los certificados de seguridad de su instalación actual como referencia. Estos normalmente se encuentran en:

/opt/jitterbit/jitterbit.conf
/opt/jitterbit/apache/conf/httpd.conf
/opt/jitterbit/JdbcDrivers.conf
/opt/jitterbit/Resources/jitterbit-agent-config.properties
/opt/jitterbit/Resources/credentials.txt

/opt/jitterbit/apache/conf/extra/
/opt/jitterbit/apache/conf/ssl.crt/
/opt/jitterbit/apache/conf/ssl.key/

$ sudo dpkg --remove jitterbit-agent

$ sudo apt-get remove jitterbit-agent

$ yum remove jitterbit-agent

$ rpm --erase jitterbit-agent

Eliminar Todos los Archivos Relacionados con Jitterbit¶

La desinstalación eliminará los archivos instalados durante la instalación. El /opt/jitterbit El directorio y la base de datos de Harmony Agente Privado no se borran automáticamente y pueden incluir archivos de registro y archivos de aplicación generados al ejecutar operaciones. Para eliminar por completo todos los archivos relacionados con Jitterbit, utilice estos dos comandos:

$ sudo rm -rf /opt/jitterbit
$ sudo rm -rf /tmp/jitterbit