Jitterbit-Agenten

Übersicht

Die Harmony-Agenten von Jitterbit verarbeiten die Operationen Ihrer Integrationsprojekte und senden sowie empfangen Endpunktdaten. Es gibt zwei Arten von Agenten: Cloud und privat:

• Cloud: Jitterbit verwaltet Cloud-Agenten auf seiner eigenen Cloud-Infrastruktur. Sie müssen nichts einrichten oder konfigurieren.

• Privat: Sie müssen private Agenten auf Ihrer eigenen Cloud- oder physischen Infrastruktur einrichten, konfigurieren und verwalten.

Alle Agenten sind Mitglieder einer Gruppe. Agentengruppen sind Gruppen von Agenten desselben Typs (Sie können private und Cloud-Agenten nicht in einer Gruppe mischen). Agenten in einer Agentengruppe verarbeiten die Operationen Ihres Integration Studio oder Design Studio-Projekts. Gruppen bieten die folgenden Vorteile:

• Intelligente Weiterleitung: Um die Leistung und Zuverlässigkeit zu verbessern, werden die Operationen eines Projekts zur Verarbeitung an eine Agentengruppe gesendet, anstatt an einzelne Agenten. (Welche Agentengruppe ein Projekt verwendet, hängt von der Umgebung ab, in der ein Projekt bereitgestellt wird. Die Beziehung zwischen einer Umgebung und ihrer Agentengruppe wird als Assoziation bezeichnet.) Sofern sich nicht nur ein Agent in einer Gruppe befindet, haben Sie keine Kontrolle darüber, von welchem Agenten eine Operation verarbeitet wird—das intelligente Weiterleitungssystem entscheidet, welcher Agent verwendet wird.

  Dieser Weiterleitungsdienst analysiert die Anforderungen der Aufgaben und vergleicht sie mit den Fähigkeiten der einzelnen Agenten (dazu gehören ihre Konnektoren, Versionen und Betriebssysteme). Aus dem Pool fähiger Agenten verteilt eine Lastenausgleichsstrategie die Arbeitslast, um Engpässe zu vermeiden. Wenn ein zugewiesener Agent beschäftigt oder offline ist, wird die Aufgabe nahtlos an einen anderen verfügbaren Agenten in der Gruppe weitergeleitet. Aufgaben werden nur an Agenten gesendet, die online sind und aktiv mit Harmony kommunizieren. Wenn keine geeigneten Agenten sofort verfügbar sind, werden Aufgaben automatisch in eine Warteschlange gestellt. Der Dienst sendet die Aufgabe dann, sobald ein geeigneter Agent verfügbar wird.

  Da diese Lastenausgleichsmechanismen die Fähigkeiten und Kapazitäten der Hosts bei der Arbeitsverteilung berücksichtigen, können Sie Hosts bereitstellen, die besser zu den charakteristischen Lasten von Projekten oder Umgebungen passen, wodurch die Tendenz vermieden wird, übermäßig viele Ressourcen bereitzustellen und auszugeben.

• Hohe Verfügbarkeit: Wenn aus irgendeinem Grund der Status eines Agents auf Gestoppt wechselt, storniert das System alle ihm zugewiesenen geplanten Operationen und führt neue Betriebsinstanzen aus, wenn der Agent wieder aktiv ist. Wenn der Agent der einzige in einer Gruppe ist, laufen Integrationsoperationen, die diese Gruppe verwenden, schließlich ab und schlagen fehl. Bei mehreren Agents in einer Gruppe werden geplante Operationen, die auf einem Gestoppten Agenten laufen, storniert und sofort auf einem aktiven Agenten neu erstellt. Dies stellt sicher, dass Ihre Projekte auch dann weiterlaufen, wenn ein Agent ausfällt, sei es ein geplanter Vorfall (wie im Fall von Software-Upgrades) oder ein unvorhergesehener. Das Maß an Fehlertoleranz steigt proportional zur Anzahl der Agents in einer Gruppe.

• Skalierbarkeit: Wenn Sie Ihr Wissen über die dynamischen Eigenschaften Ihrer Projekte verbessern, können Sie Agents aus Gruppen hinzufügen oder entfernen oder neue Gruppen und Umgebungen schaffen, die bestimmten Betriebsmustern gewidmet sind.

Die folgende Tabelle vergleicht die beiden Arten von Agenten:

Cloud-Agenten

