Crie um plano de migração

Depois de criar uma cópia do sistema de ficheiros da máquina de origem na sua máquina local, o passo seguinte é analisar o sistema de ficheiros para preparar um plano de migração. Em seguida, pode usar o plano de migração para gerar artefactos de migração.

Esta página descreve os passos necessários para preparar um plano de migração para diferentes cargas de trabalho.

Crie um plano de migração para um contentor de VM do Linux

Para realizar 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 o seguinte:

  • PATH_TO_COPIED_FILESYSTEM: o caminho para o diretório do sistema de ficheiros copiado.
  • ANALYSIS_OUTPUT_PATH: o caminho para a pasta onde quer que o resultado da análise seja criado.
  • SKIP_SIZE_CHECKS: este é um parâmetro opcional. Por predefinição, esta opção está definida como false e o Migrate to Containers CLI verifica as camadas de imagem para garantir que o tamanho não excede 15 GB. Se o tamanho total das camadas de imagens exceder 15 GB, a geração de artefactos falha e a CLI Migrate to Containers apresenta uma mensagem de erro. Para ignorar esta verificação de tamanho, defina este parâmetro como true.
  • SIZE_IN_MB: este é um parâmetro opcional. Especifique um limite de tamanho do ficheiro, em MB, para verificar se existem ficheiros que excedem um tamanho específico. Se a Migrate to Containers CLI detetar um ficheiro com um tamanho que exceda o limite de tamanho especificado, adiciona um comentário no plano de migração gerado com uma sugestão para excluir o ficheiro detetado da imagem do contentor.

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

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

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

Para obter estes valores, verifique o processo do servidor Tomcat em execução:

ps aux | grep catalina

Para realizar 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 o seguinte:

  • PATH_TO_COPIED_FILESYSTEM: o caminho para o diretório do sistema de ficheiros copiado
  • ANALYSIS_OUTPUT_PATH: o caminho para a pasta onde quer que o resultado da análise seja criado
  • 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 tempo de execução da instância do Tomcat que está a migrar. As várias bases devem ser separadas com dois pontos
  • JAVA_VERSION: versão Java do contentor no formato X.Y. A versão predefinida do Java é 11.0.

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

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

Opcional: configure o binaryAppScanner.jar

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

Para configurar o binaryAppScanner.jar:

  1. Transfira o ficheiro do instalador, binaryAppScannerInstaller.jar, a partir do apoio técnico da IBM. Tem de aceitar o contrato de licença como parte da transferência.

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

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

    Substitua o seguinte:

    • INSTALL_LOCATION: o diretório de destino para a extração. Por exemplo, se especificar /tmp como o diretório de destino, após a conclusão da instalação, binaryAppScanner.jar está disponível em /tmp/wamt/binaryAppScanner.jar.

Faça a análise

Para realizar 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 o seguinte:

  • PATH_TO_COPIED_FILESYSTEM: o caminho para o diretório do sistema do ficheiro copiado.
  • ANALYSIS_OUTPUT_PATH: o caminho para a pasta onde quer que o resultado da análise seja criado.
  • WEBSPHERE_PROFILE: este é um parâmetro opcional. Especifique o perfil do WebSphere usado na VM de origem. Formato: [Liberty|Traditional].
  • WEBSPHERE_HOME: este é um parâmetro opcional. Especifique o caminho para a instalação do servidor de aplicações 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 usar no contentor de destino. Formato: [Liberty|Traditional]. A predefinição é o perfil de origem.
  • TARGET_VERSION: este é um parâmetro opcional. Especifique a versão do WebSphere a usar no contentor de destino. A predefinição é a versão de origem.
  • TARGET_EDITION: este é um parâmetro opcional. Especifique a edição do WebSphere a usar no contentor de destino. Formato: [Base|Core|Open|ND]. A predefinição é a edição de origem.
  • TARGET_SE: este é um parâmetro opcional. Especifique a versão do Java SE a usar no contentor de destino. Formato: [SE8|SE11|SE17]. A predefinição é a origem Java SE.
  • TARGET_EE: este é um parâmetro opcional. Especifique a versão Java EE ou Jakarta EE a usar no contentor de destino. Formato: [EE7|EE8|EE9|EE10]. A predefinição é a origem Java EE ou Jakarta EE.
  • TARGET_VENDOR: este é um parâmetro opcional. Especifique o fornecedor Java a usar no contentor de destino. Formato: [IBM Corporation|Oracle Corporation]. A predefinição é o fornecedor de Java de origem.
  • TARGET_BASE_IMAGE: este é um parâmetro opcional. Especifique uma imagem de base a usar para o contentor de destino.
  • PATH_TO_BINARYAPPSCANNER: este é um parâmetro opcional. Especifique o caminho para o ficheiro binaryAppScanner.jar na sua máquina local.

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

