Jitterbit private agents auf Microsoft Windows

Einführung

Diese Seite zeigt Ihnen, wie Sie einen privaten Agenten auf Microsoft Windows installieren und ausführen. Der Abschnitt Fehlerbehebung bietet eine Liste häufiger Probleme und deren Lösungen.

Installation

Um einen privaten Agenten zu installieren, überprüfen Sie die Voraussetzungen, und folgen Sie dann den Schritten in den Abschnitten Herunterladen und Installer ausführen.

Voraussetzungen

Sie müssen Folgendes haben:

• Einen Host, der die Systemanforderungen erfüllt.

• Ihren Benutzernamen und Ihr Passwort für das Harmony-Konto.

• Ihren Namen der Harmony-Organisation.

• Den Namen und die ID einer privaten Agentengruppe.

• Zugriff auf ein Microsoft Windows-Administratorkonto auf dem Host. Verwenden Sie es für alle Aktionen auf dieser Seite.

• Wenn aktiviert, deaktivieren Sie die Zwei-Faktor-Authentifizierung (TFA). Sie können TFA nach der Installation wieder aktivieren.

Folgendes ist optional:

• Fügen Sie einen Agenten hinzu in der Management-Konsole. Wenn Sie keine unregistrierten privaten Agenten in der Agentengruppe haben, wird automatisch einer mit einem Namen erstellt, der den Namen und die IP-Adresse des Hosts enthält.

• Ein PostgreSQL-Datenbankserver wird automatisch installiert. Um Ihren eigenen zu verwenden, müssen Sie ihn vor der Installation des privaten Agenten einrichten und seinen Namen oder seine IP-Adresse, die Portnummer und die Details des Datenbankadministrator-Kontos bereithalten.

Folgendes wird empfohlen:

• Deaktivieren Sie die Windows-Kompression und -Verschlüsselung in den folgenden Ordnern:

  Beschreibung	Standardstandort
  Ordner für privaten Agenten	C:\Program Files\Jitterbit Agent\
  System-Temp-Ordner	C:\Windows\Temp\
  PostgreSQL-Datenordner	C:\PostgreSQL\14\data\ (Privater Agent 11, Version 11.0 und höher.)
  	C:\PostgreSQL\9.6\data\ (Privater Agent 10, Version 10.37 und höher.)

• Befolgen Sie die Anleitung zur Leistungsoptimierungskonfiguration.

Herunterladen

Um die Software für den privaten Agenten herunterzuladen, gehen Sie zur Seite Downloads im Harmony-Portal. (Wenn Sie bereits einen Agenten auf der Seite Agenten der Management-Konsole hinzugefügt haben, klicken Sie auf das Jitterbit Agent herunterladen Symbol des Agenten.)

Laden Sie eines der folgenden Windows-Pakete für private Agenten herunter:

• Windows (x64): (Empfohlen) Das Standard-Installationspaket (.exe-Datei). Der Schnellinstallationsmodus installiert alle Komponenten an ihren Standardstandorten. Im Erweiterten Modus können Sie den Installationsort festlegen und Ihren eigenen PostgreSQL-Datenbankserver konfigurieren.

• Windows Quiet Agent Installer (x64): Der stille Installer (.zip-Datei). Dieser verwendet eine Konfigurationsdatei, um eine unbeaufsichtigte Installation zu ermöglichen.

Installer ausführen

Befolgen Sie die Schritte für den Installatortyp:

Wenn die konfigurierten Werte korrekt sind, verläuft die Installation ohne weitere Eingriffe, und der private Agent wird gestartet. Sie können seinen Status in der Management-Konsole überprüfen oder die Protokolldatei C:\Program Files\Jitterbit Agent\log\jitterbit-agent.log einsehen.

Wenn die Installation fehlschlägt, überprüfen Sie die log\Installer.log Protokolldatei für weitere Informationen.

Upgrade

Sie müssen einen Agenten für kleinere (11.x auf 11.y oder 10.x auf 10.y) und größere (10 auf 11) Versionsupgrades stoppen und neu starten. Größere Versionsupgrades erfordern außerdem eine vollständige Deinstallation und Neuinstallation sowie eine vollständige Synchronisierung der Umgebungen.

