Crear un plan de migración

Después de crear una copia del sistema de archivos del equipo de origen en tu equipo local, el siguiente paso es analizar el sistema de archivos para preparar un plan de migración. El plan de migración se puede usar para generar artefactos de migración.

En esta página se describen los pasos necesarios para preparar un plan de migración para diferentes cargas de trabajo.

Crear un plan de migración para un contenedor de una VM Linux

Para realizar el análisis, ejecuta el siguiente comando:

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

Haz los cambios siguientes:

  • PATH_TO_COPIED_FILESYSTEM: la ruta al directorio del sistema de archivos copiado.
  • ANALYSIS_OUTPUT_PATH: la ruta a la carpeta en la que quieres que se cree el resultado del análisis.
  • SKIP_SIZE_CHECKS: este es un parámetro opcional. De forma predeterminada, este valor es false y la CLI de Migrate to Containers comprueba las capas de la imagen para asegurarse de que el tamaño no supere los 15 GB. Si el tamaño total de las capas de la imagen supera los 15 GB, se producirá un error en la generación del artefacto y la CLI de Migrate to Containers mostrará un mensaje de error. Para omitir esta comprobación del tamaño, asigna el valor true a este parámetro.
  • SIZE_IN_MB: este es un parámetro opcional. Especifica un umbral de tamaño de archivo, en MB, para buscar archivos que superen un tamaño específico. Si la CLI de Migrate to Containers detecta un archivo cuyo tamaño supera el umbral especificado, añade un comentario al plan de migración generado con una sugerencia para excluir el archivo detectado de la imagen del contenedor.

Una vez finalizado el análisis, se crea un directorio en la ruta de salida especificada que contiene el plan de migración, config.yaml.

Crear un plan de migración para cargas de trabajo de Tomcat

En el caso de los componentes de aplicaciones de Tomcat, este proceso requiere las rutas catalina-home y catalina-base como entradas.

Para obtener estos valores, comprueba el proceso del servidor Tomcat en ejecución:

ps aux | grep catalina

Para realizar el análisis, ejecuta el siguiente comando:

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

Haz los cambios siguientes:

  • PATH_TO_COPIED_FILESYSTEM: la ruta al directorio del sistema de archivos copiado
  • ANALYSIS_OUTPUT_PATH: la ruta a la carpeta en la que quieres que se cree el resultado del análisis
  • PATH_TO_CATALINA_HOME: ruta a la raíz de la instalación de Tomcat
  • PATH_TO_CATALINA_BASE: ruta a la raíz de la configuración del tiempo de ejecución de la instancia de Tomcat que vas a migrar. Si hay varias bases, deben separarse con dos puntos.
  • JAVA_VERSION: versión de Java del contenedor en formato X.Y. La versión predeterminada de Java es 11.0.

Una vez finalizado el análisis, se crea un directorio en la ruta de salida especificada que contiene el plan de migración, config.yaml.

Crear un plan de migración para cargas de trabajo de WebSphere

Opcional: Configurar binaryAppScanner.jar

Si quieres migrar cargas de trabajo tradicionales de WebSphere o realizar una migración entre diferentes entornos de Java, puedes configurar el binaryAppScanner.jar. La CLI de Migrate to Containers automatiza el uso de binaryAppScanner.jar para generar nuevas configuraciones de WebSphere y facilitar la modernización del tiempo de ejecución de Java.

Para configurar el binaryAppScanner.jar, sigue estos pasos:

  1. Descarga el archivo del instalador, binaryAppScannerInstaller.jar, desde Soporte de IBM. Debes aceptar el contrato de licencia como parte de la descarga.

  2. Extrae el archivo binaryAppScanner.jar y acepta el contrato de licencia:

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

    Haz los cambios siguientes:

    • INSTALL_LOCATION: el directorio de destino de la extracción. Por ejemplo, si especificas /tmp como directorio de destino, una vez que se haya completado la instalación, binaryAppScanner.jar estará disponible en /tmp/wamt/binaryAppScanner.jar.

Realizar el análisis

Para realizar el análisis, ejecuta el siguiente comando:

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

Haz los cambios siguientes:

  • PATH_TO_COPIED_FILESYSTEM: la ruta al archivo copiado directorio del sistema.
  • ANALYSIS_OUTPUT_PATH: la ruta a la carpeta en la que quieres que se cree el resultado del análisis.
  • WEBSPHERE_PROFILE: este es un parámetro opcional. Especifica el perfil de WebSphere que se usa en la VM de origen. Formato: [Liberty|Traditional].
  • WEBSPHERE_HOME: este es un parámetro opcional. Especifica la ruta de instalación del servidor de aplicaciones en la VM de origen.
  • WEBSPHERE_JAVA_HOME: este es un parámetro opcional. Especifica la ruta de la instalación de Java en la VM de origen.
  • TARGET_PROFILE: este es un parámetro opcional. Especifique el perfil de WebSphere que se va a usar en el contenedor de destino. Formato: [Liberty|Traditional]. El valor predeterminado es el perfil de origen.
  • TARGET_VERSION: este es un parámetro opcional. Especifica la versión de WebSphere que se va a usar en el contenedor de destino. El valor predeterminado es la versión de origen.
  • TARGET_EDITION: este es un parámetro opcional. Especifica la edición de WebSphere que se va a usar en el contenedor de destino. Formato: [Base|Core|Open|ND]. El valor predeterminado es la edición de origen.
  • TARGET_SE: este es un parámetro opcional. Especifica la versión de Java SE que se va a usar en el contenedor de destino. Formato: [SE8|SE11|SE17]. El valor predeterminado es la versión de Java SE de origen.
  • TARGET_EE: este es un parámetro opcional. Especifica la versión de Java EE o Jakarta EE que se va a usar en el contenedor de destino. Formato: [EE7|EE8|EE9|EE10]. El valor predeterminado es el Java EE o Jakarta EE de origen.
  • TARGET_VENDOR: este es un parámetro opcional. Especifica el proveedor de Java que se va a usar en el contenedor de destino. Formato: [IBM Corporation|Oracle Corporation]. El valor predeterminado es el proveedor de Java de origen.
  • TARGET_BASE_IMAGE: este es un parámetro opcional. Especifica una imagen base que se usará para el contenedor de destino.
  • PATH_TO_BINARYAPPSCANNER: este es un parámetro opcional. Especifica la ruta del archivo binaryAppScanner.jar en tu equipo local.

Una vez finalizado el análisis, se crea un directorio en la ruta de salida especificada que contiene el plan de migración, config.yaml.

Crear un plan de migración para cargas de trabajo tradicionales de WebSphere

.

Configurar binaryAppScanner.jar

Descarga la versión más reciente del archivo binaryAppScanner.jar.

Si ya has instalado el archivo binaryAppScanner.jar, comprueba la versión actual:

java -jar binaryAppScanner.jar --version

A continuación, compara tu versión actual con la que se muestra en la licencia de IBM que aparece cuando haces clic en Migration Toolkit for Application Binaries para descargar el archivo. Si no coinciden, descarga la versión más reciente del archivo binaryAppScanner.jar.

La CLI de Migrate to Containers automatiza el uso de binaryAppScanner.jar, disponible como parte del IBM WebSphere Application Server Migration Toolkit for Application Binaries, para extraer información de configuración y archivos de las aplicaciones de WebSphere Application Server en la VM de origen.

Antes de poder realizar una migración, debes aceptar el contrato de licencia y descargar el IBM WebSphere Application Server Migration Toolkit for Application Binaries. A continuación, extrae el archivo binaryAppScanner.jar.

Para configurar binaryAppScanner.jar, sigue estos pasos:

  1. Descarga el archivo del instalador, binaryAppScannerInstaller.jar, desde Soporte de IBM. Debes aceptar el contrato de licencia como parte de la descarga.

  2. Ejecuta el siguiente comando para extraer el archivo binaryAppScanner.jar y aceptar el acuerdo de licencia:

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

  3. Especifica el directorio de destino de la extracción. Por ejemplo, si especificas /tmp como directorio de destino, una vez que se haya completado la instalación, binaryAppScanner.jar estará disponible en /tmp/wamt/binaryAppScanner.jar.

Recuperar WAS_HOME

La variable de entorno WAS_HOME especifica dónde está instalado WebSphere Application Server tradicional, como /opt/IBM/WebSphere/AppServer/. La CLI de Migrate to Containers usa este valor para localizar y analizar correctamente la configuración tradicional de WebSphere.

Para obtener este valor, comprueba el proceso de WebSphere Application Server tradicional en ejecución:

ps aux | grep WAS_HOME

Generar el análisis

Para realizar el análisis, ejecuta el siguiente comando:

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

Haz los cambios siguientes:

  • PATH_TO_COPIED_FILESYSTEM: la ruta al directorio del sistema de archivos copiado.
  • ANALYSIS_OUTPUT_PATH: la ruta a la carpeta en la que quieres que se cree el resultado del análisis.
  • PATH_TO_WAS_HOME: ruta de acceso a la instalación tradicional de WebSphere Application Server.
  • PATH_TO_BINARYAPPSCANNER: ruta al archivo binaryAppScanner.jar. Por ejemplo, si has especificado /tmp como directorio de destino, binaryAppScanner.jar estará disponible en /tmp/wamt/binaryAppScanner.jar.

Una vez finalizado el análisis, se crea un directorio en la ruta de salida especificada que contiene el plan de migración, config.yaml.

Crear un plan de migración para cargas de trabajo de JBoss

Para los componentes de aplicaciones JBoss, crear un plan de migración requiere la variable JBOSS_HOME como entrada.

Para obtener este valor, comprueba el proceso del servidor JBoss en ejecución:

ps aux | grep jboss.home.dir

Para realizar el análisis, ejecuta el siguiente comando:

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

Haz los cambios siguientes:

  • PATH_TO_COPIED_FILESYSTEM: la ruta al directorio del sistema de archivos copiado
  • ANALYSIS_OUTPUT_PATH: la ruta a la carpeta en la que quieres que se cree el resultado del análisis
  • PATH_TO_JBOSS_HOME: ruta a la instalación de JBoss

Una vez finalizado el análisis, se crea un directorio en la ruta de salida especificada que contiene el plan de migración, config.yaml.

Crear un plan de migración para cargas de trabajo de Apache

Para realizar el análisis, ejecuta el siguiente comando:

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

Haz los cambios siguientes:

  • PATH_TO_COPIED_FILESYSTEM: la ruta al directorio del sistema de archivos copiado
  • ANALYSIS_OUTPUT_PATH: la ruta a la carpeta en la que quieres que se cree el resultado del análisis

Una vez finalizado el análisis, se crea un directorio en la ruta de salida especificada que contiene el plan de migración, config.yaml.

Crear un plan de migración para cargas de trabajo de WordPress

Para realizar el análisis, ejecuta el siguiente comando:

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

Haz los cambios siguientes:

  • PATH_TO_COPIED_FILESYSTEM: la ruta al directorio del sistema de archivos copiado
  • ANALYSIS_OUTPUT_PATH: la ruta a la carpeta en la que quieres que se cree el resultado del análisis

Una vez finalizado el análisis, se crea un directorio en la ruta de salida especificada que contiene el plan de migración, config.yaml.

Crear un plan de migración para los servicios IIS de Windows

Para realizar el análisis, ejecuta el siguiente comando:

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

Haz los cambios siguientes:

  • PATH_TO_IMAGE: ruta a la imagen del disco de la máquina de origen. Puedes especificar más de una imagen de disco a la vez usando varias marcas -s. Por ejemplo, -s PATH_TO_IMAGE_1 -s PATH_TO_IMAGE_2...-s PATH_TO_IMAGE_N.
  • ANALYSIS_OUTPUT_PATH: la ruta a la carpeta en la que quieres que se cree el resultado del análisis.

Una vez finalizado el análisis, se crea un directorio en la ruta de salida especificada que contiene el plan de migración, config.yaml.

Siguientes pasos