Anwendungsmigrationsbericht

Migration Toolkit for Application Binaries kann einen konsolidierten Migrationsbericht generieren, der die Inhalte des Auswertungsberichts für Anwendungstechnologien, des Anwendungsinventarberichts, des detaillierten Migrationsanalyseberichts und der WebSphere-Konfiguration enthält. Mit diesem Bericht ist es einfacher als je zuvor, Anwendungsbinärdateien für die Migration auf neuere Releases von WebSphere Traditional oder Liberty zu analysieren.

Am Anfang des Berichts finden Sie eine Zusammenfassung der Technologieauswertung, der Sie entnehmen können, welche IBM Plattformen die von der Anwendung verwendeten Technologien unterstützt, und eine Regeldringlichkeitszusammenfassung, die veranschaulicht, wie viele Regeln und Regelergebnisse für jede Regeldringlichkeit markiert wurden. Der Standardbericht zeigt die Migrationsergebnisse für die Migration von WebSphere Application Server Version 8.5.5 und Java SE 6 auf Liberty und Java SE 8 an. Sie müssen die Quellen- und Zieloptionen so ändern, dass sie Ihrem Migrationsszenario entsprechen.

Nachdem Sie festgestellt haben, ob Ihre Zielplattform für Ihre Anwendung vollständig unterstützt wird, sehen Sie sich die Details im Abschnitt mit den Details der Technologieauswertung an. Alle für Ihre Zielplattform nicht unterstützten Technologien sind mit einer Analyseregel im Abschnitt mit der detaillierten Migrationsanalyse verlinkt. Für jede Analyseregel wird eine ausführliche Hilfe bereitgestellt, in der das Migrationsproblem und die mögliche Problemlösung beschrieben sind. In den Analyseregelergebnissen sind die betroffenen Dateien zusammen mit den Übereinstimmungskriterien, dem Methodenamen, sofern zutreffend, und die Zeilennummer, sofern verfügbar, aufgelistet. Zeilennummern sind nur für Ergebnisse verfügbar, die in einem Methodenhauptteil vorkommen.

Der Berichtsabschnitt mit der detaillierten Migrationsanalyse enthält alle Migrationsprobleme, die für die Anwendung markiert wurden. Alle schwerwiegenden Migrationsprobleme müssen behoben werden. Warnungen müssen ausgewertet werden, um festzustellen, ob Änderungen an der Anwendung vorgenommen werden müssen. Informationen weisen auf Dinge hin, die beachtet werden müssen, wie z. B. veraltete APIs, die in einem späteren Release entfernt werden könnten.

Im Berichtsabschnitt zum Inventar sind eine Inventarzusammenfassung des Inhalts und der Struktur jeder Anwendung und Informationen zu potenziellen Implementierungsproblemen und Leistungsaspekten enthalten.

Wenn es sich bei Ihrer Zielplattform um Liberty handelt, ist im Berichtsabschnitt zur Liberty-Konfiguration die Konfiguration für den Liberty-Server aufgeführt, die durch das Scannen der Anwendungsbinärdateien und der WebSphere Traditional-Konfiguration ermittelt wurde. Wenn Sie eine Migration zwischen verschiedenen Versionen von WebSphere Traditional durchführen, wird ein separates wsadmin-Script beim Erkennen der Konfiguration generiert. Weitere Einzelheiten finden Sie im Abschnitt zur Konfigurationsmigration.

Der einzige erforderliche Parameter ist Eingabepfad_der_Binärdatei, der einen absoluten oder relativen Pfad zu einer .ear- oder .war-Datei oder zu einem Verzeichnis, das .ear- und .war-Dateien enthält, angibt. Wenn Eingabepfad_der_Binärdatei zu einer implementierten Anwendung in einer WebSphere Traditional-Installation führt, wird eine zusätzliche Konfiguration generiert.

Wenn keine Anwendungsserveroptionen angegeben werden, werden standardmäßig --sourceAppServer=was855 und --targetAppServer=liberty verwendet.

Das bewährte Verfahren ist, die Klassenpakete für angepasste Anwendungen mit der Option --includePackages anzugeben. Auf diese Weise vermeiden Sie das Scannen von Java EE-Paketen und Paketen anderer Anbieter, die sich nicht auf Ihre Migration auswirken. Wenn weder die Option --includePackages noch die Option --excludePackages angegeben sind, schließt das Tool Java EE und verschiedene Pakete anderer Anbieter standardmäßig aus. Diese Pakete werden als Scanoptionen am Anfang des Berichts angegeben.

Führen Sie Befehle im Verzeichnis wamt Ihrer Installation von Migration Toolkit for Application Binaries aus. Sie erhalten eine vollständige Liste der unterstützten Optionen für die Evaluierung Ihrer Anwendung, indem Sie den folgenden Befehl ausführen:

java -jar binaryAppScanner.jar --help --all

Die folgenden Beispiele veranschaulichen verschiedene Methoden zum Generieren des Berichts mit den Befehlsoptionen:

Führen Sie den folgenden Befehl aus, um den Standardbericht, einen HTML-Bericht für die Migration von WebSphere Application Server Traditional Version 8.5.5 auf Liberty, anzuzeigen:
```
java -jar binaryAppScanner.jar binaryInputPath
                    
```
Um den Bericht in eine bestimmte Datei zu speichern, geben Sie zusätzlich den Parameter -- output mit einem Dateinamen an. Wenn der Dateiname nicht vollständig qualifiziert ist, wird die Datei im aktuellen Verzeichnis erstellt.
Der folgende Befehl gibt den Bericht beispielsweise in der Datei "/MyAppDir/MyAppReport.html" aus.
```
java -jar binaryAppScanner.jar MyApp.ear --all --sourceAppServer=was70
					--targetAppServer=liberty --targetCloud=cfIBMCloud --output=/MyAppDir/MyAppReport.html
```
Um eine JSON-formatierte Berichtsdatei mit dem Standardnamen MyApp.war_MigrationReport.json im aktuellen Verzeichnis zu erstellen, in dem binaryInputPath auf /MyAppDir/MyApp.war gesetzt ist, führen Sie den folgenden Befehl aus:
```
java -jar binaryAppScanner.jar /MyAppDir/MyApp.war --all --format=json
```
Geben Sie den Parameter --all-separate-reports an, um separate Berichtsdateien für die Berichte 'Technologieauswertung', 'Detaillierte Migrationsanalyse', 'Bestand' und 'Konfiguration ' anstelle eines vollständigen konsolidierten Berichts zu erstellen.
```
java -jar binaryAppScanner.jar /MyAppDir/MyApp.war --all-separate-reports
```
Um bestimmte Dateien, Verzeichnisse oder Archive vom Scan auszuschließen, geben Sie den --excludeFiles parameter mit einem regulären Ausdruck an. Damit der reguläre Ausdruck beim Abgleich erfolgreich ist, müssen Sie sicherstellen, dass das angegebene Muster vollständige Abgleiche und keine Teilabgleiche durchführt.
Der folgende Befehl schließt beispielsweise alles aus, das in einer Ressourcenverzeichnisdatei enthalten ist.
```
java -jar binaryAppScanner.jar MyApp.ear --all --sourceAppServer=was70
					--targetAppServer=liberty --excludeFiles=.*/resource/.*
```
Um benutzerdefinierte Regeln festzulegen, geben Sie den --userRuleLocation parameter mit dem Verzeichnis an, das Ihre Regeldefinitionen und -listen enthält. Weitere Informationen zum Erstellen benutzerdefinierter Regeln finden Sie unter Benutzerdefinierte Regeln.
Der folgende Befehl führt beispielsweise die benutzerdefinierten Regeln zusammen mit den Regeln für die Migration von WebSphere Traditional auf Liberty aus.
```
java -jar binaryAppScanner.jar MyApp.ear --all --sourceAppServer=was90 --targetAppServer=liberty --userRuleLocation=/path/to/rules
```

Abb. 1. Anwendungsmigrationsbericht im HTML-Format

Der Abschnitt für die Liberty-Konfiguration ist nur dann im Bericht enthalten, wenn es sich bei der Zielplattform um Liberty handelt. Wenn Sie eine Migration zwischen WebSphere Traditional-Versionen durchführen, wird ein separates wsadmin-Script in demselben Verzeichnis wie der Bericht generiert.