ToolTransformation Advisor ausführen

Wenn Sie planen, Ihre Architektur auf Container umzustellen, führen Sie das Tool „ Transformation Advisor “ aus, bevor Sie die Migration unter IBM® App Connect Enterprise 13.0 durchführen. Verwenden Sie das Tool, um Daten darüber zu erfassen, was auf Ihrem IBM Integration Bus 10.0 oder IBM App Connect Enterprise 11.0 Integrationsknoten bereitgestellt ist, und analysieren Sie anschließend die erfassten Daten auf mögliche Probleme.

Um Daten zu Ihrem IBM Integration Bus 10.0 oder IBM App Connect Enterprise 11.0 Integrationsknoten zu erfassen und zu analysieren, führen Sie die folgenden Schritte aus.

1. Sichern Sie die Ressourcen, die Sie migrieren möchten, mit einer der folgenden Methoden.
   • Erstellen Sie eine Sicherungsdatei Ihres IBM Integration Bus 10.0 oder IBM App Connect Enterprise 11.0 Integrationsknotens, indem Sie den folgenden mqsibackupbroker Befehl ausführen:

     mqsibackupbroker myNodev11 -d C:\temp -a myNodev11.zip

   • Fügen Sie die Ressourcen hinzu, die Sie in eine implementierbare BAR -Datei migrieren möchten, indem Sie beispielsweise den Befehl ibmint package ausführen:

     ibmint package --input-path C:\myResources --output-bar-file C:\bars\myBAR 

2. Optional: Erstellen Sie unter IBM App Connect Enterprise 13.0 ein Sammelverzeichnis, in das die Protokolle des TADataCollector Befehls geschrieben werden sollen, und setzen Sie den Wert der Umgebungsvariablen TADATACOLLECTORDIRECTORY auf den Namen des Sammelverzeichnisses. Wenn Sie kein Kollektorverzeichnis erstellen, werden die Protokolle in ein temporäres Unterverzeichnis im Ausgangsverzeichnis des Benutzers geschrieben, der den Befehl ausführt.
   1. Erstellen Sie ein Kollektorverzeichnis, indem Sie den Befehl mkdir C:\TADemoausführen.
   2. Setzen Sie die Umgebungsvariable TADATACOLLECTORDIRECTORY auf den Pfad des Kollektorverzeichnisses, indem Sie den Befehl set TADATACOLLECTORDIRECTORY=C:\TADemoausführen.
3. Führen Sie unter IBM App Connect Enterprise 13.0 den TADataCollector Befehl mit einer der folgenden Optionen aus:
   • Führen Sie zum Erfassen von Daten den folgenden Befehl aus:

     TADataCollector ace collect C:\temp\myNodev11.zip

   • Führen Sie den folgenden Befehl aus, um Daten zu erfassen und zu bewerten:

     TADataCollector ace assess C:\temp\myNodev11.zip

   • Führen Sie den folgenden Befehl aus, um Berichte für Daten zu generieren, die von den beiden vorherigen Optionen erfasst und bewertet wurden:

     TADataCollector ace report

   • Führen Sie den folgenden Befehl aus, um Daten zu erfassen und zu bewerten und Berichte zu generieren:

     TADataCollector ace run C:\temp\myNodev11.zip

   Der Befehl TADataCollector kann manchmal (aber nicht immer) fehlschlagen, wenn einer der optionalen Parameter --source-platformoder --source-platform-ccsid nicht angegeben wird, wenn der Befehl aufgerufen wird. Lösen Sie dieses Problem, indem Sie den Befehl mit dem Parameter --source-platformoder --source-platform-ccsid erneut ausführen. Angenommen, Sie haben die Sicherungsdatei unter Windowserstellt:

   TADataCollector ace collect --source-platform WinX64 C:\temp\myNodev11.zip

   Der Befehl TADataCollector enthält außerdem die optionalen Parameter --server , um die Extraktion von einem bestimmten Server zu aktivieren, und --target , um das Ziel der Analyse anzugeben, die vom Tool Transformation Advisor ausgeführt werden soll.

   Weitere Informationen zum Befehl TADataCollector finden Sie unter BefehlTADataCollector.
   
   
   Wenn Sie den Befehl TADataCollector ausführen, wird die Ausgabe in Ihr Kollektorverzeichnis geschrieben. Wenn Sie das Kollektorverzeichnis erstellt und die Umgebungsvariable TADATACOLLECTORDIRECTORY festgelegt haben, wird die Ausgabe in dieses Verzeichnis geschrieben. Andernfalls wird die Ausgabe in ein temporäres Unterverzeichnis im Ausgangsverzeichnis des Benutzers geschrieben, der den Befehl ausführt. Zum Beispiel C:\Users\username\AppData\Local\Temp\TADataCollector.

   Die folgenden Unterverzeichnisse werden in Ihrem Kollektorverzeichnis erstellt:

   • logs. Die Protokolldateien haben die Namenskonvention ta_sdk_#[#].log, zum Beispiel ta_sdk_0.log, ta_sdk_1.log, ta_sdk_2.log, und so weiter, bis ta_sdk_50.log. Die neueste Protokolldatei ist das Protokoll mit der höchsten Nummer. Wenn mehr als 50 Protokolldateien vorhanden sind, wird die älteste (kleinste Zahl) gelöscht. Verwenden Sie die Protokolldateien, um den Prozess auf Fehler zu überprüfen.
   • In: output. Das Unterverzeichnis output enthält ein Unterverzeichnis und eine übereinstimmende Datei .zip für jede Bewertung, die mit diesem Collector mit dem Befehl TADataCollector erstellt wurde. Die Verzeichnis-und zip -Dateinamen lauten wie folgt:
     • Der Name der BAR-Datei, wenn eine BAR-Datei angegeben wurde, z. B. myBar.
     • Der Name des Integrationsknotens, wenn eine Sicherung bereitgestellt wurde, z. B. myNode.
     • Der Name des Integrationsknotens verknüpft mit dem Namen eines darunterliegenden Servers, wenn zusammen mit dem--server Parameter, beispielsweise myNode_myServer.
     Die Datei .zip im Ausgabeverzeichnis ist ein Transformation Advisor -Artefakt, mit dem Sie die Bewertung in eine Transformation Advisor Cloud-Instanz hochladen können.
     Ein Beurteilungsverzeichnis (z. B. output/myNode)) enthält die folgenden Unterverzeichnisse und Dateien:
     • Ass. Das Unterverzeichnis ace enthält Informationen zum Ass und seinen Zielen, die von einer Transformation Advisor -Cloudinstanz verwendet würden.
     • Ein Unterverzeichnis für jeden Integrationsserver, z. B. server1, server2, oder ein einzelnes Unterverzeichnis für die BAR-Datei. Jedes Unterverzeichnis enthält Informationen zu der Server-oder BAR-Datei, die vom Befehl TADataCollector verwendet wird, um die Datei recommendations.json. zu erstellen.
     • In: environment.json. Diese Datei enthält Informationen zu dieser Bewertung, die von einer Transformation Advisor -Cloudinstanz verwendet würde.
     • In: recommendations.json. Diese Datei wird nur erstellt wenn Sie den Befehl TADataCollectormit dem Parameter assess oder run ausführen. Die Datei enthält computerlesbare Informationen zu allen vorgeschlagenen Aktionen zur Modernisierung Ihrer Sicherungs-oder BAR-Datei für Ihr beabsichtigtes Ziel.
     • In: recommendations.html. Diese Datei wird nur erstellt, wenn Sie den TADataCollector-Befehl mit dem Parameter run ausführen (oder den Parameter report (nachdem Sie den Befehl zuvor mit dem Parameter `assess ausgeführt hatten). Die Datei enthält einen lesbaren html -Bericht für alle Vorschläge in der Datei recommendations.json .
4. Überprüfen Sie den Inhalt des Unterverzeichnisses output im Ausgabeverzeichnis.
   Wenn Sie den Befehl TADataCollector mit dem Parameter run ausgeführt haben, wird ein statischer HTML-Bericht erstellt, z. B. C:\TADemo\output\myNodev11\recommendations.html. In diesem Bericht sind die gefundenen Probleme für alle Integrationsserver aufgelistet, die dem Integrationsknoten zugeordnet sind.

   Ausführliche Informationen zu den Problemen können Sie über die Links in der Übersichtstabelle anzeigen, oder indem Sie auf der Seite nach unten scrollen. Für jedes Problem wird eine Gesamtkomplexität ermittelt, die den Typ der erforderlichen Aktion angibt:

   • Simple: Eine administrative Änderung ist erforderlich.
   • Moderate: Eine Entwicklungsänderung ist erforderlich.
   • Complex: Es ist eine schwierige Entwicklungsaufgabe oder eine alternative Strategie erforderlich.

   Das ToolTransformation Advisor stellt außerdem eine Wertigkeitsklassifikation für jedes aufgedeckt Problem bereit:

   • Green (info): Es ist keine sofortige Aktion erforderlich, aber Sie sollten sich bewusst sein.
   • Yellow (warning): Möglicherweise ist eine sofortige Aktion erforderlich oder empfohlen, bevor Sie fortfahren.
   • Red (error): Sie müssen Korrekturmaßnahmen ergreifen, bevor Sie fortfahren können.

   Das folgende Beispiel zeigt ein komplexes Problem mit dem Schweregrad „Rot“, das bei der Ausführung des Tools myNodev11 auf dem IBM App Connect Enterprise 11.0 Integrationsknoten mit einem Integrationsserver server11festgestellt wurde.

   Tabelle 1. Empfehlungsbericht für Beurteilung: myNodev11

   Bewertungseinheit	Gesamtbewertung der Komplexität	Probleme	Gesamtaufwand (Tage)
   server11	KOMPLEX	1	10

   Tabelle 2. Gesamtkomplexität: KOMPLEX

   Fehler	Warnung	Information
   Probleme der Stufe 'ROT': 1	Probleme der Stufe 'Gelb': 0	Probleme der Stufe 'Grün': 0

   Tabelle 3. Probleme mit der Einstufung KOMPLEX können durch signifikante Änderungen der Entwicklung oder durch die Verwendung einer anderen Technologie behoben werden:

   ID	Title	Cost	Severity	Lösung
   IIB01	Ziehen Sie ein anderes Transformationsverfahren als .NET in Betracht.	10	ROT	Der Nachrichtenfluss enthält eine Instanz von.NETInput oder .NETCompute -Nachrichtenflussknoten. Die Software unter IBM App Connect Enterprise 13.0 unterstützt zwar weiterhin .NET, jedoch nicht die Ausführung der .NET CLR bei der Bereitstellung in Linux® Docker -Containern auf App Connect Enterprise Certified Containers. Für die Transformation stehen weitere Nachrichtenflussknoten zur Verfügung, wie z. B. Berechnen, JavaCompute, Und Kartierung Knoten.

   Weitere Informationen zu den Regeln, die für das Tool Transformation Advisor gelten, finden Sie unter Regeln für das Tool Transformation Advisor.

5. Führen Sie alle Aktionen aus, die von dem Bericht empfohlen werden, und führen Sie anschließend das Tool Transformation Advisor erneut aus , um zu bestätigen, dass alle Probleme behoben wurden.