Créer un plan de migration

Après avoir créé une copie du système de fichiers de la machine source sur votre machine locale, l'étape suivante consiste à analyser le système de fichiers pour préparer un plan de migration. Le plan de migration peut ensuite être utilisé pour générer les artefacts de migration.

Cette page décrit les étapes nécessaires à la préparation d'un plan de migration pour différentes charges de travail.

Créer un plan de migration pour un conteneur de VM Linux

Pour effectuer l'analyse, exécutez la commande suivante :

./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 ]

Remplacez les éléments suivants :

  • PATH_TO_COPIED_FILESYSTEM : chemin d'accès au répertoire du système de fichiers copié.
  • ANALYSIS_OUTPUT_PATH : chemin d'accès au dossier dans lequel doit être créée la sortie de l'analyse
  • SKIP_SIZE_CHECKS : ce paramètre est facultatif. Par défaut, il est défini sur false et la CLI Migrate to Containers vérifie les couches d'image pour s'assurer que la taille ne dépasse pas 15 Go. Si la taille totale des couches d'image dépasse 15 Go, la génération d'artefacts échoue et la CLI Migrate to Containers affiche un message d'erreur. Pour ignorer cette vérification de taille, définissez ce paramètre sur true.
  • SIZE_IN_MB : ce paramètre est facultatif. Spécifiez un seuil de taille de fichier, en Mo, pour rechercher les fichiers qui dépassent une taille spécifique. Si la CLI Migrate to Containers détecte un fichier dont la taille dépasse le seuil spécifié, la CLI Migrate to Containers ajoute un commentaire dans le plan de migration généré avec la suggestion d'exclure le fichier détecté de l'image de conteneur.

Une fois l'analyse terminée, un nouveau répertoire est créé dans le chemin de sortie spécifié et contient le plan de migration, config.yaml.

Créer un plan de migration pour les charges de travail Tomcat

Pour les composants d'applications Tomcat, ce processus nécessite les chemins d'accès catalina-home et catalina-base en tant qu'entrées.

Pour récupérer ces valeurs, vérifiez le processus du serveur Tomcat en cours d'exécution :

ps aux | grep catalina

Pour effectuer l'analyse, exécutez la commande suivante :

./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

Remplacez les éléments suivants :

  • PATH_TO_COPIED_FILESYSTEM : chemin d'accès au répertoire du système de fichiers copié.
  • ANALYSIS_OUTPUT_PATH : chemin d'accès au dossier dans lequel vous souhaitez créer la sortie de l'analyse.
  • PATH_TO_CATALINA_HOME : chemin d'accès à la racine de l'installation Tomcat
  • PATH_TO_CATALINA_BASE : chemin d'accès à la racine de la configuration de l'environnement d'exécution de l'instance Tomcat que vous migrez Plusieurs bases doivent être séparées par le signe deux-points
  • JAVA_VERSION : version Java du conteneur au format X.Y La version par défaut de Java est 11.0.

Une fois l'analyse terminée, un nouveau répertoire est créé dans le chemin de sortie spécifié et contient le plan de migration, config.yaml.

Créer un plan de migration pour les charges de travail WebSphere

Facultatif : configurer le fichier binaryAppScanner.jar

Si vous souhaitez migrer des charges de travail WebSphere traditionnelles ou effectuer une migration entre différents environnements Java, vous pouvez configurer binaryAppScanner.jar. La CLI Migrate to Containers automatise l'utilisation de binaryAppScanner.jar pour générer de nouvelles configurations WebSphere et faciliter la modernisation de l'environnement d'exécution Java.

Pour configurer binaryAppScanner.jar, procédez comme suit :

  1. Téléchargez le fichier d'installation binaryAppScannerInstaller.jar auprès de l'assistance IBM. Vous devez accepter le contrat de licence dans le cadre du téléchargement.

  2. Extrayez le fichier binaryAppScanner.jar et acceptez le contrat de licence :

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

    Remplacez les éléments suivants :

    • INSTALL_LOCATION : répertoire cible pour l'extraction. Par exemple, si vous spécifiez /tmp comme répertoire cible, binaryAppScanner.jar est disponible à l'emplacement /tmp/wamt/binaryAppScanner.jar une fois l'installation terminée.

Effectuer l'analyse