Cloud-Agenten sind Cloud-Dienste, die von Jitterbit verwaltet werden. Sie sind so konfiguriert, dass sie sich automatisch an Ihre Projektlasten anpassen. Sie müssen Cloud-Agenten nicht installieren, konfigurieren, aktualisieren, starten oder stoppen.

Cloud-Agenten-Gruppen

Cloud-Agenten-Gruppen sind Gruppen von Cloud-Agenten, die dieselbe Version ausführen. Sie sind in allen Harmony-Abonnements enthalten. Jitterbit bietet für jede Region zwei Cloud-Agenten-Gruppen an:

• Produktions-Cloud-Agenten-Gruppe: Eine Gruppe von Agenten auf der derzeit veröffentlichten Version, die vollständig getestet und bereit für die Produktion ist.

• Sandbox-Cloud-Agenten-Gruppe: Eine Gruppe von Agenten auf der derzeit vorgeschlagenen nächsten Version, die für Evaluierung und Tests geeignet ist.

Cloud-Agenten-Gruppen benötigen keine Konfiguration oder Verwaltung. Im Gegensatz zu privaten Agenten sind einzelne Cloud-Agenten nicht in der Management-Konsole sichtbar.

Private Agenten

Im Gegensatz zu Cloud-Agenten, die von Jitterbit verwaltet werden, müssen Sie private Agenten (auf Windows, Linux, oder Docker) installieren und konfigurieren, die die Systemanforderungen erfüllen, und sowohl Agenten als auch Gruppen über die Seite Management-Konsole > Agenten verwalten.

Sie können private Agenten mit Jitterbits nativem Beobachtungsmetriken und mit einer der unterstützten Drittanbieter-Beobachtungsplattformen überwachen.

Private agent groups

Bevor Sie einen privaten Agenten installieren und ausführen können, benötigen Sie mindestens eine private Agentengruppe. (Private Agentengruppen sind eine lizenzierbare Ergänzung zu Ihrem Harmony-Abonnement.) Standardmäßig sind keine privaten Agentengruppen vorhanden. Sie müssen diese erstellen und Umgebungen zuweisen. Eine private Agentengruppe muss mindestens einen privaten Agenten enthalten, und ein Agent kann sich nur in einer Gruppe gleichzeitig befinden.

Wenn sich zwei oder mehr Agenten in einer Gruppe befinden, wechseln die Agenten sich ab, um gesamte Operation Chains zu verarbeiten, einschließlich der Kinder. Dies hat folgende Konsequenzen:

• Es gibt keine Möglichkeit vorherzusagen, auf welchem Agenten eine Operation Chain ausgeführt wird. Projekte mit Endpunkten, die lokalen Dateizugriff erfordern, sollten in einer Umgebung ausgeführt werden, in der alle Agenten in der Gruppe Zugriff auf ein gemeinsames Dateisystem oder ein freigegebenes Laufwerk haben.

• Die durchschnittliche Arbeitslast der einzelnen Agenten-Hosts kann erheblich variieren.

• Wenn ein Agent abstürzt, können Operationen hängen bleiben und Daten könnten verloren gehen.

Für unterstützte Connectoren und eine Mindestanzahl aktiver Agenten können Sie den Listening Service für Agenten in einer Gruppe aktivieren. Der Listening Service ermöglicht es unterstützten Integration Studio-Connectors, auf API-Ereignisse zu hören. Er nominiert auch einen der Agenten als Leiter. Der Leiter-Agent verteilt Operationen an die Agenten entsprechend ihrem Status und ihrer Auslastung. Wenn ein Agent abstürzt, können Daten wiederhergestellt werden.

Release schedule and release notes

Der Release-Zeitplan für Agenten variiert je nach Agententyp:

• Cloud-Agentengruppen werden automatisch gemäß dem Upgrade-Zeitplan für Sandbox Cloud Agent Groups und dem Upgrade-Zeitplan für Production Cloud Agent Groups aktualisiert.

• Aktualisierte private Agenteninstallateure sind nach Abschluss des Releases der Production Cloud Agent Group auf der Downloads Seite verfügbar.

• Das Docker-Image des privaten Agents ist am Ende der Veröffentlichung der Produktions-Cloud-Agenten-Gruppe für die Region Nordamerika (NA) auf Docker Hub verfügbar.

In den Versionshinweisen zu Harmony ist jeder Agenttyp als separater Punkt in der Tabelle der Veröffentlichungsdaten am Anfang jeder Seite der Versionshinweise aufgeführt. Einzelne Versionshinweise sind unter der Überschrift Agents aufgeführt, wobei relevante Anwendbarkeit auf bestimmte Agenttypen in den Versionshinweisen enthalten ist.

Zusammenstellungen der Versionshinweise für Produktions-Cloud-Agenten-Gruppen, Sandbox-Cloud-Agenten-Gruppen und private Agents sind ebenfalls verfügbar.

Bekannte Probleme

Dieser Abschnitt listet bekannte Probleme auf, die mit den neuesten Versionen der privaten Agents identifiziert wurden. Für bekannte Probleme, die mit anderen Jitterbit Harmony-Anwendungen identifiziert wurden, siehe Bekannte Probleme.

Mehrere Versionen von privaten Agents

Linux private Agents 11.31.1 und alle früheren Versionen

• Geplante Operationen werden nach einem Neustart eines Linux privaten Agents nicht ausgeführt

  • Zusammenfassung: Nach dem Neustart eines Linux privaten Agents startet der Scheduler-Dienst des Agents nicht, was dazu führt, dass geplante Operationen nicht wie erwartet ausgeführt werden. Dieses Problem tritt bei Windows privaten Agents nicht auf.

  • Zusätzliche Informationen: Der Scheduler-Dienst des Linux-Agents verwendet eine Bibliothek, die die neuesten Zeitzonendaten-Dateien herunterlädt. Ab dem 4. September 2024 hat der Anbieter dieser Bibliothek einen Syntaxfehler eingeführt, der dazu führt, dass der Scheduler-Dienst nicht startet.

  • Empfehlung: Dieses Problem wird mit der Version 11.31.2 behoben, die die Bibliothek, die das Problem verursacht, nicht mehr automatisch herunterlädt. Wir empfehlen, Linux private Agents auf 11.31.2 oder höher zu aktualisieren, um zu verhindern, dass dieses Problem auftritt, und in Fällen, in denen es bereits auftritt, um sich davon zu erholen.

    Alternativ können Sie, wenn Sie eine frühere Agentenversion verwenden, die folgenden Workarounds oder Wiederherstellungsschritte für Nicht-Docker-Agenten anwenden:

    • Workaround: Wenn ein Linux-Privatagent noch nicht neu gestartet wurde, um zu verhindern, dass dieses Problem auftritt, bearbeiten Sie die Datei version unter /opt/jitterbit/TimeZoneDB/version und ändern Sie ihren Wert in 2024b. Dadurch wird verhindert, dass die fehlerhafte Version der Datumsbibliothek vom Agenten heruntergeladen wird.

    • Wiederherstellung: Wenn ein Linux-Privatagent bereits dieses Problem hat, bearbeiten Sie die Datei northamerica unter /opt/jitterbit/TimeZoneDB/northamerica, um den Wert April in allen Vorkommen durch Apr zu ersetzen. Starten Sie dann den Agenten neu.

Alle aktuellen Versionen

Diese Probleme betreffen alle aktuellen Versionen:

• Installation des Windows-Privatagenten zeigt eine Microsoft Defender SmartScreen-Warnung an

  • Zusammenfassung: Bei der Installation eines Privatagenten 10.69 oder höher (für 10.x-Agenten) oder 11.8 oder höher (für 11.x-Agenten) unter Windows 2019 oder Windows 10 kann eine Warnmeldung erscheinen.

  • Zusätzliche Informationen: Die Warnmeldung lautet "Windows hat Ihren PC geschützt" mit einem Hinweis, dass Microsoft Defender SmartScreen eine nicht erkannte App am Start gehindert hat.

  • Workaround: Klicken Sie im Warnmeldungsdialog auf Weitere Informationen, um die Option Trotzdem ausführen anzuzeigen. Klicken Sie dann auf Trotzdem ausführen, um mit der Installation des Agenten fortzufahren.

• Windows-Privatagenten: Installation des 64-Bit-Agenten mit Zwei-Faktor-Authentifizierung (TFA) nicht möglich

  • Zusammenfassung: Die Installation eines 64-Bit-Windows-Privatagenten schlägt fehl, wenn TFA aktiv ist.

  • Zusätzliche Informationen: Der Installer zeigt einen Fehlerdialog an.

  • Workaround: Deaktivieren Sie vorübergehend TFA und installieren Sie den 64-Bit-Windows-Privatagenten. Aktivieren Sie TFA nach der Installation wieder.

• ODBC-Verbindungen verarbeiten erweiterte Zeichen nicht korrekt

  • Zusammenfassung: Bei der Verbindung zu einer Datenbank über einen ODBC-Treiber werden einige erweiterte Zeichen, wie ein Gedankenstrich, von Operationen, die Daten upserten, nicht korrekt verarbeitet.

  • Zusätzliche Informationen: Upsert-Operationen können fehlschlagen oder unbeabsichtigte Folgen haben, indem sie die falschen Daten beeinflussen. Beachten Sie, dass Einfüge- und Aktualisierungsoperationen von diesem Problem nicht betroffen sind.

  • Umgehungslösung: Verwenden Sie einen JDBC-Treiber für die Datenbankverbindung (siehe Anweisungen für Design Studio oder Integration Studio).

• SFTP-Verzeichnisse werden manchmal nicht automatisch erstellt

  • Zusammenfassung: Beim Schreiben auf SFTP als Ziel mit Design Studio oder Integration Studio funktioniert die automatische Erstellung von Verzeichnissen inkonsistent.

  • Zusätzliche Informationen: Abhängig vom jeweiligen FTP-Server wird das Verzeichnis möglicherweise nicht erstellt.

  • Umgehungslösung: Bestätigen Sie, dass das Verzeichnis vor der Produktion erstellt wurde.

• SetSalesforceSession Funktion funktioniert nicht

  • Zusammenfassung: Die Jitterbit-Skriptfunktion SetSalesforceSession funktioniert nicht korrekt und sollte nicht im Design Studio oder Integration Studio verwendet werden.

  • Zusätzliche Informationen: Wenn sie verwendet wird, kann das Skript einen Fehler generieren oder auch nicht. Selbst wenn das Skript keinen Fehler generiert, funktioniert die Funktion nicht korrekt. Da die Funktion nicht funktioniert, wird die integrierte Sitzungsverwaltung des Salesforce-Connectors verwendet.

• Private Agenten haben spezifische Systemanforderungen und bekannte Probleme

  • Zusammenfassung: Die privaten Agenten haben unterschiedliche und spezifische Systemanforderungen und bekannte Probleme, abhängig vom verwendeten Betriebssystem.

  • Umgehungslösung: Siehe die Systemanforderungen für private Agenten für Details.

• Agenteninstallation schlägt fehl, wenn das PostgreSQL-Passwort ein Pluszeichen (+) enthält

  • Zusammenfassung: Die Installation des privaten Agenten schlägt fehl, wenn das PostgreSQL-Passwort ein Pluszeichen (+) enthält. Es wird keine Fehlermeldung angezeigt.

  • Zusätzliche Informationen: Dies ist ein Problem mit dem Installer des privaten Agents, nicht mit PostgreSQL.

  • Umgehungslösung: Verwenden Sie ein Passwort ohne Pluszeichen (+). Nach Abschluss der Installation kann das Passwort in ein beliebiges Passwort geändert werden, das für die Verwendung mit PostgreSQL akzeptabel ist.

11.26 private agents

• Der claims-Parameter der Funktion VerifyJwtClaims hat nicht den richtigen Standardwert, wenn er leer gelassen wird

  • Zusammenfassung: Bei Verwendung der Agentenversion 11.26 führt das Leerlassen des optionalen claims-Parameters mit der VerifyJwtClaims Jitterbit-Skriptfunktion zu einem Fehler.

  • Umgehungslösung: Aktualisieren Sie auf die Agentenversion 11.27 oder höher oder geben Sie "{}" für claims ein. Zum Beispiel: VerifyJwtClaims("AxE9qm4aTZiXvA2G8sblAxjeL...", "RS256", "Secret", "{}");.

10.87 / 11.25 und frühere private agents

• Übermäßige Protokolleinträge für den Microsoft Azure Service Bus-Connector

  • Zusammenfassung: Bei Verwendung des Microsoft Azure Service Bus-Connectors mit der Agentenversion 10.87 / 11.25 oder früher werden in kurzer Zeit übermäßig viele INFO-Protokolle generiert, was zu Speicherplatzproblemen aufgrund der Größe der Datei catalina.out führt.

  • Umgehungslösung: Ein Upgrade auf die Agentenversion 11.26 oder höher wird empfohlen. Alternativ kann dieses Problem in der Agentenversion 10.87 / 11.25 oder früher behoben werden, indem die folgenden Einstellungen in die Datei logback.xml eingefügt werden, die sich in C:\Program Files\Jitterbit Agent\tomcat\shared\lib (Windows) oder /opt/jitterbit/tomcat/shared/lib (Linux) befindet:

    <logger name="com.azure.core.amqp" level="ERROR"/>
    <logger name="com.azure.messaging.servicebus" level="ERROR"/>
    <logger name="com.azure.core.implementation" level="ERROR"/>
    

