Private Jitterbit-Agenten unter Microsoft Windows

Einführung

Auf dieser Seite erfahren Sie, wie Sie einen privaten Agenten installieren und ausführen unter Microsoft Windows. Die Fehlerbehebung Abschnitt enthält eine Liste häufiger Probleme und deren Lösungen.

Installieren

Um einen privaten Agenten zu installieren, überprüfen Sie die Voraussetzungen, und folgen Sie dann den Schritten im Download und Installer ausführen Abschnitte.

Voraussetzungen

Sie müssen über Folgendes verfügen:

• Ein Host, der die Systemanforderungen erfüllt.

• Benutzername und Passwort Ihres Harmony-Kontos.

• Der Name Ihrer Harmony-Organisation.

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

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

Folgendes ist optional:

• Agent hinzufügen in der Management Console. Wenn Sie keine nicht registrierten 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 Agenten zu verwenden, müssen Sie ihn vor der Installation des privaten Agenten einrichten und seinen Namen oder seine IP-Adresse, seine Port und die Details des Datenbankadministratorkontos bereithalten.

Folgendes wird empfohlen:

• Deaktivieren Sie die Windows Komprimierung und Verschlüsselung für die folgenden Ordner:

  Beschreibung	Standardspeicherort
  Privater Agentenordner	C:\Program Files\Jitterbit Agent\
  Temporärer Systemordner	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.)

• Folgen Sie der Leistungsoptimierungskonfiguration Führung.

Herunterladen

Um die private Agentensoftware herunterzuladen, gehen Sie zum Harmony Portal Downloads Seite. (Wenn Sie bereits einen Agenten auf der Seite Agenten der Management Console hinzugefügt haben, klicken Sie auf den Laden Sie das-Symbol für den Jitterbit Agent herunter.)

Laden Sie eines der folgenden privaten Agent-Windows Pakete herunter:

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

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

Führen Sie das Installationsprogramm aus

Folgen Sie den Schritten für den Installationstyp:

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

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

Aktualisierung

Bei einem Upgrade eines privaten Agenten auf eine Nebenversion (10.x auf 10.y oder 11.x auf 11.y) muss der Agent angehalten und neu gestartet werden.

Bei einem Upgrade auf eine Hauptversion (10.x auf 11.y) müssen Sie den Agenten deinstallieren und neu installieren den privaten Agenten, den PostgreSQL -Datenbankserver und den PostgreSQL Driver. Sie müssen die Konfigurationsdateien des privaten Agenten auch manuell sichern und wiederherstellen.

Kleineres Versionsupgrade

Für ein Upgrade auf eine Nebenversion gehen Sie folgendermaßen vor:

1. Herunterladen ein Installationspaket.

2. Stop den Agenten.

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

4. (Optional) Wenn Sie andere Agenten in derselben Gruppe aktualisieren müssen, können Sie die Auswirkungen von Agenten-Ausfallzeiten minimieren, indem Sie einen Rolling-Upgrade-Ansatz verwenden. Öffnen Sie dazu jitterbit-agent-config.properties-Datei zum Bearbeiten und fügen Sie die Eigenschaft hinzu oder legen Sie sie fest agent.starting.standby=true. (Dadurch bleibt der Agent im Status Starten und kann keine Vorgänge ausführen, bis der Eigenschaftswert auf false.)

5. Führen Sie das Installationsprogramm aus:

   StandardinstallationsprogrammStilles Installationsprogramm

   Führen Sie das heruntergeladene Standardinstallationsprogramm aus und befolgen Sie die Anweisungen des InstallShield-Assistenten.

   Folgen Sie den Anweisungen install Schritte für den stillen Installer, aber in der silent_install64.ps1 Datei, Satz KO_INSTALL_MODE=0.

   Der Agent startet automatisch.

6. (Optional) Wenn Sie ein Rolling Upgrade mit dem Eigenschaftswert durchführen agent.starting.standby=true und bevor Sie einen anderen Agenten in der gleichen Gruppe aktualisieren, überwachen Sie die Agenten-Protokolldatei für die folgende Nachricht:

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

   Diese Meldung zeigt an, dass der Agent die Umfeld abgeschlossen hat. Wenn es erscheint, bearbeiten jitterbit-agent-config.properties Löschen Sie erneut die Eigenschaft agent.starting.standby(oder setzen Sie es auf false), starten Sie den Agenten dann neu.

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

8. Wenn Sie ein Backup haben .crt oder .key Dateien, die noch nicht in C:\Program Files\Jitterbit Agent\apache\conf\ssl.crt\ oder C:\Program Files\Jitterbit Agent\apache\conf\ssl.key\bzw. kopieren Sie sie an diese Speicherorte.

9. Stop und start der Agent.

Hauptversionsupgrade

Für ein Upgrade auf eine Hauptversion gehen Sie folgendermaßen vor:

1. Herunterladen ein Installationspaket.

2. Stop den Agenten.

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

