Creare un piano di migrazione

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

Questa pagina descrive i passaggi necessari per preparare un piano di migrazione per diversi carichi di lavoro.

Creare un piano di migrazione per un contenitore VM Linux

Per eseguire l'analisi, esegui il seguente 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 della directory del sistema di file copiato.
• ANALYSIS_OUTPUT_PATH: il percorso della cartella in cui vuoi che venga creato l'output dell'analisi.
• SKIP_SIZE_CHECKS: questo è un parametro facoltativo. Per impostazione predefinita, questo valore è impostato su false e l'interfaccia a riga di comando Migrate to Containers controlla i livelli dell'immagine per assicurarsi che le dimensioni non superino 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 questo controllo delle dimensioni, imposta questo parametro su true.
• SIZE_IN_MB: questo è un parametro facoltativo. Specifica una soglia di dimensioni dei file, in MB, per verificare la presenza di file che superano una dimensione specifica. 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, 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 Tomcat

Per i componenti dell'app Tomcat, questa procedura richiede i percorsi catalina-home e catalina-base 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 della directory del sistema di file copiato
• ANALYSIS_OUTPUT_PATH: il percorso della cartella in cui vuoi che venga creato l'output dell'analisi
• PATH_TO_CATALINA_HOME: percorso alla radice dell'installazione di Tomcat
• PATH_TO_CATALINA_BASE: percorso alla radice della configurazione di runtime dell'istanza Tomcat di cui esegui la migrazione. Più basi devono essere separate da due punti
• JAVA_VERSION: versione Java del contenitore in formato X.Y. La versione Java predefinita è 11.0.

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

Creare un piano di migrazione per i carichi di lavoro WebSphere

(Facoltativo) Configura il file binaryAppScanner.jar

Nota: se vuoi eseguire la migrazione dei carichi di lavoro Liberty e mantenere il relativo ambiente Java, non devi configurare binaryAppScanner.jar.

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

Per configurare binaryAppScanner.jar:

1. Scarica il file di installazione binaryAppScannerInstaller.jar dall'assistenza IBM. Devi accettare il contratto di licenza durante il 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, al termine dell'installazione binaryAppScanner.jar sarà disponibile in /tmp/wamt/binaryAppScanner.jar.

Esegui l'analisi

Per eseguire l'analisi, esegui il seguente 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 della directory di sistema del file copiato.
• ANALYSIS_OUTPUT_PATH: il percorso della cartella in cui vuoi che venga creato l'output dell'analisi.
• WEBSPHERE_PROFILE: questo è un parametro facoltativo. Specifica il profilo WebSphere utilizzato nella VM di origine. Formato: [Liberty|Traditional].
• WEBSPHERE_HOME: questo è un parametro facoltativo. Specifica il percorso dell'installazione del server di 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|Traditional]. Il valore predefinito è il profilo di origine.
• TARGET_VERSION: questo è un parametro facoltativo. Specifica la versione di WebSphere da utilizzare nel contenitore di destinazione. Il valore predefinito è la versione di origine.
• TARGET_EDITION: questo è un parametro facoltativo. Specifica la versione di WebSphere da utilizzare nel contenitore di destinazione. Formato: [Base|Core|Open|ND]. Il valore predefinito è la versione di origine.
• TARGET_SE: questo è un parametro facoltativo. Specifica la versione Java SE da utilizzare nel contenitore 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 Jakarta EE di origine.
• TARGET_VENDOR: questo è un parametro facoltativo. Specifica il fornitore Java da utilizzare nel contenitore di destinazione. Formato: [IBM Corporation|Oracle Corporation]. Il valore predefinito è 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, nel percorso di output specificato viene creata una nuova directory contenente il piano di migrazione, config.yaml.

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

Importante: il plug-in websphere-traditional è stato ritirato. Per i clienti esistenti, questo plug-in è ancora supportato fino a dicembre 2023, dopodiché non sarà più disponibile. Se non hai esperienza con la modernizzazione dei carichi di lavoro WebSphere, utilizza il plug-in websphere-container con l'interfaccia a riga di comando Migrate to Containers.

Configurare binaryAppScanner.jar

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

Se hai già installato il file binaryAppScanner.jar, controlla la versione corrente:

java -jar binaryAppScanner.jar --version

Poi, confronta la versione corrente con quella mostrata nella licenza IBM che viene visualizzata 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 di binaryAppScanner.jar, disponibile nell'ambito del IBM WebSphere Application Server Migration Toolkit per i binari delle applicazioni, per estrarre informazioni di configurazione e file per le applicazioni WebSphere Application Server 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 di installazione binaryAppScannerInstaller.jar dall'assistenza IBM. Devi accettare il contratto di licenza durante il download.

2. Esegui il seguente comando per estrarre il file binaryAppScanner.jar e accettare 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 sarà disponibile in /tmp/wamt/binaryAppScanner.jar.

Recupera WAS_HOME

La variabile di ambiente WAS_HOME specifica dove è installato WebSphere Application Server traditional, ad esempio /opt/IBM/WebSphere/AppServer/. L'interfaccia a riga di comando Migrate to Containers utilizza 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 il seguente 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 della directory del sistema di file 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 all'indirizzo /tmp/wamt/binaryAppScanner.jar.

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

Creare un piano di migrazione per i carichi di lavoro JBoss

Per i componenti dell'app JBoss, la creazione di un piano di migrazione richiede la variabile 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 il seguente 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 della directory del sistema di file copiato
• ANALYSIS_OUTPUT_PATH: il percorso della cartella in cui vuoi che venga creato l'output dell'analisi
• PATH_TO_JBOSS_HOME: percorso dell'installazione di JBoss

Al termine dell'analisi, nel percorso di output specificato viene creata una nuova directory 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 della directory del sistema di file copiato
• 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.

Creare un piano di migrazione per i carichi di lavoro WordPress

Per eseguire l'analisi, esegui il seguente comando:

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

Sostituisci quanto segue:

• PATH_TO_COPIED_FILESYSTEM: il percorso della directory del sistema di file copiato
• 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.

Creare un piano di migrazione per i servizi IIS di Windows

Per eseguire l'analisi, esegui il seguente comando:

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

Sostituisci quanto segue:

• PATH_TO_IMAGE: il percorso dell'immagine del disco della macchina di origine. Puoi specificare più di un'immagine disco alla volta utilizzando più flag -s. 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, nel percorso di output specificato viene creata una nuova directory contenente il piano di migrazione, config.yaml.

Passaggi successivi

• Scopri come personalizzare il piano di migrazione per quanto segue:
  • VM Linux
  • Tomcat
  • WebSphere Liberty
  • WebSphere tradizionale
  • JBoss
  • Apache
  • WordPress
  • Servizi Windows IIS