Einen Migrationsplan erstellen

Nachdem Sie eine Kopie des Dateisystems der Quellmaschine auf Ihrem lokalen Computer erstellt haben, analysieren Sie als Nächstes das Dateisystem, um einen Migrationsplan vorzubereiten. Mit dem Migrationsplan können dann Migrationsartefakte generiert werden.

Auf dieser Seite werden die Schritte zum Vorbereiten eines Migrationsplans für verschiedene Arbeitslasten beschrieben.

Migrationsplan für einen Linux-VM-Container erstellen

Führen Sie den folgenden Befehl aus, um die Analyse durchzuführen:

./m2c analyze \
  -s PATH_TO_COPIED_FILESYSTEM \
  -p linux-vm-container \
  -o ANALYSIS_OUTPUT_PATH \
  [ -r skip_size_checks=SKIP_SIZE_CHECKS  ] \
  [ -r big_files_threshold_mb=SIZE_IN_MB ]

Ersetzen Sie Folgendes:

• PATH_TO_COPIED_FILESYSTEM: der Pfad zum kopierten Dateisystemverzeichnis.
• ANALYSIS_OUTPUT_PATH: der Pfad zu dem Ordner, in dem die Analyseausgabe erstellt werden soll
• SKIP_SIZE_CHECKS: Dies ist ein optionaler Parameter. Standardmäßig ist dies auf false gesetzt und die Migrate to Containers-Befehlszeile prüft die Image-Ebenen, um sicherzustellen, dass die Größe 15 GB nicht überschreitet. Wenn die Gesamtgröße der Image-Ebenen 15 GB überschreitet, schlägt die Artefaktgenerierung fehl und die Migrate to Containers CLI zeigt eine Fehlermeldung an. Wenn Sie diese Größenprüfung überspringen möchten, setzen Sie diesen Parameter auf true.
• SIZE_IN_MB: Dies ist ein optionaler Parameter. Geben Sie einen Schwellenwert für die Dateigröße in MB an, um nach Dateien zu suchen, die eine bestimmte Größe überschreiten. Wenn Migrate to Containers CLI eine Datei mit einer Größe erkennt, die den angegebenen Größengrenzwert überschreitet, fügt die Migrate to Containers CLI im generierten Migrationsplan einen Kommentar mit einem Vorschlag hinzu, die erkannte Datei aus dem Container-Image auszuschließen.

Nach Abschluss der Analyse wird im angegebenen Ausgabepfad, der den Migrationsplan config.yaml enthält, ein neues Verzeichnis erstellt.

Migrationsplan für Tomcat-Arbeitslasten erstellen

Für Tomcat-Anwendungskomponenten sind bei diesem Prozess die Pfade catalina-home und catalina-base als Eingaben erforderlich.

Prüfen Sie den laufenden Tomcat-Serverprozess, um diese Werte abzurufen:

ps aux | grep catalina

Führen Sie den folgenden Befehl aus, um die Analyse durchzuführen:

./m2c analyze \
  -s PATH_TO_COPIED_FILESYSTEM \
  -p tomcat-container \
  -o ANALYSIS_OUTPUT_PATH \
  -r catalina-home=PATH_TO_CATALINA_HOME \
  -r catalina-base=PATH_TO_CATALINA_BASE \
  -r java-version=JAVA_VERSION

Ersetzen Sie Folgendes:

• PATH_TO_COPIED_FILESYSTEM: der Pfad zum kopierten Dateisystemverzeichnis.
• ANALYSIS_OUTPUT_PATH: der Pfad zu dem Ordner, in dem die Analyseausgabe erstellt werden soll
• PATH_TO_CATALINA_HOME: der Pfad zum Stammverzeichnis der Tomcat-Installation
• PATH_TO_CATALINA_BASE: der Pfad zum Stammverzeichnis der Laufzeitkonfiguration der Tomcat-Instanz, die Sie migrieren Mehrere Basen sollten durch Doppelpunkte getrennt werden
• JAVA_VERSION: Java-Version des Containers im Format X.Y. Die Standard-Java-Version ist 11.0.

Nach Abschluss der Analyse wird im angegebenen Ausgabepfad, der den Migrationsplan config.yaml enthält, ein neues Verzeichnis erstellt.

Migrationsplan für Websphere-Arbeitslasten erstellen

Optional: binaryAppScanner.jar einrichten

Hinweis: Wenn Sie Liberty-Arbeitslasten migrieren und ihre Java-Umgebung verwalten möchten, müssen Sie keine binaryAppScanner.jar einrichten.

Wenn Sie herkömmliche WebSphere-Arbeitslasten migrieren oder eine Migration zwischen verschiedenen Java-Umgebungen ausführen möchten, können Sie binaryAppScanner.jar einrichten. Die Migrate to Containers-Befehlszeile automatisiert die Verwendung von binaryAppScanner.jar, um neue WebSphere-Konfigurationen zu generieren und die Java-Laufzeitmodernisierung zu erleichtern.

So richten Sie binaryAppScanner.jar ein:

1. Laden Sie die Installationsdatei binaryAppScannerInstaller.jar vom IBM Support herunter. Sie müssen als Teil des Downloads die Lizenzvereinbarung akzeptieren.

2. Extrahieren Sie die Datei binaryAppScanner.jar und akzeptieren Sie die Lizenzvereinbarung:

   java -jar binaryAppScannerInstaller.jar --acceptLicense --verbose INSTALL_LOCATION
   

   Ersetzen Sie Folgendes:

   • INSTALL_LOCATION: das Zielverzeichnis für die Extraktion. Wenn Sie beispielsweise /tmp als Zielverzeichnis angeben, ist binaryAppScanner.jar nach Abschluss der Installation unter /tmp/wamt/binaryAppScanner.jar verfügbar.

Analyse durchführen

Führen Sie den folgenden Befehl aus, um die Analyse durchzuführen:

./m2c analyze \
  -s PATH_TO_COPIED_FILESYSTEM \
  -p websphere-container \
  -o ANALYSIS_OUTPUT_PATH \
  -r websphere-profile=WEBSPHERE_PROFILE \
  -r websphere-home=WEBSPHERE_HOME \
  -r websphere-java-home=WEBSPHERE_JAVA_HOME \
  -r target-profile=TARGET_PROFILE \
  -r target-version=TARGET_VERSION \
  -r target-edition=TARGET_EDITION \
  -r target-se=TARGET_SE \
  -r target-ee=TARGET_EE \
  -r target-vendor=TARGET_VENDOR \
  -r target-base-image=TARGET_BASE_IMAGE \
  --volume PATH_TO_BINARYAPPSCANNER:/binaryAppScanner.jar

Ersetzen Sie Folgendes:

• PATH_TO_COPIED_FILESYSTEM: der Pfad zum kopierten Dateisystemverzeichnis.
• ANALYSIS_OUTPUT_PATH: der Pfad zu dem Ordner, in dem die Analyseausgabe erstellt werden soll
• WEBSPHERE_PROFILE: Dies ist ein optionaler Parameter. Geben Sie das WebSphere-Profil an, das in der Quell-VM verwendet wird. Format: [Liberty|Traditional].
• WEBSPHERE_HOME: Dies ist ein optionaler Parameter. Geben Sie den Pfad zur Anwendungsserverinstallation in der Quell-VM an.
• WEBSPHERE_JAVA_HOME: Dies ist ein optionaler Parameter. Geben Sie den Pfad zur Java-Installation in der Quell-VM an.
• TARGET_PROFILE: Dies ist ein optionaler Parameter. Geben Sie das WebSphere-Profil an, das im Zielcontainer verwendet werden soll. Format: [Liberty|Traditional]. Standardmäßig ist das Quellprofil ausgewählt.
• TARGET_VERSION: Dies ist ein optionaler Parameter. Geben Sie die WebSphere-Version an, die im Zielcontainer verwendet werden soll. Die Standardeinstellung ist die Quellversion.
• TARGET_EDITION: Dies ist ein optionaler Parameter. Geben Sie die WebSphere-Edition an, die im Zielcontainer verwendet werden soll. Format: [Base|Core|Open|ND]. Standardmäßig ist die Quelledition festgelegt.
• TARGET_SE: Dies ist ein optionaler Parameter. Geben Sie die Java SE-Version an, die im Zielcontainer verwendet werden soll. Format: [SE8|SE11|SE17]. Standardmäßig ist die Java SE-Quellversion festgelegt.
• TARGET_EE: Dies ist ein optionaler Parameter. Geben Sie die Java EE- oder Jakarta EE-Version an, die im Zielcontainer verwendet werden soll. Format: [EE7|EE8|EE9|EE10]. Die Standardeinstellung ist die Java EE- oder Jakarta EE-Quellversion.
• TARGET_VENDOR: Dies ist ein optionaler Parameter. Geben Sie den Java-Anbieter an, der im Zielcontainer verwendet werden soll. Format: [IBM Corporation|Oracle Corporation]. Die Standardeinstellung ist der Java-Quellanbieter.
• TARGET_BASE_IMAGE: Dies ist ein optionaler Parameter. Geben Sie ein Basis-Image für den Zielcontainer an.
• PATH_TO_BINARYAPPSCANNER: Dies ist ein optionaler Parameter. Geben Sie den Pfad zur Datei binaryAppScanner.jar auf Ihrem lokalen Computer an.

