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 nutzen, 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 nutzt 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 aus:

   -   **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. Wenn 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, wenn 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. (Wenn 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 Fertigstellung einer vollständigen 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 notwendige Connector-Updates

  Upgrades von privaten Agents 11.48 und früher auf 11.49 und später enthalten ein notwendiges Update für 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. Custom 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 die folgenden 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 von benutzerdefinierten Connectors für 12.x private Agents

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

Upgrade-Anweisungen

Führen Sie die folgenden Schritte aus, um einen privaten 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 der Umgebungssynchronisierung akzeptieren Agents keine Integrationsprojekt-Operationen 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 fordert der Installer auf, wenn UseInternalPooling nicht bereits in jitterbit.conf definiert ist: Möchten Sie internes Pooling aktivieren, um die Leistung des privaten Jitterbit-Agents 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 installiert (C:\Program Files\PostgreSQL\<VERSION>\), 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, überwachen Sie die Agent-Protokolldatei auf die folgende Meldung:

   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

1. Falls 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 dorthin.

2. Stoppen und starten Sie den Agent.

Deinstallation

Um einen privaten Agent und seinen PostgreSQL-Datenbankserver vollständig zu deinstallieren, führen Sie diese Schritte aus:

1. Stoppen 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 stoppen, können ihn aber nur auf dem Host oder durch einen Neustart des Hosts wieder starten.

Starten

Ein privater Agent wird automatisch mit dem Host gestartet.

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

• 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 ermöglicht es laufenden Operationen, bis zum Abschluss fortzufahren.

• Drain Stop: Der Agent lehnt neue Operationen ab und ermöglicht es 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 10.000-ms-Intervallen). API-basierte Operationen erhalten bis zu agent.drainstop.api.wait (standardmäßig 180 Sekunden). Nach dem Timeout 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 (im Fall mehrerer Agent-Gruppen) neu erstellt oder zur Neuerstellung auf dem Agent festgelegt, wenn dieser wieder aufgenommen wird (im Fall einzelner Agent-Gruppen).

• Harter Stopp: 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 so eingestellt, dass sie neu erstellt werden, wenn der Agent wieder läuft (bei einzelnen Agent-Gruppen).

  Warnung

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

Um einen gestoppten privaten Agenten zu starten, melden Sie sich beim Server an und führen einen Befehl aus, oder starten Sie den Host neu. 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

In der Management Console wird der Status als Wird beendet angezeigt.

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

Drain-Stopp

Bei einem Drain-Stopp lehnt der Agent neue Operationen ab und ermöglicht es laufenden Operationen, für einen konfigurierbaren Timeout-Zeitraum weiterzulaufen, 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 10.000-ms-Intervallen). API-basierte Operationen erhalten bis zu agent.drainstop.api.wait (standardmäßig 180 Sekunden). Nach dem Timeout werden alle nicht abgeschlossenen Operationen abgebrochen und ihr Status wird mit der Cloud synchronisiert, bevor der Agent heruntergefahren wird.

Um einen Drain-Stopp durchzuführen, 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 Agenten 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
  

Harter Stopp

Um einen Agenten 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 pausiert werden. In diesem Zustand beendet der Agent alle gerade verarbeiteten Operationen und verarbeitet keine weiteren Operationen. In der Management Console wird der Status als Wird beendet 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 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)

Fehlerbehebung

Diese Abschnitte auf der Seite Fehlerbehebung können bei der Fehlerbehebung von 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 Jitterbit-Privatagenten 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 des 64-Bit-Windows-Agenten

• TranDb-Verbindungsfehler

• Fehlgeschlagene Windows-Installation wiederherstellen

• Cleanup-Dienst kann gesperrte Protokolldateien unter Windows nicht entfernen