Crie um plano de migração para cargas de trabalho tradicionais do WebSphere

Configure o binaryAppScanner.jar

Transfira a versão mais recente do ficheiro binaryAppScanner.jar.

Se já tiver instalado o ficheiro binaryAppScanner.jar, verifique a versão atual:

java -jar binaryAppScanner.jar --version

Em seguida, compare a sua versão atual com a versão apresentada na licença da IBM que aparece quando clica em Migration Toolkit for Application Binaries para transferir o ficheiro. Se forem diferentes, transfira a versão mais recente do ficheiro binaryAppScanner.jar.

A CLI Migrate to Containers automatiza a utilização do binaryAppScanner.jar, disponível como parte do IBM WebSphere Application Server Migration Toolkit for Application Binaries, para extrair informações de configuração e ficheiros para aplicações do WebSphere Application Server na VM de origem.

Antes de poder efetuar uma migração, tem de aceitar o contrato de licença e transferir o IBM WebSphere Application Server Migration Toolkit for Application Binaries e, em seguida, extrair o ficheiro binaryAppScanner.jar.

Para configurar o binaryAppScanner.jar:

  1. Transfira o ficheiro do instalador, binaryAppScannerInstaller.jar, a partir do apoio técnico da IBM. Tem de aceitar o contrato de licença como parte da transferência.

  2. Execute o seguinte comando para extrair o ficheiro 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 especificar /tmp como o diretório de destino, após a conclusão da instalação, binaryAppScanner.jar está 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 migração para a CLI Containers usa este valor para localizar e analisar corretamente a configuração tradicional do WebSphere.

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

ps aux | grep WAS_HOME

Execute a análise

Para realizar 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 o seguinte:

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

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

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

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

Para obter este valor, verifique o processo do servidor JBoss em execução:

ps aux | grep jboss.home.dir

Para realizar 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 o seguinte:

  • PATH_TO_COPIED_FILESYSTEM: o caminho para o diretório do sistema de ficheiros copiado
  • ANALYSIS_OUTPUT_PATH: o caminho para a pasta onde quer que o resultado da análise seja criado
  • PATH_TO_JBOSS_HOME: caminho para a instalação do JBoss

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

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

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

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

Substitua o seguinte:

  • PATH_TO_COPIED_FILESYSTEM: o caminho para o diretório do sistema de ficheiros copiado
  • ANALYSIS_OUTPUT_PATH: o caminho para a pasta onde quer que o resultado da análise seja criado

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

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

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

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

Substitua o seguinte:

  • PATH_TO_COPIED_FILESYSTEM: o caminho para o diretório do sistema de ficheiros copiado
  • ANALYSIS_OUTPUT_PATH: o caminho para a pasta onde quer que o resultado da análise seja criado

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

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

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

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

Substitua o seguinte:

  • PATH_TO_IMAGE: o caminho para a imagem do disco da máquina de origem. Pode especificar mais do que uma imagem de disco de cada vez através de 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 quer que o resultado da análise seja criado.

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

O que se segue?