Private Agents und Agent-Gruppen auf der Seite „Agents" in der Jitterbit Management Console verwalten

Einführung

Verwenden Sie die Registerkarte Private, um private Agents und Agent-Gruppen zu verwalten:

Sie enthält eine Symbolleiste und eine Tabelle mit privaten Agent-Gruppen. Klicken Sie auf eine Gruppe, um die Agents der Gruppe zu verwalten.

Die Symbolleiste enthält diese Steuerelemente:

Suche: Geben Sie eine Suchzeichenfolge ein, um eine Suche ohne Berücksichtigung der Groß-/Kleinschreibung in einer beliebigen Spalte durchzuführen (außer Cloud-Protokollierung und Aktionen). Es werden nur Gruppen angezeigt, deren Spalten der Suchzeichenfolge entsprechen, wobei der entsprechende Text hervorgehoben wird.
Ein Satz von Menüs zum Filtern der Agent-Gruppenliste nach Folgendem:
- Status: Wählen Sie Alle Status, um Agent-Gruppen mit Agents aller Status anzuzeigen, Kein Status, um Agent-Gruppen mit Agents ohne Status anzuzeigen, oder einen der aufgelisteten Statusnamen, um nur Agent-Gruppen mit Agents mit den ausgewählten Status anzuzeigen. (Wenn Alle Status ausgewählt ist, sind auch alle anderen Optionen ausgewählt.)
- Agent-Gruppe: Wählen Sie Alle Gruppen, um alle Agent-Gruppen anzuzeigen, oder einen der aufgelisteten Agent-Gruppennamen, um nur diese ausgewählten Agent-Gruppen anzuzeigen.
- Agent-Name: Wählen Sie Alle Agents, um Agent-Gruppen für alle Agents anzuzeigen, Keine Agents zugeordnet, um Agent-Gruppen ohne Agents anzuzeigen, oder einen der aufgelisteten Agent-Namen, um nur die Agent-Gruppen dieser Agents anzuzeigen.
- Umgebungsname: Wählen Sie Alle Umgebungen, um Agent-Gruppen in allen Umgebungen anzuzeigen, Keine Umgebungen zugeordnet, um Agent-Gruppen ohne zugeordnete Umgebung anzuzeigen, oder einen der aufgelisteten Umgebungsnamen, um nur die damit verknüpften Agent-Gruppen anzuzeigen.
Tipp

Ihre Filterauswahl wird beim nächsten Besuch der Seite beibehalten.
Aktualisieren: Aktualisiert die Tabelle.
Spalten filtern: Öffnet die Spalten-Schublade, um Spalten neu anzuordnen oder deren Sichtbarkeit zu ändern.
Agent-Gruppe hinzufügen: Fügt eine private Agent-Gruppe hinzu.

Private Agent-Gruppen verwalten

Private Agent-Gruppen werden in einer Tabelle mit den folgenden Spalten angezeigt (einige davon können durch die Spalten filtern-Einstellungen ausgeblendet werden):

Agent-Gruppen-ID: Die ID-Nummer der privaten Agent-Gruppe. Um die ID in die Zwischenablage zu kopieren, zeigen Sie auf die Spalte und klicken Sie dann auf das Symbol Kopieren.
Agent-Gruppenname: Der Name der privaten Agent-Gruppe. Um den Namen in die Zwischenablage zu kopieren, zeigen Sie auf die Spalte und klicken Sie dann auf das Symbol Kopieren.
Beschreibung: Die Beschreibung der privaten Agent-Gruppe.
Umgebungen: Die Umgebung, die der Agent-Gruppe zugeordnet ist.
Cloud-Protokollierung: Wenn aktiviert, können Sie auf detaillierte Protokollmeldungen in der Registerkarte Runtime Meldungen zugreifen und Agent-Protokolle herunterladen. Wenn deaktiviert, bietet die Registerkarte Meldungen einen Link zu den Betriebsprotokolldetails auf dem Agent-Host. Falls Ihre Firewall dies zulässt, wird das Protokoll in einer separaten Browser-Registerkarte geöffnet.

Wichtig

Sie müssen alle privaten Agents in der Gruppe neu starten, wenn Sie diese Einstellung ändern.

Hinweis

Der Schalter Cloud-Protokollierung aktiviert oder deaktiviert die Betriebsprotokollierung nicht und beeinflusst nicht, ob Komponenteneingabe- und -ausgabedaten (generiert, wenn Betriebsdebug-Protokollierung aktiviert ist) in der Harmony-Cloud gespeichert werden. Der Schalter beeinflusst nur, ob Betriebsprotokolle und detaillierte Protokollmeldungen in der Harmony-Cloud gespeichert werden.

Das Aktivieren oder Deaktivieren der Cloud-Protokollierung für eine Agent-Gruppe kann eine Benachrichtigung an designierte Empfänger senden. Richten Sie diese Benachrichtigung auf der Seite Benachrichtigungen der Management Console mit dem Ereignis Cloud-Protokollierungsstatus geändert ein oder passen Sie sie an.
Agent-Gruppenklasse: Verwenden Sie das Menü, um eine dieser Klassifizierungen auszuwählen:
- Standard: Ermöglicht maximal einen Agent in der Gruppe.
- Hochverfügbarkeit: Ermöglicht zwei oder mehr Agents in der Gruppe und erfordert eine Agent-Gruppierung für HA-Lizenz (Hochverfügbarkeit). Dieser Klassentyp ermöglicht es mehreren Agents innerhalb einer Gruppe, die Betriebslast zu teilen und bietet Redundanz für Hochverfügbarkeitsszenarios.
Hinweis

Die Agent-Gruppierung für HA-Lizenz wird auf Systemebene nicht erzwungen. Wenn Sie eine Standard-Gruppe ohne Lizenz oder über Ihre Lizenzgrenze hinaus in Hochverfügbarkeit umklassifizieren, werden Sie durch eine Informationsmeldung aufgefordert, Ihren Jitterbit-Vertreter zu kontaktieren, um Ihre Zuweisung anzupassen. Außerdem wird ein Warnsymbol neben dem Namen der Agent-Gruppe angezeigt. Wenn Sie auf das Symbol zeigen, wird die gleiche Informationsmeldung angezeigt.

Ihre Lizenzierungs- und Nutzungsinformationen finden Sie auf der Seite Dashboard der Management Console.
Agents-Anzahl: Die Anzahl der Agents in der Agent-Gruppe. Eine Gruppe mit der Hochverfügbarkeit-Agent-Gruppenklasse ist standardmäßig auf 10 Agents begrenzt. Wenn Ihr Anwendungsfall mehr Agents in einer einzelnen Gruppe erfordert, kontaktieren Sie Ihren Jitterbit-Vertreter, um ein höheres Limit für diese Gruppe anzufordern.
Aktionen: Diese Spalte enthält die folgenden Symbole:
- Details: Öffnen Sie die Schublade Agent-Gruppendetails. Wenn die Schublade geöffnet ist, werden die folgenden Steuerelemente in der oberen rechten Ecke der Schublade angezeigt:
  - Vorherige: Wählen Sie die vorherige private Agent-Gruppe aus.
  - Nächste: Wählen Sie die nächste private Agent-Gruppe aus.
  - Erweitern: Erweitern Sie die Schublade Agent-Gruppendetails auf die Größe der Seite. Wenn erweitert, klicken Sie auf das Symbol Minimieren, um es auf seine ursprüngliche Größe zurückzusetzen.
  - Schließen: Schließen Sie die Schublade.
- Connectors aktualisieren: Aktualisieren Sie Studio-Connector SDK-basierte Connectors auf allen Agents in der Gruppe. (Dies setzt die Einstellung Automatische Connector-Aktualisierung deaktivieren der Organisationsrichtlinie außer Kraft, die automatische Aktualisierungen verhindert.)
- Bearbeiten: Bearbeiten Sie die private Agent-Gruppe.
- Löschen: Löschen Sie die private Agent-Gruppe. Sie können eine Gruppe erst löschen, wenn alle Umgebungszuordnungen entfernt wurden.

Eine private Agent-Gruppe hinzufügen

Gehen Sie wie folgt vor, um eine private Agent-Gruppe hinzuzufügen:

Klicken Sie auf die Schaltfläche Agent-Gruppe hinzufügen in der Symbolleiste der Registerkarte Privat. Die Schublade Agent-Gruppe hinzufügen wird geöffnet:
Geben Sie einen Wert in das Feld Gruppenname ein.
(Optional) Geben Sie einen Wert in das Feld Beschreibung ein.

Tipp

Der Gruppenname und die Beschreibung dürfen nur alphanumerische Zeichen, Unterstriche _, Klammern (), Bindestriche - und Leerzeichen enthalten.
Schalten Sie den Umschalter Cloud-Protokollierung ein oder aus.
Öffnen Sie das Menü Agent-Gruppenklasse, und wählen Sie dann entweder Standard oder Hochverfügbarkeit:
Klicken Sie auf die Schaltfläche Speichern.
Wenn die neue Gruppe (Agent Group C in diesem Beispiel) in der Tabelle angezeigt wird, können Sie Agents hinzufügen:

Hinweis

Der Abonnementplan Ihrer Organisation umfasst eine Zuweisung von privaten Agents und Hochverfügbarkeits-Gruppen (HA) für private Agents.

Eine private Agent-Gruppe bearbeiten

Um eine private Agent-Gruppe zu bearbeiten, gehen Sie wie folgt vor:

Fahren Sie mit der Maus über eine private Agent-Gruppe und klicken Sie auf das Symbol Bearbeiten in der Spalte Aktionen. Die Schublade Agent-Gruppe bearbeiten wird geöffnet:
Bearbeiten Sie die Felder Gruppenname oder Beschreibung, oder ändern Sie die Einstellungen für Cloud-Protokollierung oder Agent-Gruppenklasse. Agent-Gruppen mit zwei oder mehr Agents können die Klasse nicht von Hochverfügbarkeit zu Standard ändern, bis die Anzahl der Agents in der Gruppe eins beträgt.
Klicken Sie auf die Schaltfläche Speichern.

Eine private Agent-Gruppe löschen

Um eine private Agent-Gruppe zu löschen, gehen Sie wie folgt vor:

Fahren Sie mit der Maus über eine private Agent-Gruppe und klicken Sie auf das Symbol Löschen in der Spalte Aktionen. Das Dialogfeld Agent-Gruppe löschen wird geöffnet:
Um die Aktion fortzusetzen, geben Sie das Wort DELETE an der angegebenen Stelle ein und klicken Sie auf die Schaltfläche Löschen.

Tipp

Eine private Agent-Gruppe kann nur gelöscht werden, wenn sie keine zugeordneten Umgebungen hat.

Private Agents verwalten

Um die Details einer private Agent-Gruppe anzuzeigen, können Sie entweder auf eine Zeile in der Tabelle klicken oder mit der Maus auf eine Zeile fahren und auf das Symbol Details in der Spalte Aktionen klicken. Die Schublade Agent-Gruppendetails wird am unteren Rand der Seite mit den folgenden Registerkarten geöffnet:

Agents
Plugins
Umgebungen

Wenn die private Agent-Gruppe mindestens einen laufenden Agent hat und die Remote-Agent-Konfiguration auf der Registerkarte Agent-Verwaltung unter Organisationen aktiviert ist, werden auch die folgenden Registerkarten angezeigt:

Jitterbit-Konfiguration
Datenbanktreiber

Gruppendetails anzeigen

Um die Agents in einer private Agent-Gruppe zu verwalten, gehen Sie wie folgt vor:

Öffnen Sie die Schublade Agent-Gruppendetails für die private Agent-Gruppe, die Sie verwalten möchten.
Wählen Sie in der Schublade Agent-Gruppendetails die Registerkarte Agents aus:

Die Registerkarte Agents der Gruppendetails enthält Folgendes:

Eine Symbolleiste mit diesen Steuerelementen:
- Suchen: Geben Sie eine Suchzeichenfolge ein, um eine Suche ohne Berücksichtigung der Groß-/Kleinschreibung in einer beliebigen Spalte durchzuführen (außer Aktionen). Es werden nur Agents angezeigt, deren Spalten der Suchzeichenfolge entsprechen, wobei der entsprechende Text hervorgehoben wird.
- Aktualisieren: Aktualisieren Sie die Tabelle.
- Spalten filtern: Öffnen Sie die Schublade Spalten, um Spalten neu anzuordnen oder deren Sichtbarkeit zu ändern.
- Erstellen: Fügen Sie einen privaten Agent zur private Agent-Gruppe hinzu. Diese Option ist deaktiviert, wenn die Gruppe eine Standard-Agent-Gruppenklasse mit maximal einem Agent hat. Bei einer Hochverfügbarkeit-Gruppe bleibt diese Option aktiviert, nachdem die Gruppe ihre maximale Anzahl von Agents erreicht hat, und das Limit wird durchgesetzt, wenn Sie den neuen Agent speichern.
Eine Tabelle mit privaten Agents mit den folgenden Spalten:
- Name: Der Name des privaten Agents.
- ID: Die ID-Nummer des privaten Agents.
- IP: Die IP-Adresse des Hosts des privaten Agents.
- OS: Das Betriebssystem des Hosts des privaten Agents.
- Version: Die Versionsnummer der Software des privaten Agents.
- Status: Der Status des privaten Agents.
- Aktionen:
  - Agent-Protokolle herunterladen: Um private Agent-Protokolldateien herunterzuladen, öffnen Sie das Menü, wählen Sie aus, welche Protokolle des privaten Agents heruntergeladen werden sollen, und klicken Sie auf die Schaltfläche Herunterladen. Sie können eine oder alle der folgenden Optionen auswählen:

Jitterbit-Protokolle: Alle Dateien im Verzeichnis JITTERBIT_HOME/log des privaten Agent-Hosts.

    -   **Apache-Protokolle:** Alle Dateien im Verzeichnis `JITTERBIT_HOME/apache/log` des privaten Agent-Hosts.

    -   **Transformationsprotokolle:** Alle Verzeichnisse und Dateien im Verzeichnis `JITTERBIT_HOME/DataInterchange/Temp/LOG` des privaten Agent-Hosts.

    -   **Tomcat-Protokolle:** Alle Dateien im Verzeichnis `JITTERBIT_HOME/tomcat/logs` des privaten Agent-Hosts.

    -   **Debug-Protokolle:** Alle Verzeichnisse und Dateien im Verzeichnis `JITTERBIT_HOME/DataInterchange/Temp/Debug` des privaten Agent-Hosts.

    Einzelne Protokolle werden gezippt, kombiniert, erneut gezippt und dann mit dem Dateinamen `log.zip` heruntergeladen.

-   **<span class="icon-download-agent"></span> Jitterbit Agent herunterladen:** Den privaten Agent-Software herunterladen. Wählen Sie die Version und das Betriebssystem aus und klicken Sie auf die Schaltfläche **Herunterladen**.

-   <span id="drain-stop"/> **<span class="icon-pan-tool"></span> Drain Stop:** Aktiv nur, wenn der Agent läuft. Ein Dialog öffnet sich, um die Aktion zu bestätigen.

-   **<span class="icon-more"></span> Weitere Aktionen:** Klicken Sie, um die folgenden Optionen anzuzeigen:

    -   **<span class="icon-pencil"></span> Agent bearbeiten:** Den Namen des privaten Agents bearbeiten. Aktiv nur, wenn der Agent gestoppt oder nicht registriert ist.

    -   **<span class="icon-trash-detailed"></span> Agent löschen:** Den privaten Agent löschen und aus der privaten Agent-Gruppe und Ihrer Organisation entfernen.

Agent-Status

Der Status eines privaten Agents ist einer der folgenden:

Nicht registriert: Der Agent wurde hinzugefügt, ist aber nicht bereit, Operationen auszuführen.
Wird gestartet: Der Agent ist registriert und wird bereit, Operationen auszuführen.
Läuft: Der Agent ist bereit, Operationen auszuführen.
Wird gestoppt: Der Agent antwortet auf eine Drain-Stop-Anfrage. Laufende Operationen dürfen bis zu agent.drainstop.api.wait Sekunden (standardmäßig 180) ausgeführt werden, bevor sie als abgebrochen markiert werden.
Gestoppt: Der Agent bleibt registriert, führt aber keine Operationen aus.
Unbekannt: Der Agent ist registriert, aber es gab keinen Heartbeat in den letzten 5 Minuten (das Standardintervall).

Das folgende Diagramm zeigt, wie sich der Status eines privaten Agents ändern kann:

