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.

Crea un piano di migrazione per un container 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 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, quindi la generazione dell'artefatto non riesce e l'interfaccia 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 con una dimensione superiore a la soglia delle dimensioni specificata, l'interfaccia a riga di comando Migrate to Containers aggiunge un commento piano di migrazione generato con un suggerimento di escludere il file rilevato dall'immagine container.

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 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 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 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 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 Java predefinita è 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 binaryAppScanner.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 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, dopo il l'installazione è terminata, binaryAppScanner.jar è disponibile all'indirizzo /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 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|Traditional].
  • 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|Traditional]. 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 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 Giacarta 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, 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 la versione corrente:

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 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, è necessario accettare il contratto di licenza e scaricare IBM WebSphere Application Server Migration Toolkit for Application Binaries, 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 nell'ambito del 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/. 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 del file system copiato .
  • ANALYSIS_OUTPUT_PATH: il percorso della cartella in cui da creare l'output dell'analisi.
  • PATH_TO_WAS_HOME: percorso dell'applicazione WebSphere Installazione tradizionale su server.
  • PATH_TO_BINARYAPPSCANNER: percorso di 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.

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 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 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 quando vogliamo creare 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 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 sistema di file copiato
  • ANALYSIS_OUTPUT_PATH: il percorso della cartella in cui quando vogliamo creare 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 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 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