Saltar al contenido

PostgreSQL para agentes privados de Jitterbit

Introducción

Los agentes privados dependen de un servidor de base de datos PostgreSQL para el almacenamiento persistente. Se instala una instancia de PostgreSQL durante el proceso de instalación del agente, pero puedes optar por usar tu propia instancia de PostgreSQL. Esta página muestra cómo hacerlo y cómo inspeccionar el contenido de la base de datos.

Requisitos previos

Si deseas usar tu propia instancia de base de datos PostgreSQL, debe cumplir con los siguientes requisitos.

Misma versión que la empaquetada

Los números de versión mayor y menor de tu instancia de PostgreSQL deben coincidir con la que se incluyó originalmente con el agente privado. (Los agentes privados actualmente utilizan la serie PostgreSQL 14.x). Para ver qué versión está instalada, ejecuta este comando:

 & "C:\Program Files\PostgreSQL\14\bin\postgres.exe" -V

/opt/jitterbit/pgsql/bin/postgres -V

Precaución

Otras versiones pueden funcionar, pero no han sido probadas.

Restricciones de caracteres de la contraseña

La contraseña para la cuenta de administrador del servidor (generalmente postgres) no debe contener caracteres acentuados (como é), ni ninguno de los caracteres que se muestran a continuación:

+ @ $ % & [] { } ( ) , ; ? ^ = £ \ |

Cifrado de contraseña MD5

El servidor debe utilizar cifrado de contraseña MD5. Para establecer esto, ejecuta lo siguiente en una sesión de psql:

set password_encryption TO 'md5';

Puertos abiertos

El puerto 46914 debe estar abierto y disponible.

Recomendaciones

Lo siguiente no es obligatorio, pero se recomienda:

  • En entornos de alta carga, instala PgBouncer.

  • No utilices la base de datos ni su host en ninguna operación de proyecto.

Usa tu propia instancia de PostgreSQL

La forma de configurar un agente para usar tu propia instancia de PostgreSQL depende del tipo de host del agente:

Con el instalador estándar, en el aviso Seleccionar modo de instalación, selecciona Avanzado. (Esto se selecciona automáticamente si se encuentra una instalación existente de PostgreSQL en el host.) Sigue las indicaciones para configurar el agente para usar tu propio servidor PostgreSQL.

Con el instalador silencioso, la instancia de PostgreSQL debe estar en ejecución en el mismo host que el agente. Establece los parámetros Postgres_* para tu instancia y luego ejecuta el instalador.

  1. Después de instalar el paquete del agente y antes del paso de Configurar, ejecuta el siguiente comando:

    jitterbit-config -c

  2. Sigue las indicaciones para configurar el agente para usar tu propio servidor PostgreSQL.

  3. Completa los pasos de Configurar.

Navegar la base de datos

Precaución

Debes acceder a la instancia de PostgreSQL del agente privado solo cuando lo indique el soporte de Jitterbit.

Durante el proceso de instalación, además de la cuenta de administrador predeterminada postgres, se crea una segunda cuenta, con el nombre jitterbit en Linux, o jitterbitpostgres en Windows. Esto ocurre ya sea que uses la instancia de PostgreSQL predeterminada o la tuya propia.

La contraseña para esta cuenta se genera aleatoriamente y se escribe en el archivo jitterbit.conf, bajo la sección [DbInfo], junto con los detalles de conexión del servidor de base de datos:

Ejemplo de la sección [DbInfo] de jitterbit.conf
[DbInfo]
User=jitterbit
Password='Ts1OtvM?tid5onCAqin!'
Driver='PostgreSQL-jitterbit'
SystemDbName='postgres'
Server=0.my.pg.host
Port=5432

Consejo

Como esta es una cuenta de administrador adicional, puedes usarla para restablecer una contraseña olvidada para la cuenta de administrador predeterminada postgres.

Los agentes privados almacenan datos en numerosas tablas en la base de datos TranDb. A continuación se presenta una selección de tablas y columnas de particular interés:

  • key_values: Detalles del agente:

    Nombre de columna Descripción
    VersionNumber Versión del agente
    Agent_Name Nombre del agente
    Agent_Group_Name Nombre del grupo
    Agent_Group_Id ID del grupo
    Agent_Id ID del agente
    Agent_Group_Size Número de agentes en el grupo

  • environmentstab: Detalles del entorno:

    Nombre de columna Descripción
    id ID del entorno
    organization_id ID de la organización a la que pertenece este entorno
    environmentname Nombre del entorno

  • deploylogtab: Todos los elementos del proyecto desplegados en este agente.

  • operationstab: Operaciones desplegadas en este agente.

  • organizationinfotab: Organizaciones con las que está registrado el agente.

  • projectstab: Proyectos desplegados en este agente.

  • verboseloguploadtab: Registro de mensajes de log detallados subidos a la nube.