Zum Inhalt springen

Jitterbit private agents auf Linux

Einführung

Diese Seite zeigt Ihnen, wie Sie einen privaten Agenten auf Linux installieren und ausführen. Der Abschnitt Fehlerbehebung bietet eine Liste häufiger Probleme und deren Lösungen.

Installation

Um einen privaten Agenten zu installieren, befolgen Sie diese Schritte:

  1. Erfüllen Sie die Voraussetzungen.

  2. Laden Sie ein Installationspaket für den privaten Agenten herunter.

  3. Führen Sie den Installer für den privaten Agenten aus.

  4. Konfigurieren und starten Sie den privaten Agenten.

Voraussetzungen

Sie müssen Folgendes haben:

  • Einen Host, der die Systemanforderungen erfüllt.

  • Den Namen Ihrer Harmony-Organisation sowie den Benutzernamen und das Passwort Ihres Harmony-Kontos.

  • Den Namen und die ID einer privaten Agentengruppe.

  • Ein Konto mit Root-Rechten.

Folgendes ist optional:

  • Fügen Sie einen Agenten hinzu in der Management-Konsole. Wenn Sie keine unregistrierten privaten Agenten in der Agentengruppe haben, wird automatisch einer mit einem Namen erstellt, der den Hostnamen und die IP-Adresse enthält.

  • Ein PostgreSQL-Datenbankserver wird automatisch installiert. Um Ihre eigene zu verwenden, müssen Sie diese vor der Installation des privaten Agenten einrichten und deren Namen oder IP-Adresse, die Portnummer und die Details des Datenbankadministrator-Kontos kennen.

Folgendes wird empfohlen:

Download

Um die Software für den privaten Agenten herunterzuladen, gehen Sie zur Harmony-Portal-Seite Downloads.

Tipp

Wenn Sie bereits einen Agenten auf der Seite Agenten der Management-Konsole hinzugefügt haben, klicken Sie auf das Jitterbit Agent herunterladen-Symbol des Agenten.

Laden Sie eines der folgenden Linux-Pakete für den privaten Agenten herunter:

  • Linux Debian (x64): Die .deb-Paketdatei, zur Installation auf Ubuntu Linux als Root.

  • Linux RPM: Die .rpm Paketdatei, zum Installieren auf Red Hat Linux als Root.

  • Linux Redhat Non-Root (x64): Die .tar Datei, zum Installieren auf Red Hat Linux als Nicht-Root-Benutzer.

Installer

Führen Sie die folgenden Befehle für den heruntergeladenen Installer-Typ aus:

Als Root
dpkg --install <PATH>/jitterbit-agent_<VERSION>_amd64.deb
update-alternatives --install /usr/bin/python python /usr/bin/python2 1
Als Root
yum install <PATH>/jitterbit-agent-<VERSION>.x86_64.rpm

  1. Melden Sie sich als Nicht-Root-Benutzer mit sudo-Rechten an.

  2. Installieren Sie die erforderlichen Pakete:

    sudo dnf install -y unzip

    Hinweis

    Dies könnte bereits auf Ihrem System installiert sein, abhängig davon, wie es eingerichtet wurde.

  3. Erstellen Sie den Benutzer jitterbit:

    Als Nicht-Root-Benutzer
    sudo useradd --user-group jitterbit --base-dir /opt --groups wheel
sudo passwd jitterbit

  4. Verlassen Sie die Shell des Nicht-Root-Benutzers.

  5. Melden Sie sich als jitterbit an.

  6. Erstellen Sie eine Benutzer systemd Dienstdatei:

    Als jitterbit
    mkdir -p $HOME/.config/systemd/user
cat > $HOME/.config/systemd/user/jitterbit.service <<EOF
[Unit]
Description=Jitterbit private agent
Documentation=https://docs.jitterbit.com/agent/linux/
After=default.target