%%{
init: {
    'state': { 'nodeSpacing': 50, 'rankSpacing': 25 }
    }
}%%
stateDiagram-v2
  direction LR
  state "&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Unknown\n(Lost heartbeat)" as U
  Unregistered --> Starting
  state Registered {
    Stopped --> Starting
    Starting --> Running
    Running --> Stopping: \nDrain stop
    Stopping --> Stopped
  Starting --> U
    Running --> U
    Stopping --> U
    Stopped --> U
  }

Agents hinzufügen

Eine Standard-Agent-Gruppe enthält einen Agent, und eine Hochverfügbarkeits-Gruppe enthält standardmäßig bis zu 10 Agents.

Um einen privaten Agent zu einer privaten Agent-Gruppe hinzuzufügen, führen Sie diese Schritte aus:

Öffnen Sie die Schublade Agent-Gruppendetails für die private Agent-Gruppe, in die der neue private Agent eingefügt werden soll.
Klicken Sie auf das Symbol Erstellen in der Symbolleiste der Registerkarte Agent der Schublade. Eine neue Zeile Neuer Agent wird in der Tabelle angezeigt:
Geben Sie einen Wert in das Feld Name ein:
Klicken Sie auf das Symbol Speichern:
Sie können jetzt Ihren privaten Agent mit dem neuen Agent-Namen und der neuen Agent-ID registrieren.

Agents löschen

Um einen privaten Agent aus einer privaten Agent-Gruppe zu löschen, führen Sie diese Schritte aus:

Öffnen Sie die Schublade Agent-Gruppendetails für die private Agent-Gruppe, die den privaten Agent enthält, den Sie löschen möchten.
Bewegen Sie in der Schublade Agent-Gruppendetails den Mauszeiger über einen privaten Agent und klicken Sie auf das Symbol Weitere Aktionen.
Wählen Sie im Menü Agent löschen aus. Das Dialogfeld Agent löschen wird geöffnet:

Dialogtext

Agent löschen
Möchten Sie den Agent agentName wirklich löschen?

Bitte geben Sie "DELETE" ein, um zu bestätigen.

Um die Aktion fortzusetzen, geben Sie das Wort DELETE an der angegebenen Stelle ein und klicken Sie auf die Schaltfläche Delete.

Tipp

Ein Agent kann nur gelöscht werden, wenn sein Status einer der folgenden Werte ist: Starting, Stopped, Unregistered oder Unknown.

Plugins verwalten

Um die Plugins einer privaten Agent-Gruppe zu verwalten, führen Sie diese Schritte aus:

Öffnen Sie die Schublade Agent group details für eine private Agent-Gruppe.
Wählen Sie in der Schublade Agent group details die Registerkarte Plugins:

Um Plugins mit der ausgewählten privaten Agent-Gruppe zu verknüpfen oder die Verknüpfung aufzuheben, verwenden Sie den Schalter in der Spalte Association.

Um zum Plugin-Eintrag auf der Seite Plugins der Management Console zu springen, bewegen Sie den Mauszeiger über die Spalte Actions und klicken Sie auf das Symbol Go to plugin.

Umgebungszuordnungen anzeigen

Um zu sehen, mit welchen Umgebungen der private Agent verknüpft ist, führen Sie diese Schritte aus:

Öffnen Sie die Schublade Agent group details für eine private Agent-Gruppe.
Wählen Sie in der Schublade Agent group details die Registerkarte Environments:

Um den Zuordnungsstatus zu ändern, bewegen Sie den Mauszeiger über die Spalte Actions und klicken Sie auf das Symbol Go to environment. Die Seite Environments der Management Console wird für die Umgebung geöffnet.

Agent-Konfigurationen verwalten

Wenn die ausgewählte private Agent-Gruppe aktive private Agents hat, können Sie alle Agents in einer Gruppe remote konfigurieren, ohne sich bei jedem einzelnen Agent-Host anmelden zu müssen. Dazu müssen diese Bedingungen erfüllt sein:

Es muss mindestens einen privaten Agent in der Gruppe geben, der den Status Running hat.
Sie müssen die Remote-Agent-Konfiguration auf der Registerkarte Agent Management unter Organizations aktivieren.

Wenn diese Bedingungen erfüllt sind, sind die Registerkarten Jitterbit configuration und Database Drivers auch in der Schublade Agent group details sichtbar.

Jitterbit-Konfiguration

Um die Konfiguration einer privaten Agent-Gruppe zu verwalten, führen Sie diese Schritte aus:

Öffnen Sie die Schublade Agent group details für die private Agent-Gruppe, die Sie konfigurieren möchten.
Wählen Sie in der Schublade Agent group details die Registerkarte Jitterbit Configuration:

Die Registerkarte Jitterbit Configuration zeigt die Standard-Datei jitterbit.conf des privaten Agents in Tabellenform. Zwischen der Registerkartenleiste und der Tabelle befindet sich eine Symbolleiste mit den folgenden Steuerelementen:

Search: Suchen Sie nach Konfigurationselementen nach Abschnitt, Aktivierungsstatus, Schlüssel, Wert oder Beschreibung.
Reset to default: Setzen Sie die Konfiguration für alle Agents in der Gruppe auf ihre Standardwerte zurück. Gehen Sie dazu wie folgt vor:
1. Klicken Sie auf das Symbol.
2. Lesen Sie die Informationen im Dialog Reset configuration to default.
3. Geben Sie das Wort RESET an der angegebenen Stelle ein und klicken Sie auf die Schaltfläche Reset.
Tipp

Standardwerte für jeden Schlüssel werden in Tooltips in der Spalte Value angezeigt.
Refresh: Aktualisieren Sie die Tabelle.
Edit configuration: Bearbeiten Sie Konfigurationselemente für alle Agents in der Gruppe. Gehen Sie dazu wie folgt vor:
1. Klicken Sie auf das Symbol.
2. Lesen Sie die Informationen im Dialog Edit Jitterbit Configuration und klicken Sie auf die Schaltfläche Continue.
3. Nehmen Sie Änderungen an den Konfigurationselementen vor und klicken Sie auf das Symbol Save.
4. Lesen Sie erneut die Informationen im Dialog Edit Jitterbit Config und klicken Sie auf die Schaltfläche Save.
Konfiguration hinzufügen: Fügen Sie ein Konfigurationselement für alle Agents in der Gruppe hinzu. Gehen Sie dazu wie folgt vor:
1. Klicken Sie auf das Symbol.
2. Lesen Sie die Informationen im Dialog Neue Jitterbit-Konfiguration hinzufügen, und klicken Sie dann auf die Schaltfläche Weiter.
3. Eine neue Zeile wird in der Tabelle angezeigt. Legen Sie Werte für Abschnitt, Schlüssel und Wert fest, schalten Sie den Schalter Aktiviert ein oder aus, und klicken Sie dann auf das Symbol Speichern.
4. Lesen Sie erneut die Informationen im Dialog Neue Jitterbit-Konfiguration hinzufügen, und klicken Sie dann auf die Schaltfläche Speichern.

Hinweis

Wenn Sie die Remote-Konfiguration aktivieren, werden die Werte in der Datei jitterbit.conf eines privaten Agents überschrieben, aber nicht gelöscht. Die Warnmeldungen dienen nur zu Ihrer Information.

Datenbanktreiber verwalten

Um die Datenbanktreiber einer privaten Agent-Gruppe zu verwalten, gehen Sie wie folgt vor:

Öffnen Sie die Schublade Agent-Gruppendetails für eine private Agent-Gruppe.
Wählen Sie in der Schublade Agent-Gruppendetails die Registerkarte Datenbanktreiber:

Die Registerkarte Datenbanktreiber enthält ein Textfeld mit dem Inhalt des Abschnitts [DbDrivers] der Datei jitterbit.conf.

Um die Datenbanktreiber-Konfiguration für alle Agents in der Gruppe zu bearbeiten, gehen Sie wie folgt vor:

Klicken Sie auf das Symbol Bearbeiten.
Lesen Sie die Informationen im Dialog Datenbanktreiber bearbeiten, und klicken Sie dann auf die Schaltfläche Weiter.
Bearbeiten Sie die Datei, und klicken Sie dann auf das Symbol Speichern.
Lesen Sie erneut die Informationen im Dialog Datenbanktreiber bearbeiten, und klicken Sie dann auf die Schaltfläche Speichern.

Fehlerbehebung

Weitere Informationen zur Fehlerbehebung finden Sie in den folgenden Abschnitten im Harmony-Fehlerbehebungsleitfaden: