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 artefatti di migrazione.

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

Crea un piano di migrazione per un container 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 della directory del file system copiata.
• ANALYSIS_OUTPUT_PATH: il percorso della cartella in cui vuoi creare l'output dell'analisi.
• SKIP_SIZE_CHECKS: parametro facoltativo. Per impostazione predefinita, è impostato su false e l'interfaccia a riga di comando Migrate to Containers controlla i livelli 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 artefatti non riesce e l'interfaccia a riga di comando Migrate to Containers mostra un messaggio di errore. Per saltare questo controllo delle dimensioni, imposta questo parametro su true.
• SIZE_IN_MB: parametro facoltativo. Specifica una soglia per le dimensioni del file, in MB, per verificare se i file superano una dimensione specifica. Se l'interfaccia a riga di comando Migrate to Containers rileva un file con una dimensione superiore alla soglia di dimensioni specificata, l'interfaccia a riga di comando Migrate to Containers aggiunge un commento nel piano di migrazione generato con un suggerimento per escludere il file rilevato dall'immagine container.

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

Crea un piano di migrazione per i carichi di lavoro Tomcat

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

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

ps aux | grep catalina

Per eseguire l'analisi, esegui questo 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 file system copiata
• ANALYSIS_OUTPUT_PATH: il percorso della cartella in cui vuoi creare l'output dell'analisi
• PATH_TO_CATALINA_HOME: percorso della directory principale dell'installazione Tomcat
• PATH_TO_CATALINA_BASE: percorso della directory principale della configurazione del runtime dell'istanza Tomcat di cui stai eseguendo la migrazione. Separare più basi usando i due punti
• JAVA_VERSION: versione Java del container in formato X.Y. La versione Java predefinita è 11.0.

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

Crea un piano di migrazione per i carichi di lavoro WebSphere

(Facoltativo) Configura il file binarioAppScanner.jar

Nota: se vuoi eseguire la migrazione di carichi di lavoro Liberty e mantenere l'ambiente Java, non è necessario configurare binaryAppScanner.jar.

Se vuoi eseguire la migrazione di 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 facilitare la modernizzazione del runtime Java.

Per configurare binaryAppScanner.jar:

1. Scarica il file di installazione, binaryAppScannerInstaller.jar, dall'assistenza di 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, dopo il completamento dell'installazione, binaryAppScanner.jar è disponibile in /tmp/wamt/binaryAppScanner.jar.

Esegui 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 della directory del file system copiata.
• ANALYSIS_OUTPUT_PATH: il percorso della cartella in cui vuoi creare l'output dell'analisi.
• WEBSPHERE_PROFILE: parametro facoltativo. Specifica il profilo WebSphere utilizzato nella VM di origine. Formato: [Libertà|Tradizionale].
• WEBSPHERE_HOME: parametro facoltativo. Specifica il percorso di installazione di Application Server nella VM di origine.
• WEBSPHERE_JAVA_HOME: parametro facoltativo. Specifica il percorso dell'installazione Java nella VM di origine.
• TARGET_PROFILE: parametro facoltativo. Specifica il profilo WebSphere da utilizzare nel contenitore di destinazione. Formato: [Libertà|Tradizionale]. Il valore predefinito è il profilo di origine.
• TARGET_VERSION: parametro facoltativo. Specifica la versione di WebSphere da utilizzare nel contenitore di destinazione. Il valore predefinito è la versione di origine.
• TARGET_EDITION: parametro facoltativo. Specifica la versione WebSphere da utilizzare nel contenitore di destinazione. Formato: [Base|Core|Open|ND]. Il valore predefinito è la versione di origine.
• TARGET_SE: parametro facoltativo. Specifica la versione di Java SE da utilizzare nel contenitore di destinazione. Formato: [SE8|SE11|SE17]. Il valore predefinito è Java SE di origine.
• TARGET_EE: 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: parametro facoltativo. Specifica il fornitore Java da utilizzare nel container di destinazione. Formato: [IBM Corporation|Oracle Corporation]. Il valore predefinito è il fornitore Java di origine.
• TARGET_BASE_IMAGE: parametro facoltativo. Specifica un'immagine di base da utilizzare per il container di destinazione.
• PATH_TO_BINARYAPPSCANNER: parametro facoltativo. Specifica il percorso del file binaryAppScanner.jar sulla tua macchina locale.

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

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

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

Configura il file binarioAppScanner.jar

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

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

java -jar binaryAppScanner.jar --version

Quindi, confronta la tua versione attuale con quella indicata nella licenza IBM visualizzata quando fai clic su Kitterket di migrazione per i binari delle applicazioni per scaricare il file. Se sono diversi, scarica l'ultima versione del file binaryAppScanner.jar.

L'interfaccia a riga di comando Migrate to Containers automatizza l'utilizzo di binaryAppScanner.jar, disponibile come parte di IBM WebSphere Application Server Migration Toolkit for Application Binaries, 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 Application Binaries, quindi estrarre il file binaryAppScanner.jar.

Per configurare binaryAppScanner.jar:

1. Scarica il file di installazione, binaryAppScannerInstaller.jar, dall'assistenza di IBM. Devi accettare il contratto di licenza durante il download.

2. Esegui questo 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 è disponibile in /tmp/wamt/binaryAppScanner.jar.

Recupera WAS_HOME

La variabile di ambiente WAS_HOME specifica dove è installato WebSphere Application Server tradizionale, ad esempio /opt/IBM/WebSphere/AppServer/. L'interfaccia a riga di comando di 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 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 della directory del file system copiata.
• ANALYSIS_OUTPUT_PATH: il percorso della cartella in cui vuoi creare l'output dell'analisi.
• PATH_TO_WAS_HOME: percorso dell'installazione tradizionale di WebSphere Application Server.
• PATH_TO_BINARYAPPSCANNER: percorso del file binaryAppScanner.jar. Ad esempio, se hai specificato /tmp come directory di destinazione, binaryAppScanner.jar è disponibile in /tmp/wamt/binaryAppScanner.jar.

Al termine dell'analisi, viene creata una nuova directory nel percorso di output specificato che contiene 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 la variabile JBOSS_HOME come input.

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

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 della directory del file system copiata
• ANALYSIS_OUTPUT_PATH: il percorso della cartella in cui vuoi creare l'output dell'analisi
• PATH_TO_JBOSS_HOME: percorso dell'installazione di JBoss

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

Crea un piano di migrazione per i carichi di lavoro Apache

Per eseguire l'analisi, esegui questo 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 file system copiata
• ANALYSIS_OUTPUT_PATH: il percorso della cartella in cui vuoi creare l'output dell'analisi

Al termine dell'analisi, viene creata una nuova directory nel percorso di output specificato che contiene 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 della directory del file system copiata
• ANALYSIS_OUTPUT_PATH: il percorso della cartella in cui vuoi creare l'output dell'analisi

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

Crea un piano di migrazione per i servizi Windows IIS

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 dell'immagine 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 creare l'output dell'analisi.

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

Passaggi successivi

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