Saltar al contenido

Agentes privados de Jitterbit en Linux

Introducción

Esta página le muestra cómo instalar y ejecutar un agente privado en Linux. Solución de problemas La sección ofrece una lista de problemas comunes y sus soluciones.

Instalar

Para instalar un agente privado, consulte los Requisitos previos, luego siga los pasos en Descargar, Ejecutar instalador, y Configurar secciones.

Prerrequisitos

Debes tener lo siguiente:

  • Un alojar que cumpla con los requisitos del sistema.

  • Su nombre de usuario y contraseña de su cuenta Harmony.

  • El nombre de su organización Harmony.

  • El nombre y el ID de un grupo de agentes privados.

  • Una cuenta con privilegios de root. Úsela para todas las acciones de esta página.

Los siguientes son opcionales:

  • Agregar un agente en la Management Console. Si no tiene ningún agente privado no registrado en el grupo de agentes, se crea uno automáticamente con un nombre que incluye el nombre del host y la dirección IP.

  • Un servidor de base de datos PostgreSQL se instala automáticamente. Para utilizar el suyo, debe configurarlo antes de instalar el agente privado y tener listo su nombre o dirección IP, su número de puerto y los detalles de la cuenta de administrador de la base de datos.

Se recomiendan los siguientes:

Descargar

Para descargar el software del agente privado, vaya al Portal Harmony Descargas página. (Si ya ha agregado un agente en la página Agentes de la Management Console, haga clic en el agente del agente Descargar Jitterbit Agente** icono.)

Descargue uno de los siguientes paquetes de agente privado de Linux:

  • Linux Debian (x64): El .deb archivo de paquete, para instalar en Debian o Ubuntu Linux como root.

  • RPM de Linux: El .rpm archivo de paquete, para instalar en Red Hat Linux como root.

  • Linux Redhat no root (x64): El .tar archivo que puede ser descomprimido en Red Hat Linux por un usuario que no sea root.

Nota

A root o sudo La cuenta aún es necesaria para instalar el software prerrequisito y agregar una cuenta de usuario.

Ejecutar el instalador

En una terminal, ejecute los siguientes comandos para el tipo de instalador descargado:

apt-get install <PATH>/jitterbit-agent_<VERSION>_amd64.deb
update-alternatives --install /usr/bin/python python /usr/bin/python2 1
yum install <PATH>/jitterbit-agent-<VERSION>.x86_64.rpm
alternatives --set python /usr/bin/python2
as root
yum install python2 tar unixODBC unzip
alternatives --set python /usr/bin/python2
useradd -U jitterbit -b /opt -G wheel
passwd jitterbit
# Set a password

```sh title="as jitterbit" tar -C /opt -xf /jitterbit-agent-.x86_64.tar

. scripts/set.env.sh scripts/install.sh ```

Configurar

Para configurar, registrar y reiniciar un agente privado en Linux, siga estos pasos:

  1. Ejecute este comando:

    jitterbit-config
    

    Para permitir que el agente se comunique a través de un servidor proxy, agregue las opciones requeridas.

  2. Cuando se le solicite, ingrese el nombre de usuario y la contraseña de su cuenta de Harmony, y seleccione las opciones correspondientes a su organización, grupo de agentes y agente.

    Si instaló el tar paquete como el jitterbit usuario, entrar y en el siguiente mensaje:

    Warning: this tool requires root privileges.
    Hint: Use sudo or log on as the root user.
    Do you want to continue as the current user?`[t/n]:`
    
  3. Ejecute este comando:

    jitterbit restart
    

Mejora

Una actualización de una versión menor del agente privado (Agente privado 10, versión 10.x a 10.y, o Agente privado 11, versión 11.x a 11.y) requiere que el agente se detenga y se reinicie. Una actualización de una versión mayor (Agente privado 10 a Agente privado 11) es lo mismo, pero requiere una sincronización completa de ambientes.

Consejo

Durante la sincronización, el agente no puede procesar operaciones. Para minimizar el tiempo de inactividad del agente que afecta a los procesos comerciales, configure un grupo de agentes con varios agentes y permita que los agentes se sincronicen por completo antes de permitirles procesar operaciones.