[Service]
Type=forking
Environment=JITTERBIT_HOME=/opt/jitterbit
Environment=PG_HOME=\${JITTERBIT_HOME}/pgsql
Environment=PG_DATA=\${JITTERBIT_HOME}/DataInterchange/pgsql/data
Environment=LD_LIBRARY_PATH=\${JITTERBIT_HOME}/lib:\${JITTERBIT_HOME}/psql/lib
Environment=PATH=\${JITTERBIT_HOME}/bin:\${JITTERBIT_HOME}/pgsql/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
ExecStart=/opt/jitterbit/bin/jitterbit start
ExecStop=/opt/jitterbit/bin/jitterbit stop
TimeoutSec=600

[Install]
WantedBy=default.target
EOF

  7. Laden Sie den systemd Daemon neu, aktivieren Sie den Dienst und lassen Sie die systemd-Dienste laufen, wenn der Benutzer nicht angemeldet ist:

    Als jitterbit
    systemctl --user daemon-reload
systemctl --user enable jitterbit.service
loginctl enable-linger

  8. Richten Sie die Shell-Umgebung ein:

    Als jitterbit
    mkdir -p $HOME/.bashrc.d
cat >> $HOME/.bashrc.d/jitterbit <<EOF
export JITTERBIT_HOME=/opt/jitterbit
export ODBCINI=\${JITTERBIT_HOME}/odbcinst.ini
export ODBCSYSINI=\${JITTERBIT_HOME}
export PG_HOME=\${JITTERBIT_HOME}/pgsql
export PG_DATA=\${JITTERBIT_HOME}/DataInterchange/pgsql/data
export LD_LIBRARY_PATH=\${JITTERBIT_HOME}/lib:\${JITTERBIT_HOME}/psql/lib
export PATH=\${JITTERBIT_HOME}/bin:\${JITTERBIT_HOME}/pgsql/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
EOF
. ./.bashrc

  9. (Optional) Überprüfen Sie die Umgebung:

    Als jitterbit
    env | grep jitterbit

    Die Ausgabe sollte wie folgt aussehen:

    PWD=/opt/jitterbit
LOGNAME=jitterbit
HOME=/opt/jitterbit
PG_HOME=/opt/jitterbit/pgsql
PG_DATA=/opt/jitterbit/DataInterchange/pgsql/data
JITTERBIT_HOME=/opt/jitterbit
ODBCINI=/opt/jitterbit/odbcinst.ini
USER=jitterbit
LD_LIBRARY_PATH=/opt/jitterbit/lib:/opt/jitterbit/psql/lib
ODBCSYSINI=/opt/jitterbit
PATH=/opt/jitterbit/bin:/opt/jitterbit/pgsql/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
MAIL=/var/spool/mail/jitterbit

    Wichtig

    Die hervorgehobenen Werte sind wichtig, insbesondere JITTERBIT_HOME, das immer /opt/jitterbit sein muss.

  10. Entpacken Sie die heruntergeladene Tar-Datei:

    Als jitterbit
    tar -C /opt -xf <PATH>/jitterbit-agent-<VERSION>.x86_64.tar
    • <PATH>: Der Pfad zur heruntergeladenen .tar-Datei, in einem Verzeichnis mit Lesezugriff für den Benutzer jitterbit.

  11. Führen Sie den Installer aus:

    Als jitterbit
    $HOME/scripts/install.sh

Wichtig

Sie müssen jetzt den privaten Agenten konfigurieren.

Konfigurieren

Um einen privaten Agenten unter Linux zu konfigurieren, zu registrieren und neu zu starten, befolgen Sie diese Schritte:

  1. Führen Sie diesen Befehl aus:

    Als root
    jitterbit-config
    Als root
    jitterbit-config
    Als jitterbit
    jitterbit-config

    Geben Sie an der folgenden Eingabeaufforderung y ein:

    Warnung: Dieses Tool benötigt Root-Rechte.
Hinweis: Verwenden Sie sudo oder melden Sie sich als Root-Benutzer an.
Möchten Sie als aktueller Benutzer fortfahren? [y/n]:

  2. (Optional) Um dem Agenten die Kommunikation über einen Proxy-Server zu ermöglichen, fügen Sie die erforderlichen Optionen hinzu.

  3. Geben Sie bei der Aufforderung Ihren Benutzernamen und Ihr Passwort für das Harmony-Konto ein und wählen Sie die Optionen aus, die Ihrer Organisation, Agentengruppe und Agenten entsprechen.

  4. Führen Sie diesen Befehl aus:

    Als root
    jitterbit restart
    Als root
    jitterbit restart
    Als jitterbit
    jitterbit restart

Upgrade

Die Versionen des privaten Agenten verwenden semantische Versionierung, die in der Form X.Y ausgedrückt wird, wobei X die Hauptversionsnummer und Y die Nebenversionsnummer ist. Es gibt zwei Arten von Upgrades:

  • Major: Wenn Sie von 10.x → 11.x oder von 11.x → 12.x upgraden, wird dies als Major-Version Upgrade betrachtet. In diesen Fällen müssen Sie den Agenten stoppen und neu starten und warten, bis eine vollständige Synchronisierung der Umgebungen abgeschlossen ist. Während einer vollständigen Synchronisierung ist die Umgebung gesperrt und kann keine Operationen verarbeiten. Wenn die Projekte in der Umgebung groß sind, kann dies einige Zeit in Anspruch nehmen.

  • Minor: Wenn Sie von 10.x → 10.y, 11.x → 11.y oder 12.x → 12.y upgraden, handelt es sich um ein Minor-Version Upgrade. In diesen Fällen müssen Sie nur den Agenten stoppen und neu starten.

    .deb und .rpm Upgrades von 11.48 und früher auf 11.49+ beinhalten notwendige Connector-Updates

    Upgrades von privaten Agenten 11.48 und früher auf 11.49 und später beinhalten ein notwendiges Update für Connector SDK-basierte Connectors.

    Sie werden während des Upgrade-Prozesses aufgefordert, dies zu akzeptieren. Upgrades, die mit silent_install gesetzt und Redhat Non-Root-Installationen durchgeführt werden, akzeptieren dieses Prerequisite automatisch.

Upgrades von 11.x auf 12.x

Plugin-Updates sind erforderlich, um die Multipart-Pipeline oder AWS S3 Create-Plugins auf 12.x-Agenten zu verwenden. Auch benutzerdefinierte Connector SDK-Connectors benötigen möglicherweise Updates.

Plugin-Updates für 12.x private Agenten

Wenn Sie eines der folgenden Plugins verwenden, müssen Sie alle bestehenden Verwendungen der inkompatiblen Plugins durch die neuen, erforderlichen Versionen für 12.x ersetzen, da sonst die Operationen mit diesen Plugins beim Upgrade des Agenten fehlschlagen:

Plugin-Name Inkompatible Versionen Erforderliche Version
Jitterbit Multipart Pipeline Plugin (veraltet) 1.0.9.0
1.0.8.0		 1.0.10.0
Jitterbit AWS S3 Create (veraltet) 1.0.1.0
1.0.0.0		 1.0.2.0

Die erforderlichen Plugin-Versionen sind abwärtskompatibel mit 11.x-Agenten, sodass Sie die Plugins vor dem Upgrade des Agenten aktualisieren können. Um ein Plugin zu aktualisieren, befolgen Sie diese Schritte:

  1. Weisen Sie die neue Plugin-Version der privaten Agentengruppe in der Management Console Customizations > Plugins-Seite zu.
  2. Entfernen Sie das inkompatible Plugin von der Aktivität in Ihren Studio- oder Design-Studio-Projekten.
  3. Weisen Sie die neue, kompatible Version zu.
  4. Testen und implementieren Sie die Operation.

Überprüfung von benutzerdefinierten Konnektoren für 12.x private Agenten

Benutzerdefinierte Konnektoren, die von einem Drittanbieter mit dem Connector SDK erstellt wurden, müssen möglicherweise geändert werden, um mit 12.x privaten Agenten kompatibel zu sein. Sie sollten die Kompatibilität benutzerdefinierter Konnektoren überprüfen, bevor Sie private Agenten auf 12.x aktualisieren.

Upgrade-Anweisungen

Um einen privaten Agenten unter Linux zu aktualisieren, befolgen Sie diese Schritte:

  1. Laden Sie ein Installationspaket herunter.

  2. Wenn der Agent noch Operationen verarbeitet, pausieren Sie das Entleeren.

    Oder, wenn Sie sicher sind, dass nichts auf dem Agenten läuft, stoppen Sie das Entleeren.

  3. Überwachen Sie die Agenten-Protokolldatei. Fahren Sie fort, wenn alle Operationen abgeschlossen sind.

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

  5. Führen Sie den folgenden Befehl für den heruntergeladenen Installatortyp aus:

    Als Root
    dpkg --install <PATH>/jitterbit-agent_<VERSION>_amd64.deb
    Als Root
    yum upgrade <PATH>/jitterbit-agent-<VERSION>.x86_64.rpm
Als jitterbit
tar -C /opt -xf /<PATH>/jitterbit-agent-<VERSION>.x86_64.tar

  • <PATH>: Der Pfad zur heruntergeladenen .tar-Datei in einem Verzeichnis mit Leserechten für den jitterbit-Benutzer.

  • Vergleichen Sie die folgenden Dateien mit Ihren Sicherungskopien und stellen Sie geänderte Einstellungen wieder her:

    Standort 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

  • Wenn Sie Sicherungsdateien .crt oder .key haben, die sich nicht bereits in /opt/jitterbit/apache/conf/ befinden, kopieren Sie diese an diesen Ort.

  • (Optional) Während der Umgebungssynchronisation akzeptieren die Agenten keine Integrationsprojektoperationen zur Verarbeitung. Sie können die Auswirkungen dieser Ausfallzeit mit einem Rolling Upgrade minimieren.

  • Starten Sie den Agenten neu:

    Als root
    jitterbit restart
    Als root
    jitterbit restart
    Als jitterbit
    jitterbit restart

  • (Optional) Wenn Sie ein Rolling Upgrade mit dem Eigenschaftswert agent.starting.standby=true durchführen und bevor Sie einen anderen Agenten in derselben Gruppe aktualisieren, überwachen Sie die Agentenprotokolldatei auf die folgende Nachricht:

    Agentensynchronisation für Umgebung <123456> und Agentengruppen-ID <987654> abgeschlossen um ...

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

Deinstallieren

Um einen privaten Agenten unter Linux zu deinstallieren, befolgen Sie diese Schritte:

  1. Stoppen Sie den Agenten.

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

    Standort 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 dessen Datenverzeichnis), die Dienststartdatei und das Benutzerkonto jitterbit zu entfernen, führen Sie diese Befehle aus:

    Als Root
    apt-get remove --autoremove jitterbit-agent
userdel --remove --force jitterbit
    Als Root
    yum remove jitterbit-agent
userdel --remove --force jitterbit
    Als Nicht-Root-Benutzer außer 'jitterbit'
    sudo userdel --remove --force jitterbit

Verwalten

Sie können einen privaten Agenten mit dem jitterbit-Befehl starten, stoppen und den Status anzeigen. Sie können auch die Management-Konsole verwenden, um einen Agenten aus der Ferne zu stoppen, können ihn jedoch nur erneut in einem Terminal auf dem Host neu starten. Abgesehen von Nicht-Root-Installationen können Sie den Agenten auch durch einen Neustart des Hosts neu starten.

Hinweis

Agents, die mit automatischer Registrierung gestartet wurden, können sich beim Stoppen automatisch abmelden.

Start

Private Agents, die aus einer .deb- oder .rpm-Paketdatei installiert wurden, starten automatisch mit dem Host. Bei nicht-root .tar-Datei-Installationen müssen Sie ein Systemskript hinzufügen, um den Agenten zu starten, oder ihn manuell starten.

Hinweis

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

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

Als Root
jitterbit start
Als Root
jitterbit start
Als jitterbit
jitterbit start

Stop

Es gibt drei Möglichkeiten, einen privaten Agenten zu stoppen, die sich darin unterscheiden, wie laufende Operationen behandelt werden:

  • Drain-Pause: Der Agent lehnt neue Operationen ab und erlaubt laufenden Operationen, bis sie abgeschlossen sind.

  • Drain-Stopp: Der Agent lehnt neue Operationen ab und erlaubt laufenden Operationen, für einen konfigurierbaren Timeout-Zeitraum fortzufahren, der durch agent.drain.stop.database.poll.no.of.retries und agent.drain.stop.database.poll.interval.in.millisec gesteuert wird (standardmäßig 100 Abfragen in Intervallen von 10.000 ms). API-basierte Operationen haben bis zu agent.drainstop.api.wait (standardmäßig 180 Sekunden) Zeit. Nach dem Timeout werden alle Operationen, die nicht abgeschlossen sind, abgebrochen und ihr Status wird mit der Cloud synchronisiert, bevor der Agent heruntergefahren wird. Wenn es sich um geplante Operationen handelt, werden diese automatisch auf einem anderen Agenten in der Gruppe (im Falle mehrerer Agentengruppen) neu erstellt oder so eingestellt, dass sie beim Fortsetzen des Agenten neu erstellt werden (im Falle von Einzelagentengruppen).

  • Harter Stopp: Der Agent lehnt neue Operationen ab, beendet laufende Operationen und markiert sie dann als abgebrochen. Wenn es sich um geplante Operationen handelt, werden diese automatisch auf einem anderen Agenten in der Gruppe (im Falle mehrerer Agentengruppen) neu erstellt oder so eingestellt, dass sie beim Fortsetzen des Agenten neu erstellt werden (im Falle von Einzelagentengruppen).

    Vorsicht

    Ein hartes Stoppen eines privaten Agents kann zu Datenverlust führen.

Drain pause

Um einen privaten Agenten unter Linux in den Drain-Pause-Modus zu versetzen, führen Sie den folgenden Befehl aus:

Als Root
jitterbit-utils --drain-pause
Als Root
jitterbit-utils --drain-pause
Als jitterbit
jitterbit-utils --drain-pause

Im Management Console wird der Status als Stopping angezeigt.

Um einen pausierten Agenten unter Linux wieder aufzunehmen, verwenden Sie den Start-Befehl.

Drain stop

Während eines Drain-Stops lehnt der Agent neue Operationen ab und erlaubt laufenden Operationen, für einen konfigurierbaren Timeout-Zeitraum fortzufahren, der durch agent.drain.stop.database.poll.no.of.retries und agent.drain.stop.database.poll.interval.in.millisec gesteuert wird (standardmäßig 100 Abfragen in Intervallen von 10.000 ms). API-basierte Operationen haben bis zu agent.drainstop.api.wait (standardmäßig 180 Sekunden). Nach dem Timeout werden alle nicht abgeschlossenen Operationen abgebrochen und ihr Status wird mit der Cloud synchronisiert, bevor der Agent heruntergefahren wird.

Um einen privaten Agenten unter Linux zu drain-stoppen, verwenden Sie eine dieser Optionen:

  • Wählen Sie im Harmony Portal-Menü Management Console > Agents. Wählen Sie in der Action-Spalte des zu stoppenden Agents Action > Drain Stop und klicken Sie dann im Bestätigungsdialog auf OK.

  • Führen Sie den folgenden Befehl aus:

    Als Root
    jitterbit-utils --drain-stop
    Als Root
    jitterbit-utils --drain-stop
    Als jitterbit
    jitterbit-utils --drain-stop

Hard stop

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

Als Root
jitterbit stop
Als Root
jitterbit stop
Als jitterbit
jitterbit stop

Warnung

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

Status

Um den Status des Agenten zu sehen, verwenden Sie eine dieser Optionen:

  • Wählen Sie im Menü des Harmony Portals Management Console > Agents.

  • Führen Sie diesen Befehl aus:

    Als Root
    jitterbit status
    Als Root
    jitterbit status
    Als jitterbit
    jitterbit status

Troubleshoot

Diese Abschnitte auf der Troubleshoot-Seite können bei der Fehlersuche von privaten Agenteninstallationen unter Linux hilfreich sein: