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, seine 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\
  Temporärer Systemordner	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 Schnellinstallations-Modus 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 Installer-Typ:

Wenn die konfigurierten Werte korrekt sind, verläuft die Installation ohne weitere Eingriffe, und der private Agent startet. 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 Protokolldatei log\Installer.log auf weitere Informationen.

Upgrade

Private Agent-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 auf eine vollständige Synchronisierung der Umgebungen warten. 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 dieses Prerequisite 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 im Management Console Customizations > Plugins-Seite 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 der benutzerdefinierten 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 Umgebungssynchronisation akzeptieren Agenten keine Integrationsprojektoperationen zur Verarbeitung. Sie können die Auswirkungen dieser Ausfallzeit mit einem Rolling Upgrade minimieren.

7. Führen Sie den Installer aus:

   Standard-InstallerStiller Installer

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

   Hinweis

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

   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 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 die Datei jitterbit-agent-config.properties erneut, löschen Sie die Eigenschaft agent.starting.standby (oder setzen Sie sie auf false), und starten Sie dann 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 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.

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 aus der Ferne zu stoppen, können ihn jedoch nur wieder auf dem Host oder durch Neustarten des Hosts neu starten.

Start

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"
  

Stop

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 lässt laufende Vorgänge bis zur Fertigstellung fortfahren.

• Drain stop: Der Agent lehnt neue Vorgänge ab und lässt laufende Vorgänge bis zur Fertigstellung fortfahren, bis zu einem Zeitraum, der durch den Parameter agent.drainstop.api.wait festgelegt ist (standardmäßig 180 Sekunden), nach dem sie als abgebrochen markiert werden. Wenn es sich um geplante Vorgänge handelt, werden diese automatisch auf einem anderen Agenten in der Gruppe (im Fall von mehreren Agentengruppen) neu erstellt oder so eingestellt, dass sie auf dem Agenten neu erstellt werden, wenn dieser wieder aktiv wird (im Fall von einzelnen Agentengruppen).

• Hard stop: Der Agent lehnt neue Vorgänge ab, beendet laufende Vorgänge und markiert sie dann als abgebrochen. Wenn es sich um geplante Vorgänge handelt, werden diese automatisch auf einem anderen Agenten in der Gruppe (im Fall von mehreren Agentengruppen) neu erstellt oder so eingestellt, dass sie auf dem Agenten neu erstellt werden, wenn dieser wieder aktiv wird (im Fall von einzelnen Agentengruppen).

  Vorsicht

  Ein hartes 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 Pausenmodus 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-Stopp zu versetzen, 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 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 nach den folgenden Diensten 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-Dienst nach fehlgeschlagenem Upgrade unter Windows entfernt.

• PostgreSQL-Fehler bei Windows Jitterbit privaten Agenten.

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

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

• Wiederherstellung einer fehlgeschlagenen privaten Agenteninstallation unter Windows.