Guida alla risoluzione dei problemi dello strumento Discovery

Strumento di rilevamento e Migration Toolkit per i binari delle applicazioni

Per informazioni su come scaricare e utilizzare Migration Toolkit per i binari delle applicazioni, fare clic qui.

Non è riuscito a caricare il file zip della raccolta sul Transformation Advisor server

Dopo aver raccolto le informazioni di configurazione di un'applicazione, lo strumento di rilevamento crea un file zip e cerca di caricarlo sul server Transformation Advisor server. Se non riesce a raggiungere il server, è possibile che venga visualizzato il seguente messaggio di errore:

Current Operation: Error occurred: Problem connecting with server See log for details.

Per ovviare a questo problema, è possibile ottenere il file zip della raccolta dalla directory dello strumento di discovery e caricarlo manualmente sul server attraverso la pagina della raccolta nell'interfaccia utente Transformation Advisor server attraverso la pagina Raccolta dell'interfaccia utente.

WebSphere il profilo (nome_profilo) non esiste

Questo messaggio viene visualizzato quando lo strumento di ricerca non riesce a trovare il nome del profilo di ingresso dal registro dei profili WAS. Verificare che il nome del profilo di input sia corretto controllando il WS_PROFILE_REGISTRY definito nel file $WAS_HOME/properties/wasprofile.properties .

Il file profileRegistry.xml predefinito è:

WS_PROFILE_REGISTRY=${was.install.root}/properties/profileRegistry.xml

Se il file XML del registro del profilo non utilizza il file predefinito, creare un collegamento simbolico da $WAS_HOME/properties/profileRegistry.xml al percorso del vero file del registro del profilo.

Radice di contesto errata per le applicazioni web su WebSphere rilevata dallo strumento di rilevamento

Nella versione Transformation Advisor1.9.4 e successive, il discovery tool rileva il context root per le applicazioni web in esecuzione su WebSphere. La root di contesto dell'applicazione viene utilizzata nelle distribuzioni su Liberty per semplificare l'accesso all'applicazione. Se la root di contesto non è appropriata, viene visualizzata una pagina con il seguente messaggio di errore quando si accede all'applicazione distribuita:

Context Root Not Found.

Per risolvere questo problema, aggiorna il diagramma Helm per l'applicazione nel repository Git :

1. Clona il repository Git contenente il grafico Helm per l'applicazione.

2. Modificare il file chart/[application name]/values.yaml e cambiare il campo rewriteTarget in '/' come mostrato:

   ingress:
     enabled: true
     rewriteTarget: "/"
   

3. Eseguire il commit e il push delle modifiche al repository Git .

4. Attendere la ridistribuzione dell'applicazione. Il percorso di ingresso per l'applicazione ora reindirizza alla pagina di base Liberty. Puoi accedere all'applicazione accodando la root di contesto dell'applicazione al percorso di ingresso.

Ad esempio, se il percorso di ingresso è modresorts e la radice del contesto per l'applicazione è resorts, il sito URL per accedere all'applicazione sarà http://[OCP public IP]/modresorts/resorts/.

Lo strumento di rilevamento non riesce a generare gli artefatti server.xml

Se lo strumento di discovery viene eseguito da un utente diverso da quello che ha lanciato il deployment manager, non riuscirà a generare gli artefatti server.xml. Le risorse raccolte avranno l'aspetto di una raccolta che non ha richiesto l'analisi della configurazione. Nelle versioni Transformation Advisor versioni precedenti a 1.9.4, è possibile che venga visualizzato il seguente errore:

Exception in thread 'main' java.io.FileNotFoundException: <some_path>_server.xml (A file or directory in the path name does not exist.)

    at java.io.FileInputStream.<init>(FileInputStream.java:113)
    at java.io.FileInputStream.<init>(FileInputStream.java:73)
                ...
                ...

È necessario eseguire il discovery tool come lo stesso utente che ha lanciato il deployment manager. È possibile verificare quale utente è utilizzando il comando ps .

Errore di checksum durante l'estrazione dello strumento di ricerca

Se viene restituito un errore di checksum dopo aver tentato di estrarre lo strumento di ricerca, provare questa soluzione:

