Requisitos del Sistema para Agentes Privados de Linux¶

Descripción General¶

Estos son los requisitos del sistema para instalar el agente privado Harmony en un sistema Linux. Antes de la instalación, recomendamos revisar Alta disponibilidad y balanceo de cargas de los grupos de Agente y Charla técnica sobre las mejores prácticas de los agentes privados.

Para obtener instrucciones sobre cómo descargar, instalar, configurar, reiniciar, actualizar, revertir y desinstalar un agente privado de Linux, consulte la página correspondiente a las distribuciones compatibles:

Requisitos del Sistema¶

Mejores Prácticas¶

Sistemas compatibles: Instale el agente privado en un sistema probado y compatible, como se indica en esta página. Para obtener resultados óptimos, le recomendamos que siga estos requisitos previos y requisitos para el sistema operativo, la base de datos PostgreSQL y el hardware.
Alta disponibilidad y balanceo de cargas: Antes de la instalación, revise las recomendaciones de alta disponibilidad (activa/activa) y balanceo de cargas como se describe en Alta disponibilidad y balanceo de cargas de los grupos de Agente.
Instalación del servidor: Para ambientes de producción, recomendamos instalar el agente privado en un servidor. La instalación del Agente en una computadora de escritorio se recomienda solo para ambientes de desarrollo, control de calidad o pruebas.
Instalación limpia: No instale el agente privado en un servidor que ya esté ejecutando otra base de datos. El agente instala y ejecuta su propia base de datos PostgreSQL. Ejecutar el agente en un servidor que ya esté ejecutando una base de datos Oracle o SQL Server puede causar problemas de rendimiento.
Misma zona horaria: Recomendamos que todos los agentes de un grupo de agentes privados tengan la misma zona horaria. Debido a que la zona horaria de los cronogramas configurados depende de la zona horaria del agente privado, las ejecuciones de los cronogramas pueden ser impredecibles si las zonas horarias son diferentes.
Permisos de cuenta: Recomendamos utilizar una cuenta de superusuario de Linux para instalar el agente. No se recomienda utilizar una cuenta de usuario local.
Desinstalación: Antes de desinstalar, le recomendamos que copie los archivos de configuración y los certificados de seguridad de su instalación actual en caso de que desee reinstalar con la misma configuración en otro momento.

Requisitos del Sistema Operativo¶

La versión Linux del agente privado Harmony requiere un sistema operativo de 64 bits. Es compatible con estas distribuciones derivadas de Debian Linux y Red Hat Enterprise Linux para hardware Intel:

Ubuntu 20.04 LTS
Ubuntu 22.04 LTS
Red Hat Enterprise Linux 8
Amazon Linux AMI 2

El agente privado Harmony no ha sido certificado frente a otras distribuciones similares con distribuciones de paquetes Debian o RPM derivadas de las distribuciones Debian y Red Hat. Amazon Linux ofrece varias versiones de Linux, de las cuales solo Amazon Linux AMI 2 ha sido certificado.

Requisitos de Software Previos¶

Para obtener instrucciones sobre cómo instalar las bibliotecas necesarias, consulte la página correspondiente a su distribución:

Versión de Java Requerida¶

El paquete de agente privado Harmony se incluye con una versión de 64 bits del ambiente de ejecución de Java 8 (JRE) y no requiere un tiempo de ejecución de Java independiente. Jitterbit instala automáticamente el ambiente de ejecución de Java requerido específicamente para que Jitterbit lo use de modo que no entre en conflicto con otras instalaciones de Java que puedan estar ya instaladas. A partir de Harmony 9.8, la versión de Java que se incluye con el agente es AdoptOpenJDK JRE. Este JRE tiene la licencia descrita en el sitio web de OpenJDK.

Jitterbit se puede configurar para utilizar un JRE externo. La versión mínima es 1.8 (Java 8). Para cambiar el tiempo de ejecución de Java utilizado por el agente privado de Harmony, edite el archivo /etc/sysconfig/jitterbit utilizar la versión adecuada del tiempo de ejecución de Java y reiniciar todos los servicios de Jitterbit.

Requisito de Extensión de Criptografía Java de Resistencia Ilimitada¶

Para que el agente se comunique de forma segura con recursos como servidores, el ambiente de ejecución de Java que utiliza el agente debe utilizar la extensión de criptografía de Java (JCE) con archivos de política de jurisdicción de resistencia ilimitada. Si utiliza el JRE que se envía con el agente, este utiliza JCE con archivos de política de jurisdicción de resistencia ilimitada.

Si sustituye un JRE diferente al que se incluye con el agente, deberá reemplazar los archivos de políticas incluidos con el JRE por archivos de políticas de jurisdicción de fuerza ilimitada, si aún no los está utilizando. Para instalar los archivos de políticas de jurisdicción de fuerza ilimitada de la extensión de criptografía de Java:

Vaya al sitio web de Oracle para descargar el archivo ZIP que contiene los archivos de política de jurisdicción de fuerza ilimitada de Java Cryptography Extension (JCE).
Descomprima el archivo ZIP para extraer el archivo local_policy.jar y US_export_policy.jar archivos JAR.
Copie y reemplace los archivos JAR existentes que se encuentran en <JITTERBIT_HOME>\jre\lib\security, reemplazando <JITTERBIT_HOME> con la ruta al directorio raíz de su agente privado.
Reinicie el agente privado Jitterbit.

Requisitos de PostgreSQL¶

PostgreSQL se instala como parte de la instalación del agente privado. Esta instancia de PostgreSQL es para uso exclusivo de Jitterbit.

La versión de PostgreSQL distribuida con el agente depende de la versión del agente privado:

Los agentes privados de Linux 11.0 y posteriores se incluyen con la versión 14.5-1 de 64 bits de PostgreSQL y el controlador ODBC PostgreSQL 13.2.0.0.
Los agentes privados de Linux 10.37 a 10.x se incluyen con una versión 9.6.x de 64 bits de PostgreSQL con el controlador ODBC de PostgreSQL 9.2.

El uso de una instalación de PostgreSQL existente en lugar de la instancia de PostgreSQL incluida con el agente se admite mediante opciones de configuración avanzadas. Durante la configuración de un agente privado de Linux, ejecute el secuencia de comandos de configuración con el -c opción.

La versión de la base de datos PostgreSQL existente debe coincidir con la esperada por la versión del agente:

Para los agentes privados de Linux 11.0 y posteriores, se ha confirmado que funciona una base de datos PostgreSQL existente de la versión 14.5-1. Se espera que funcionen otras versiones de PostgreSQL 14.x, pero no se han probado.
Para los agentes privados de Linux 10.x que sean al menos 10.37, la base de datos PostgreSQL existente debe ser la versión 9.6.x.

Se deben cumplir estos requisitos para instalar la instancia de PostgreSQL que viene incluida con el agente:

No instale PostgreSQL por separado antes de instalar un agente privado para instalaciones nuevas.
No utilice un signo más (+) como parte de la contraseña de PostgreSQL al instalar un agente privado de Harmony. La cantidad mínima de caracteres para una contraseña de PostgreSQL es ocho (8). Le recomendamos que no utilice caracteres acentuados (como é) o cualquiera de estos caracteres en la contraseña de PostgreSQL : + @ $ % &[] {} (), ; ? ^ = £.
No tenga ninguna otra base de datos configurada o ejecutándose en la instancia PostgreSQL de Jitterbit.
No utilice la base de datos/servidor PostgreSQL Jitterbit como parte de ninguna operación o transformaciones de Jitterbit.
No utilice la compresión de Windows en la carpeta Jitterbit, la carpeta PostgreSQL o la carpeta temporal de la máquina donde está instalado y en ejecución el agente privado. El uso de la compresión de Windows ralentizará drásticamente el procesamiento de las operaciones y transformaciones de Jitterbit.
El puerto 46914 debe estar libre para que lo utilice la base de datos PostgreSQL.
PgBouncer puede ser necesario para ambientes de alta carga. Agente privado Harmony Linux versión 10.6 y luego se instala automáticamente PgBouncer. Si ya tiene una instalación existente de PgBouncer y si tiene problemas con la actualización, comuníquese con el soporte técnico para obtener ayuda.

Requisitos de Hardware¶

Estos son los requisitos mínimos de hardware y máquinas virtuales para los agentes privados de Harmony:

Procesador de cuatro núcleos
8 GB de RAM
50 GB de espacio disponible en el disco duro; esto incluye espacio para el software, el procesamiento paralelo y el almacenamiento temporal que puede crecer bastante mientras se ejecuta una operación.
Velocidad de transferencia mínima de 100 MB/s (megabytes por segundo) en el disco duro
Conexión a Internet de alta velocidad
Una instalación directa de hardware o una instalación en una máquina virtual de VMWare, VirtualBox, Amazon AWS o Rackspace que esté configurada para los requisitos específicos descritos anteriormente
Configuración óptima del sistema y del ambiente general; si no se configura de forma óptima, pueden surgir problemas esporádicos e impredecibles debido a una E/S de disco deficiente, memoria limitada o insuficiente, espacio de disco limitado o insuficiente, fallas de energía y/o reinicios abruptos del sistema.
Acceso al puerto de salida 443 (HTTPS) para comunicarse con Harmony. El puerto 443 normalmente está permitido por los firewalls de servidores corporativos.
Acceso a puertos de entrada específicos según sea necesario; generalmente, no es necesario abrir los puertos de entrada

Se recomienda utilizar la plataforma API Jitterbit para los mensajes o datos entrantes. Cuando se utiliza un agente privado para recibir un mensaje directamente (como un mensaje saliente de Salesforce) en lugar de la plataforma API Jitterbit, se pueden abrir los puertos entrantes 443 (con SSL) o 46909 (HTTPS). Se pueden utilizar puertos personalizados para requisitos específicos si se redefinen en la configuración del agente privado y están permitidos por cualquier firewall corporativo.

Próximos Pasos¶

Para obtener instrucciones sobre cómo descargar, instalar, configurar, reiniciar, actualizar, revertir y desinstalar un agente privado de Linux, consulte la página correspondiente a su distribución: