Zum Inhalt springen

PostgreSQL für Jitterbit private Agenten

Einführung

Private Agenten sind auf einen PostgreSQL-Datenbankserver für die 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.

Warnung

Agenten mit PostgreSQL-Instanzen, die nicht im Lieferumfang enthalten sind, werden nicht unterstützt.

Voraussetzungen

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

Gleiche Version wie im Lieferumfang enthalten

Die major.minor Versionsnummer der PostgreSQL-Instanz, die Sie verwenden möchten, muss mit der übereinstimmen, die vom privaten Agenten installiert wurde. (Andere Versionen können funktionieren, wurden jedoch 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

Einschränkungen bei Passwortzeichen

Das Passwort für das Serveradministrator-Konto (normalerweise postgres) und das jitterbitpostgres Dienstkonto (nur Windows) muss aus 8 oder mehr ASCII Zeichen bestehen und darf keines der unten aufgeführten Zeichen enthalten:

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

Installationsvalidierung

Ab der Version 12.8 des privaten Agenten validiert der Windows-Installer das Passwort des PostgreSQL-Dienstkontos (jitterbitpostgres) während der Eingabe gegen diese Einschränkungen und fordert Sie auf, es zu korrigieren, bevor die Installation fortgesetzt wird.

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 geöffnet und verfügbar sein.

Empfehlungen

Die folgenden Punkte sind nicht erforderlich, werden jedoch empfohlen:

  • In Umgebungen mit hoher Last PgBouncer verwenden.

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

Verwenden Sie Ihre eigene PostgreSQL-Instanz

Die Konfiguration eines Agents zur Verwendung Ihrer eigenen PostgreSQL-Instanz hängt vom Typ des Agentenhosts ab:

Mit dem Standard-Installer wählen Sie an der Eingabeaufforderung Installationsmodus auswählen Erweitert. (Dies wird automatisch ausgewählt, wenn eine vorhandene PostgreSQL-Installation auf dem Host gefunden wird.) Folgen Sie den Eingabeaufforderungen, 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 Eingabeaufforderungen, 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 Agents 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 im 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 Standard-Administratorkonto 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 Agenten-Version
    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.