gzip -d transformationadvisor-<OperatingSystem>_<workspace>_<collection>.tgz
tar xf transformationadvisor-<OperatingSystem>_<workspace>_<collection>.tar

Errore durante l'esecuzione dello strumento di ricerca in lingue diverse dall'inglese

/data/WebSphere/AppServer/profiles/Dmgr01/bin/wsadmin.sh -user wasadmin -password wasdm1i -lang jython -c "AdminApp.list()"

Nel terminale in cui si esegue lo strumento di rilevamento, digitare:

export LANG=C

Eseguire quindi nuovamente il comando discovery tool e il problema dovrebbe essere aggirato.

Lo scanner binario ignora i package com.ibm

Lo strumento di ricerca può essere configurato per ignorare alcuni pacchetti. Controllare il file customCmd.properties nella directory $TA_HOME/conf per verificarlo. Se sono presenti pacchetti ignorati, è possibile eliminare il commento dalla riga e modificare il comando per includerli. Lo strumento di ricerca includerà i comandi non commentati quando viene invocato lo scanner binario.

Lo strumento di ricerca salta i profili gestiti quando viene eseguito rispetto a un profilo specificato

I profili gestiti vengono saltati perché una copia della loro configurazione è conservata sul sito dmgr. L'esecuzione su dmgr dovrebbe risolvere il problema.

Lo strumento di ricerca salta le applicazioni installate in modalità copia binaria zero quando viene eseguito rispetto a un profilo specificato

Le applicazioni installate con la modalità di copia binaria zero vengono saltate perché lo strumento di rilevamento non è in grado di ottenere tutte le configurazioni necessarie per le applicazioni per generare l'analisi della migrazione. Questo tipo di applicazione deve essere valutato manualmente per determinare il lavoro di migrazione.

L'esecuzione dello strumento di rilevamento produce un errore libjvm.so failed to load:

Questo errore può essere causato quando Java non riesce a trovare le librerie corrette. Utilizzare la versione di Java presente sulla macchina stessa invece di quella scaricata con lo strumento di ricerca. Completare la seguente procedura per risolvere questo errore:

1. Controlla se wsadmin è posseduto o eseguito da un utente specifico. In caso affermativo, lo stesso utente deve eseguire lo strumento di rilevamento.

2. Assicurarsi che l'utente abbia le autorizzazioni di lettura, scrittura ed esecuzione nella posizione in cui è stato scompattato lo strumento di ricerca.

Accertarsi di utilizzare la versione di Java presente sulla macchina:

1. cd in transformationadvisor-2.1.

2. Sostituire la directory JRE con la directory JRE dalla macchina WAS.

3. Eseguire nuovamente il comando dello strumento di ricerca.

Errore durante il caricamento - Rilevati file incompatibili

Lo strumento di rilevamento produce rapporti collegati a ciascuna applicazione. Se si visualizza questo errore, significa che una o più applicazioni non sono state elaborate correttamente e il passo per collegare il report a un'applicazione non è riuscito.

È possibile risolvere questo problema come segue:

1. Decomprimere il file profile.zip .

2. Eliminare i file con i seguenti nomi:

   InventoryReport.json, InventoryReport.html, AnalysisReport.json,
   AnalysisReport.html, TechnologyReport.json, TechnologyReport.html

3. Caricare manualmente il file zip su Transformation Advisor attraverso l'interfaccia utente.

Per determinare se mancano delle applicazioni:

1. Ottenere l'elenco delle applicazioni in Transformation Advisor.

2. Consultare la directory profiles in WAS_HOME per esaminare l'elenco completo delle applicazioni installate in tale profilo.

3. Individuare le applicazioni nel profilo che mancano da Transformation Advisor.

Untar non è riuscito dopo aver scaricato lo strumento di rilevamento e averlo copiato su una macchina virtuale Linux

Provare invece i seguenti comandi:

gzip -d transformationadvisor-2.1_Linux_xxxxxx.tgz
tar xf transformationadvisor-2.1_Linux_xxxxx.tar

Impossibile scaricare i file di migrazione dopo il caricamento dei dati

Se si carica un file zip dallo strumento di rilevamento all'interfaccia utente Transformation Advisor UI ma non si riesce a scaricare il bundle di migrazione o i file di migrazione, è necessario eseguire un'analisi completa in modo da ottenere la configurazione del server Transformation Advisor ottenere la configurazione del server. Eseguire il comando seguente:

bin\transformationadvisor.bat -w <WEBSPHERE_HOME_DIR> -p <PROFILE_NAME>

Quindi ritentare il caricamento.

Lo strumento di individuazione di Windows non funziona se la home di WebSphere contiene uno spazio nel percorso

Se si esegue lo strumento di rilevamento di Windows con il seguente comando:

bin\transformationadvisor.bat -w "C:\Program Files (x86)\IBM\WebSphere\AppServer" -p AppSrv01

Lo strumento di ricerca potrebbe generare un messaggio di errore. Per risolvere il problema, procedere come segue: Aprire il prompt dei comandi e accedere alla directory di cui si desidera conoscere il percorso breve.

Type dir /x

Eseguire lo strumento di ricerca con il nome del collegamento, ad esempio:

bin\transformationadvisor.bat -w "C:\PROGRA~2\IBM\WebSphere\AppServer" -p AppSrv01

Lo strumento di individuazione di Windows non funziona dopo l'estrazione nel percorso predefinito

bin\transformationadvisor.bat -w "C:\Program Files\IBM\WebSphere\AppServer" -p AppSrv01 admin admin

Il percorso per TA_HOME è troppo lungo. Per risolvere questo problema, deselezionare l'opzione per utilizzare il nome del file come sottodirectory, poiché il percorso contiene già la sottodirectory di transformationadvisor-2.1 quando si scompatta il file zip del discovery tool. Quando questa casella è deselezionata, lo strumento di ricerca decomprime in: C:\Users\Administrator\TA\DC\transformationadvisor-2.1

Passi per l'esecuzione dello strumento di discovery in un ambiente z/OS

1. Si raccomanda di eseguire lo strumento di rilevamento da una sessione ssh e non dalla shell OMVS di Unix System Services, poiché lo strumento di rilevamento utilizza l'aggiornamento dello schermo in modi che non funzionano sui dispositivi di tipo 3270.

2. Installare bash se non è già disponibile e verificare che sia aggiunto al percorso di sistema, ad esempio export PATH=/usr/bin/rocket/bash-4.3/bin:$PATH

3. Installare gunzip se non è già disponibile, ad esempio da Rocket Software.

4. sftp/scaricare il file del discovery tool transformationadvisor-zOS.tgz sul computer z/OS.

5. Estrarre il file .tgz , ad esempio eseguendo: gunzip -c transformationadvisor-zOS.tgz | tar xf -

6. Assicurarsi che la cartella transformationadvisor-2.X.X sia di proprietà dell'utente che eseguirà successivamente lo strumento di ricerca. Se necessario, modificare i permessi e la proprietà della cartella eseguendo:

   chown -R <user> transformationadvisor-2.X.X
   

7. Cambiare directory alla cartella transformationadvisor-2.X.X e aggiungerla al percorso di sistema.

8. Eseguire (da una shell normale, NON da bash):

   cd bin && . ./zOSPrereq && cd ..
   

9. Per visualizzare tutte le opzioni di esecuzione:

   bin/transformationadvisor --help

   La prima volta che si esegue lo strumento di ricerca, si dovrà leggere il testo del contratto di licenza.

   Se si verifica un problema relativo alla memoria, aggiungere l'opzione -J-Xmx512m :

   bin/transformationadvisor -J-Xmx512m --help
   

10. (Questo passaggio non è più necessario da Transformation Advisor 3.0 in poi) Se si utilizzano regole definite dall'utente (una funzione disponibile solo da Transformation Advisor 2.5.0 ), si noti che tutti i file all'interno della directory conf/userDefinedRules sono in UTF-8 e devono essere mantenuti in questa codifica. Pertanto, per utilizzare questa funzione in z/OS, lavorare con i file in UTF-8 in un altro sistema e poi copiarli nuovamente.

11. Eseguire lo strumento di rilevamento, ad esempio:

    bin/transformationadvisor -w <WAS home>
    

    oppure

    bin/transformationadvisor -w <WAS home> -p default
    

12. Lo strumento di ricerca produce un file zip, ad esempio default.zip, che possono essere caricati nell'interfaccia IBM Transformation Advisor Per visualizzare i risultati.