Wenn Sie zwei oder mehr Agenten in einer Agentengruppe haben, wird empfohlen, diese nacheinander zu aktualisieren, damit Ihre Integrationsprojekte immer mindestens einen Agenten haben, der Operationen verarbeitet. Wenn Sie nur einen Agenten in der Gruppe haben, werden die Operationen im Ausstehenden Status in die Warteschlange gestellt, bis der Agent online ist und bereit ist, sie zu verarbeiten.

Um einen privaten Agenten unter Windows zu aktualisieren, befolgen Sie diese Schritte:

1. Laden Sie ein Installationspaket herunter.

2. Wenn der Agent noch Operationen verarbeitet, pausieren Sie ihn.

   Oder, wenn Sie sicher sind, dass nichts auf dem Agenten läuft, stoppen Sie ihn.

3. Überwachen Sie die Agenten-Protokolldatei. Fahren Sie fort, wenn alle Operationen abgeschlossen sind.

4. Erstellen Sie Sicherungskopien der folgenden Dateien:

   Speicherort	Datei
   C:\Program Files\Jitterbit Agent\	jitterbit.conf
   C:\Program Files\Jitterbit Agent\	JdbcDrivers.conf
   C:\Program Files\Jitterbit Agent\Resources\	jitterbit-agent-config.properties
   C:\Program Files\Jitterbit Agent\apache\conf\	httpd.conf
   C:\Program Files\Jitterbit Agent\apache\conf\extra\	Alle .conf-Dateien
   C:\Program Files\Jitterbit Agent\apache\conf\ssl.crt\	Alle .crt-Dateien
   C:\Program Files\Jitterbit Agent\apache\conf\ssl.key\	Alle .key-Dateien

5. (Optional) Während der Umgebungssynchronisation akzeptieren Agenten keine Integrationsprojektoperationen zur Verarbeitung. Sie können die Auswirkungen dieser Ausfallzeit mit einem Rolling Upgrade-Ansatz minimieren.

   Dazu öffnen Sie die Datei jitterbit-agent-config.properties zur Bearbeitung und fügen die Eigenschaft agent.starting.standby=true hinzu oder setzen sie. (Dies hält den Agenten im Starten-Status und verhindert, dass er Operationen verarbeitet, bis der Eigenschaftswert auf false gesetzt wird.)

6. Führen Sie den Installer aus:

   Standard-InstallerStillen Installer

   Führen Sie den heruntergeladenen Standard-Installer aus und beantworten Sie die Eingabeaufforderungen des InstallShield-Assistenten.

   Befolgen Sie die Installations Schritte für den stillen Installer, aber setzen Sie in der Datei silent_install64.ps1 KO_INSTALL_MODE=0.

   Der Agent startet automatisch.

7. (Optional) Wenn Sie ein schrittweises Upgrade mit dem Eigenschaftswert agent.starting.standby=true durchführen und bevor Sie einen anderen Agenten in derselben Gruppe aktualisieren, überwachen Sie die Agenten-Protokolldatei auf die folgende Nachricht:

   Agentensynchronisierung für Umgebung <123456> und Agentengruppen-ID <987654> abgeschlossen um ...
   

   Diese Nachricht zeigt an, dass der Agent die Umgebungssynchronisierung abgeschlossen hat. Wenn sie erscheint, bearbeiten Sie erneut die Datei jitterbit-agent-config.properties, löschen Sie die Eigenschaft agent.starting.standby (oder setzen Sie sie auf false), und starten Sie dann den Agenten neu.

8. Vergleichen Sie die folgenden Dateien mit Ihren Sicherungskopien und stellen Sie alle geänderten Einstellungen wieder her:

   Standort	Datei
   C:\Program Files\Jitterbit Agent\	jitterbit.conf
   C:\Program Files\Jitterbit Agent\	JdbcDrivers.conf
   C:\Program Files\Jitterbit Agent\Resources\	jitterbit-agent-config.properties
   C:\Program Files\Jitterbit Agent\apache\conf\	httpd.conf
   C:\Program Files\Jitterbit Agent\apache\conf\extra\	Alle .conf Dateien

   Tipp

   Verwenden Sie ein Vergleichs- und Zusammenführungswerkzeug, wie WinMerge.

