Ir para o conteúdo

PostgreSQL para agentes privados do Jitterbit

Introdução

Agentes privados dependem de um servidor de banco de dados PostgreSQL para armazenamento persistente. Uma instância do PostgreSQL é instalada durante o processo de instalação do agente, mas você pode optar por usar sua própria instância do PostgreSQL. Esta página mostra como fazer isso e como inspecionar o conteúdo do banco de dados.

Pré-requisitos

Se você deseja usar sua própria instância do banco de dados PostgreSQL, ela deve atender aos seguintes requisitos.

Mesma versão que a incluída

Os números da versão maior e menor da sua instância do PostgreSQL devem corresponder àquela originalmente incluída com o agente privado. (Agentes privados atualmente usam a série PostgreSQL 14.x.) Para ver qual versão está instalada, execute este comando:

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

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

Cuidado

Outras versões podem funcionar, mas não foram testadas.

Restrições de caracteres da senha

A senha para a conta de administrador do servidor (geralmente postgres) não deve conter caracteres acentuados (como é), ou qualquer um dos caracteres mostrados abaixo:

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

Criptografia de senha MD5

O servidor deve usar criptografia de senha MD5. Para definir isso, execute o seguinte em uma sessão psql:

set password_encryption TO 'md5';

Portas abertas

A porta 46914 deve estar aberta e disponível.

Recomendações

Os seguintes itens não são obrigatórios, mas são recomendados:

  • Em ambientes de alta carga, instale PgBouncer.

  • Não use o banco de dados ou seu host em nenhuma operação de projeto.

Use sua própria instância do PostgreSQL

A forma de configurar um agente para usar sua própria instância do PostgreSQL depende do tipo de host do agente:

Com o instalador padrão, na solicitação Selecionar Modo de Instalação, selecione Avançado. (Isso é selecionado automaticamente se uma instalação existente do PostgreSQL for encontrada no host.) Siga as instruções para configurar o agente para usar seu próprio servidor PostgreSQL.

Com o instalador silencioso, a instância do PostgreSQL deve estar em execução no mesmo host que o agente. Defina os parâmetros Postgres_* para sua instância e, em seguida, execute o instalador.

  1. Após instalar o pacote do agente e antes da etapa Configurar, execute o seguinte comando:

    jitterbit-config -c

  2. Siga as instruções para configurar o agente para usar seu próprio servidor PostgreSQL.

  3. Complete as etapas de Configurar.

Navegar pelo banco de dados

Cuidado

Você deve acessar a instância do PostgreSQL do agente privado somente quando instruído pelo suporte da Jitterbit.

Durante o processo de instalação, além da conta de administrador padrão postgres, uma segunda conta é criada, com o nome jitterbit no Linux, ou jitterbitpostgres no Windows. Isso acontece independentemente de você usar a instância padrão ou a sua própria do PostgreSQL.

A senha para esta conta é gerada aleatoriamente e escrita no arquivo jitterbit.conf, na seção [DbInfo], juntamente com os detalhes de conexão do servidor de banco de dados:

Exemplo da seção [DbInfo] do jitterbit.conf
[DbInfo]
User=jitterbit
Password='Ts1OtvM?tid5onCAqin!'
Driver='PostgreSQL-jitterbit'
SystemDbName='postgres'
Server=0.my.pg.host
Port=5432

Dica

Como esta é uma conta de administrador adicional, você pode usá-la para reiniciar uma senha esquecida para a conta de administrador padrão postgres.

Agentes privados armazenam dados em várias tabelas no banco de dados TranDb. A seguir, uma seleção de tabelas e colunas de particular interesse:

  • key_values: Detalhes do agente:

    Nome da coluna Descrição
    VersionNumber Versão do agente
    Agent_Name Nome do agente
    Agent_Group_Name Nome do grupo
    Agent_Group_Id ID do grupo
    Agent_Id ID do agente
    Agent_Group_Size Número de agentes no grupo

  • environmentstab: Detalhes do ambiente:

    Nome da coluna Descrição
    id ID do ambiente
    organization_id ID da organização à qual este ambiente pertence
    environmentname Nome do ambiente

  • deploylogtab: Todos os elementos do projeto implantados neste agente.

  • operationstab: Operações implantadas neste agente.

  • organizationinfotab: Organizações com as quais o agente está registrado.

  • projectstab: Projetos implantados neste agente.

  • verboseloguploadtab: Registro de mensagens de log detalhadas carregadas para a nuvem.