Zum Inhalt springen

Private Jitterbit-Agenten unter Linux

Einführung

Auf dieser Seite erfahren Sie, wie Sie einen privaten Agenten installieren und ausführen unter Linux. 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, Installationsprogramm ausführen und Konfigurieren 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.

  • Ein Konto mit Root-Rechten. Verwenden Sie es für alle Aktionen auf dieser Seite.

Folgendes ist optional:

  • Agenten 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:

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-Linux Pakete herunter:

  • Linux Debian (x64): Die .deb Paketdatei zur Installation unter Debian oder Ubuntu Linux als Root.

  • Linux RPM: Die .rpm Paketdatei zur Installation auf Red Hat Linux als Root.

  • Linux Redhat Non-Root (x64): Die .tar Datei, die unter Red Hat Linux von einem Nicht-Root-Benutzer entpackt werden kann.

Hinweis

A root oder sudo Für die Installation der erforderlichen Software und das Hinzufügen eines Benutzerkontos ist weiterhin ein Konto erforderlich.

Führen Sie das Installationsprogramm aus

Führen Sie in einem Terminal die folgenden Befehle für den heruntergeladenen Installationstyp aus:

apt-get install <PATH>/jitterbit-agent_<VERSION>_amd64.deb
update-alternatives --install /usr/bin/python python /usr/bin/python2 1

yum install <PATH>/jitterbit-agent-<VERSION>.x86_64.rpm
alternatives --set python /usr/bin/python2
as root
yum install python2 tar unixODBC unzip
alternatives --set python /usr/bin/python2
useradd-U jitterbit -b /opt-G wheel
passwd jitterbit
# Set a password

``` sh title="as jitterbit" tar-C /opt -xf /jitterbit-agent-.x86_64.tar

. scripts/set.env.sh scripts/install.sh ```

Konfigurieren

Gehen Sie folgendermaßen vor, um einen privaten Agenten unter Linux zu konfigurieren, zu registrieren und neu zu starten:

  1. Führen Sie diesen Befehl aus:

    jitterbit-config

    Um den Agenten über einen Proxyserver kommunizieren zu lassen, fügen Sie die erforderlichen Optionen hinzu.

  2. Geben Sie bei der entsprechenden Aufforderung den Benutzernamen und das Kennwort Ihres Harmony-Kontos ein und wählen Sie die Optionen aus, die Ihrer Organisation, Agentengruppe und Ihrem Agenten entsprechen.

    Wenn Sie die tar Paket als jitterbit Benutzer, geben Sie y bei folgender Eingabeaufforderung:

    Warning: this tool requires root privileges.
Hint: Use sudo or log on as the root user.
Do you want to continue as the current user?`[j/n]:`

  3. Führen Sie diesen Befehl aus:

    jitterbit restart

Aktualisierung

Bei einem Upgrade einer Nebenversion eines privaten Agenten (Privater Agent 10, Version 10.x auf 10.y oder Privater Agent 11, Version 11.x auf 11.y) muss der Agent angehalten und neu gestartet werden. Bei einem Upgrade einer Hauptversion (Privater Agent 10 auf Privater Agent 11) ist das Gleiche erforderlich, allerdings ist eine vollständige Synchronisierung erforderlich von Umgebungen.

Tipp

Während der Synchronisierung kann der Agent keine Vorgänge verarbeiten. Um die Agent-Ausfallzeit, die Ihre Geschäftsprozesse beeinträchtigt, zu minimieren, richten Sie eine Agent-Gruppe mit mehreren Agenten ein und lassen Sie die Agenten vollständig synchronisieren, bevor Sie sie Vorgänge verarbeiten lassen.

Um einen privaten Agenten unter Linux zu aktualisieren, gehen Sie folgendermaßen vor:

  1. Herunterladen ein Installationspaket.

  2. Stop den Agenten.

  3. Erstellen Sie Sicherungskopien der folgenden Dateien:

    Speicherort Datei
    /opt/jitterbit/ jitterbit.conf
    /opt/jitterbit/ JdbcDrivers.conf
    /opt/jitterbit/Resources/ jitterbit-agent-config.properties
    /opt/jitterbit/apache/conf/ httpd.conf
    /opt/jitterbit/apache/conf/ *.crt
    /opt/jitterbit/apache/conf/ *.key
    /opt/jitterbit/apache/conf/extra/ *.conf
    /opt/jitterbit/jre/lib/security/ cacerts

  4. Führen Sie in einem Terminal den folgenden Befehl für den heruntergeladenen Installationstyp aus:

    apt-get upgrade <PATH>/jitterbit-agent_<VERSION>_amd64.deb

    yum upgrade <PATH>/jitterbit-agent-<VERSION>.x86_64.rpm
    as jitterbit
    tar-C /opt -xf <PATH>/jitterbit-agent-<VERSION>.x86_64.tar

  5. Vergleichen Sie die folgenden Dateien mit Ihren Sicherungskopien und stellen Sie alle geänderten Einstellungen wieder her:

    Speicherort Datei
    /opt/jitterbit/ jitterbit.conf
    /opt/jitterbit/ JdbcDrivers.conf
    /opt/jitterbit/Resources/ jitterbit-agent-config.properties
    /opt/jitterbit/apache/conf/ httpd.conf
    /opt/jitterbit/apache/conf/extra/ *.conf
    /opt/jitterbit/jre/lib/security/ cacerts

  6. Wenn Sie ein Backup haben .crt oder .key Dateien, die noch nicht in /opt/jitterbit/apache/conf/, kopieren Sie sie an diesen Speicherort.

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

  8. Um den Agenten zu starten, führen Sie diesen Befehl aus:

    jitterbit start

  9. (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), und starten Sie den Agenten dann neu.

Deinstallieren

Um einen privaten Agenten unter Linux zu deinstallieren, gehen Sie folgendermaßen vor:

  1. Stopp den Agenten.

  2. (Optional) Erstellen Sie Sicherungskopien der folgenden Dateien:

    Speicherort Datei
    /opt/jitterbit/ jitterbit.conf
    /opt/jitterbit/ JdbcDrivers.conf
    /opt/jitterbit/Resources/ jitterbit-agent-config.properties
    /opt/jitterbit/apache/conf/ httpd.conf
    /opt/jitterbit/apache/conf/ *.crt
    /opt/jitterbit/apache/conf/ *.key
    /opt/jitterbit/apache/conf/extra/ *.conf
    /opt/jitterbit/jre/lib/security/ cacerts

  3. Um die Installationsdateien (einschließlich PostgreSQL und seines Datenverzeichnisses), die Dienststartdatei und die jitterbit Benutzerkonto, führen Sie diese Befehle aus:

    apt-get remove --autoremove jitterbit-agent
userdel --remove --force jitterbit

    yum remove jitterbit-agent
userdel --remove --force jitterbit
    as root or with sudo
    yum remove python2 tar unixODBC unzip
userdel --remove --force jitterbit

Verwalten

Sie können starten, stoppen und zeigen Sie den Status eines privaten Agenten mit der jitterbit Befehl. Sie können einen Agenten auch über die Management Console remote stoppen, ihn aber nur in einem Terminal auf dem Host neu starten. Mit Ausnahme von Nicht-Root-Installationen können Sie den Agenten auch durch einen Neustart des Host neu starten.

Agenten gestartet mit automatischer Registrierung wird automatisch abgemeldet, wenn es gestoppt wird.

Start

Private Agenten, die von einem .deb oder .rpm Paketdatei automatisch mit dem Host starten. Für Nicht-Root .tar Dateiinstallationen müssen Sie zum Starten des Agenten ein Script hinzufügen oder ihn manuell starten.

Hinweis

Es kann mehrere Minuten dauern, bis ein privater Agent die Synchronisierung abgeschlossen hat und sich im Laufstatus befindet.

Um einen privaten Agenten unter Linux zu starten, führen Sie diesen Befehl aus:

jitterbit start

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.

    Achtung

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

Ablasspause

Um einen privaten Agenten unter Linux anzuhalten, führen Sie den folgenden Befehl aus in einem Terminal:

jitterbit-utils --drain-pause

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

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

Ablaufstopp

Um einen privaten Agenten unter Linux 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 einem Terminal den folgenden Befehl aus:

    jitterbit-utils --drain-stop

Harter Stopp

Um einen privaten Agenten unter Linux hart zu stoppen, führen Sie diesen Befehl aus:

jitterbit stop

Achtung

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

Projektstatus

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

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

  • Führen Sie in einer Terminalsitzung diesen Befehl aus:

    jitterbit status

Fehlerbehebung

Diese Abschnitte auf der Seite zur Fehlerbehebung kann bei der Fehlerbehebung bei privaten Agentinstallationen unter Linux hilfreich sein: