Jitterbit private agents unter Microsoft Windows

Einführung

Diese Seite zeigt dir, wie du einen private agent unter Microsoft Windows installierst und ausführst. Der Abschnitt Troubleshooting enthält eine Liste häufiger Probleme und deren Lösungen.

Installation

Um einen private agent zu installieren, überprüfe die Voraussetzungen und folge dann den Schritten in den Abschnitten Download und Installer ausführen.

Voraussetzungen

Du benötigst Folgendes:

• Ein Host, der die Systemanforderungen erfüllt.

• Dein Harmony-Kontoname und Passwort.

• Dein Harmony-Organisationsname.

• Name und ID einer private agent group.

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

• Falls aktiviert, deaktiviere die Zwei-Faktor-Authentifizierung (TFA). Du kannst TFA nach der Installation wieder aktivieren.

Folgende Punkte sind optional:

• Füge einen agent hinzu in der Management Console. Falls du keine nicht registrierten private agents in der agent group hast, 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 deinen eigenen zu verwenden, musst du ihn vor der Installation des private agent einrichten und seinen Namen oder seine IP-Adresse, seine Portnummer und die Details des Datenbankadministratorkontos bereithalten.

Folgende Punkte werden empfohlen:

• Deaktiviere Windows-Komprimierung und -Verschlüsselung in den folgenden Ordnern:

  Beschreibung	Standardort
  Private agent-Ordner	C:\Program Files\Jitterbit Agent\
  Temporärer Systemordner	C:\Windows\Temp\
  PostgreSQL-Datenordner	C:\PostgreSQL\*\data\

• Folge dem Leitfaden zur Performance-Tuning-Konfiguration.

Download

Um die private agent-Software herunterzuladen, gehe zur Seite Downloads des Harmony Portal. (Falls du bereits einen agent auf der Seite Agents der Management Console hinzugefügt hast, klicke auf das Symbol Download Jitterbit Agent des agent.)

Lade eines der folgenden private agent Windows-Pakete herunter:

• Windows (x64): (Empfohlen) Das Standard-Installer-Paket (.exe-Datei). Der Modus Quick Install installiert alle Komponenten an ihren Standardorten. Im Modus Advanced kannst du den Installationsort festlegen und deinen eigenen PostgreSQL-Datenbankserver konfigurieren.

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

Installer ausführen

Folge den Schritten für deinen Installer-Typ:

1. Wählen Sie bei der Eingabeaufforderung Select Install Mode entweder Quick Install oder Advanced:

   -   **Quick Install:** Dieser Modus installiert den privaten Agent am Standardort (`C:\Program Files\Jitterbit Agent`), installiert einen PostgreSQL-Datenbankserver, installiert den psqlODBC-Treiber, erstellt einen lokalen Microsoft Windows-Benutzer `jitterbitpostgres` und installiert Microsoft Visual C++ Redistributable-Pakete. Falls eine vorhandene PostgreSQL-Installation gefunden wird, wechselt das Installationsprogramm in den erweiterten Modus.
   
       1.  Geben Sie ein [gültiges Passwort](/de/agent/postgresql/#password-character-restrictions) für den zu installierenden PostgreSQL-Datenbankserver ein und bestätigen Sie es. Dieses Passwort wird auch für das Dienstkonto `jitterbitpostgres` verwendet.
   
           !!! note "Agent-Version 12.8 und später: PostgreSQL-Passwortvalidierung"
               Ab der privaten Agent-Version 12.8 validiert das Installationsprogramm das Passwort des PostgreSQL-Dienstkontos (`jitterbitpostgres`) gegen [Zeichenbeschränkungen](/de/agent/postgresql/#password-character-restrictions) und zeigt eine Eingabeaufforderung an, falls es ein nicht zulässiges Zeichen enthält. Frühere Versionen validieren das Passwort in diesem Schritt nicht, und ein ungültiges Passwort führt dazu, dass die Installation mit [Fehler 1722](/de/agent/troubleshooting/#win-error) fehlschlägt, nachdem PostgreSQL bereits installiert wurde.
   
       2.  Klicken Sie bei jedem Schritt der PostgreSQL-Installation auf **Next >**.
   
       3.  Klicken Sie auf der letzten Seite des Installationsprogramms auf **Finish**. Die Organisation, die Agent-Gruppe und die Agent-Registrierung können auf der Seite **Installation Summary** bestätigt werden.
   
   -   **Advanced:** Dieser Modus ermöglicht die Installation der Agent-Software an einem anderen Ort und die Auswahl eines vorhandenen PostgreSQL-Servers.
   
       4.  (Optional) Klicken Sie auf der Seite **Choose Destination Folder** auf **Change**, um den Installationsort festzulegen.
   
       5.  Geben Sie auf der Seite **Database administrative credentials** die Details eines vorhandenen PostgreSQL-Datenbankservers ein.
   

   1. Klicken Sie auf der letzten Seite des Installationsprogramms auf Finish. (Falls die Installation fehlschlägt, aktivieren Sie die Option Show the Windows Install log, bevor Sie auf Finish klicken.)

1. Bearbeiten Sie silent_install64.ps1, suchen Sie den Parameter $JitterbitArgList, und überprüfen oder ändern Sie den Wert von KO_INSTALL_MODE:

   • KO_INSTALL_MODE=\"1\": Installiert einen privaten Agent und einen PostgreSQL-Datenbankserver.

   • KO_INSTALL_MODE=\"2\": (Standard) Installiert nur einen privaten Agent. Für diese Option muss bereits ein PostgreSQL-Datenbankserver installiert sein.

2. Führen Sie in einer Eingabeaufforderung die folgenden Befehle aus:

   Set-ExecutionPolicy Unrestricted
   silent_install64.ps1
   

   • Zeile 1: Ermöglicht die Ausführung von PowerShell-Skripten.
   • Zeile 2: Führt das automatische Installationsprogramm aus.

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

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

Upgrade

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

• Hauptversion: Wenn Sie ein Upgrade von 10.x → 11.x oder 11.x → 12.x durchführen, handelt es sich um ein Upgrade der Hauptversion. In diesen Fällen müssen Sie den Agent stoppen und neu starten und auf die 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 dauern.

• Nebenversion: Wenn Sie ein Upgrade von 10.x → 10.y, 11.x → 11.y oder 12.x → 12.y durchführen, handelt es sich um ein Upgrade der Nebenversion. In diesen Fällen müssen Sie nur den Agent stoppen und neu starten.

  Upgrades von 11.48 und früher auf 11.49+ enthalten erforderliche Connector-Updates

  Upgrades von privaten Agents 11.48 und früher auf 11.49 und später enthalten ein erforderliches Update für Connector SDK-basierte Connectors.

  Sie werden aufgefordert, dies während des Upgrade-Prozesses zu akzeptieren, wenn Sie das Standard-Installationsprogramm verwenden. Upgrades mit dem automatischen Installationsprogramm akzeptieren diese Voraussetzung automatisch.

Upgrades von 11.x auf 12.x

Plugin-Updates sind erforderlich, um die Multipart Pipeline oder AWS S3 Create Plugins auf 12.x Agents zu verwenden. Benutzerdefinierte Connector SDK Connectors müssen möglicherweise auch aktualisiert werden.

Plugin-Updates für 12.x private Agents

Wenn Sie eines der folgenden Plugins verwenden, müssen Sie alle vorhandenen Verwendungen der inkompatiblen Plugins durch die neuen erforderlichen Versionen für 12.x ersetzen, oder Operationen mit diesen Plugins schlagen fehl, wenn Sie den Agent aktualisieren:

Die erforderlichen Plugin-Versionen sind abwärtskompatibel mit 11.x Agents, sodass Sie die Plugins vor dem Agent-Upgrade aktualisieren können. Führen Sie diese Schritte aus, um ein Plugin zu aktualisieren:

1. Ordnen Sie die neue Plugin-Version der Gruppe des privaten Agents in der Management Console auf der Seite Customizations > Plugins zu.
2. Heben Sie die Zuweisung des inkompatiblen Plugins aus der Aktivität in Ihren Studio- oder Design Studio-Projekten auf.
3. Weisen Sie die neue, kompatible Version zu.
4. Testen und stellen Sie die Operation bereit.

Überprüfung benutzerdefinierter Connectors für 12.x private Agents

Benutzerdefinierte Connectoren, die von Drittanbietern mit dem Connector SDK erstellt wurden, benötigen möglicherweise Änderungen, um mit Private Agents der Version 12.x kompatibel zu sein. Sie sollten die Kompatibilität benutzerdefinierter Connectoren überprüfen, bevor Sie Private Agents auf 12.x aktualisieren.

Upgrade-Anleitung

Führen Sie diese Schritte aus, um einen Private Agent unter Windows zu aktualisieren:

1. Laden Sie ein Installer-Paket herunter.

2. Falls der Agent noch Operationen verarbeitet, pausieren Sie ihn mit Drain.

   Oder, falls Sie sicher sind, dass auf dem Agent nichts läuft, stoppen Sie ihn mit Drain.

3. Überwachen Sie die Agent-Protokolldatei. Fahren Sie fort, wenn alle Operationen die Verarbeitung abgeschlossen haben.

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 des Umgebungssynchronisierungszeitraums akzeptieren Agents keine Integrationsprojektoperationen zur Verarbeitung. Sie können die Auswirkungen dieser Ausfallzeit mit einem Rolling-Upgrade-Ansatz minimieren.

7. Führen Sie den Installer aus:

   Standard-InstallerStiller Installer

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

   PostgreSQL-Eingabeaufforderungen und Verhalten während des Upgrades

   • Falls der Installer nach dem Kennwort des Windows-Betriebssystem-Dienstkontos jitterbitpostgres fragt und Sie es nicht kennen, können Sie den Installer abbrechen. Die vorhandene Agent-Installation ist nicht betroffen. Setzen Sie das Kennwort des Dienstkontos jitterbitpostgres zurück, bevor Sie das Upgrade erneut versuchen.
   • Ab Agent 12.5 fragt der Installer, falls UseInternalPooling nicht bereits in jitterbit.conf definiert ist: Möchten Sie internes Pooling aktivieren, um die Leistung des Jitterbit Private Agent zu optimieren und zu verbessern? Wenn Sie Ja wählen, wird UseInternalPooling=true zum Abschnitt [DbInfo] hinzugefügt. Wenn Sie Nein wählen, bleibt der Schlüssel nicht gesetzt (deaktiviert). Falls UseInternalPooling bereits definiert ist, ändert der Installer seinen Wert nicht.
   • Falls PostgreSQL zuvor an einem benutzerdefinierten Speicherort installiert wurde, wird bei einem Upgrade die neue PostgreSQL-Version weiterhin am Standardspeicherort (C:\Program Files\PostgreSQL\<VERSION>\) installiert, nicht am vorhandenen benutzerdefinierten Speicherort.

   Führen Sie die Installationsschritte für den stillen Installer aus, aber setzen Sie in der Datei silent_install64.ps1 KO_INSTALL_MODE=0.

   Der Agent wird automatisch gestartet.

8. (Optional) Falls Sie ein Rolling-Upgrade mit dem Eigenschaftswert agent.starting.standby=true durchführen und vor dem Upgrade eines anderen Agents in derselben Gruppe die Agent-Protokolldatei auf die folgende Meldung überwachen:

   Agent synchronization for environment <123456> and agent group ID <987654> completed at ...
   

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

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

   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

   Tipp

   Verwenden Sie ein Vergleichs- und Zusammenführungstool wie WinMerge.

10. Falls 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 diese Speicherorte.

11. Beenden und starten Sie den Agent.

Deinstallation

Führen Sie die folgenden Schritte aus, um einen privaten Agent und seinen PostgreSQL-Datenbankserver vollständig zu deinstallieren:

1. Beenden Sie den Agent.

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

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

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

   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 Basisverzeichnis des Dienstkontos C:\Users\jitterbitpostgres.

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

   • HKEY_LOCAL_MACHINE\SOFTWARE\PostgreSQL

   • HKEY_LOCAL_MACHINE\SOFTWARE\PostgreSQL Global Development Group

Verwaltung

Ein privater Agent wird über Einträge im Microsoft Windows-Menü Start oder mit Befehlen in einer Eingabeaufforderung verwaltet. Sie können auch die Management Console verwenden, um einen Agent remote zu beenden, können ihn aber nur auf dem Host oder durch einen Neustart des Hosts erneut starten.

Starten

Ein privater Agent wird automatisch mit dem Host gestartet.

Verwenden Sie eine dieser Optionen, um einen Agent zu starten:

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

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

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

Stoppen

Es gibt drei Möglichkeiten, einen privaten Agent zu stoppen, die sich darin unterscheiden, wie laufende Operationen behandelt werden:

• Drain Pause: Der Agent lehnt neue Operationen ab und lässt laufende Operationen bis zur Fertigstellung weiterlaufen.

• Drain Stop: Der Agent lehnt neue Operationen ab und lässt laufende Operationen für einen konfigurierbaren Timeout-Zeitraum weiterlaufen, gesteuert durch agent.drain.stop.database.poll.no.of.retries und agent.drain.stop.database.poll.interval.in.millisec (standardmäßig 100 Abfragen in 10.000-ms-Intervallen). API-basierte Operationen erhalten bis zu agent.drainstop.api.wait (standardmäßig 180 Sekunden). Nach Ablauf des Timeouts werden alle nicht abgeschlossenen Operationen abgebrochen und ihr Status wird mit der Cloud synchronisiert, bevor der Agent heruntergefahren wird. Wenn es sich um geplante Operationen handelt, werden diese automatisch auf einem anderen Agent in der Gruppe neu erstellt (bei mehreren Agent-Gruppen) oder zur Neuerstellung auf dem Agent festgelegt, wenn dieser wieder aufgenommen wird (bei einzelnen Agent-Gruppen).

• Hard Stop: Der Agent lehnt neue Operationen ab, beendet laufende Operationen und markiert sie als abgebrochen. Wenn es sich um geplante Operationen handelt, werden diese automatisch auf einem anderen Agent in der Gruppe neu erstellt (bei mehreren Agent-Gruppen) oder zur Neuerstellung auf dem Agent festgelegt, wenn dieser wieder aufgenommen wird (bei einzelnen Agent-Gruppen).

  Warnung

  Das Hard Stoppen eines privaten Agents kann zu Datenverlust führen.

Man muss einen gestoppten privaten Agent durch Anmeldung beim Server und Ausführung eines Befehls oder durch Neustart des Hosts starten. Agents 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 Agent 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

In der Management Console wird der Status als Stopping angezeigt.

Um einen angehaltenen Agent unter Windows fortzusetzen, verwenden Sie den Start-Befehl.

Drain Stop

Während eines Drain Stop lehnt der Agent neue Operationen ab und lässt laufende Operationen für einen konfigurierbaren Timeout-Zeitraum weiterlaufen, gesteuert durch agent.drain.stop.database.poll.no.of.retries und agent.drain.stop.database.poll.interval.in.millisec (standardmäßig 100 Abfragen in 10.000-ms-Intervallen). API-basierte Operationen erhalten bis zu agent.drainstop.api.wait (standardmäßig 180 Sekunden). Nach Ablauf des Timeouts werden alle nicht abgeschlossenen Operationen abgebrochen und ihr Status wird mit der Cloud synchronisiert, bevor der Agent heruntergefahren wird.

Um einen Agent zu stoppen, verwenden Sie eine dieser Optionen:

• Wählen Sie im Harmony Portal-Menü Management Console > Agents aus. Wählen Sie in der Spalte Action des zu stoppenden Agents Action > Drain Stop aus 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 Agent hart zu stoppen, verwenden Sie eine dieser Optionen:

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

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

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

Pause

Ein privater Agent kann angehalten werden. In diesem Zustand beendet der Agent alle gerade verarbeiteten Operationen und verarbeitet keine weiteren Operationen. In der Management Console wird der Status als Stopping angezeigt.

Um einen privaten Agent unter Microsoft Windows anzuhalten, führen Sie diesen Befehl in einer Eingabeaufforderung aus:

JitterbitUtils.exe --drain-pause

Um einen angehaltenen Agent unter Microsoft Windows fortzusetzen, verwenden Sie den Befehl Start.

Status

Um den Status des Agents anzuzeigen, verwenden Sie eine dieser Optionen:

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

• Suchen Sie nach den folgenden Diensten im Microsoft Windows-Dienstprogramm Computerverwaltung 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)

Troubleshooting

Diese Abschnitte auf der Seite Troubleshooting können bei der Behebung von Problemen mit privaten Agent-Installationen unter Windows hilfreich sein:

• Agent offline oder nicht erreichbar

• Agent zeigt unterschiedliche Versionen oder IP-Adressen an

• Verbindungs-, Websocket- und E/A-Fehler bei privaten Jitterbit-Agents mit Azure-VMs

• IPv6-Problem unter Windows

• Apache Server-Fehler: Keine installierten ConfigArgs

• PostgreSQL-Dienst nach fehlgeschlagenem Upgrade unter Windows entfernt

• Fehler 1720 oder 1722 bei Windows-Installation

• TFA verhindert Installation von 64-Bit-Windows-Agent

• TranDb-Verbindungsfehler

• Fehlgeschlagene Windows-Installation wiederherstellen

• Cleanup-Dienst kann gesperrte Protokolldateien unter Windows nicht entfernen