9. Wenn Sie Sicherungsdateien .crt oder .key haben, die sich nicht bereits in C:\Program Files\Jitterbit Agent\apache\conf\ssl.crt\ oder C:\Program Files\Jitterbit Agent\apache\conf\ssl.key\ befinden, kopieren Sie diese an die entsprechenden Orte.

10. Stoppen und starten Sie den Agenten.

Deinstallieren

Um einen privaten Agenten und seinen PostgreSQL-Datenbankserver vollständig zu deinstallieren, befolgen Sie diese Schritte:

1. Stoppen Sie den Agenten.

2. Erstellen Sie Sicherungskopien der folgenden Dateien:

   Standort	Datei
   C:\Program Files\Jitterbit Agent\	jitterbit.conf
   C:\Program Files\Jitterbit Agent\	JdbcDrivers.conf
   C:\Program Files\Jitterbit Agent\Resources\	jitterbit-agent-config.properties
   C:\Program Files\Jitterbit Agent\apache\conf\	httpd.conf
   C:\Program Files\Jitterbit Agent\apache\conf\extra\	Alle .conf-Dateien
   C:\Program Files\Jitterbit Agent\apache\conf\ssl.crt\	Alle .crt-Dateien
   C:\Program Files\Jitterbit Agent\apache\conf\ssl.key\	Alle .key-Dateien

3. Deinstallieren Sie die folgenden Programme:

   • Jitterbit Agent: Die Jitterbit-Software für private Agenten.

   • PostgreSQL: Der PostgreSQL-Datenbankserver des privaten Agenten. (Die Version hängt von der Version des privaten Agenten ab.)

   • psqlodbc: Der PostgreSQL ODBC-Datenbanktreiber.

4. Löschen Sie das Jitterbit PostgreSQL-Dienstbenutzerkonto:

   Beispiel PowerShell-Befehl

   net user /delete jitterbitpostgres
   

5. (Optional) Löschen Sie die Jitterbit-Dienste:

   sc delete Jitterbit Apache Server
   sc delete Jitterbit Cleanup
   sc delete Jitterbit Process Engine
   sc delete Jitterbit Scheduler
   sc delete Jitterbit Tomcat Server
   sc delete JitterbitPgbouncer
   sc delete Jitterbit-Verbose-Log-Shipper
   

6. Starten Sie Windows neu.

7. Löschen Sie das PostgreSQL-Datenverzeichnis C:\Program Files\PostgreSQL\<VERSION>\data für die deinstallierte Datenbankversion.

8. (Optional) Löschen Sie das Home-Verzeichnis des Dienstkontos C:\Users\jitterbitpostgres.

9. (Optional) Löschen Sie die folgenden Schlüssel im Windows-Registrierungseditor:

   • HKEY_LOCAL_MACHINE\SOFTWARE\PostgreSQL

   • HKEY_LOCAL_MACHINE\SOFTWARE\PostgreSQL Global Development Group

Verwalten

Ein privater Agent wird über Einträge im Microsoft Windows Start-Menü oder mit Befehlen, die in einer Eingabeaufforderung eingegeben werden, verwaltet. Sie können auch die Management-Konsole verwenden, um einen Agenten remote zu stoppen, können ihn jedoch nur auf dem Host oder durch Neustarten des Hosts wieder starten.

Starten

Ein privater Agent startet automatisch mit dem Host.

Um einen Agenten zu starten, verwenden Sie eine dieser Optionen:

• Wählen Sie im Microsoft Windows Start-Menü Jitterbit Agent > Jitterbit-Dienste starten.

• Führen Sie in einer Eingabeaufforderung diesen Befehl aus:

  "C:\Program Files\Jitterbit Agent\StartServices.bat"
  

Stoppen

Es gibt drei Möglichkeiten, einen privaten Agenten zu stoppen, die sich darin unterscheiden, wie laufende Vorgänge behandelt werden:

• Drain-Pause: Der Agent lehnt neue Vorgänge ab und erlaubt laufenden Vorgängen, bis zum Abschluss fortzufahren.

• Drain-Stopp: Der Agent lehnt neue Vorgänge ab und erlaubt laufenden Vorgängen, bis zu einem durch den Parameter agent.drainstop.api.wait festgelegten Zeitraum (standardmäßig 180 Sekunden), fortzufahren.