Nach Abschluss der Analyse wird im angegebenen Ausgabepfad, der den Migrationsplan config.yaml enthält, ein neues Verzeichnis erstellt.

Migrationsplan für traditionelle Websphere-Arbeitslasten erstellen

Wichtig: Das websphere-traditional-Plug-in wurde eingestellt. Für bestehende Kunden wird dieses Plug-in noch bis Dezember 2023 unterstützt. Danach ist es nicht mehr verfügbar. Wenn Sie mit der Modernisierung von WebSphere-Arbeitslasten noch nicht vertraut sind, verwenden Sie stattdessen das websphere-container-Plug-in mit der Migrate to Containers-Befehlszeile.

Die binaryAppScanner.jar-Datei einrichten

Laden Sie die neueste Version der Datei binaryAppScanner.jar herunter.

Wenn Sie die Datei binaryAppScanner.jar bereits installiert haben, prüfen Sie die aktuelle Version:

java -jar binaryAppScanner.jar --version

Vergleichen Sie dann Ihre aktuelle Version mit der in der IBM-Lizenz angezeigten Version, wenn Sie auf Migration Toolkit for Application Binaries klicken, um die Datei herunterzuladen. Wenn sie unterschiedlich sind, laden Sie die neueste Version der Datei binaryAppScanner.jar herunter.

Die Migrate to Containers-Befehlszeile automatisiert die Verwendung der binaryAppScanner.jar-Datei, die im IBM WebSphere Application Server Migration Toolkit for Application Binaries verfügbar ist, um Konfigurationsinformationen und Dateien für WebSphere WebSphere Application Server-Anwendungen in der Quell-VM zu extrahieren.

Bevor Sie eine Migration ausführen können, müssen Sie die Lizenzvereinbarung akzeptieren, das IBM WebSphere Application Server Migration Toolkit for Application Binaries herunterladen und die Datei binaryAppScanner.jar extrahieren.

Um binaryAppScanner.jar einzurichten:

1. Laden Sie die Installationsdatei binaryAppScannerInstaller.jar vom IBM Support herunter. Sie müssen als Teil des Downloads die Lizenzvereinbarung akzeptieren.

2. Führen Sie den folgenden Befehl aus, um die Datei binaryAppScanner.jar zu extrahieren und die Lizenzvereinbarung zu akzeptieren:

   java -jar binaryAppScannerInstaller.jar --acceptLicense --verbose
   

3. Geben Sie das Zielverzeichnis für die Extraktion an. Wenn Sie beispielsweise /tmp als Zielverzeichnis angeben, ist binaryAppScanner.jar nach Abschluss der Installation unter /tmp/wamt/binaryAppScanner.jar verfügbar.

WAS_HOME abrufen

Die Umgebungsvariable WAS_HOME gibt den Installationsort von traditionellen WebSphere Application Server an, z. B. /opt/IBM/WebSphere/AppServer/. Die Migrate to Containers-Befehlszeile verwendet diesen Wert, um die traditionelle WebSphere-Konfiguration zu finden und zu analysieren.

Prüfen Sie den ausgeführten WebSphere Application Server traditional-Prozess, um diesen Wert abzurufen:

ps aux | grep WAS_HOME

Analyse ausführen

Führen Sie den folgenden Befehl aus, um die Analyse durchzuführen:

./m2c analyze \
  -s PATH_TO_COPIED_FILESYSTEM \
  -p websphere-traditional-container -o ANALYSIS_OUTPUT_PATH \
  -r was-home=PATH_TO_WAS_HOME \
  --volume PATH_TO_BINARYAPPSCANNER:/binaryAppScanner.jar

Ersetzen Sie Folgendes:

• PATH_TO_COPIED_FILESYSTEM: der Pfad zum kopierten Dateisystemverzeichnis.
• ANALYSIS_OUTPUT_PATH: der Pfad zu dem Ordner, in dem die Analyseausgabe erstellt werden soll
• PATH_TO_WAS_HOME: der Pfad zur traditionellen WebSphere Application Server-Installation.
• PATH_TO_BINARYAPPSCANNER: der Pfad zur Datei binaryAppScanner.jar. Wenn Sie beispielsweise /tmp als Zielverzeichnis angegeben haben, ist binaryAppScanner.jar unter /tmp/wamt/binaryAppScanner.jar verfügbar.

Nach Abschluss der Analyse wird im angegebenen Ausgabepfad, der den Migrationsplan config.yaml enthält, ein neues Verzeichnis erstellt.

Migrationsplan für JBoss-Arbeitslasten erstellen

Bei JBoss-Anwendungskomponenten ist zum Erstellen eines Migrationsplans die Variable JBOSS_HOME als Eingabe erforderlich.

Prüfen Sie den laufenden JBoss-Serverprozess, um diesen Wert abzurufen:

ps aux | grep jboss.home.dir

Führen Sie den folgenden Befehl aus, um die Analyse durchzuführen:

./m2c analyze \
  -s PATH_TO_COPIED_FILESYSTEM \
  -p jboss-container \
  -o ANALYSIS_OUTPUT_PATH \
  -r jboss-home=PATH_TO_JBOSS_HOME

Ersetzen Sie Folgendes:

• PATH_TO_COPIED_FILESYSTEM: der Pfad zum kopierten Dateisystemverzeichnis.
• ANALYSIS_OUTPUT_PATH: der Pfad zu dem Ordner, in dem die Analyseausgabe erstellt werden soll
• PATH_TO_JBOSS_HOME: der Pfad zur JBoss-Installation

Nach Abschluss der Analyse wird im angegebenen Ausgabepfad, der den Migrationsplan config.yaml enthält, ein neues Verzeichnis erstellt.

Migrationsplan für Apache-Arbeitslasten erstellen

Führen Sie den folgenden Befehl aus, um die Analyse durchzuführen:

./m2c analyze \
  -s PATH_TO_COPIED_FILESYSTEM \
  -p apache-container \
  -o ANALYSIS_OUTPUT_PATH

Ersetzen Sie Folgendes:

• PATH_TO_COPIED_FILESYSTEM: der Pfad zum kopierten Dateisystemverzeichnis.
• ANALYSIS_OUTPUT_PATH: der Pfad zu dem Ordner, in dem die Analyseausgabe erstellt werden soll

Nach Abschluss der Analyse wird im angegebenen Ausgabepfad, der den Migrationsplan config.yaml enthält, ein neues Verzeichnis erstellt.

Migrationsplan für WordPress-Arbeitslasten erstellen

Führen Sie den folgenden Befehl aus, um die Analyse durchzuführen:

./m2c analyze \
  -s PATH_TO_COPIED_FILESYSTEM \
  -p wordpress-container \
  -o ANALYSIS_OUTPUT_PATH

Ersetzen Sie Folgendes:

• PATH_TO_COPIED_FILESYSTEM: der Pfad zum kopierten Dateisystemverzeichnis.
• ANALYSIS_OUTPUT_PATH: der Pfad zu dem Ordner, in dem die Analyseausgabe erstellt werden soll

Nach Abschluss der Analyse wird im angegebenen Ausgabepfad, der den Migrationsplan config.yaml enthält, ein neues Verzeichnis erstellt.

Migrationsplan für Windows IIS-Dienste erstellen

Führen Sie den folgenden Befehl aus, um die Analyse durchzuführen:

./m2c analyze -s PATH_TO_IMAGE -p windows-iis-container -o ANALYSIS_OUTPUT_PATH

Ersetzen Sie Folgendes:

• PATH_TO_IMAGE ist der Pfad zum Quell-Image des Maschinenlaufwerks. Sie können mehrere Laufwerk-Images gleichzeitig mit mehreren -s-Flags angeben. Beispiel: -s PATH_TO_IMAGE_1 -s PATH_TO_IMAGE_2...-s PATH_TO_IMAGE_N
• ANALYSIS_OUTPUT_PATH: der Pfad zu dem Ordner, in dem die Analyseausgabe erstellt werden soll

Nach Abschluss der Analyse wird im angegebenen Ausgabepfad, der den Migrationsplan config.yaml enthält, ein neues Verzeichnis erstellt.

Nächste Schritte

• Migrationsplan für Folgendes anpassen:
  • Linux-VMs
  • Tomcat
  • WebSphere Liberty
  • WebSphere Traditional
  • JBoss
  • Apache
  • WordPress
  • Windows-IIS-Dienste