Jitterbit-Agenten

Übersicht

Die Harmony Agenten von Jitterbit verarbeiten die Vorgänge Ihrer Integrationsprojekte und senden und empfangen Endpoint. Es gibt zwei Arten von Agenten: Cloud und Privat:

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

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

Alle Agenten sind Mitglieder einer Gruppe. Agent sind Gruppen von Agenten der gleichen Art. Agenten innerhalb einer Agentengruppe teilen sich die Arbeit der Verarbeitung an Integration Studio oder Design Studio des Projekts. Welche Agentengruppe und welche Art von Agenten ein Projekt verwendet, hängt davon ab, welche Umfeld auf dem das Projekt bereitgestellt wird.

Die folgende Tabelle vergleicht die beiden Agentenarten:

Cloud-Agenten

Cloud-Agenten sind von Jitterbit verwaltete Cloud-Dienste. Sie sind so konfiguriert, dass sie sich automatisch an die Arbeitslast Ihres Projekts anpassen. Sie müssen keine Cloud-Agenten installieren, konfigurieren, aktualisieren, starten oder stoppen.

Cloud-Agent-Gruppen

Cloud-Agent-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-Agent-Gruppen:

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

• Sandbox Cloud Agent-Gruppe: Eine Gruppe von Agenten der aktuell vorgeschlagenen nächsten Version, geeignet für Evaluierungen und Tests.

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

Private Agenten

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

Private Agentengruppen

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 werden keine privaten Agentengruppen bereitgestellt. Sie müssen sie erstellen und Umgebungen zuweisen. Eine private Agentengruppe muss mindestens einen privaten Agenten enthalten, und ein Agent kann sich jeweils nur in einer Gruppe befinden.

Wenn sich zwei oder mehr Agenten in einer Gruppe befinden, bearbeiten die Agenten abwechselnd ganze Operation, einschließlich der untergeordneten Elemente. Dies hat folgende Konsequenzen:

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

• Die durchschnittliche Arbeitsbelastung einzelner Agent-Hosts kann erheblich variieren.

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

Für unterstützte Konnektoren und eine Mindestanzahl aktiver Agenten können Sie den Listening-Dienst aktivieren für Agenten in einer Gruppe. Der Listening-Dienst ermöglicht unterstützten Integration Studio Konnektoren warten auf API -Ereignisse. Außerdem wird einer der Agenten als Leiter bestimmt. Der Leiter-Agent verteilt die Operation entsprechend ihrem Status und ihrer Auslastung an die Agenten. Wenn ein Agent abstürzt, können Daten wiederhergestellt werden.

Veröffentlichungszeitplan und Versionshinweise

Der Veröffentlichungsplan für Agenten variiert je nach Agententyp:

• Cloud-Agent-Gruppen werden beim Sandbox Cloud Agent-Gruppe Upgrade automatisch aktualisiert und Upgrade der Produktion Cloud Agent-Gruppe Zeitpläne.

• Aktualisierte private Agent-Installationsprogramme sind unter Downloads verfügbar-Seite am Ende der Veröffentlichung der Produktion Cloud Agent-Gruppe.

• Das private Agent-Docker-Image wird unter Docker Hub verfügbar zum Abschluss der Veröffentlichung der Produktion Cloud Agent-Gruppe in der Region Nordamerika (NA).

In den Harmony Versionshinweisen, wird jeder Agententyp als separater Eintrag in der Tabelle mit den Veröffentlichungsdaten oben auf jeder Seite mit den Versionshinweisen aufgeführt. Einzelne Versionshinweise sind unter der Überschrift Agenten aufgeführt. Die relevante Anwendbarkeit auf bestimmte Agententypen ist in den Versionshinweisen aufgeführt.

Zusammenstellungen von Versionshinweisen für Production Cloud-Agent-Gruppen, Sandbox Cloud-Agent-Gruppen und private Agenten sind ebenfalls verfügbar.

Bekannte Probleme

In diesem Abschnitt sind bekannte Probleme aufgeführt, die bei aktuellen Versionen privater Agenten festgestellt wurden. Bekannte Probleme, die bei anderen Jitterbit Harmony Anwendungen festgestellt wurden, finden Sie unter Bekannte Probleme.

Mehrere Versionen privater Agenten

Private Linux Agenten 11.31.1 und alle früheren Versionen

• Geplante Vorgänge können nach einem Neustart eines privaten Linux Agenten nicht ausgeführt werden

  • Zusammenfassung: Nach dem Neustart eines privaten Linux Agenten Scheduler Der Dienst kann nicht gestartet werden, wodurch geplante Vorgänge nicht wie erwartet ausgeführt werden. Dieses Problem tritt bei privaten Windows Agenten nicht auf.

  • Zusätzliche Informationen: Der Linux Agent Scheduler Der Dienst verwendet eine Bibliothek, die die neuesten Zeitzonendatendateien herunterlädt. Am 4. September 2024 hat der Anbieter dieser Bibliothek einen Syntaxfehler eingeführt, der dazu führt, dass Scheduler Dienst wird nicht gestartet.

  • Empfehlung: Dieses Problem wurde mit Version 11.31.2 behoben, die die das Problem verursachende Bibliothek nicht mehr automatisch herunterlädt. Wir empfehlen, private Linux Agenten auf 11.31.2 oder höher zu aktualisieren, um das Auftreten dieses Problems zu verhindern und es in Fällen, in denen es bereits auftritt, zu beheben.

    Wenn Sie eine frühere Agentenversion verwenden, können Sie alternativ die folgenden Workaround- oder Wiederherstellungsschritte auf Nicht-Docker-Agenten anwenden:

    • Workaround: Wenn ein privater Linux Agent noch nicht neu gestartet wurde, bearbeiten Sie zur Vermeidung dieses Problems die version Datei unter /opt/jitterbit/TimeZoneDB/version und ändern Sie den Wert in 2024b. Dadurch wird verhindert, dass die Version der Datumsbibliothek mit dem Problem vom Agenten heruntergeladen wird.

    • Wiederherstellung: Wenn dieses Problem bereits bei einem privaten Linux Agenten auftritt, können Sie es beheben, indem Sie die northamerica Datei unter /opt/jitterbit/TimeZoneDB/northamerica um den Wert zu ersetzen April mit Apr in allen Fällen. Starten Sie dann den Agenten neu.

Alle aktuellen Versionen

Diese Probleme betreffen alle neueren Versionen:

• Bei der privaten Windows-Agentinstallation wird eine Microsoft Defender SmartScreen-Warnung angezeigt

  • Zusammenfassung: Bei der Installation eines privaten Agenten 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 wird möglicherweise eine Warnmeldung angezeigt.

  • Zusätzliche Informationen: Die Warnmeldung lautet „Windows hat Ihren PC geschützt“ mit dem Hinweis, dass Microsoft Defender SmartScreen den Start einer nicht erkannten App verhindert hat.

  • Problemumgehung: Klicken Sie im Dialogfeld mit der Warnmeldung auf Weitere Informationen, um die Option Trotzdem ausführen anzuzeigen. Klicken Sie dann auf Trotzdem ausführen, um mit der Agenteninstallation fortzufahren.

• Private Windows Agenten: 64-Bit-Agent mit Zwei-Faktor-Authentifizierung (TFA) kann nicht installiert werden

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

  • Zusätzliche Informationen: Das Installationsprogramm zeigt einen Fehlerdialog an.

  • Problemumgehung: Deaktivieren Sie TFA vorübergehend und installieren Sie den privaten 64-Bit Windows Agenten. Aktivieren Sie TFA nach der Installation.

• ODBC-Verbindungen verarbeiten erweiterte Zeichen nicht richtig

  • Zusammenfassung: Beim Herstellen einer Verbindung mit einer Datenbank über einen ODBC Driver werden einige erweiterte Zeichen, wie z. B. ein Halbgeviertstrich, von Vorgängen, die Daten aktualisieren, nicht richtig verarbeitet.

  • Zusätzliche Informationen: Upsert-Vorgänge können fehlschlagen oder mit unbeabsichtigten Folgen erfolgreich sein, da die falschen Daten betroffen sind. Beachten Sie, dass Einfüge- und Aktualisierungsvorgänge von diesem Problem nicht betroffen sind.

  • Workaround: Verwenden Sie einen JDBC- Driver 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, die automatische Erstellung von Verzeichnissen funktioniert inkonsistent.

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

  • Problemumgehung: Bestätigen Sie vor der Produktionsverwendung, dass das Verzeichnis erstellt wurde.

• SetSalesforceSession Funktion funktioniert nicht

  • Zusammenfassung: Die Jitterbit Script Skriptfunktion SetSalesforceSession funktioniert nicht richtig und sollte nicht in Design Studio oder Integration Studio.

  • Zusätzliche Informationen: Bei Verwendung kann das Script einen Fehler erzeugen, muss es aber nicht. Auch wenn das Script keinen Fehler erzeugt, funktioniert die Funktion nicht richtig. 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 je nach verwendetem Betriebssystem unterschiedliche und spezifische Systemanforderungen und bekannte Probleme.

  • Workaround: Siehe die Systemanforderungen für private Agenten für weitere Einzelheiten.

• Die Agent schlägt fehl, da das PostgreSQL -Passwort ein Pluszeichen enthält (+)

  • Zusammenfassung: Die Installation eines 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 privaten Agent-Installationsprogramm, nicht mit PostgreSQL.

  • Workaround: Verwenden Sie ein Passwort ohne Pluszeichen (+). Wenn die Installation abgeschlossen ist, kann das Kennwort in ein beliebiges für die Verwendung mit PostgreSQL akzeptables Kennwort geändert werden.

11.26 private Agenten

• Der VerifyJwtClaims Funktion claims Parameter wird nicht standardmäßig auf den richtigen Wert gesetzt, wenn er leer gelassen wird

  • Zusammenfassung: Wenn Sie Agentversion 11.26 verwenden und den optionalen Parameter leer lassen, claims Parameter leer mit dem VerifyJwtClaims Die Jitterbit Script Skriptfunktion generiert einen Fehler.

  • Workaround: Upgrade auf Agent-Version 11.27 oder höher oder geben Sie ein "{}" für claims. Zum Beispiel, VerifyJwtClaims("AxE9qm4aTZiXvA2G8sblAxjeL...", "RS256", "Secret", "{}");.

10.87 / 11.25 und frühere private Agenten

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

  • Zusammenfassung: Bei Verwendung des Microsoft Azure Service Bus Connectors mit Agent-Version 10.87 / 11.25 oder früher, eine übermäßige Anzahl von INFO Protokolle werden in einem kurzen Zeitraum generiert, was aufgrund der Größe der catalina.out Datei.

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

    <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 wird während der Umstellung auf die Sommerzeit übersprungen

  • Zusammenfassung: Wenn Sie den Agenten in der Version 10.84/11.22 oder früher verwenden und der Agent eine Zeitzone mit Sommerzeit nutzt, treten bei der Umstellung auf die Sommerzeit die folgenden bekannten Probleme auf:

    • Wenn ein Zeitplan für einmal täglich zwischen 1 und 2 Uhr morgens festgelegt ist, kann der geplante Operation aufgrund der Sommerzeit am ersten Sonntag im November nicht ausgeführt werden.

    • Wenn ein Zeitplan für einmal täglich zwischen 2 und 3 Uhr morgens festgelegt ist, kann der geplante Operation aufgrund der Sommerzeit am zweiten Sonntag im März nicht ausgeführt werden.

  • Problemumgehung: Aktualisieren Sie auf die Agentenversion 10.85 / 11.23 oder höher oder stellen Sie die Zeitzone des Agenten mithilfe der Organisationsrichtlinie Zeitzone des geplanten Agent überschreiben auf UTC ein. und wählen Sie Etc/UTC.

10.45 und frühere private Agenten

• Apache Log4j2 JNDI-Schwachstellen betreffen private Agenten

  • Zusammenfassung: Apache Log4j2-Schwachstellen CVE-2021-44228 und CVE-2021-45046 betreffen private Agenten, die Integration Studio Steckverbinder mit dem Integration Studio Connector-SDK.

  • Milderung: Die Schwachstellen wurden durch eine Notfallwartung behoben. Nach der Wartung mussten private Agenten neu gestartet und für jeden betroffenen Connector ein Operation ausgeführt werden, damit das Update wirksam wurde. Detaillierte Informationen und Anweisungen finden Sie unter Milderung der Apache Log4j2 JNDI-Schwachstelle.

10.38 Private Linux Agenten

• Die PostgreSQL Datenbank wird beim Upgrade von Version 10.37 auf 10.38 neu initialisiert

  • Hintergrund: Beim Upgrade eines privaten Linux Agenten von einer Version vor 10.37 auf eine Version 10.37 oder höher wird die PostgreSQL -Datenbank neu initialisiert, da sie auf Version 9.6 aktualisiert wird. Dieses Upgrade erstellt die Datenbank auf Ihrem privaten Agenten neu und Ihre Daten werden während dieses Upgradevorgangs wiederhergestellt. Nach dem Upgrade sind alle mit einer früheren PostgreSQL Version erstellten Backups nicht mehr kompatibel. Der Upgradevorgang kann je nach Anzahl der Projekte und Größe der mit Ihrer privaten Agentengruppe verknüpften Umgebungen mehr als 30 Minuten dauern. Alle ausstehenden Jobs werden in eine Warteschlange gestellt, um nach Abschluss des Upgrades ausgeführt zu werden. Dieses Upgrade betrifft nicht den privaten Windows Agenten.

  • Bekanntes Problem: Es ist ein Bekanntes Problem, dass beim Upgrade eines privaten Linux Agenten von Version 10.37 auf 10.38 die PostgreSQL Datenbank neu initialisiert wird.

  • Problemumgehung: Aktualisieren Sie auf einen privaten Linux Agenten der Version 10.39 oder höher.

10.0 private Agenten

• Der Integration Studio Cherwell-Anschluss funktioniert nicht

  • Zusammenfassung: Ab der 10.1 Harmony Version, eine Änderung am Cherwell Connector In Integration Studio bedeutet, dass es nicht mehr mit 10.0-Agenten kompatibel ist.

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

9.8 private Agenten

• Plugins werden nicht ausgeführt

  • Zusammenfassung: Ein Problem mit Plugins, die nicht ausgeführt werden konnten, führte dazu, dass der Download des privaten Agenten 9.8 kurz nach der Veröffentlichung zurückgezogen wurde.

  • Problemumgehung: Wenn Sie noch einen privaten Agenten 9.8 haben, aktualisieren Sie bitte auf eine neuere Version.