PostgreSQL für private Jitterbit-Agenten

Einführung

Private Agenten benötigen einen PostgreSQL-Datenbankserver für persistente Speicherung. Eine PostgreSQL-Instanz wird während der Agent-Installation installiert, aber Sie können auch Ihre eigene PostgreSQL-Instanz verwenden. Diese Seite zeigt, wie das funktioniert und wie Sie den Datenbankinhalt überprüfen.

Voraussetzungen

Wenn Sie Ihre eigene PostgreSQL-Datenbankinstanz verwenden möchten, muss diese die folgenden Anforderungen erfüllen.

Gleiche Version wie die gebündelte

Die major.minor Versionsnummer der PostgreSQL-Instanz, die Sie verwenden möchten, muss mit der vom privaten Agent installierten Version übereinstimmen. (Andere Versionen funktionieren möglicherweise, wurden aber nicht getestet und werden nicht unterstützt.)

Um zu sehen, welche Version derzeit installiert ist, führen Sie diesen Befehl aus:

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

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

Passwortzeichenbeschränkungen

Das Passwort für das Serveradministratorkonto (normalerweise postgres) und das jitterbitpostgres-Servicekonto (nur Windows) muss mindestens 8 ASCII-Zeichen lang sein und darf keine der unten angezeigten Zeichen enthalten:

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

Passwortverschlüsselung

Der Server muss MD5- oder SCRAM-SHA-256-Passwortverschlüsselung verwenden. Um MD5 zu verwenden, führen Sie Folgendes in einer psql-Sitzung aus:

set password_encryption TO 'md5';

Um stattdessen SCRAM-SHA-256 zu verwenden, folgen Sie dem SCRAM auf PostgreSQL-Leitfaden.

Offene Ports

Port 46914 muss offen und verfügbar sein.

Empfehlungen

Die folgenden Punkte sind nicht erforderlich, aber empfohlen:

• Verwenden Sie in Umgebungen mit hoher Last PgBouncer.

• Verwenden Sie die Datenbank oder ihren Host nicht in Projektoperationen.

Verwenden Sie Ihre eigene PostgreSQL-Instanz

Die Konfiguration eines Agenten zur Verwendung Ihrer eigenen PostgreSQL-Instanz hängt vom Agent-Hosttyp ab:

Durchsuchen Sie die Datenbank

Während des Installationsvorgangs wird zusätzlich zum Standard-postgres-Administratorkonto ein zweites erstellt, mit dem Namen jitterbit unter Linux oder jitterbitpostgres unter Windows. Dies geschieht unabhängig davon, ob Sie die Standard- oder Ihre eigene PostgreSQL-Instanz verwenden.

Das Passwort für dieses Konto wird zufällig generiert und in die jitterbit.conf-Datei geschrieben, unter dem Abschnitt [DbInfo], zusammen mit den Verbindungsdetails des Datenbankservers:

[DbInfo]
User=jitterbit
Password='Ts1OtvM?tid5onCAqin!'
Driver='PostgreSQL-jitterbit'
SystemDbName='postgres'
Server=0.my.pg.host
Port=5432

Private Agents speichern Daten in zahlreichen Tabellen in der Datenbank TranDb. Im Folgenden finden Sie eine Auswahl von Tabellen und Spalten von besonderem Interesse:

• key_values: Agent-Details:

  Spaltenname	Beschreibung
  VersionNumber	Agent-Version
  Agent_Name	Agent-Name
  Agent_Group_Name	Gruppenname
  Agent_Group_Id	Gruppen-ID
  Agent_Id	Agent-ID
  Agent_Group_Size	Anzahl der Agents in der Gruppe

• environmentstab: Umgebungsdetails:

  Spaltenname	Beschreibung
  id	Umgebungs-ID
  organization_id	Organisations-ID, zu der diese Umgebung gehört
  environmentname	Umgebungsname

• deploylogtab: Alle Projektelemente, die auf diesem Agent bereitgestellt wurden.

• operationstab: Operationen, die auf diesem Agent bereitgestellt wurden.

• organizationinfotab: Organisationen, bei denen der Agent registriert ist.

• projectstab: Projekte, die auf diesem Agent bereitgestellt wurden.

• verboseloguploadtab: Datensatz der ausführlichen Protokollmeldungen, die in die Cloud hochgeladen wurden.

Fehlerbehebung

Weitere Informationen zur Fehlerbehebung finden Sie in den folgenden Abschnitten im Leitfaden zur Fehlerbehebung bei Private Agents:

• TranDb-Verbindungsfehler

• PostgreSQL: Schnelles Herunterfahren

• PostgreSQL unter Linux verwendet MD5 statt SCRAM-SHA-256

• PostgreSQL-Dienst nach fehlgeschlagenem Upgrade unter Windows entfernt