Creare un piano di migrazione

Dopo aver creato una copia del file system della macchina di origine sul computer locale, il passaggio successivo consiste nell'analizzare il file system per preparare un piano di migrazione. La piano di migrazione può quindi essere utilizzato per generare artefatti di migrazione.

In questa pagina vengono descritti i passaggi necessari per preparare un piano di migrazione carichi di lavoro diversi.

Creare un piano di migrazione per un contenitore VM Linux

Per eseguire l'analisi, esegui questo 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 ]

Sostituisci quanto segue:

  • PATH_TO_COPIED_FILESYSTEM: il percorso del file system copiato .
  • ANALYSIS_OUTPUT_PATH: il percorso della cartella in cui da creare l'output dell'analisi.
  • SKIP_SIZE_CHECKS: questo è un parametro facoltativo. Per impostazione predefinita, questo parametro è impostato su false e l'interfaccia a riga di comando Migrate to Containers controlla l'immagine per garantire che la dimensione non superi i 15 GB. Se la dimensione totale dei livelli immagine supera i 15 GB, la generazione degli elementi non riesce e lo strumento a riga di comando Migrate to Containers visualizza un messaggio di errore. Per saltare controllo delle dimensioni, imposta questo parametro su true.
  • SIZE_IN_MB: questo è un parametro facoltativo. Specifica un valore soglia per le dimensioni del file, in MB, per verificare la presenza di file che superano una dimensioni specifiche. Se l'interfaccia a riga di comando Migrate to Containers rileva un file di dimensioni superiori alla soglia specificata, aggiunge un commento al piano di migrazione generato con un suggerimento per escludere il file rilevato dall'immagine del contenitore.

Al termine dell'analisi, viene creata una nuova directory nella percorso di output contenente il piano di migrazione config.yaml.

Crea un piano di migrazione per i carichi di lavoro Tomcat

Per i componenti dell'app Tomcat, questa procedura richiede catalina-home e catalina-base percorsi come input.

Per recuperare questi valori, controlla il processo del server Tomcat in esecuzione:

ps aux | grep catalina

Per eseguire l'analisi, esegui il seguente 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

Sostituisci quanto segue:

  • PATH_TO_COPIED_FILESYSTEM: il percorso del file system copiato directory
  • ANALYSIS_OUTPUT_PATH: il percorso della cartella in cui quando vogliamo creare l'output dell'analisi
  • PATH_TO_CATALINA_HOME: percorso della radice del tomcat installazione
  • PATH_TO_CATALINA_BASE: percorso della directory principale del runtime dell'istanza Tomcat di cui stai eseguendo la migrazione. Separa le diverse basi usando i due punti
  • JAVA_VERSION: versione Java del contenitore in X.Y formato. La versione predefinita di Java è 11.0.

Al termine dell'analisi, viene creata una nuova directory nella percorso di output contenente il piano di migrazione config.yaml.

Crea un piano di migrazione per i carichi di lavoro WebSphere

(Facoltativo) Configura il file binariAppScanner.jar

Se vuoi eseguire la migrazione dei carichi di lavoro tradizionali di WebSphere tra diversi ambienti Java, puoi configurare binaryAppScanner.jar. L'interfaccia a riga di comando Migrate to Containers automatizza l'utilizzo dell'binaryAppScanner.jar per generare nuove configurazioni WebSphere e facilitare la modernizzazione del runtime Java.

Per configurare binaryAppScanner.jar:

  1. Scarica il file del programma di installazione, binaryAppScannerInstaller.jar, da Assistenza IBM. Devi accettare il contratto di licenza nell'ambito del download.

  2. Estrai il file binaryAppScanner.jar e accetta il contratto di licenza:

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

    Sostituisci quanto segue:

    • INSTALL_LOCATION: la directory di destinazione per l'estrazione. Ad esempio, se specifichi /tmp come directory di destinazione, dopo il l'installazione è terminata, binaryAppScanner.jar è disponibile all'indirizzo /tmp/wamt/binaryAppScanner.jar.

Eseguire l'analisi

Per eseguire l'analisi, esegui questo 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

Sostituisci quanto segue:

  • PATH_TO_COPIED_FILESYSTEM: il percorso del file copiato nella directory di sistema.
  • ANALYSIS_OUTPUT_PATH: il percorso della cartella in cui da creare l'output dell'analisi.
  • WEBSPHERE_PROFILE: questo è un parametro facoltativo. Specifica il profilo WebSphere utilizzato nella VM di origine. Formato: [Liberty|Tradizionale].
  • WEBSPHERE_HOME: questo è un parametro facoltativo. Specifica il percorso dell'installazione del server delle applicazioni nella VM di origine.
  • WEBSPHERE_JAVA_HOME: questo è un parametro facoltativo. Specifica il percorso dell'installazione di Java nella VM di origine.
  • TARGET_PROFILE: questo è un parametro facoltativo. Specifica il profilo WebSphere da utilizzare nel contenitore di destinazione. Formato: [Liberty|Tradizionale]. Per impostazione predefinita è il profilo di origine.
  • TARGET_VERSION: questo è un parametro facoltativo. Specifica la versione WebSphere da utilizzare nel contenitore di destinazione. Il valore predefinito è la versione di origine.
  • TARGET_EDITION: questo è un parametro facoltativo. Specifica l'edizione WebSphere da utilizzare nel container di destinazione. Formato: [Base|Core|Open|ND]. Il valore predefinito è la versione di origine.
  • TARGET_SE: questo è un parametro facoltativo. Specifica la versione di Java SE da utilizzare nel container di destinazione. Formato: [SE8|SE11|SE17]. Il valore predefinito è Java SE di origine.
  • TARGET_EE: questo è un parametro facoltativo. Specifica la versione Java EE o Jakarta EE da utilizzare nel contenitore di destinazione. Formato: [EE7|EE8|EE9|EE10]. Il valore predefinito è Java EE o Giacarta EE di origine.
  • TARGET_VENDOR: questo è un parametro facoltativo. Specifica il fornitore Java da utilizzare nel container di destinazione. Formato: [IBM Corporation|Oracle Corporation]. Per impostazione predefinita è il fornitore Java di origine.
  • TARGET_BASE_IMAGE: questo è un parametro facoltativo. Specifica un'immagine di base da utilizzare per il container di destinazione.
  • PATH_TO_BINARYAPPSCANNER: questo è un parametro facoltativo. Specifica il percorso del file binaryAppScanner.jar sulla tua macchina locale.

Al termine dell'analisi, viene creata una nuova directory nella percorso di output contenente il piano di migrazione config.yaml.

Crea un piano di migrazione per i carichi di lavoro tradizionali WebSphere

Configura il file binariAppScanner.jar

Scarica la versione più recente del file binaryAppScanner.jar.

Se hai già installato il file binaryAppScanner.jar, controlla lo stato attuale versione:

java -jar binaryAppScanner.jar --version

Quindi, confronta la tua versione corrente con quella mostrata nella licenza IBM che viene visualizzato quando fai clic su Migration Toolkit for Application Binaries. per scaricare il file. Se sono diverse, scarica l'ultima versione del binaryAppScanner.jar file.

L'interfaccia a riga di comando Migrate to Containers automatizza l'utilizzo dell'binaryAppScanner.jar, disponibile nell'ambito di IBM WebSphere Application Server Migration Toolkit for Application Binaries, per estrarre informazioni e file di configurazione per WebSphere Application Server delle applicazioni nella VM di origine.

Prima di poter eseguire una migrazione, devi accettare il contratto di licenza e scaricare IBM WebSphere Application Server Migration Toolkit per i binari dell'applicazione, quindi estrarre il file binaryAppScanner.jar.

Per configurare binaryAppScanner.jar:

  1. Scarica il file del programma di installazione, binaryAppScannerInstaller.jar, da Assistenza IBM. Devi accettare il contratto di licenza durante il download.

  2. Esegui questo comando per estrarre il file binaryAppScanner.jar e accetta il Contratto di licenza:

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

  3. Specifica la directory di destinazione per l'estrazione. Ad esempio, se specifichi /tmp come directory di destinazione, al termine dell'installazione binaryAppScanner.jar è disponibile presso /tmp/wamt/binaryAppScanner.jar.