• Harter Stopp: Der Agent lehnt neue Vorgänge ab und beendet laufende Vorgänge.

  Vorsicht

  Ein harter Stopp eines privaten Agenten kann zu Datenverlust führen.

Sie müssen einen gestoppten privaten Agenten starten, indem Sie sich auf dem Server anmelden und einen Befehl ausführen oder den Host neu starten. Agenten können nicht remote gestartet werden.

Wenn der Agent mit automatischer Registrierung gestartet wurde, wird er beim Stoppen automatisch abgemeldet.

Drain-Pause

Um einen privaten Agenten unter Windows in den Drain-Pause-Modus zu versetzen, führen Sie den folgenden Befehl in einer Eingabeaufforderung aus:

"C:\Program Files\Jitterbit Agent\bin\JitterbitUtils.exe" --drain-pause

Im Management Console wird der Status als Stopping angezeigt.

Um einen pausierten Agenten unter Windows fortzusetzen, verwenden Sie den Start Befehl.

Drain stop

Um einen Agenten im Drain-Stop zu beenden, verwenden Sie eine dieser Optionen:

• Wählen Sie im Harmony Portal Menü Management Console > Agents. Wählen Sie in der Action-Spalte des zu stoppenden Agenten Action > Drain Stop und klicken Sie dann im Bestätigungsdialog auf OK.

• Führen Sie in einer Eingabeaufforderung den folgenden Befehl aus:

  "C:\Program Files\Jitterbit Agent\bin\JitterbitUtils.exe" --drain-stop
  

Hard stop

Um einen Agenten im Hard-Stop zu beenden, verwenden Sie eine dieser Optionen:

• Wählen Sie im Microsoft Windows Start-Menü Jitterbit Agent > Stop Jitterbit Services.

• Führen Sie in einer Eingabeaufforderung diesen Befehl aus:

  "C:\Program Files\Jitterbit Agent\StopServices.bat"
  

Pause

Ein privater Agent kann pausiert werden. In diesem Zustand beendet der Agent alle aktuell verarbeiteten Vorgänge und verarbeitet keine weiteren Vorgänge. Im Management Console wird der Status als Stopping angezeigt.

Um einen privaten Agenten unter Microsoft Windows zu pausieren, führen Sie diesen Befehl in einer Eingabeaufforderung aus:

JitterbitUtils.exe --drain-pause

Um einen pausierten Agenten unter Microsoft Windows fortzusetzen, verwenden Sie den Start Befehl.

Status

Um den Status des Agenten zu sehen, verwenden Sie eine dieser Optionen:

• Wählen Sie im Harmony Portal Menü Management Console > Agents.

• Suchen Sie die folgenden Dienste im Microsoft Windows Computer Management-Dienstprogramm oder in einer Eingabeaufforderung mit sc.exe query "<SERVICE>":

  • Jitterbit Apache Server

  • Jitterbit Cleanup

  • Jitterbit Process Engine

  • Jitterbit Scheduler

  • Jitterbit Tomcat Server

  • JitterbitPgBouncer

  • JitterbitVerboseLogShipper (Dienstname Jitterbit-Verbose-Log-Shipper)

Fehlerbehebung

Diese Abschnitte auf der Fehlerbehebungsseite können bei der Fehlersuche von privaten Agenteninstallationen unter Windows hilfreich sein:

• Jitterbit privater Agent läuft nicht oder ist gestoppt oder nicht erreichbar.

• Jitterbit privater Agent zeigt unterschiedliche Versionen oder IPs an.

• Verbindungs-, Websocket- und I/O-Fehler bei Jitterbit privaten Agenten, die Azure-VMs verwenden.

• Fehler 1722 bei Windows Jitterbit privaten Agenten.

• IPv6-Problem bei Windows Jitterbit privaten Agenten.

• Apache-Serverfehler bei Jitterbit privaten Agenten.

• PostgreSQL-Fehler bei Windows Jitterbit privaten Agenten.

• 64-Bit Windows Jitterbit private Agenten mit Zwei-Faktor-Authentifizierung (TFA) können nicht installiert werden.

• Verbindungs-Slots-Fehler bei Windows 64-Bit Jitterbit privaten Agenten.

• Wiederherstellung einer fehlgeschlagenen Installation des privaten Agenten unter Windows.