Criar um plano de migração

Depois de criar uma cópia do sistema de arquivos da máquina de origem na máquina local, a próxima etapa é analisar o sistema de arquivos para preparar um plano de migração. O plano de migração pode ser usado para gerar artefatos de migração.

Nesta página, descrevemos as etapas necessárias para preparar um plano de migração para diferentes cargas de trabalho.

Criar um plano de migração para um contêiner de VM do Linux

Para executar a análise, execute o seguinte 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 ]

Substitua:

  • PATH_TO_COPIED_FILESYSTEM: o caminho para o diretório do sistema de arquivos copiado.
  • ANALYSIS_OUTPUT_PATH: o caminho para a pasta onde você quer que a saída de análise seja criada.
  • SKIP_SIZE_CHECKS: este é um parâmetro opcional. Por padrão, ele é definido como false e a CLI do Migrate to Containers verifica as camadas da imagem para garantir que o tamanho não exceda 15 GB. Se o tamanho total das camadas de imagem exceder 15 GB, a geração do artefato falhará e a CLI do Migrate to Containers exibirá uma mensagem de erro. Para pular essa verificação de tamanho, defina o parâmetro como true.
  • SIZE_IN_MB: este é um parâmetro opcional. Especifique um limite de tamanho de arquivo, em MB, para verificar a existência de arquivos que excedam um tamanho específico. Quando a CLI do Migrate to Containers detecta um arquivo com tamanho maior que o limite de tamanho especificado, ela adiciona um comentário no plano de migração gerado com uma sugestão para excluir o arquivo detectado da imagem de contêiner.

Depois que a análise é concluída, um novo diretório é criado no caminho de saída especificado que contém o plano de migração, config.yaml.

Criar um plano de migração para cargas de trabalho do Tomcat

Para componentes do app Tomcat, esse processo requer os caminhos catalina-home e catalina-base como entradas.

Para recuperar esses valores, verifique o processo do servidor Tomcat em execução:

ps aux | grep catalina

Para executar a análise, execute o seguinte 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

Substitua:

  • PATH_TO_COPIED_FILESYSTEM: o caminho para o diretório do sistema de arquivos copiado
  • ANALYSIS_OUTPUT_PATH: o caminho para a pasta em que você quer que a saída de análise seja criada
  • PATH_TO_CATALINA_HOME: caminho para a raiz da instalação do Tomcat
  • PATH_TO_CATALINA_BASE: caminho para a raiz da configuração de ambiente de execução da instância do Tomcat que você está migrando. Várias bases precisam ser separadas por dois pontos
  • JAVA_VERSION: versão do Java do contêiner no formato X.Y. A versão padrão do Java é 11.0.

Depois que a análise é concluída, um novo diretório é criado no caminho de saída especificado que contém o plano de migração, config.yaml.

Criar um plano de migração para cargas de trabalho da WebSphere

Opcional: configurar o binaryAppScanner.jar

Se você quiser migrar cargas de trabalho tradicionais do WebSphere ou realizar uma migração entre diferentes ambientes Java, configure o binaryAppScanner.jar. A CLI do Migrate to Containers automatiza o uso do binaryAppScanner.jar para gerar novas configurações do WebSphere e facilitar a modernização do ambiente de execução do Java.

Para configurar binaryAppScanner.jar:

  1. Faça o download do arquivo instalador, binaryAppScannerInstaller.jar, pelo Suporte da IBM. Você precisa aceitar o contrato de licença como parte do download.

  2. Extraia o arquivo binaryAppScanner.jar e aceite o contrato de licença:

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

    Substitua:

    • INSTALL_LOCATION: o diretório de destino para extração. Por exemplo, se você especificar /tmp como o diretório de destino, depois que a instalação for concluída, binaryAppScanner.jar estará disponível em /tmp/wamt/binaryAppScanner.jar.

Realize a análise

Para executar a análise, execute o seguinte 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

Substitua:

  • PATH_TO_COPIED_FILESYSTEM: o caminho para o diretório do sistema de arquivos copiado.
  • ANALYSIS_OUTPUT_PATH: o caminho para a pasta onde você quer que a saída de análise seja criada.
  • WEBSPHERE_PROFILE: este é um parâmetro opcional. Especifique o perfil do WebSphere usado na VM de origem. Formato: [Liberty|Tradicional].
  • WEBSPHERE_HOME: este é um parâmetro opcional. Especifique o caminho para a instalação do servidor de aplicativos na VM de origem.
  • WEBSPHERE_JAVA_HOME: este é um parâmetro opcional. Especifique o caminho para a instalação do Java na VM de origem.
  • TARGET_PROFILE: este é um parâmetro opcional. Especifique o perfil do WebSphere a ser usado no contêiner de destino. Formato: [Liberty|Tradicional]. O padrão é o perfil de origem.
  • TARGET_VERSION: este é um parâmetro opcional. Especifique a versão do WebSphere a ser usada no contêiner de destino. O padrão é a versão da origem.
  • TARGET_EDITION: este é um parâmetro opcional. Especifique a edição do WebSphere a ser usada no contêiner de destino. Formato: [Base|Core|Open|ND]. O padrão é a edição de origem.
  • TARGET_SE: este é um parâmetro opcional. Especifique a versão do Java SE a ser usada no contêiner de destino. Formato: [SE8|SE11|SE17]. O padrão é o Java SE de origem.
  • TARGET_EE: este é um parâmetro opcional. Especifique a versão do Java EE ou de Jakarta EE a ser usada no contêiner de destino. Formato: [EE7|EE8|EE9|EE10]. O padrão é o Java EE ou o Jakarta EE de origem.
  • TARGET_VENDOR: este é um parâmetro opcional. Especifique o fornecedor do Java a ser usado no contêiner de destino. Formato: [IBM Corporation|Oracle Corporation]. O padrão é o fornecedor Java de origem.
  • TARGET_BASE_IMAGE: este é um parâmetro opcional. Especifique uma imagem base a ser usada no contêiner de destino.
  • PATH_TO_BINARYAPPSCANNER: este é um parâmetro opcional. Especifique o caminho para o arquivo binaryAppScanner.jar na sua máquina local.

Depois que a análise é concluída, um novo diretório é criado no caminho de saída especificado que contém o plano de migração, config.yaml.

Criar um plano de migração para cargas de trabalho do WebSphere tradicional

Configurar o binaryAppScanner.jar

Faça o download da versão mais recente do arquivo binaryAppScanner.jar.

Se você já instalou o arquivo binaryAppScanner.jar, verifique a versão atual:

java -jar binaryAppScanner.jar --version

Em seguida, compare a versão atual com a versão exibida na licença da IBM que aparece quando você clica em Kit de ferramentas de migração para binários de aplicativos para fazer o download do arquivo. Se eles forem diferentes, faça o download da versão mais recente do arquivo binaryAppScanner.jar.

A CLI do Migrate to Containers automatiza o uso do binaryAppScanner.jar, disponível como parte do Kit de ferramentas de migração do servidor de aplicativos IBM WebSphere para binários do aplicativo, para extrair informações e arquivos de configuração do WebSphere Aplicativos do Servidor de aplicativos na VM de origem.

Antes de fazer uma migração, aceite o contrato de licença e faça o download do Kit de ferramentas de migração do servidor de aplicativos IBM WebSphere para binários de aplicativo e, em seguida, extraia o arquivo binaryAppScanner.jar.

Para configurar binaryAppScanner.jar:

  1. Faça o download do arquivo instalador, binaryAppScannerInstaller.jar, pelo Suporte da IBM. Você precisa aceitar o contrato de licença como parte do download.

  2. Execute o seguinte comando para extrair o arquivo binaryAppScanner.jar e aceitar o Contrato de Licença:

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

  3. Especifique o diretório de destino para a extração. Por exemplo, se você especificar /tmp como o diretório de destino, depois que a instalação for concluída, binaryAppScanner.jar estará disponível em /tmp/wamt/binaryAppScanner.jar.

Recuperar WAS_HOME

A variável de ambiente WAS_HOME especifica onde o WebSphere Application Server tradicional está instalado, como /opt/IBM/WebSphere/AppServer/. A CLI do Migrate to Containers usa esse valor para localizar e analisar corretamente a configuração do WebSphere tradicional.

Para recuperar esse valor, verifique o processo do WebSphere Application Server tradicional em execução:

ps aux | grep WAS_HOME

Executar a análise

Para executar a análise, execute o seguinte 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

Substitua:

  • PATH_TO_COPIED_FILESYSTEM: o caminho para o diretório do sistema de arquivos copiado.
  • ANALYSIS_OUTPUT_PATH: o caminho para a pasta onde você quer que a saída de análise seja criada.
  • PATH_TO_WAS_HOME: caminho para a instalação do WebSphere Application Server tradicional.
  • PATH_TO_BINARYAPPSCANNER: caminho para o arquivo binaryAppScanner.jar. Por exemplo, se você especificou /tmp como o diretório de destino, binaryAppScanner.jar está disponível em /tmp/wamt/binaryAppScanner.jar.

Depois que a análise é concluída, um novo diretório é criado no caminho de saída especificado que contém o plano de migração, config.yaml.

Criar um plano de migração para cargas de trabalho do JBoss

Para componentes do aplicativo JBoss, a criação de um plano de migração requer a variável JBOSS_HOME como entrada.

Para recuperar esse valor, verifique o processo do servidor JBoss em execução:

ps aux | grep jboss.home.dir

Para executar a análise, execute o seguinte comando:

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

Substitua:

  • PATH_TO_COPIED_FILESYSTEM: o caminho para o diretório do sistema de arquivos copiado
  • ANALYSIS_OUTPUT_PATH: o caminho para a pasta em que você quer que a saída de análise seja criada
  • PATH_TO_JBOSS_HOME: caminho para a instalação do JBoss

Depois que a análise é concluída, um novo diretório é criado no caminho de saída especificado que contém o plano de migração, config.yaml.

Criar um plano de migração para cargas de trabalho do Apache

Para executar a análise, execute o seguinte comando:

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

Substitua:

  • PATH_TO_COPIED_FILESYSTEM: o caminho para o diretório do sistema de arquivos copiado
  • ANALYSIS_OUTPUT_PATH: o caminho para a pasta em que você quer que a saída de análise seja criada

Depois que a análise é concluída, um novo diretório é criado no caminho de saída especificado que contém o plano de migração, config.yaml.

Criar um plano de migração para cargas de trabalho do WordPress

Para executar a análise, execute o seguinte comando:

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

Substitua:

  • PATH_TO_COPIED_FILESYSTEM: o caminho para o diretório do sistema de arquivos copiado
  • ANALYSIS_OUTPUT_PATH: o caminho para a pasta em que você quer que a saída de análise seja criada

Depois que a análise é concluída, um novo diretório é criado no caminho de saída especificado que contém o plano de migração, config.yaml.

Criar um plano de migração para serviços IIS do Windows

Para executar a análise, execute o seguinte comando:

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

Substitua:

  • PATH_TO_IMAGE: o caminho para a imagem do disco da máquina de origem. É possível especificar mais de uma imagem do disco por vez usando várias flags -s. Por exemplo, -s PATH_TO_IMAGE_1 -s PATH_TO_IMAGE_2...-s PATH_TO_IMAGE_N.
  • ANALYSIS_OUTPUT_PATH: o caminho para a pasta onde você quer que a saída de análise seja criada.

Depois que a análise é concluída, um novo diretório é criado no caminho de saída especificado que contém o plano de migração, config.yaml.

A seguir