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. Una instancia de PostgreSQL se instala 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

El número de versión mayor.menor de la instancia de PostgreSQL que deseas usar debe coincidir con el instalado por el agente privado. Para ver qué versión está actualmente instalada, ejecuta este comando:

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

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

Restricciones de caracteres de la contraseña

La contraseña para la cuenta de administrador del servidor (generalmente postgres) debe tener 8 caracteres o más, y 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 usar 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 ejecutándose en el mismo host que el agente. Establezca los parámetros Postgres_* para su instancia y luego ejecute el instalador.

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

    jitterbit-config -c

  2. Siga las indicaciones para configurar el agente para usar su propio servidor PostgreSQL.

  3. Complete los pasos de Configurar.

Navegar la base de datos

Advertencia

Debe 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 use la instancia de PostgreSQL predeterminada o la suya 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, puede 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.