Installation des Connectors

Der Pareo Connector läuft als Container auf einer virtuellen Maschine (VM) in Ihrem Netz. Er liest Daten aus Teamcenter und SAP und sendet sie per HTTPS an Pareo. Die Verbindung geht immer vom Connector aus, Pareo selbst baut keine Verbindung in Ihr Netz auf. Diese Seite beschreibt die Schritte der Installation in der richtigen Reihenfolge. Anlegen und Freigabe des Connectors übernimmt der Pareo-Support. Authentifizierung und Sicherheit des Connectors sind in einem separaten Artikel zu finden: Sicherheit des Connectors.

Zuständigkeiten

Den Connector installieren Sie, wann es Ihnen passt, einen Termin brauchen Sie dafür nicht. Bei Fragen oder Unklarheiten melden Sie sich jederzeit beim Pareo-Support: Wir helfen gern, auch in einem gemeinsamen Termin. Damit die Installation möglichst einfach verläuft, gehen Sie vorher die folgende Checkliste durch.

Checkliste vor der Installation

Virtuelle Maschine

Netz

Geben Sie nach Möglichkeit die Hostnamen frei. ingest.pareo.ai verweist auf eine feste, reservierte Adresse. Arbeitet Ihre Firewall nur mit IP-Adressen, geben Sie diese Adresse frei.

Ob Sie die beiden folgenden Abschnitte brauchen, zeigt Ihnen spätestens connector check (siehe Prüfen und starten). Wer es nicht weiß, kann sie zunächst überspringen.

Proxy

Eigene Zertifikate

Technischer Benutzer in Teamcenter

• Der Benutzer meldet sich mit Benutzername und Passwort über die SOA-JSON-REST-Schnittstelle (/tc/JsonRestServices) an. Eine Anmeldung per Single Sign-on (SSO) oder Zertifikat unterstützt der Connector nicht. Melden sich Ihre Mitarbeitenden in Teamcenter per SSO an, bitten Sie Ihren Teamcenter-Administrator um einen technischen Benutzer mit Passwort-Anmeldung.
• Der Benutzer hat nur Leserechte.
• Der Benutzer darf in Teamcenter suchen und die gefundenen Item-Revisionen lesen. Pareo sucht nach dem Typ Ihrer Materialien, zum Beispiel Mat1Material, und liest nur Revisionen mit dem Freigabestatus Released. Welche gespeicherte Abfrage dafür verwendet wird, legt der Pareo-Support mit Ihrem Teamcenter-Administrator fest.
• Nennen Sie dem Pareo-Support den Typ Ihrer Materialien und, falls Sie eigene verwenden, die Namen Ihrer Freigabestatus.
• Die gespeicherte Abfrage liefert weniger als 250.000 Objekte. Der Connector fragt je Lauf höchstens so viele Objekte ab. Liefert Teamcenter genau diese Zahl, kann er nicht erkennen, ob die Liste vollständig ist, und bricht den Lauf ab, damit Pareo keine Daten fälschlich entfernt. Ist die Abfrage größer, legt der Pareo-Support mit Ihnen eine engere fest, zum Beispiel für eine einzelne Gruppe in Teamcenter. Meldet Teamcenter mehr gefundene Objekte, als es liefert, zum Beispiel wegen einer eigenen Obergrenze in Teamcenter, bricht der Lauf ebenso ab.
• Das Passwort läuft während der Einrichtung nicht ab, oder es gibt ein Verfahren, es zu ersetzen (siehe Passwort für Teamcenter oder SAP ändern).

Technischer Benutzer und Services in SAP

Der Connector liest die OData-Standard-APIs von SAP S/4HANA.

1. Aktivieren Sie diese Services in der Transaktion /IWFND/MAINT_SERVICE: API_CLFN_PRODUCT_SRV, API_CLFN_CHARACTERISTIC_SRV, API_BILL_OF_MATERIAL_SRV.

2. Legen Sie einen technischen Benutzer (Systembenutzer) an, der für diese Services und ihre Daten nur Anzeigerechte hat (Berechtigungsaktivität 03).

3. Legen Sie das Anmeldeverfahren fest: Basic (Benutzer und Passwort) oder OAuth 2.0 Client Credentials.

4. Testen Sie vor der Installation mit diesem Benutzer einen Aufruf von der VM aus. Lassen Sie die einfachen Anführungszeichen stehen: Ohne sie ersetzt die Shell $top durch eine leere Zeichenfolge, und der Aufruf liest alle Stücklisten. Unter Windows verwenden Sie in der PowerShell curl.exe, denn curl allein ruft dort einen anderen Befehl auf.

   Linux

   # Basic
   curl -u <user> 'https://<sap-host>:<port>/sap/opu/odata/sap/API_BILL_OF_MATERIAL_SRV/A_BillOfMaterial?$top=1'
   # OAuth: zuerst ein Token holen, dann damit aufrufen
   curl -u <client-id> -d grant_type=client_credentials 'https://<sap-host>:<port>/sap/bc/sec/oauth2/token'
   curl -H 'Authorization: Bearer <access_token>' 'https://<sap-host>:<port>/sap/opu/odata/sap/API_BILL_OF_MATERIAL_SRV/A_BillOfMaterial?$top=1'

   Windows

   # Basic
   curl.exe -u <user> 'https://<sap-host>:<port>/sap/opu/odata/sap/API_BILL_OF_MATERIAL_SRV/A_BillOfMaterial?$top=1'
   # OAuth: zuerst ein Token holen, dann damit aufrufen
   curl.exe -u <client-id> -d grant_type=client_credentials 'https://<sap-host>:<port>/sap/bc/sec/oauth2/token'
   curl.exe -H 'Authorization: Bearer <access_token>' 'https://<sap-host>:<port>/sap/opu/odata/sap/API_BILL_OF_MATERIAL_SRV/A_BillOfMaterial?$top=1'

   Kommt eine Antwort mit Daten zurück, sind Service, Benutzer und Netz richtig eingerichtet. Verwendet SAP ein Zertifikat Ihrer eigenen Zertifizierungsstelle, ergänzen Sie --cacert corp-root.pem. Unter Windows prüft curl.exe Zertifikate gegen den Zertifikatspeicher von Windows. Ist Ihre Zertifizierungsstelle dort hinterlegt, brauchen Sie --cacert nicht. Notieren Sie die Token-URL, mit der es funktioniert hat, für sap.token_url.

Alle Entitätsmengen, die der Connector liest, führt Sicherheit des Connectors auf.

Mit Testsystemen beginnen

Beginnen Sie mit Ihren Testsystemen. Ein Connector liest entweder Testsysteme oder Produktivsysteme, nie beides. Solange ein Connector aktiv ist, lehnt Pareo innerhalb derselben Organisation einen zweiten Connector für dasselbe System in der anderen Umgebung ab. Den späteren Wechsel beschreibt Von Test auf Produktion umstellen.

Schritt 1: Installationspaket anfordern

Nennen Sie dem Pareo-Support:

1. Die Systeme: Teamcenter, SAP oder beide. Daten aus anderen Systemen lehnt Pareo ab, gleich, was der Connector sendet.
2. Test oder Produktion: ob es Test- oder Produktivsysteme sind.
3. Die Benachrichtigungsadresse: die E-Mail-Adresse, an die Pareo die Benachrichtigungen zum Connector schickt, am besten einen Verteiler Ihrer IT. Sie braucht kein Konto in Pareo und lässt sich später über den Pareo-Support ändern.
4. Den Standort (optional): Betreiben Sie an mehreren Standorten eigene Systeme und wollen Sie je Standort einen Connector, nennen Sie den Standort, zum Beispiel „Werk Augsburg“. Der Name dient nur der Unterscheidung. Welche Daten der Connector liest, legen die gespeicherte Abfrage und die SAP-Einstellungen fest.

Der Pareo-Support legt den Connector daraufhin an und schickt Ihnen das Installationspaket pareo-connector-install.zip auf vertraulichem Weg.

Das Paket enthält den Einrichtungsschlüssel. Er ist 30 Tage gültig und lässt sich nur einmal verwenden. Ist die Datei verloren gegangen oder sind die 30 Tage abgelaufen, fordern Sie beim Pareo-Support ein neues Paket an. Der alte Schlüssel wird damit ungültig.

Schritt 2: Installation des Connectors

Entpacken und prüfen

1. Entpacken Sie das Paket in einen Ordner auf der VM, zum Beispiel /opt/pareo-connector. Das Paket enthält compose.yaml, .env, config/connector.yaml, security-sheet.md und secrets/setup.key.

2. Prüfen Sie die Signatur und die Software-Stückliste (SBOM) des Images. Speichern Sie den öffentlichen Schlüssel aus Sicherheit des Connectors als pareo-connector.pub. Die Image-Referenz steht in der .env unter PAREO_CONNECTOR_IMAGE:

   cosign verify --key pareo-connector.pub <image>@sha256:<digest>
   cosign verify-attestation --key pareo-connector.pub --type spdxjson <image>@sha256:<digest>

   Beide Befehle enden mit „The signatures were verified against the specified public key“.

3. Laden Sie das Image herunter und vergleichen Sie seinen Digest mit dem geprüften Digest:

   Docker

   docker compose pull
   docker image inspect --format '{{index .RepoDigests 0}}' <image>

   Podman

   podman-compose pull
   podman image inspect --format '{{index .RepoDigests 0}}' <image>

   Auch in der ersten Log-Zeile des Connectors steht ein Digest. Das ist aber nur der Wert von PAREO_IMAGE_DIGEST aus der compose.yaml, keine Prüfung des laufenden Images. Dafür verwenden Sie den Befehl oben.

Konfigurationsdatei ausfüllen

Öffnen Sie config/connector.yaml. Ändern Sie nur diese Zeilen:

• Ohne timezone gelten die Zeiten in schedule als UTC.
• teamcenter.url und sap.url müssen https verwenden. Weiterleitungen folgt der Connector nicht.
• Der Proxy gilt nur für Verbindungen zu Pareo. Verbindungen zu Teamcenter und SAP laufen direkt.
• Das Proxy-Passwort ist das einzige Secret in config/connector.yaml. Schützen Sie die Datei deshalb mit denselben Dateirechten wie die Secret-Dateien.

Prüfen Sie die Datei anschließend. Bei einem Fehler nennt die Ausgabe die betroffene Zeile:

docker compose run --rm connector config check

podman-compose run --rm connector config check

ok   config read, no secrets in it

Zugangsdaten in Secret-Dateien ablegen

Jede Datei mit Zugangsdaten besteht aus genau zwei Zeilen: In Zeile 1 steht der Benutzer (oder die OAuth-Client-ID), in Zeile 2 das Passwort (oder Secret). Legen Sie die Dateien mit einem Texteditor an, zum Beispiel nano secrets/tc_user, und nicht über einen Shell-Befehl, denn der bliebe samt Passwort in der Shell-Historie.

TC_TECH_USER
the-password

Der Container läuft als Benutzer 65532, nicht als Root, und muss die Dateien lesen können. Bei Podman ohne Root-Rechte gehört zu diesem Benutzer ein anderer Benutzer auf der VM, deshalb übergeben Sie ihm die Dateien dort mit podman unshare:

sudo chown -R 65532:65532 secrets
sudo chmod 500 secrets && sudo chmod 400 secrets/*

chmod 500 secrets && chmod 400 secrets/*
podman unshare chown -R 65532:65532 secrets

Eine Secret-Datei, die Sie später ändern, etwa für ein neues Passwort oder einen neuen Einrichtungsschlüssel, bearbeiten Sie so:

sudo nano secrets/tc_user

podman unshare nano secrets/tc_user

Die compose.yaml bindet außerdem /etc/hostname der VM schreibgeschützt ein. Diesen Hostnamen meldet der Connector an Pareo, und Pareo nimmt nur Daten vom freigegebenen Hostnamen an. Ein neuer Container, etwa nach einem Update, übernimmt den Namen der VM und bleibt dadurch freigegeben.

Root-Zertifikate einbinden

Prüfen und starten

1. Führen Sie die Prüfungen aus. Dabei sendet der Connector keine Daten.

   Docker

   docker compose run --rm connector check

   Podman

   podman-compose run --rm connector check

   ok   trusts the company root certificate from ca_bundle
   ok   reached ingest.pareo.ai through proxy.corp.local
   ..   not joined yet: the source checks run after Pareo approved the connector

   Meldet eine Zeile fix, nennt sie die Ursache. Unter Wenn etwas nicht funktioniert führt jede Meldung zu dem Abschnitt, den Sie dann brauchen, etwa zu Proxy oder Eigene Zertifikate.

   Teamcenter und SAP prüft der Connector erst nach der Freigabe in Schritt 3, weil er dafür zuerst sein Extraktionsprofil von Pareo braucht. Testen Sie die Anmeldungen an SAP und Teamcenter vorher mit eigenen Mitteln (siehe Checkliste).

2. Starten Sie den Connector.

   Docker

   docker compose up -d
   docker compose logs -f connector

   Podman

   podman-compose up -d
   podman-compose logs -f connector

3. Prüfen Sie das Log. Dort sollten diese Zeilen stehen:

   ok   connector 1.0.5 (image sha256:a4f9867a4252, as pinned in compose.yaml)
   ok   key pair created on this VM, fingerprint 2CF8 A59B 879F 5EFC D38D F4AD 535B 2651
   ok   setup key accepted
   ..   waiting for approval in Pareo (asks again every minute, no deadline). Compare fingerprint 2CF8 A59B 879F 5EFC D38D F4AD 535B 2651

4. Schicken Sie dem Pareo-Support den Fingerabdruck auf einem zweiten Weg, nicht auf dem, auf dem das Paket kam. Rufen Sie zum Beispiel an, oder lassen Sie ihn von einer anderen Person schicken als der, die das Paket erhalten hat.

Feldzuordnung prüfen

Der Connector liest nur Felder Ihrer Systeme, die einem Pareo-Feld zugeordnet sind, alle anderen bleiben unberührt. Vor der Freigabe schickt Ihnen der Pareo-Support die Feldzuordnung: je Zeile das Pareo-Feld, den Namen des Felds in Ihrem System und das System, aus dem der Connector es liest. Administratoren sehen sie auch in Pareo, im Reiter Feldzuordnung am Connector. Leiten Sie die Liste an die Personen weiter, die entscheiden, welche Daten Ihr Netz verlassen dürfen, etwa an Ihr Sicherheitsteam. Änderungswünsche setzt der Pareo-Support um.

Nach der Freigabe können Sie zählen lassen, was der Connector lesen würde, ohne dass Daten gesendet werden:

docker compose run --rm connector dry-run

podman-compose run --rm connector dry-run

ok   teamcenter: 1,812 released materials read from 2,040 revisions in 10 blocks of 200
     field mapping, records with a value:
       "Material code"                1,812 of 1,812
       "REACH status"                 1,640 of 1,812
       "UBA criteria"                     0 of 1,812
     dry run: counted only, nothing was sent.

dry-run gibt nur Feldnamen und Anzahlen aus, nie Werte. Steht bei einem Feld 0, ist sein Name in der Zuordnung meist falsch.

Schritt 3: Freigabe

Der Pareo-Support vergleicht den Fingerabdruck, den Sie geschickt haben, mit dem Fingerabdruck, den Pareo zeigt, und gibt den Connector nur frei, wenn beide übereinstimmen. An der VM warten müssen Sie dafür nicht: Der Connector fragt einmal pro Minute nach und startet von selbst. Stimmen die Fingerabdrücke nicht überein, erhalten Sie ein neues Installationspaket. Hat jemand anderes den Einrichtungsschlüssel zuerst verwendet, kann sich Ihr Connector nicht anmelden, und sein Log sagt das. Fordern Sie dann beim Pareo-Support ein neues Paket an.

Danach führt Pareo die ersten Prüfungen aus: Verbindung zu Pareo, Teamcenter-Anmeldung samt gespeicherter Abfrage und SAP-Anmeldung. Daten werden dabei nicht gesendet. Schlägt eine Prüfung fehl, nennt sie die Ursache (siehe Wenn etwas nicht funktioniert).

Nach der Freigabe lädt der Connector sein signiertes Extraktionsprofil und startet sofort die erste vollständige Synchronisation, ohne auf den Zeitplan zu warten. Im Log steht dann:

ok   approved by Pareo, organization <your organization>, may send: teamcenter, sap
ok   extraction profile 0f61bda8b713a564 installed, signature verified
ok   teamcenter login, saved query "<name>": 861 revisions found
ok   sap login, bills of materials readable
     teamcenter run started: full

Erste Synchronisation prüfen

Öffnen Sie Einstellungen → Verbindungen → Synchronisationsläufe für die Läufe aller Quellen. Die Läufe eines einzelnen Connectors sehen Sie unter Einstellungen → Verbindungen → Pareo Connector: Wählen Sie den Connector und öffnen Sie den Tab Synchronisationsläufe. Zu jedem Lauf sehen Sie das Ergebnis, die geschriebenen und entfernten Zeilen sowie die gesendeten Datenpakete.

Teamcenter meldet mehr Revisionen, als der Connector Datensätze sendet. Das ist normal, denn er sendet je Item nur die neueste freigegebene Revision.

Bei einem großen Teamcenter-Bestand dauert die erste vollständige Synchronisation entsprechend lange: Der Connector liest in Blöcken von 200 Datensätzen, mit je einem Aufruf an Teamcenter.

Schlägt ein Lauf fehl, nennt das Log die Ursache, und nach 30 Minuten folgt ein neuer Versuch. Beheben Sie die Ursache. Steht die erste vollständige Synchronisation noch aus, starten Sie sie mit einem Neustart sofort:

docker compose restart connector

podman-compose restart connector

Unvollständige oder fehlerhafte Daten

Ihre Daten müssen nicht fehlerfrei sein. Connector und Pareo prüfen jeden Datensatz einzeln. Ein fehlerhafter Datensatz wird mit Begründung zurückgehalten, alle übrigen übernimmt Pareo. Der Lauf gilt dann als Teilweise, und ein teilweiser Lauf entfernt nie Zeilen.

Zu zurückgehaltenen Datensätzen stehen im Log nur Kennung und Grund. Eigenschaftswerte verlassen die VM nie über ein Log.

Täglicher Betrieb

• Zeitplan. Standardmäßig läuft jeden Tag um 02:00 eine Delta-Synchronisation und jeden Sonntag um 03:00 eine vollständige Synchronisation (UTC, sofern Sie keine timezone setzen). Nur die vollständige Synchronisation entfernt Zeilen, die in der Quelle fehlen.
• Status. Die Connector-Liste zeigt jeden Connector mit seinem Zustand. OK heißt: Er hat sich in den letzten Minuten gemeldet und seine Prüfungen bestehen.
• Benachrichtigungen. Pareo schickt eine E-Mail an Ihre Benachrichtigungsadresse, wenn sich ein Connector 2 Stunden nicht meldet, ein Lauf fehlschlägt oder nur teilweise gelingt, die Daten eines Laufs in Pareo nicht gespeichert wurden, die Festplatte oder der Zwischenspeicher voll ist, eine Prüfung fehlschlägt oder eine neue Version verfügbar ist. Jede Ursache wird nur einmal gemeldet. Benutzer mit der Rolle Administrator sehen dieselben Meldungen zusätzlich unter Benachrichtigungen in Pareo. Der Pareo-Support erhält sie ebenfalls, außer zu neuen Versionen, und meldet sich bei Ihnen, wenn etwas zu tun ist.
• Aufträge an den Connector. Der Pareo-Support kann aus Pareo heraus die Prüfungen starten, einzelne Produkte sofort synchronisieren, Diagnosedaten anfordern und das Log-Level vorübergehend auf debug setzen. Der Connector führt den Auftrag bei seiner nächsten Meldung aus, also innerhalb einer Minute. Zugriff auf die VM brauchen Sie dafür nicht zu geben.

Jeder Connector hat eine eigene Seite mit den Tabs Übersicht (Prüfungen und Zustand), Synchronisationsläufe, Feldzuordnung, Anfragen und Software (Version und Update-Schaltfläche).

Betrieb und Wartung

Konfigurationsdatei ändern

Bearbeiten Sie config/connector.yaml und prüfen Sie sie dann:

docker compose run --rm connector config check

podman-compose run --rm connector config check

Der laufende Connector übernimmt die Änderung innerhalb einer Minute, ohne Neustart. Eine fehlerhafte Konfiguration hält ihn nicht an: Er arbeitet mit der letzten gültigen Konfiguration weiter und vermerkt die fehlerhafte Zeile im Log.

Connector aktualisieren

Gibt es eine neue Version, zeigt die Connector-Seite die installierte und die neueste Version und was neu ist, und Ihre Benachrichtigungsadresse erhält eine E-Mail.

Mit dem Updater (Compose-Profil updates, in jedem neuen Installationspaket aktiv): Das Update startet von selbst im Wartungsfenster, oder wenn ein Admin auf der Connector-Seite auf Auf X aktualisieren klickt. Ihre IT legt das in der .env fest:

Der Updater liest die Datei alle 15 Sekunden neu, eine Änderung braucht keinen Neustart. Die Seite zeigt jeden Schritt: Herunterladen, Signatur prüfen, Neu starten, Erster Kontakt, Prüfungen. Meldet sich die neue Version nicht innerhalb von 5 Minuten mit bestandenen Prüfungen, startet der Updater die vorige wieder. Siehe Sicherheit des Connectors.

Zeigt die Seite „Braucht Ihre IT“, braucht die neue Version eine Änderung am Installationspaket, zum Beispiel eine neue Zeile in der compose.yaml. Die Seite nennt die Änderung. Übernehmen Sie compose.yaml und .env aus einem neuen Installationspaket, behalten Sie den Ordner config und die Secrets, und führen Sie up -d aus.

Ohne den Updater aktualisiert Ihre IT von Hand:

1. Fordern Sie beim Pareo-Support den neuen Wert für PAREO_CONNECTOR_IMAGE an. Ein neuer Einrichtungsschlüssel ist nicht nötig.

2. Prüfen Sie das neue Image mit cosign wie in Schritt 2.

3. Ändern Sie PAREO_CONNECTOR_IMAGE in der .env. Der Ordner config und die Secrets bleiben unverändert.

4. Laden Sie das neue Image und starten Sie den Container neu:

   Docker

   docker compose pull
   docker compose up -d

   Podman

   podman-compose pull
   podman-compose up -d

5. Die neue Version steht in der ersten Log-Zeile und erscheint innerhalb einer Minute auf der Connector-Seite.

Um zur vorherigen Version zurückzukehren, setzen Sie den alten Wert von PAREO_CONNECTOR_IMAGE wieder in die .env und führen up -d erneut aus. Das State-Volume bleibt dabei erhalten.

Pareo legt eine Mindestversion fest. Ein älterer Connector meldet zwar weiter seinen Status, Pareo nimmt aber keine Daten mehr von ihm an, und die Seite zeigt Nicht mehr unterstützt. Nach dem Update synchronisiert er wieder von selbst.

Passwort für Teamcenter oder SAP ändern

1. Tragen Sie das neue Passwort in Zeile 2 von secrets/tc_user oder secrets/sap_client ein.

2. Prüfen Sie die Anmeldung:

   Docker

   docker compose run --rm connector check

   Podman

   podman-compose run --rm connector check

Ein Neustart ist nicht nötig, der Connector liest die Secret-Dateien bei jedem Zugriff neu.

Nach einer abgelehnten Anmeldung hält der Connector diese Quelle an, damit das Konto nicht gesperrt wird. Er versucht es erneut, sobald sich die Secret-Datei ändert oder Sie connector check ausführen. Ändern Sie das Passwort deshalb in Teamcenter oder SAP und auf der VM zur selben Zeit.

Schlüssel des Connectors ersetzen

Ersetzen Sie den Schlüssel, wenn der Einrichtungsschlüssel oder die VM möglicherweise kompromittiert sind oder das State-Volume verloren gegangen ist.

1. Fordern Sie beim Pareo-Support einen neuen Einrichtungsschlüssel an. Der alte Schlüssel ist ab dann ungültig.

2. Ersetzen Sie secrets/setup.key durch die neue Datei und starten Sie den Container neu:

   Docker

   docker compose restart connector

   Podman

   podman-compose restart connector

3. Der Connector sichert sein altes Schlüsselpaar, erzeugt ein neues und meldet sich erneut bei Pareo an.

4. Schicken Sie dem Pareo-Support den neuen Fingerabdruck wie in Schritt 2. Der Pareo-Support gibt den Connector erneut frei. Die synchronisierten Daten bleiben erhalten.

Connector auf eine andere VM umziehen

1. Beenden Sie den alten Container:

   Docker

   docker compose down

   Podman

   podman-compose down

2. Fordern Sie beim Pareo-Support einen neuen Einrichtungsschlüssel an.

3. Installieren Sie den Connector auf der neuen VM wie in Schritt 2, mit demselben Ordner config und denselben Secrets.

4. Schicken Sie dem Pareo-Support den neuen Fingerabdruck wie in Schritt 2. Der Pareo-Support gibt den neuen Host frei.

Sichern

Sichern Sie den Ordner mit compose.yaml, config und secrets. Das State-Volume enthält Schlüsselpaar, Lesefortschritt und Zwischenspeicher des Connectors und muss nicht gesichert werden: Geht es verloren, ersetzen Sie den Schlüssel wie oben beschrieben, und die nächste vollständige Synchronisation liest alles neu ein.

Von Test auf Produktion umstellen

1. Sagen Sie dem Pareo-Support Bescheid. Er widerruft den Test-Connector und legt einen Connector für die Produktivsysteme an.
2. Installieren Sie ihn wie in Schritt 2 auf einer VM, die die Produktivsysteme erreicht, mit den technischen Benutzern der Produktivsysteme.

Die Daten des Test-Connectors bleiben erhalten und sind als Testdaten gekennzeichnet.

Eine vollständige Synchronisation wird abgelehnt

Liefert eine vollständige Synchronisation weniger als die Hälfte der Datensätze der letzten, deutet das eher auf verlorene Leserechte hin als auf gelöschte Daten. Pareo verwirft diesen Lauf dann, behält alle Zeilen und benachrichtigt den Pareo-Support und Ihre Benachrichtigungsadresse mit „full read refused, nothing written“.

1. Klären Sie mit dem Teamcenter- oder SAP-Administrator, ob der technische Benutzer Rechte verloren oder sich die gespeicherte Abfrage geändert hat. Ist das der Fall, beheben sie die Ursache, und Pareo prüft die nächste vollständige Synchronisation erneut.
2. Ist die kleinere Menge richtig, etwa nach einer geplanten Bereinigung, sagen Sie dem Pareo-Support Bescheid. Er bestätigt den Lauf, und Pareo entfernt die Zeilen, die in der Quelle fehlen. Wer den Lauf bestätigt hat, wird protokolliert, und spätere vollständige Synchronisationen werden mit diesem Lauf verglichen.

Pausieren, widerrufen und entfernen

Pausieren und Widerrufen übernimmt der Pareo-Support auf Ihre Bitte. Im Notfall können die Administratoren Ihrer Organisation beides auch selbst unter Einstellungen → Verbindungen → Pareo Connector tun.

• Pausieren hält alle Synchronisationen an, der Connector meldet sich aber weiter. Fortsetzen nimmt sie wieder auf.

• Widerrufen beendet sofort jede Datenübertragung des Connectors und lässt sich nicht rückgängig machen. Bereits synchronisierte Daten bleiben mit dem Zeitpunkt ihrer letzten Synchronisation erhalten.

• Aus der Liste entfernen nimmt einen widerrufenen Connector aus der Connector-Liste. Seine Maschine bleibt abgewiesen, synchronisierte Daten behalten ihre Quelle, und Pareo bewahrt auf, wer ihn freigegeben und widerrufen hat.

• Um den Connector von der VM zu entfernen, widerrufen Sie ihn zuerst, führen dann den folgenden Befehl aus und löschen den Ordner. -v löscht dabei auch das State-Volume mit dem privaten Schlüssel.

  Docker

  docker compose down -v

  Podman

  podman-compose down -v

Wenn etwas nicht funktioniert

Jede Zeile auf der Konsole beginnt mit ok, fix oder ... Eine fix-Zeile nennt die Ursache und den nächsten Schritt. Die häufigsten Meldungen:

Was Sie dem Pareo-Support schicken

Schreiben Sie an , und fügen Sie Folgendes bei:

1. Die Ausgabe der Prüfungen und die letzten Zeilen des Logs:

   Docker

   docker compose run --rm connector check
   docker compose logs --tail 200 connector

   Podman

   podman-compose run --rm connector check
   podman-compose logs --tail 200 connector

2. Den Namen des Connectors und den Zeitpunkt des Problems.

Das Log enthält nur Datensatz-Kennungen, Anzahlen und Fehler, nie Eigenschaftswerte oder Passwörter. Schicken Sie weder den Ordner secrets noch die Datei setup.key. Alternativ fordert der Pareo-Support die Diagnosedaten über Diagnose senden selbst beim Connector an. Pareo erhält dann die Einstellungen ohne Secrets, die Prüfergebnisse, die letzten Log-Zeilen und die Kennzahlen der Läufe.

Ansprechpartner