Auf dieser Seite können wir alles über die brechenden Änderungen in TC 5 nachlesen. und wie sie bei diesen, wenn möglich auch ihre Prozesse migrieren können

Neue Logging-Funktionen in TRANSCONNECT.local

Was hat sich verbessert?

Die neue Logging-Funktion (Protokollierung) in TRANSCONNECT 5.0 macht es dir viel einfacher, Fehler zu finden und die Systemfunktionen zu überwachen.

Die wichtigsten Neuerungen für dich:

Bessere Kontrolle über die Logs Du kannst jetzt für jede einzelne Komponente separat einstellen, wie detailliert die Protokolle sein sollen. Das bedeutet: Wenn du nur bei einer bestimmten Funktion tiefer einsteigen möchtest, musst du nicht alles protokollieren. Das spart Speicherplatz und macht die Logs übersichtlicher.

Automatische Protokollierung Alle Komponenten und auch externe Programme werden standardmäßig automatisch protokolliert – ohne dass du etwas tun musst. Das ist praktisch, wenn Probleme auftreten, die du nicht erwartet hast.

Übersichtliche Dateien Die Log-Dateien werden automatisch archiviert, wenn sie zu groß werden (nach 10 MB) oder jeden Tag neu angelegt. So verlierst du nie den Überblick und dein System läuft nicht aus dem Speicher.

Standardformat Die Logs folgen bewährten Standards der Industrie und enthalten alle wichtigen Informationen: Uhrzeit, Prozess, Fehlertyp und Nachricht – in einem lesbaren Format.

Praktisch für dich:

• Im Server: Die Protokolle landen in einer Datei namens transconnect.log und werden nach klaren Regeln verwaltet.
• In Docker: Logs werden direkt ausgegeben und sind leicht zu verarbeiten.
• Im Manager: Du kannst die Log-Level (Detaillierungsgrad) direkt in den Einstellungen anpassen – mehr Details brauchst du nicht zu konfigurieren.

Die genaue Konfiguration findest du im Handbuch, wenn du tiefer einsteigen möchtest.

Neue TC Java CLI – Was ändert sich für Sie?

Hintergrund der Umstellung Bislang gab es unterschiedliche Skripte für Windows und Linux/Mac, die teilweise unterschiedlich funktionierten. Das führte zu viel Wartungsaufwand und Inkonsistenzen zwischen den Betriebssystemen.

Was ist neu? Wir haben die Skripte durch eine einheitliche Java-basierte Lösung ersetzt, die auf allen Betriebssystemen gleich funktioniert.

Das bringt Ihnen Vorteile:

• Das Programm verhält sich auf Windows, Linux und Mac identisch

• Die Meldungen und Ausgaben sind überall gleich

• Alles läuft zuverlässiger und stabiler

Das ändert sich für Sie konkret:

Die bisherigen .sh– und .bat-Dateien funktionieren weiterhin wie gewohnt – Sie müssen nichts umstellen.

Statt setenv.sh und setenv.bat gibt es jetzt eine einzige Datei setenv.properties. Diese funktioniert auf allen Betriebssystemen gleich und dient nur zum Einstellen von Umgebungsvariablen.

Die Meldungen beim Ausführen der Skripte sehen jetzt auf jedem System gleich aus – können aber anders aussehen als vorher.

Wichtig: Die Skripte dürfen nicht mehr einfach auf den Desktop oder woanders verschoben werden – sie brauchen den Bezug zum Installationsverzeichnis. Falls nötig, können Sie die Skripte aber mit einem festen Pfad anpassen. Ein Mechanismus mit derCustom.sh, zur Ausführung von individuellem Code ist weiterhin vorhanden, wird aber offiziell nicht mehr unterstützt.

Welche Skripte sind betroffen? backup, recover, serverstart, serverstop, servicecontrol, repotool

Besonderheit bei Backup & Wiederherstellung: Es gibt kein automatisches Backup mehr im Installationsordner. Sie müssen den Quell- und Zielordner jetzt beim Ausführen des Skripts selbst angeben.

Beräumungsassistent entfernt

Breaking Change

Der Beräumungsassistent wurde vollständig aus TRANSCONNECT entfernt. Diese Funktion konnte potenziell Datenkonsistenzprobleme verursachen.

Änderungen:

• Der Menüeintrag für den Beräumungsassistenten ist im Manager nicht mehr verfügbar

Migrationsstrategie

1. Vor dem Upgrade: Schließen Sie alle ausstehenden Beräumungsvorgänge mit dem Assistenten in Ihrer aktuellen Version ab
2. Nach dem Upgrade: Verwenden Sie stattdessen die geplante Nachrichtenbereinigung

MS Sharepoint Online Dateiadapter entfernt

Breaking Change

Der MS Sharepoint Online Untertyp des Dateiadapters wurde entfernt. Dieser Adapter war aufgrund einer Microsoft-Funktionsentfernung nicht funktionsfähig und verursachte Verwirrung.

Änderungen:

• Der Sharepoint Online Verbindungstyp ist im Dateiadapter nicht mehr verfügbar

Migrationsstrategie

1. Betroffene Konfigurationen identifizieren: Prüfen Sie, ob einer Ihrer Adapter den Sharepoint Online Untertyp verwendet
2. Nach dem Upgrade: Bestehende Adapter, die mit diesem Untertyp konfiguriert sind, werden als „Fehlender Adapter“ angezeigt
3. Alternative Lösungen:
   • Verwenden Sie den neuen Sharepoint Online Konnektor

SNMP-Adapter entfernt

Breaking Change

Der SNMP-Adapter wurde vollständig entfernt. Die zugrunde liegende Technologie war seit über einem Jahrzehnt veraltet.

Änderungen:

• Der SNMP-Adapter ist nicht mehr verfügbar

Migrationsstrategie

1. Betroffene Konfigurationen identifizieren: Prüfen Sie, ob Ihre Integrationen den SNMP-Adapter verwenden
2. Nach dem Upgrade: Bestehende SNMP-Adapter-Instanzen werden als „Fehlender Adapter“ angezeigt
3. Alternative Lösungen:
   • Verwenden Sie moderne Monitoring-APIs (REST-basiert)
   • Implementieren Sie benutzerdefinierte Konnektoren

Veraltete MQTT-Implementierung entfernt

Breaking Change

Die veraltete HiveMQ MQTT-Implementierung wurde entfernt. Die Eigenschaft MQTT Library Used ist nicht mehr verfügbar.

Änderungen:

• Die Konfigurationseigenschaft MQTT Library Used ist nicht mehr verfügbar
• Die Paho MQTT-Implementierung ist nun die einzige Option

Migrationsstrategie

1. Automatische Migration: Bestehende Repositories mit MQTT-Konnektoren, die für HiveMQ konfiguriert sind, fallen automatisch auf die Paho-Implementierung zurück
2. Funktionalität überprüfen: Testen Sie nach dem Upgrade Ihre MQTT-Verbindungen, um sicherzustellen, dass sie mit Paho korrekt funktionieren
3. Keine manuelle Aktion erforderlich – der Fallback erfolgt automatisch

ROPC-Authentifizierungsverfahren entfernt

Breaking Change

Das Resource Owner Password Credentials (ROPC) OAuth 2.0-Verfahren wurde aus allen Adaptern entfernt. ROPC ist veraltet und gilt als unsicher.

Änderungen:

• Die ROPC-Authentifizierungsoption (OAuth 2.0/OpenID Password) ist in E-Mail-, HTTP- und SOAP-Adaptern nicht mehr verfügbar

Migrationsstrategie

1. Betroffene Adapter identifizieren: Prüfen Sie, welche Ihrer Adapter die ROPC-Authentifizierung (OAuth 2.0/OpenID Password) verwenden
2. Vor dem Upgrade: Planen Sie die Migration zu einer unterstützten Authentifizierungsmethode
3. Unterstützte Alternativen:
   • Client Credentials Flow: Für Service-zu-Service-Authentifizierung
   • Authorization Code Flow: Für benutzerdelegierte Zugriffe
   • Zertifikatbasierte Authentifizierung: Wo unterstützt
4. Nach dem Upgrade: TC Server mit Adaptern, die für ROPC konfiguriert sind, können weiterhin starten, aber die Authentifizierung schlägt fehl. Konfigurieren Sie diese Adapter auf unterstützte Verfahren um.

Manager-Update-Funktion entfernt

Breaking Change

Die Manager-Update-Funktionalität, die das Aktualisieren des Managers direkt vom Server ermöglichte, wurde entfernt.

Änderungen:

• Die Funktion „Nach Updates suchen“ ist im Manager nicht mehr verfügbar

Migrationsstrategie

1. Updates manuell herunterladen: Beziehen Sie Manager-Updates als ZIP-Archive über die offiziellen Vertriebskanäle
2. Update-Prozess:
   • Laden Sie die neue Manager-Version herunter
   • Installieren Sie sie neben der bestehenden Installation oder ersetzen Sie diese
3. Hinweis: Der Dialog „Installationsdetails“ unter Hilfe > Info zeigt möglicherweise noch einen Update-Button an (Eclipse-Plattform-Einschränkung), dieser ist jedoch nicht funktionsfähig

jTDS MSSQL JDBC-Treiber entfernt

Breaking Change

Verweise auf den jTDS JDBC-Treiber für MS SQL Server wurden entfernt. Der jTDS-Treiber ist veraltet und funktioniert nicht mehr mit modernen SQL Server-Versionen.

Änderungen:

• Der jTDS-Treiber wird nicht mehr unterstützt; verwenden Sie stattdessen den offiziellen Microsoft JDBC-Treiber

Migrationsstrategie

1. Offiziellen Microsoft JDBC-Treiber herunterladen:
   • Besuchen Sie: https://learn.microsoft.com/de-de/sql/connect/jdbc/download-microsoft-jdbc-driver-for-sql-server
   • Laden Sie die entsprechende Version herunter
2. Treiber installieren:
   • Platzieren Sie die JAR-Datei im lib/ext-Verzeichnis des TC Servers oder im Benutzerverzeichnis – konsultieren Sie die Dokumentation
   • Aktualisieren Sie tc.ini mit der neuen Treiberkonfiguration
3. Verbindungszeichenfolgen aktualisieren: Falls Ihre Konfigurationen jTDS-spezifische Verbindungs-URLs verwenden, aktualisieren Sie diese auf das Microsoft-Treiberformat:
   • Alt (jTDS): jdbc:jtds:sqlserver://host:port/database
   • Neu (Microsoft): jdbc:sqlserver://host:port;databaseName=database

JavaDoc aus dem Installer entfernt

Breaking Change

Die JavaDoc-Dokumentation ist nicht mehr über den Installer verfügbar.

Änderungen:

• Die Dokumentations-Installationsoption ist im Setup nicht mehr verfügbar

Migrationsstrategie

1. Entwicklerdokumentation aufrufen: Verwenden Sie stattdessen die Entwicklerdokumentation im Benutzerhandbuch

HEAD-Request Preflight Check aus HTTP Adapter entfernt

Breaking Change

Der HTTP-Adapter führt beim Erstellen einer Verbindung nicht mehr automatisch eine Vorab-Prüfung (HEAD-Request) zum Zielserver durch. Diese Prüfung wird jetzt nur noch beim expliziten Testen einer Verbindung über die „Verbindungstest“-Funktion ausgeführt.

Änderungen:

• Im HTTP-Ausgangsadapter wird nur noch der in der Nachricht spezifizierte Request abgesetzt und kein HEAD-Request mehr.

Migrationsstrategie

1. Sollten die  Umgebung einen HEAD-Request im Vorfeld benötigen, implementieren Sie diesen im Prozess vor dem eigentlichen Request.