Actualizar o Desinstalar un Agente Privado de Linux¶

Introducción¶

La actualización de un agente privado desde una versión anterior a una posterior se puede realizar sin desinstalar la versión anterior del agente, como se describe en Actualizar un agente a continuación. Sin embargo, existen consideraciones adicionales al actualizar de un agente privado de Linux 10.x a uno 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.

Pequeña Actualización¶

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

Si ha agregado certificados al archivo de almacén de claves (/opt/jitterbit/jre/lib/security/cacerts), restáurelo desde su copia de seguridad y luego reinicie el agente.

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. La actualización de la base de datos PostgreSQL y del controlador ODBC PostgreSQL se completará automáticamente cuando se actualice el agente, siempre que se cumplan los requisitos de PostgreSQL se cumplen.

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 el uso típico del 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 que se produzca una interrupción, consulte las recomendaciones para implementaciones grandes a continuación.

• El programador tiene un inicio retrasado de 10 minutos, como se indica en Scheduler.log durante este tiempo, no se activarán las operaciones programadas. Una vez que se complete la demora, se activarán las operaciones programadas que se hubieran activado durante la demora.

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 se mantenga fuera de servicio y no comience a acumular una gran cantidad 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 el procedimiento 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 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.

Revertir un Agente¶

No se espera que sea necesario volver a una versión anterior de un agente privado. Sin embargo, si fuera necesario, estos son los pasos:

1. Realice una copia de seguridad de los archivos de configuración y los certificados de seguridad para referencia (opcional; consulte Desinstalar agente a continuación).
2. Desinstale el agente (consulte Desinstalar agente a continuación).
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 utilizar sus archivos de respaldo (opcional):

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

   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, use herramientas como el complemento de comparación de Notepad++ para ayudarlo a comparar y actualizar manualmente las configuraciones. No cambie las configuraciones con contraseñas o puertos definidos, como los que se encuentran en el 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 de Linux).

Desinstalar un Agente¶

Antes de desinstalar, se recomienda guardar los archivos de configuración y los certificados de seguridad de la instalación actual para fines de referencia. Por lo general, 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 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. /opt/jitterbit el directorio y la base de datos del agente privado de Harmony 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