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:
- Siga la configuración de ajuste de rendimiento guía.
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
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
. scripts/set.env.sh scripts/install.sh ```
Configurar
Para configurar, registrar y reiniciar un agente privado en Linux, siga estos pasos:
-
Ejecute este comando:
jitterbit-config
Para permitir que el agente se comunique a través de un servidor proxy, agregue las opciones requeridas.
-
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 eljitterbit
usuario, entrary
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]:`
-
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:
-
Descargar un paquete de instalación.
-
Detener el agente.
-
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
-
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 jitterbittar -C /opt -xf <PATH>/jitterbit-agent-<VERSION>.x86_64.tar
-
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
-
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. -
(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 propiedadagent.starting.standby=true
. (Esto mantiene al agente en estado Iniciando y evita que procese operaciones hasta que el valor de la propiedad se establezca enfalse
.) -
Para iniciar el agente, ejecute este comando:
jitterbit start
-
(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 propiedadagent.starting.standby
(o configúrelo enfalse
), luego reinicie el agente.
Desinstalar
Para desinstalar un agente privado en Linux, siga estos pasos:
-
Detenerse el agente.
-
(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
-
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 sudoyum 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: