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) muss aus 8 oder mehr Zeichen bestehen und darf keine Akzentzeichen (wie é) oder eines der unten aufgeführten Zeichen enthalten:

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

Passwortverschlüsselung

Der Server muss die 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, werden jedoch empfohlen:

  • Verwenden Sie in Umgebungen mit hoher Auslastung PgBouncer.

  • Verwenden Sie die Datenbank oder deren 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 bei der Aufforderung Installationsmodus auswählen die Option Erweitert. (Dies wird automatisch ausgewählt, wenn eine vorhandene PostgreSQL-Installation auf dem Host gefunden wird.) Folgen Sie den Anweisungen, 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 Anweisungen, 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 der Datei jitterbit.conf im Abschnitt [DbInfo] zusammen mit den Verbindungsdetails des Datenbankservers gespeichert:

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 Agents speichern Daten in zahlreichen Tabellen in der TranDb-Datenbank. Folgendes ist eine Auswahl von Tabellen und Spalten von besonderem Interesse:

  • key_values: Agentdetails:

    Spaltenname Beschreibung
    VersionNumber Agentversion
    Agent_Name Agentname
    Agent_Group_Name Gruppenname
    Agent_Group_Id Gruppen-ID
    Agent_Id Agent-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: Auf diesem Agenten bereitgestellte Operationen.

  • 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.