4. Deinstallieren Sie die folgenden Programme:

   • Jitterbit-Agent: Die private Jitterbit-Agentensoftware.
   • PostgreSQL 9.6: Der PostgreSQL Datenbankserver des privaten Agenten.
   • psqlodbc: Der PostgreSQL ODBC- Driver.

5. (Optional) Löschen Sie das PostgreSQL Datenverzeichnis C:\Program Files\PostgreSQL\9.6\data.

6. Installieren den neuen privaten Agenten. Der Agent startet automatisch.

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

8. Wenn Sie ein Backup haben .crt oder .key Dateien, die nicht in C:\Program Files\Jitterbit Agent\apache\conf\ssl.crt\ oder C:\Program Files\Jitterbit Agent\apache\conf\ssl.key\bzw. kopieren Sie sie an diese Speicherorte.

9. Stop und start der Agent.

Deinstallieren

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

1. Stopp den Agenten.

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 private Jitterbit-Agentensoftware.

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

   • psqlodbc: Der PostgreSQL ODBC- Driver.

4. Löschen Sie das Benutzerkonto des Jitterbit-PostgreSQL -Dienstes:

   Example PowerShell command

   net user /delete jitterbitpostgres
   

5. Starten Sie Windows neu.

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

7. (Optional) Löschen Sie das Stammverzeichnis des Dienstkontos C:\Users\jitterbitpostgres.

8. (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 Startmenü von Microsoft Windows oder über Befehle verwaltet, die in einer Eingabeaufforderung eingegeben werden. Sie können einen Agenten auch über die Management Console remote stoppen, ihn jedoch nur auf dem Host oder durch einen Neustart des Host erneut starten.

Start

Ein privater Agent startet automatisch mit dem Host.

Um einen Agenten zu starten, verwenden Sie eine der folgenden Optionen:

• Wählen Sie im Microsoft Windows-Startmenü Jitterbit Agent > Jitterbit Services 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. Jede davon unterscheidet sich in der Behandlung laufender Vorgänge:

• Drain pause: Der Agent lehnt neue Vorgänge ab und lässt laufende Vorgänge bis zum Abschluss weiterlaufen.

• Ablaufstopp: Der Agent lehnt neue Operationen ab und lässt laufende Operationen bis zu einem durch den Parameter agent.drainstop.api.wait (standardmäßig 180 Sekunden).

• Harter Stopp: der Agent lehnt neue Operationen ab und beendet laufende Operationen.

  Vorsicht

  Das harte Stoppen eines privaten Agenten kann zu Datenverlust führen.

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

Wenn der Agent mit der automatischen Registrierung gestartet wurde, wird es automatisch abgemeldet, wenn es gestoppt wird.

Ablasspause

Um einen privaten Agenten unter Windows anzuhalten, führen Sie den folgenden Befehl aus in einer Eingabeaufforderung:

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

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

Um einen angehaltenen Agenten unter Windows fortzusetzen, verwenden Sie die Start Befehl.

Ablaufstopp

Um einen Agenten zu stoppen, verwenden Sie eine der folgenden Optionen:

• Wählen Sie im Menü des Harmony-Portals Management Console > Agenten. Wählen Sie in der Spalte Aktion des zu stoppenden Agenten Aktion > Drain Stop und klicken Sie dann im Bestätigungsdialogfeld 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 endgültig zu stoppen, verwenden Sie eine der folgenden Optionen:

• Wählen Sie im Microsoft Windows-Startmenü Jitterbit Agent > Jitterbit Services stoppen.

• 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 aktuell ausgeführten Vorgänge und führt keine weiteren Vorgänge aus. In der Management Console wird der Status als Wird gestoppt angezeigt.

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

JitterbitUtils.exe --drain-pause

Um einen angehaltenen Agenten unter Microsoft Windows fortzusetzen, verwenden Sie die Start Befehl.

Projektstatus

Um den Status des Agenten anzuzeigen verwenden Sie eine der folgenden Optionen:

• Wählen Sie im Harmony-Portalmenü Management Console > Agenten.

• Suchen Sie 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 zur Fehlerbehebung kann bei der Fehlerbehebung bei privaten Agentinstallationen unter Windows hilfreich sein:

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

• Jitterbit-Privatagent zeigt unterschiedliche Versionen oder IPs an.

• Verbindungs-, WebSocket- und E/A-Fehler bei privaten Jitterbit-Agenten, die Azure-VMs verwenden.

• Fehler 1722 mit privaten Windows Jitterbit-Agenten.

• IPv6-Problem bei privaten Windows-Jitterbit-Agenten.

• Apache-Serverfehler bei privaten Jitterbit-Agenten.

• PostgreSQL Fehler mit privaten Windows Jitterbit-Agenten.

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

• Verbindungsslotfehler mit privaten Jitterbit-Agenten unter Windows 64-Bit.

• Eine fehlgeschlagene private Agenteninstallation unter Windows wiederherstellen.