Zum Inhalt springen

PostgreSQL für Jitterbit private Agenten

Einführung

Private Agenten sind auf einen PostgreSQL-Datenbankserver für persistente Speicherung angewiesen. Eine PostgreSQL-Instanz wird während des Installationsprozesses des Agenten installiert, aber Sie können auch Ihre eigene PostgreSQL-Instanz verwenden. Diese Seite zeigt, wie das geht und wie Sie den Inhalt der Datenbank überprüfen können.

Voraussetzungen

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

Gleiche Version wie im Bundle

Die Haupt- und Nebenversionen Ihrer PostgreSQL-Instanz sollten mit der ursprünglich mit dem privaten Agenten gelieferten übereinstimmen. (Private Agenten verwenden derzeit die PostgreSQL 14.x-Serie.) Um zu sehen, welche Version installiert ist, führen Sie diesen Befehl aus:

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

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

Vorsicht

Andere Versionen können funktionieren, wurden jedoch nicht getestet.

Einschränkungen bei Passwortzeichen

Das Passwort für das Serveradministrator-Konto (normalerweise postgres) darf keine Akzentzeichen (wie é) oder eines der unten aufgeführten Zeichen enthalten:

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

MD5-Passwortverschlüsselung

Der Server muss die MD5-Passwortverschlüsselung verwenden. Um dies einzustellen, führen Sie Folgendes in einer psql-Sitzung aus:

set password_encryption TO 'md5';

Offene Ports

Port 46914 muss offen und verfügbar sein.

Empfehlungen

Die folgenden Punkte sind nicht erforderlich, werden jedoch empfohlen:

  • In Umgebungen mit hoher Last installieren Sie 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 Typ des Agentenhosts ab:

Mit dem Standard-Installer wählen Sie an der Aufforderung Installationsmodus auswählen Erweitert aus. (Dies wird automatisch ausgewählt, wenn eine vorhandene PostgreSQL-Installation auf dem Host gefunden wird.) Folgen Sie den Aufforderungen, um den Agenten so zu konfigurieren, dass er Ihren eigenen PostgreSQL-Server verwendet.

Mit dem stummen Installer muss die PostgreSQL-Instanz auf demselben Host wie der Agent ausgeführt werden. Setzen Sie die Postgres_*-Parameter für Ihre Instanz und führen Sie dann den Installer aus.

  1. Nach der Installation des Agentenpakets und vor dem Konfigurieren führen Sie den folgenden Befehl aus:

    jitterbit-config -c

  2. Folgen Sie den Aufforderungen, um den Agenten so zu konfigurieren, dass er Ihren eigenen PostgreSQL-Server verwendet.

  3. Schließen Sie die Schritte zum Konfigurieren ab.

Durchsuchen der Datenbank

Vorsicht

Sie sollten auf die PostgreSQL-Instanz des privaten Agenten nur zugreifen, wenn Sie von Jitterbit-Support dazu aufgefordert werden.

Während des Installationsprozesses wird zusätzlich zum Standardadministratorkonto postgres ein zweites Konto 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 Datei jitterbit.conf unter dem Abschnitt [DbInfo] zusammen mit den Verbindungsdetails des Datenbankservers geschrieben:

Beispiel für den Abschnitt [DbInfo] von jitterbit.conf
[DbInfo]
User=jitterbit
Password='Ts1OtvM?tid5onCAqin!'
Driver='PostgreSQL-jitterbit'
SystemDbName='postgres'
Server=0.my.pg.host
Port=5432

Tipp

Da dies ein zusätzliches Administratorkonto ist, können Sie es verwenden, um ein vergessenes Passwort zurückzusetzen für das Standardadministrator-Konto postgres.

Private Agenten speichern Daten in zahlreichen Tabellen in der TranDb-Datenbank. Folgendes ist eine Auswahl von Tabellen und Spalten von besonderem Interesse:

  • key_values: Agentendetails:

    Spaltenname Beschreibung
    VersionNumber Agentenversion
    Agent_Name Agentenname
    Agent_Group_Name Gruppenname
    Agent_Group_Id Gruppen-ID
    Agent_Id Agenten-ID
    Agent_Group_Size Anzahl der Agenten in der Gruppe

  • environmentstab: Umgebungsdetails:

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

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

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

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

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

  • verboseloguploadtab: Aufzeichnung von ausführlichen Protokollnachrichten, die in die Cloud hochgeladen wurden.