Recupera WAS_HOME

La variabile di ambiente WAS_HOME specifica dove WebSphere Application Server sia tradizionale, ad esempio /opt/IBM/WebSphere/AppServer/. Utilizza l'interfaccia a riga di comando di Migrate to Containers questo valore per individuare e analizzare correttamente la configurazione tradizionale di WebSphere.

Per recuperare questo valore, controlla il processo tradizionale di WebSphere Application Server in esecuzione:

ps aux | grep WAS_HOME

Esegui l'analisi

Per eseguire l'analisi, esegui questo 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

Sostituisci quanto segue:

  • PATH_TO_COPIED_FILESYSTEM: il percorso del file system copiato .
  • ANALYSIS_OUTPUT_PATH: il percorso della cartella in cui vuoi che venga creato l'output dell'analisi.
  • PATH_TO_WAS_HOME: percorso dell'installazione tradizionale di WebSphere Application Server.
  • PATH_TO_BINARYAPPSCANNER: percorso del binaryAppScanner.jar file. Ad esempio, se hai specificato /tmp come directory di destinazione, binaryAppScanner.jar è disponibile /tmp/wamt/binaryAppScanner.jar.

Al termine dell'analisi, viene creata una nuova directory nella percorso di output contenente il piano di migrazione config.yaml.

Crea un piano di migrazione per i carichi di lavoro JBoss

Per i componenti dell'app JBoss, la creazione di un piano di migrazione richiede JBOSS_HOME come input.

Per recuperare questo valore, controlla il processo del server JBoss in esecuzione:

ps aux | grep jboss.home.dir

Per eseguire l'analisi, esegui questo comando:

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

Sostituisci quanto segue:

  • PATH_TO_COPIED_FILESYSTEM: il percorso del file system copiato directory
  • ANALYSIS_OUTPUT_PATH: il percorso della cartella in cui quando vogliamo creare l'output dell'analisi
  • PATH_TO_JBOSS_HOME: percorso dell'installazione JBoss

Al termine dell'analisi, viene creata una nuova directory nella percorso di output contenente il piano di migrazione config.yaml.

Creare un piano di migrazione per i carichi di lavoro Apache

Per eseguire l'analisi, esegui il seguente comando:

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

Sostituisci quanto segue:

  • PATH_TO_COPIED_FILESYSTEM: il percorso del file system copiato directory
  • ANALYSIS_OUTPUT_PATH: il percorso della cartella in cui vuoi che venga creato l'output dell'analisi

Al termine dell'analisi, nel percorso di output specificato viene creata una nuova directory contenente il piano di migrazione, config.yaml.

Crea un piano di migrazione per i carichi di lavoro WordPress

Per eseguire l'analisi, esegui questo comando:

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

Sostituisci quanto segue:

  • PATH_TO_COPIED_FILESYSTEM: il percorso del file system copiato directory
  • ANALYSIS_OUTPUT_PATH: il percorso della cartella in cui vuoi che venga creato l'output dell'analisi

Al termine dell'analisi, viene creata una nuova directory nella percorso di output contenente il piano di migrazione config.yaml.

Creare un piano di migrazione per i servizi IIS di Windows

Per eseguire l'analisi, esegui questo comando:

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

Sostituisci quanto segue:

  • PATH_TO_IMAGE: il percorso del disco della macchina di origine dell'immagine. Puoi specificare più di un'immagine disco alla volta utilizzando più -s e i flag facoltativi. Ad esempio: -s PATH_TO_IMAGE_1 -s PATH_TO_IMAGE_2...-s PATH_TO_IMAGE_N.
  • ANALYSIS_OUTPUT_PATH: il percorso della cartella in cui vuoi che venga creato l'output dell'analisi.

Al termine dell'analisi, viene creata una nuova directory nella percorso di output contenente il piano di migrazione config.yaml.

Passaggi successivi