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:

• Einen Agenten hinzufügen 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	Standardort
  Ordner für privaten Agenten	C:\Program Files\Jitterbit Agent\
  System-Temporärordner	C:\Windows\Temp\
  PostgreSQL-Datenordner	C:\PostgreSQL\*\data\

• 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

Private Agenten-Versionen verwenden semantische Versionierung, die in der Form X.Y ausgedrückt wird, wobei X die Hauptversionsnummer und Y die Nebenversionsnummer ist. Es gibt zwei Arten von Upgrades:

• Major: Wenn Sie von 10.x → 11.x oder 11.x → 12.x upgraden, wird dies als Major-Version Upgrade betrachtet. In diesen Fällen müssen Sie den Agenten stoppen und neu starten und warten, bis eine vollständige Synchronisierung der Umgebungen abgeschlossen ist. Während einer vollständigen Synchronisierung ist die Umgebung gesperrt und kann keine Operationen verarbeiten. Wenn die Projekte in der Umgebung groß sind, kann dies einige Zeit in Anspruch nehmen.

• Minor: Wenn Sie von 10.x → 10.y, 11.x → 11.y oder 12.x → 12.y upgraden, handelt es sich um ein Minor-Version Upgrade. In diesen Fällen müssen Sie nur den Agenten stoppen und neu starten.

  Upgrades von 11.48 und früher auf 11.49+ beinhalten notwendige Connector-Updates

  Upgrades von privaten Agenten 11.48 und früher auf 11.49 und später beinhalten ein notwendiges Update für Connector SDK-basierte Connectoren.

  Sie werden während des Upgrade-Prozesses aufgefordert, dies zu akzeptieren, wenn Sie den Standard-Installer verwenden. Upgrades, die mit dem stillen Installer durchgeführt werden, akzeptieren diese Voraussetzung automatisch.

Upgrades von 11.x auf 12.x

Plugin-Updates sind erforderlich, um die Multipart-Pipeline oder die AWS S3 Create-Plugins auf 12.x-Agenten zu verwenden. Auch benutzerdefinierte Connector-SDK-Connectoren müssen möglicherweise aktualisiert werden.

Plugin-Updates für 12.x private Agenten

Wenn Sie eines der folgenden Plugins verwenden, müssen Sie alle bestehenden Verwendungen der inkompatiblen Plugins durch die neuen, erforderlichen Versionen für 12.x ersetzen, da sonst die Operationen mit diesen Plugins beim Upgrade des Agenten fehlschlagen:

Die erforderlichen Plugin-Versionen sind rückwärtskompatibel mit 11.x-Agenten, sodass Sie die Plugins vor dem Upgrade des Agenten aktualisieren können. Um ein Plugin zu aktualisieren, befolgen Sie diese Schritte:

1. Weisen Sie die neue Plugin-Version der privaten Agentengruppe in der Management-Konsole Seite Anpassungen > Plugins zu.
2. Entfernen Sie das inkompatible Plugin von der Aktivität in Ihren Studio- oder Design-Studio-Projekten.
3. Weisen Sie die neue, kompatible Version zu.
4. Testen und implementieren Sie die Operation.

Überprüfung von benutzerdefinierten Connectoren für 12.x private Agenten

Benutzerdefinierte Connectoren, die von einem Drittanbieter mit dem Connector SDK erstellt wurden, müssen möglicherweise geändert werden, um mit 12.x privaten Agenten kompatibel zu sein. Sie sollten die Kompatibilität benutzerdefinierter Connectoren überprüfen, bevor Sie private Agenten auf 12.x aktualisieren.

Upgrade-Anweisungen

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. Erstellen Sie eine Sicherungskopie des folgenden Registrierungseintrags:

   HKLM\SOFTWARE\WOW6432Node\Apache Software Foundation\Procrun 2.0\Jitterbit Tomcat Server\Parameters\Java
   

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

7. Führen Sie das Installationsprogramm aus:

   Standard-InstallationsprogrammStiller Installer

   Führen Sie das heruntergeladene Standard-Installationsprogramm aus und antworten Sie auf die Eingabeaufforderungen des InstallShield-Assistenten.

   Jitterbit PostgreSQL Passwortaufforderung

   Wenn das Installationsprogramm nach dem Passwort des Windows OS-Dienstkontos jitterbitpostgres fragt und Sie es nicht wissen, können Sie das Installationsprogramm abbrechen. Die bestehende Agenteninstallation ist nicht betroffen. Setzen Sie das Passwort des jitterbitpostgres Dienstkontos zurück, bevor Sie den Upgrade-Versuch wiederholen.

   Agent-Version 12.5 und höher: interner Pooling-Hinweis

   Bei einem Upgrade auf die Agent-Version 12.5 oder höher, wenn UseInternalPooling noch nicht in jitterbit.conf definiert ist, fordert der Installer: Möchten Sie internes Pooling aktivieren, um die Leistung des Jitterbit-Privatagenten zu optimieren und zu verbessern? Die Auswahl von Ja fügt UseInternalPooling=true zum Abschnitt [DbInfo] hinzu. Die Auswahl von Nein lässt den Schlüssel ungesetzt (deaktiviert). Wenn UseInternalPooling bereits definiert ist, ändert der Installer dessen Wert nicht.

   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.

8. (Optional) Wenn Sie ein schrittweises Upgrade mit dem Eigenschaftswert agent.starting.standby=true durchführen und bevor Sie einen weiteren Agenten in derselben Gruppe upgraden, überwachen Sie die Agent-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 den Agenten neu.

9. Vergleichen Sie die folgenden Dateien mit Ihren Sicherungskopien und stellen Sie geänderte 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.

10. Wenn Sie Sicherungskopien von .crt- oder .key-Dateien 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.

11. 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 Benutzerkonto des Jitterbit PostgreSQL-Dienstes:

   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 wieder auf dem Host oder durch Neustarten des Hosts neu 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-Stop: Der Agent lehnt neue Vorgänge ab und erlaubt laufenden Vorgängen, für einen konfigurierbaren Timeout-Zeitraum fortzufahren, der durch agent.drain.stop.database.poll.no.of.retries und agent.drain.stop.database.poll.interval.in.millisec gesteuert wird (standardmäßig 100 Abfragen in Intervallen von 10.000 ms). API-basierte Vorgänge haben bis zu agent.drainstop.api.wait (standardmäßig 180 Sekunden) Zeit. Nach dem Timeout werden alle Vorgänge, die nicht abgeschlossen sind, abgebrochen und ihr Status wird mit der Cloud synchronisiert, bevor der Agent heruntergefahren wird. Wenn es sich um geplante Vorgänge handelt, werden diese automatisch auf einem anderen Agenten in der Gruppe (im Falle mehrerer Agentengruppen) neu erstellt oder so eingestellt, dass sie beim Fortsetzen auf dem Agenten neu erstellt werden (im Falle von Einzelagentengruppen).

• Hard stop: Der Agent lehnt neue Operationen ab, beendet laufende Operationen und markiert sie dann als abgebrochen. Wenn es sich um geplante Operationen handelt, werden diese automatisch auf einem anderen Agenten in der Gruppe (im Falle mehrerer Agentengruppen) neu erstellt oder so eingestellt, dass sie beim Fortsetzen des Agenten neu erstellt werden (im Falle von Einzelagentengruppen).

  Vorsicht

  Das harte Stoppen 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

Während eines Drain Stops lehnt der Agent neue Operationen ab und erlaubt laufenden Operationen, für einen konfigurierbaren Timeout-Zeitraum fortzufahren, der durch agent.drain.stop.database.poll.no.of.retries und agent.drain.stop.database.poll.interval.in.millisec gesteuert wird (standardmäßig 100 Abfragen in Intervallen von 10.000 ms). API-basierte Operationen haben bis zu agent.drainstop.api.wait (standardmäßig 180 Sekunden). Nach dem Timeout werden alle Operationen, die nicht abgeschlossen sind, abgebrochen und ihr Status wird mit der Cloud synchronisiert, bevor der Agent heruntergefahren wird.

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

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

• In einer Eingabeaufforderung führen Sie den folgenden Befehl aus:

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

Hard stop

Um einen Agenten hart zu stoppen, 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 derzeit 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)

Troubleshoot

Diese Abschnitte auf der Troubleshoot-Seite 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 mit Windows Jitterbit privaten Agenten.

• IPv6-Problem bei Windows Jitterbit privaten Agenten.

• Apache-Serverfehler bei Jitterbit privaten Agenten.

• PostgreSQL-Dienst nach fehlgeschlagenem Upgrade unter Windows entfernt.

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