Pour effectuer l'analyse, exécutez la commande suivante :

./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

Remplacez les éléments suivants :

  • PATH_TO_COPIED_FILESYSTEM : chemin d'accès au répertoire du système de fichiers copié.
  • ANALYSIS_OUTPUT_PATH : chemin d'accès au dossier dans lequel doit être créée la sortie de l'analyse
  • WEBSPHERE_PROFILE : ce paramètre est facultatif. Spécifiez le profil WebSphere utilisé dans la VM source. Format : [Liberty|Traditionnel]
  • WEBSPHERE_HOME : ce paramètre est facultatif. Spécifiez le chemin d'accès à l'installation du serveur d'application dans la VM source.
  • WEBSPHERE_JAVA_HOME : ce paramètre est facultatif. Spécifiez le chemin d'accès à l'installation Java dans la VM source.
  • TARGET_PROFILE : ce paramètre est facultatif. Spécifiez le profil WebSphere à utiliser dans le conteneur cible. Format : [Liberty|Traditionnel] Correspond par défaut au profil source.
  • TARGET_VERSION : ce paramètre est facultatif. Spécifiez la version de WebSphere à utiliser dans le conteneur cible. Correspond par défaut à la version source.
  • TARGET_EDITION : ce paramètre est facultatif. Spécifiez l'édition WebSphere à utiliser dans le conteneur cible. Format : [Base|Core|Ouvrir|ND] Correspond par défaut à l'édition source.
  • TARGET_SE : ce paramètre est facultatif. Spécifiez la version Java SE à utiliser dans le conteneur cible. Format : [SE8|SE11|SE17] Correspond par défaut à la version Java SE source.
  • TARGET_EE : ce paramètre est facultatif. Spécifiez la version Java EE ou Jakarta EE à utiliser dans le conteneur cible. Format : [EE7|EE8|EE9|EE10] La valeur par défaut correspond à la version Java EE ou Jakarta EE source.
  • TARGET_VENDOR : ce paramètre est facultatif. Spécifiez le fournisseur Java à utiliser dans le conteneur cible. Format : [IBM Corporation|Oracle Corporation] Correspond par défaut au fournisseur Java source.
  • TARGET_BASE_IMAGE : ce paramètre est facultatif. Spécifiez une image de base à utiliser pour le conteneur cible.
  • PATH_TO_BINARYAPPSCANNER : ce paramètre est facultatif. Spécifiez le chemin d'accès au fichier binaryAppScanner.jar sur votre ordinateur local.

Une fois l'analyse terminée, un nouveau répertoire est créé dans le chemin de sortie spécifié et contient le plan de migration, config.yaml.

Créer un plan de migration pour les charges de travail Websphere traditionnelles

Configurer le fichier binaryAppScanner.jar

Téléchargez la dernière version du fichier binaryAppScanner.jar.

Si vous avez déjà installé le fichier binaryAppScanner.jar, vérifiez la version actuelle :

java -jar binaryAppScanner.jar --version

Comparez ensuite votre version actuelle à la version dans la licence IBM qui s'affiche lorsque vous cliquez sur Kit de migration pour les binaires d'application pour télécharger le fichier. Si elles sont différentes, téléchargez la dernière version du fichier binaryAppScanner.jar.

La CLI Migrate to Containers automatise l'utilisation de l'outil binaryAppScanner.jar, disponible dans le kit de migration IBM WebSphere Application Server pour les binaires d'application, pour extraire les informations et fichiers de configuration pour les applications WebSphere Application Server de la VM source.

Avant de pouvoir effectuer une migration, vous devez accepter le contrat de licence et télécharger le kit de migration IBM WebSphere Application Server pour les binaires d'application, puis extraire le fichier binaryAppScanner.jar.

Pour configurer binaryAppScanner.jar, procédez comme suit :

  1. Téléchargez le fichier d'installation binaryAppScannerInstaller.jar auprès de l'assistance IBM. Vous devez accepter le contrat de licence dans le cadre du téléchargement.

  2. Exécutez la commande suivante pour extraire le fichier binaryAppScanner.jar et accepter le contrat de licence :

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

  3. Spécifiez le répertoire cible pour l'extraction. Par exemple, si vous spécifiez /tmp comme répertoire cible, binaryAppScanner.jar est disponible à l'emplacement /tmp/wamt/binaryAppScanner.jar une fois l'installation terminée.

Récupérer WAS_HOME

La variable d'environnement WAS_HOME spécifie l'emplacement d'installation traditionnel de WebSphere Application Server, tel que /opt/IBM/WebSphere/AppServer/. La CLI Migrate to Containers utilise cette valeur pour localiser et analyser correctement la configuration WebSphere traditionnelle.

Pour récupérer cette valeur, vérifiez le processus traditionnel de WebSphere Application Server en cours d'exécution :

ps aux | grep WAS_HOME

Exécuter l'analyse

Pour effectuer l'analyse, exécutez la commande suivante :

./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

Remplacez les éléments suivants :

  • PATH_TO_COPIED_FILESYSTEM : chemin d'accès au répertoire du système de fichiers copié.
  • ANALYSIS_OUTPUT_PATH : chemin d'accès au dossier dans lequel doit être créée la sortie de l'analyse
  • PATH_TO_WAS_HOME : chemin d'accès à l'installation de WebSphere Application Server traditionnel
  • PATH_TO_BINARYAPPSCANNER : chemin d'accès au fichier binaryAppScanner.jar. Par exemple, si vous avez spécifié /tmp comme répertoire cible, binaryAppScanner.jar est disponible à l'emplacement /tmp/wamt/binaryAppScanner.jar.

Une fois l'analyse terminée, un nouveau répertoire est créé dans le chemin de sortie spécifié et contient le plan de migration, config.yaml.

Créer un plan de migration pour les charges de travail JBoss

Pour les composants d'applications JBoss, la création d'un plan de migration nécessite la variable JBOSS_HOME en tant qu'entrée.

Pour récupérer cette valeur, vérifiez le processus du serveur JBoss en cours d'exécution :

ps aux | grep jboss.home.dir

Pour effectuer l'analyse, exécutez la commande suivante :

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

Remplacez les éléments suivants :

  • PATH_TO_COPIED_FILESYSTEM : chemin d'accès au répertoire du système de fichiers copié.
  • ANALYSIS_OUTPUT_PATH : chemin d'accès au dossier dans lequel vous souhaitez créer la sortie de l'analyse.
  • PATH_TO_JBOSS_HOME : chemin d'accès à l'installation de JBoss

Une fois l'analyse terminée, un nouveau répertoire est créé dans le chemin de sortie spécifié et contient le plan de migration, config.yaml.

Créer un plan de migration pour les charges de travail Apache

Pour effectuer l'analyse, exécutez la commande suivante :

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

Remplacez les éléments suivants :

  • PATH_TO_COPIED_FILESYSTEM : chemin d'accès au répertoire du système de fichiers copié.
  • ANALYSIS_OUTPUT_PATH : chemin d'accès au dossier dans lequel vous souhaitez créer la sortie de l'analyse.

Une fois l'analyse terminée, un nouveau répertoire est créé dans le chemin de sortie spécifié et contient le plan de migration, config.yaml.

Créer un plan de migration pour les charges de travail WordPress

Pour effectuer l'analyse, exécutez la commande suivante :

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

Remplacez les éléments suivants :

  • PATH_TO_COPIED_FILESYSTEM : chemin d'accès au répertoire du système de fichiers copié.
  • ANALYSIS_OUTPUT_PATH : chemin d'accès au dossier dans lequel vous souhaitez créer la sortie de l'analyse.

Une fois l'analyse terminée, un nouveau répertoire est créé dans le chemin de sortie spécifié et contient le plan de migration, config.yaml.

Créer un plan de migration pour les services Windows IIS

Pour effectuer l'analyse, exécutez la commande suivante :

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

Remplacez les éléments suivants :

  • PATH_TO_IMAGE : chemin d'accès à l'image disque de la machine source. Vous pouvez spécifier plusieurs images disque à la fois à l'aide de plusieurs options -s. Exemple : -s PATH_TO_IMAGE_1 -s PATH_TO_IMAGE_2...-s PATH_TO_IMAGE_N.
  • ANALYSIS_OUTPUT_PATH : chemin d'accès au dossier dans lequel doit être créée la sortie de l'analyse

Une fois l'analyse terminée, un nouveau répertoire est créé dans le chemin de sortie spécifié et contient le plan de migration, config.yaml.

Étapes suivantes