Para actualizar un agente privado en Linux, siga estos pasos:

  1. Descargar un paquete de instalación.

  2. Detener el agente.

  3. Realice copias de seguridad de los siguientes archivos:

    Ubicación Archivo
    /opt/jitterbit/ jitterbit.conf
    /opt/jitterbit/ JdbcDrivers.conf
    /opt/jitterbit/Resources/ jitterbit-agent-config.properties
    /opt/jitterbit/apache/conf/ httpd.conf
    /opt/jitterbit/apache/conf/ *.crt
    /opt/jitterbit/apache/conf/ *.key
    /opt/jitterbit/apache/conf/extra/ *.conf
    /opt/jitterbit/jre/lib/security/ cacerts
  4. En una terminal, ejecute el siguiente comando para el tipo de instalador descargado:

    apt-get upgrade <PATH>/jitterbit-agent_<VERSION>_amd64.deb
    
    yum upgrade <PATH>/jitterbit-agent-<VERSION>.x86_64.rpm
    
    as jitterbit
    tar -C /opt -xf <PATH>/jitterbit-agent-<VERSION>.x86_64.tar
    
  5. Compare los siguientes archivos con sus copias de seguridad y restaure las configuraciones modificadas:

    Ubicación Archivo
    /opt/jitterbit/ jitterbit.conf
    /opt/jitterbit/ JdbcDrivers.conf
    /opt/jitterbit/Resources/ jitterbit-agent-config.properties
    /opt/jitterbit/apache/conf/ httpd.conf
    /opt/jitterbit/apache/conf/extra/ *.conf
    /opt/jitterbit/jre/lib/security/ cacerts
  6. Si tienes una copia de seguridad .crt o .key archivos que aún no están en /opt/jitterbit/apache/conf/, cópielos en esa ubicación.

  7. (Opcional) Si debe actualizar otros agentes en el mismo grupo, puede minimizar el impacto del tiempo de inactividad del agente utilizando un enfoque de actualización continua. Para ello, abra jitterbit-agent-config.properties archivo para editarlo y agregar o configurar la propiedad agent.starting.standby=true. (Esto mantiene al agente en estado Iniciando y evita que procese operaciones hasta que el valor de la propiedad se establezca en false.)

  8. Para iniciar el agente, ejecute este comando:

    jitterbit start
    
  9. (Opcional) Si está realizando una actualización continua con el valor de la propiedad agent.starting.standby=true, y antes de actualizar otro agente en el mismo grupo, supervise el archivo de registro del agente para el siguiente mensaje:

    Agent synchronization for environment <123456> and agent group ID <987654> completed at ...
    

    Este mensaje indica que el agente ha completado la sincronización del ambiente Cuando aparezca, edite jitterbit-agent-config.properties Nuevamente, elimine la propiedad agent.starting.standby(o configúrelo en false), luego reinicie el agente.

Desinstalar

Para desinstalar un agente privado en Linux, siga estos pasos:

  1. Detenerse el agente.

  2. (Opcional) Realice copias de seguridad de los siguientes archivos:

    Ubicación Archivo
    /opt/jitterbit/ jitterbit.conf
    /opt/jitterbit/ JdbcDrivers.conf
    /opt/jitterbit/Resources/ jitterbit-agent-config.properties
    /opt/jitterbit/apache/conf/ httpd.conf
    /opt/jitterbit/apache/conf/ *.crt
    /opt/jitterbit/apache/conf/ *.key
    /opt/jitterbit/apache/conf/extra/ *.conf
    /opt/jitterbit/jre/lib/security/ cacerts
  3. Para eliminar los archivos de instalación (incluido PostgreSQL y su directorio de datos), el archivo de inicio del servicio y el jitterbit cuenta de usuario, ejecute estos comandos:

    apt-get remove --autoremove jitterbit-agent
    userdel --remove --force jitterbit
    
    yum remove jitterbit-agent
    userdel --remove --force jitterbit
    
    as root or with sudo
    yum remove python2 tar unixODBC unzip
    userdel --remove --force jitterbit
    

Administrar

Puedes empezar, detener, y muestra el estado de un agente privado con el jitterbit dominio. También puede utilizar la Management Console para detener un agente de forma remota, pero solo puede reiniciarlo nuevamente en una terminal en el alojar. A excepción de las instalaciones que no sean root, también puede reiniciar el agente reiniciando el alojar.

Los agentes comenzaron con registro automático se cancela automáticamente el registro cuando se detiene.

Comenzar

Agentes privados instalados desde un .deb o .rpm El archivo del paquete se inicia automáticamente con el alojar. Para usuarios que no son root .tar Para instalar archivos, debe agregar un secuencia de comandos del sistema para iniciar el agente o iniciarlo manualmente.

Nota

Un agente privado puede tardar varios minutos en completar la sincronización y estar en estado de ejecución.

Para iniciar un agente privado en Linux, ejecute este comando:

jitterbit start

Detener

Hay tres formas de detener un agente privado, cada una de las cuales se diferencia en cómo se tratan las operaciones en ejecución:

  • Pausa de drenaje: el agente rechaza nuevas operaciones y permite que las operaciones en ejecución continúen hasta su finalización.

  • Detención del drenaje: el agente rechaza nuevas operaciones y permite que las operaciones en ejecución continúen hasta su finalización hasta un período establecido por el parámetro agent.drainstop.api.wait (por defecto, 180 segundos).

  • Parada brusca: el agente rechaza nuevas operaciones y finaliza las operaciones en ejecución.

    Precaución

    Detener bruscamente un agente privado puede provocar la pérdida de datos.

Pausa de drenaje

Para drenar y pausar un agente privado en Linux, ejecute el siguiente comando en una terminal:

jitterbit-utils --drain-pause

En la Management Console, el estado se muestra como Deteniendo.

Para reanudar un agente en pausa en Linux, utilice Iniciar dominio.

Tapón de drenaje

Para detener el drenaje de un agente privado en Linux, utilice cualquiera de estas opciones:

  • En el menú del portal Harmony, seleccione Management Console > Agentes. En la columna Acción del agente que se va a detener, seleccione Acción > Detención de drenaje y, a continuación, haga clic en Aceptar en el cuadro de diálogo de confirmación.

  • En una terminal, ejecute el siguiente comando:

    jitterbit-utils --drain-stop
    

Parada brusca

Para detener por completo un agente privado en Linux, ejecute este comando:

jitterbit stop

Precaución

Detener bruscamente un agente privado puede provocar la pérdida de datos.

Estado

Para ver el estado del agente, utilice cualquiera de estas opciones:

  • Desde el menú del Portal Harmony, seleccione Management Console > Agentes.

  • En una sesión de terminal, ejecute este comando:

    jitterbit status
    

Solucionar problemas

Estas secciones de la Página de solución de problemas puede ayudar a solucionar problemas de instalaciones de agentes privados en Linux: