Crea un plan de migración

Después de crear una copia del sistema de archivos de la máquina de origen en tu máquina 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 a fin de preparar un plan de migración para diferentes cargas de trabajo.

Crea un plan de migración para un contenedor de VMs de 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 ]

Reemplaza lo siguiente:

PATH_TO_COPIED_FILESYSTEM: Es la ruta de acceso al directorio del sistema de archivos copiado.
ANALYSIS_OUTPUT_PATH: la ruta de acceso a la carpeta en la que deseas que se cree el resultado del análisis.
SKIP_SIZE_CHECKS: este es un parámetro opcional. De forma predeterminada, se establece en false y la CLI de Migrate to Containers verifica las capas de imágenes para garantizar que el tamaño no supere los 15 GB. Si el tamaño total de las capas de la imagen supera los 15 GB, la generación de artefactos falla y la CLI de Migrate to Containers muestra un mensaje de error. Para omitir esta verificación de tamaño, establece este parámetro en true.
SIZE_IN_MB: este es un parámetro opcional. Especifica un límite de tamaño de archivo, en MB, para verificar los archivos que superan un tamaño específico. Si la CLI de Migrate to Containers detecta un archivo con un tamaño que supera el umbral de tamaño especificado, la CLI de Migrate to Containers agrega un comentario en el plan de migración generado con una sugerencia para excluir el archivo detectado del imagen de contenedor.

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

Crea un plan de migración para las cargas de trabajo de Tomcat

Para los componentes de la app de Tomcat, este proceso requiere las rutas catalina-home y catalina-base como entradas.

Para recuperar estos valores, verifica el proceso del servidor de 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

Reemplaza lo siguiente:

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

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

Crea un plan de migración para las cargas de trabajo de WebSphere

Opcional: Configura el objeto binaryAppScanner.jar

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

Para configurar binaryAppScanner.jar, haz lo siguiente:

Descarga el archivo de instalación, binaryAppScannerInstaller.jar, de Asistencia de IBM. Debes aceptar el contrato de licencia como parte de la descarga.
Extrae el archivo binaryAppScanner.jar y acepta el contrato de licencia:
```
java -jar binaryAppScannerInstaller.jar --acceptLicense --verbose INSTALL_LOCATION
```
Reemplaza lo siguiente:
- INSTALL_LOCATION: el directorio de destino para la extracción. Por ejemplo, si especificas /tmp como directorio de destino, después de que se complete la instalación, binaryAppScanner.jar estará disponible en /tmp/wamt/binaryAppScanner.jar.

Realiza 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

Reemplaza lo siguiente:

PATH_TO_COPIED_FILESYSTEM: la ruta de acceso al directorio del sistema de archivos copiado.
ANALYSIS_OUTPUT_PATH: la ruta de acceso a la carpeta en la que deseas 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|Tradicional].
WEBSPHERE_HOME: este es un parámetro opcional. Especifica la ruta de acceso a la instalación del servidor de aplicaciones en la VM de origen.
WEBSPHERE_JAVA_HOME: este es un parámetro opcional. Especifica la ruta de acceso a la instalación de Java en la VM de origen.
TARGET_PROFILE: este es un parámetro opcional. Especifica el perfil de WebSphere que se usará en el contenedor de destino. Formato: [Liberty|Tradicional]. La configuración predeterminada es el perfil de origen.
TARGET_VERSION: este es un parámetro opcional. Especifica la versión de WebSphere que se 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 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 usará en el contenedor de destino. Formato: [SE8|SE11|SE17]. La configuración predeterminada es Java SE de origen.
TARGET_EE: este es un parámetro opcional. Especifica la versión de Java EE o Yakarta EE para usarla en el contenedor de destino. Formato: [EE7|EE8|EE9|EE10]. La configuración predeterminada es Java EE o Yakarta EE de origen.
TARGET_VENDOR: este es un parámetro opcional. Especifica el proveedor de Java que se usará en el contenedor de destino. Formato: [IBM Corporation|Oracle Corporation]. La configuración predeterminada es el proveedor de origen de Java.
TARGET_BASE_IMAGE: este es un parámetro opcional. Especifica una imagen base para usar en el contenedor de destino.
PATH_TO_BINARYAPPSCANNER: este es un parámetro opcional. Especifica la ruta de acceso al archivo binaryAppScanner.jar en tu máquina local.

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

Crea un plan de migración para las cargas de trabajo tradicionales de WebSphere

Configura el binarioAppScanner.jar

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

Si ya instalaste el archivo binaryAppScanner.jar, verifica la versión actual:

java -jar binaryAppScanner.jar --version

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

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

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

Para configurar binaryAppScanner.jar:

Descarga el archivo de instalación, binaryAppScannerInstaller.jar, de Asistencia de IBM. Debes aceptar el contrato de licencia como parte de la descarga.
Ejecuta el siguiente comando para extraer el archivo binaryAppScanner.jar y aceptar el contrato de licencia:
```
java -jar binaryAppScannerInstaller.jar --acceptLicense --verbose
```
Especifica el directorio de destino para la extracción. Por ejemplo, si especificas /tmp como directorio de destino, después de que se complete la instalación, binaryAppScanner.jar estará disponible en /tmp/wamt/binaryAppScanner.jar.

Recupera `WAS_HOME`

La variable de entorno WAS_HOME especifica dónde se instala WebSphere Application Server tradicional, como /opt/IBM/WebSphere/AppServer/. La CLI de Migrate to Containers usa este valor para ubicar y analizar de forma correcta la configuración tradicional de WebSphere.

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

ps aux | grep WAS_HOME

Ejecuta 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

Reemplaza lo siguiente:

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

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

Crea un plan de migración para las cargas de trabajo de JBoss

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

Para recuperar este valor, verifica 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

Reemplaza lo siguiente:

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

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

Crea un plan de migración para las 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

Reemplaza lo siguiente:

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

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

Crea un plan de migración para las 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

Reemplaza lo siguiente:

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

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

Crea un plan de migración para los servicios de 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

Reemplaza lo siguiente:

PATH_TO_IMAGE: la ruta de acceso a la imagen de disco de la máquina de origen. Puedes especificar más de una imagen de disco a la vez con 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 de acceso a la carpeta en la que deseas que se cree el resultado del análisis.

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

¿Qué sigue?

Aprende a personalizar el plan de migración para lo siguiente:

Crea un plan de migración

Crea un plan de migración para un contenedor de VMs de Linux

Crea un plan de migración para las cargas de trabajo de Tomcat

Crea un plan de migración para las cargas de trabajo de WebSphere

Opcional: Configura el objeto binaryAppScanner.jar

Realiza el análisis

Crea un plan de migración para las cargas de trabajo tradicionales de WebSphere

Configura el binarioAppScanner.jar

Recupera WAS_HOME

Ejecuta el análisis

Crea un plan de migración para las cargas de trabajo de JBoss

Crea un plan de migración para las cargas de trabajo de Apache

Crea un plan de migración para las cargas de trabajo de WordPress

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

¿Qué sigue?

Recupera `WAS_HOME`