10.84 / 11.22 und frühere private Agenten

• Einmal-täglicher Zeitplan wurde während des Wechsels zur Sommerzeit übersprungen

  • Zusammenfassung: Bei Verwendung der Agentenversion 10.84 / 11.22 oder früher und wenn der Agent eine Zeitzone verwendet, die die Sommerzeit beachtet, treten während eines Wechsels zur Sommerzeit folgende bekannte Probleme auf:

    • Wenn ein einmal-täglicher Zeitplan zwischen 1 - 2 Uhr festgelegt ist, schlägt die geplante Operation am ersten Sonntag im November aufgrund der Sommerzeit fehl.

    • Wenn ein einmal-täglicher Zeitplan zwischen 2 - 3 Uhr festgelegt ist, schlägt die geplante Operation am zweiten Sonntag im März aufgrund der Sommerzeit fehl.

  • Umgehung: Upgrade auf die Agentenversion 10.85 / 11.23 oder höher oder setzen Sie die Zeitzone des Agents auf UTC, indem Sie die Zeitzonenüberschreibung für den Agenten Organisationsrichtlinie verwenden und Etc/UTC auswählen.

10.45 und frühere private Agenten

• Apache Log4j2 JNDI-Sicherheitsanfälligkeiten betreffen private Agenten

  • Zusammenfassung: Die Sicherheitsanfälligkeiten von Apache Log4j2 CVE-2021-44228 und CVE-2021-45046 betreffen private Agenten, die mit den Integration Studio-Connectoren, die mit dem Integration Studio Connector SDK erstellt wurden, arbeiten.

  • Minderung: Eine Notwartung hat die Sicherheitsanfälligkeiten behoben. Nach der Wartung mussten private Agenten neu gestartet und eine Operation für jeden betroffenen Connector ausgeführt werden, damit das Update wirksam wird. Für detaillierte Informationen und Anweisungen siehe Minderung der Apache Log4j2 JNDI-Sicherheitsanfälligkeit.

10.38 Linux private Agenten

• Die PostgreSQL-Datenbank wird bei einem Upgrade von Version 10.37 auf 10.38 neu initialisiert

  • Hintergrund: Bei der Aktualisierung eines Linux-Privatagenten von einer Version vor 10.37 auf eine Version, die 10.37 oder später ist, wird die PostgreSQL-Datenbank neu initialisiert, da sie auf Version 9.6 aktualisiert wird. Dieses Upgrade erstellt die Datenbank auf Ihrem Privatagenten neu, und Ihre Daten werden während dieses Upgrade-Prozesses wiederhergestellt. Nach dem Upgrade sind alle Sicherungen, die mit einer früheren PostgreSQL-Version erstellt wurden, nicht mehr kompatibel. Der Upgrade-Prozess kann je nach Anzahl der Projekte und der Größe der Umgebungen, die mit Ihrer Privatagentengruppe verbunden sind, mehr als 30 Minuten in Anspruch nehmen. Alle ausstehenden Jobs werden in eine Warteschlange gestellt, um nach Abschluss des Upgrades ausgeführt zu werden. Dieses Upgrade betrifft nicht den Windows-Privatagenten.

  • Bekanntes Problem: Es ist ein bekanntes Problem, dass bei der Aktualisierung eines Linux-Privatagenten von Version 10.37 auf 10.38 die PostgreSQL-Datenbank neu initialisiert wird.

  • Umgehungslösung: Aktualisieren Sie auf einen Linux-Privatagenten, der Version 10.39 oder höher ist.

10.0 private agents

• Der Integration Studio Cherwell-Connector funktioniert nicht

  • Zusammenfassung: Mit der 10.1 Harmony-Version wurde eine Änderung am Cherwell-Connector im Integration Studio vorgenommen, die ihn nicht mehr mit 10.0-Agenten kompatibel macht.

  • Umgehungslösung: Wenn Sie den Cherwell-Connector verwenden, aktualisieren Sie bitte auf 10.1-Agenten oder höher.

9.8 private agents

• Plugins werden nicht ausgeführt

  • Zusammenfassung: Ein Problem mit nicht funktionierenden Plugins führte dazu, dass der Download des 9.8-Privatagenten kurz nach der Veröffentlichung zurückgezogen wurde.

  • Umgehungslösung: Wenn Sie noch einen 9.8-Privatagenten haben, aktualisieren Sie bitte auf eine spätere Version.