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 sutrue
. - 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
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
:
Scarica il file di installazione,
binaryAppScannerInstaller.jar
, dall'assistenza di IBM. Devi accettare il contratto di licenza durante il download.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
.
- INSTALL_LOCATION: la directory di destinazione per l'estrazione.
Ad esempio, se specifichi
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
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
:
Scarica il file di installazione,
binaryAppScannerInstaller.jar
, dall'assistenza di IBM. Devi accettare il contratto di licenza durante il download.Esegui questo comando per estrarre il file
binaryAppScanner.jar
e accettare il Contratto di licenza:java -jar binaryAppScannerInstaller.jar --acceptLicense --verbose
Specifica la directory di destinazione per l'estrazione. Ad esempio, se specifichi
/tmp
come directory di destinazione, al termine dell'installazionebinaryAppScanner.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: