Guide de dépannage de l'outil de découverte

Outil de découverte et Migration Toolkit pour les binaires d'application

Pour savoir comment télécharger et utiliser le site Migration Toolkit pour les binaires d'application, cliquez ici.

Échec du téléchargement du fichier zip de la collection vers Transformation Advisor serveur

Une fois que l'outil de découverte a recueilli les informations de configuration d'une application, il crée un fichier zip et tente de le télécharger sur le Transformation Advisor serveur. S'il ne parvient pas à accéder au serveur, le message d'erreur suivant s'affiche :

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

Pour contourner ce problème, vous pouvez récupérer le fichier zip de la collection dans le répertoire de l'outil de découverte et le télécharger manuellement sur le serveur via la page Collection de l'interface utilisateur Transformation Advisor serveur via la page Collection de l'interface utilisateur.

WebSphere le profil (nom_du_profil) n'existe pas

Ce message s'affiche lorsque l'outil de découverte ne parvient pas à trouver le nom du profil d'entrée dans le registre des profils WAS. Assurez-vous que le nom du profil d'entrée est correct en vérifiant la variable WS_PROFILE_REGISTRY définie dans le fichier $WAS_HOME/properties/wasprofile.properties.

Le fichier par défaut profileRegistry.xml est le suivant :

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

Si votre fichier XML de registre de profil n'utilise pas le fichier par défaut, créez un lien symbolique entre $WAS_HOME/properties/profileRegistry.xml et l'emplacement du fichier de registre de profil réel.

Racine de contexte incorrecte pour les applications web sur WebSphere détectée par l'outil de découverte

Dans les versions Transformation Advisor à partir de la version 1.9.4, l'outil de découverte détecte la racine du contexte pour les applications web fonctionnant sur WebSphere. La racine de contexte de l'application est utilisée dans les déploiements sur Liberty pour simplifier l'accès à l'application. Si la racine de contexte est incorrecte, une page contenant le message d'erreur suivant s'affiche lors de l'accès à l'application déployée :

Context Root Not Found.

Afin de contourner ce problème, mettez à jour la charte Helm pour l'application dans le référentiel Git :

1. Clonez le référentiel Git qui contient la charte Helm pour l'application.

2. Modifiez le fichier chart/[application name]/values.yaml et remplacez le rewriteTarget en '/' comme indiqué :

   ingress:
     enabled: true
     rewriteTarget: "/"
   

3. Validez les modifications et envoyez-les au référentiel Git.

4. Attendez que l'application soit redéployée. Le chemin Ingress pour l'application effectue à présent une redirection vers la page de base Liberty. Vous pouvez accéder à l'application en ajoutant la racine de contexte de l'application au chemin Ingress.

Par exemple, si le chemin d'entrée est modresorts et que la racine du contexte pour l'application est resorts, le chemin URL pour accéder à l'application serait http://[OCP public IP]/modresorts/resorts/.

L'outil de découverte ne parvient pas à générer les artefacts server.xml

Si l'outil de découverte est exécuté par un utilisateur autre que celui qui a lancé le gestionnaire de déploiement, il ne parviendra pas à générer les artefacts server.xml. Les artefacts collectés ressembleront à une collection qui n'a pas demandé d'analyse de configuration. Sur les versions Transformation Advisor antérieures à 1.9.4, vous pouvez rencontrer l'erreur suivante :

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)
                ...
                ...

Vous devez exécuter l'outil de découverte en tant qu'utilisateur ayant lancé le gestionnaire de déploiement. Pour connaître cet ID utilisateur, vous pouvez exécuter la commande ps.

Erreur de somme de contrôle lors de l'extraction de l'outil de découverte

Si une erreur de somme de contrôle est renvoyée après avoir essayé d'extraire l'outil de découverte, essayez cette solution de contournement :

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

Erreur lors de l'exécution de l'outil de découverte dans des langues autres que l'anglais

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

Dans le terminal où vous exécutez l'outil de découverte, tapez :

export LANG=C

Exécutez ensuite à nouveau la commande de l'outil de découverte et le problème devrait être contourné.

Le scanner binaire ignore les packages com.ibm

L'outil de découverte peut être configuré pour ignorer certains paquets. Vérifiez le fichier customCmd.properties dans le répertoire $TA_HOME/conf . Si des packages sont ignorés, vous pouvez supprimer la mise en commentaire de la ligne et modifier la commande de manière à les inclure. L'outil de découverte inclura les commandes non commentées lors de l'invocation de l'analyseur binaire.

L'outil de découverte ne tient pas compte des profils gérés lorsqu'il est exécuté par rapport à un profil spécifié

Les profils gérés sont ignorés car une copie de leur configuration est conservée sur le site dmgr. L'exécution sur le site dmgr devrait résoudre ce problème.

L'outil de découverte ne tient pas compte des applications installées en mode de copie binaire zéro lorsqu'il est exécuté par rapport à un profil spécifié

Les applications qui ont été installées avec le mode de copie binaire zéro sont ignorées parce que l'outil de découverte ne peut pas obtenir toutes les configurations requises pour les applications afin de générer l'analyse de migration. Ce type d'application doit être évalué manuellement pour déterminer l'effort de migration.

L'exécution de l'outil de découverte produit une erreur libjvm.so failed to load:

Cette erreur peut être provoquée lorsque Java ne parvient pas à trouver les bibliothèques appropriées. Utilisez la version de Java sur la machine elle-même plutôt que celle qui est téléchargée avec l'outil de découverte. Procédez comme suit pour résoudre cette erreur :

1. Vérifier si wsadmin appartient ou est exécuté par un utilisateur spécifique. Si c'est le cas, c'est ce même utilisateur qui doit exécuter l'outil de découverte.

2. Assurez-vous que l'utilisateur dispose des droits de lecture, d'écriture et d'exécution sur l'emplacement où vous avez décompressé l'outil de découverte.

Vérifiez que vous utilisez la version de Java qui se trouve sur la machine :

1. cd dans transformationadvisor-2.1.

2. Remplacez le répertoire JRE par le répertoire JRE de l'application WAS proprement dite.

3. Exécutez à nouveau la commande de l'outil de découverte.

Erreur lors du téléchargement - Fichiers incompatibles détectés

L'outil de découverte produit des rapports liés à chaque application. Si ce message d'erreur s'affiche, cela signifie qu'une ou plusieurs applications n'ont pas été correctement traitées et que l'étape de liaison du rapport à une application a échoué.

Vous pouvez résoudre ce problème comme suit :

1. Décompressez le fichier profile.zip.

2. Supprimer les fichiers portant les noms suivants :

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

3. Téléchargez manuellement le fichier zip vers Transformation Advisor via l'interface utilisateur.

Pour déterminer si des applications sont manquantes :

1. Obtenir la liste des applications dans Transformation Advisor.

2. Consultez le répertoire des profils dans WAS_HOME pour passer en revue la liste complète des applications installées dans ce profil.

3. Identifier les applications du profil qui sont absentes de Transformation Advisor.

Untar a échoué après avoir téléchargé l'outil de découverte et l'avoir copié sur une VM Linux

Exécutez plutôt les commandes suivantes :

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

Impossible de recevoir par téléchargement les fichiers de migration après l'envoi par téléchargement des données

Si vous téléchargez un fichier zip depuis l'outil de découverte vers l'interface utilisateur Transformation Advisor Mais que vous ne parvenez pas à télécharger le pack de migration ou les fichiers de migration, vous devez effectuer une analyse complète afin de pouvoir obtenir la configuration du serveur Transformation Advisor puisse obtenir la configuration du serveur. Exécutez la commande suivante :

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

Relancez l'envoi par téléchargement.

L'outil de découverte Windows ne fonctionne pas si WebSphere home contient un espace dans le chemin d'accès

Si vous exécutez l'outil de découverte de Windows avec la commande suivante :

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

L'outil de découverte peut envoyer un message d'erreur. Procédez comme suit pour résoudre le problème : Ouvrez l'invite de commande et allez dans le répertoire dont vous voulez connaître le chemin court.

Type dir /x

Exécutez l'outil de découverte avec le nom du raccourci, par exemple :

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

L'outil de découverte de Windows ne fonctionne pas après l'extraction vers le chemin d'accès par défaut

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

Le chemin d'accès à TA_HOME est trop long. Pour résoudre ce problème, décochez l'option d'utilisation du nom du fichier comme sous-répertoire car le chemin contient déjà le sous-répertoire transformationadvisor-2.1 lorsque vous décompressez le fichier zip de l'outil de découverte. Lorsque cette case n'est pas cochée, l'outil de découverte se décompresse en : C:\Users\Administrator\TA\DC\transformationadvisor-2.1

Étapes à suivre pour exécuter l'outil de découverte dans un environnement z/OS

1. Il est recommandé d'exécuter l'outil de découverte à partir d'une session ssh, et non à partir du shell OMVS (Unix System Services), car l'outil de découverte utilise l'actualisation de l'écran d'une manière qui ne fonctionne pas sur les appareils de type 3270.

2. Installez bash si ce n'est pas déjà fait et veillez à ce qu'il soit ajouté au chemin système, par exemple, export PATH=/usr/bin/rocket/bash-4.3/bin:$PATH

3. Installer gunzip s'il n'est pas déjà disponible, par exemple auprès de Rocket Software.

4. téléchargez le fichier de l'outil de découverte transformationadvisor-zOS.tgz sur la machine z/OS.

5. Extrayez le fichier .tgz , par exemple en exécutant: gunzip -c transformationadvisor-zOS.tgz | tar xf -

6. Assurez-vous que le dossier transformationadvisor-2.X.X appartient à l'utilisateur qui exécutera ultérieurement l'outil de découverte. Si nécessaire, modifiez les autorisations et la propriété du dossier en exécutant le programme :

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

7. Changez de répertoire jusqu'au dossier transformationadvisor-2.X.X, ajoutez-le au chemin d'accès du système.

8. Exécuter (à partir d'un shell normal, PAS à partir de bash) :

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

9. Pour voir toutes les options d'exécution :

   bin/transformationadvisor --help

   Lors de la première exécution de l'outil de découverte, un texte d'accord de licence sera affiché.

   Si un problème de mémoire survient, ajoutez l'option -J-Xmx512m :

   bin/transformationadvisor -J-Xmx512m --help
   

10. (Cette étape n'est plus nécessaire à partir de Transformation Advisor 3.0 cette étape n'est plus nécessaire à partir de la date d'entrée en vigueur de la loi.) Si des règles définies par l'utilisateur sont utilisées (une fonctionnalité disponible uniquement à partir de Transformation Advisor 2.5.0 ), notez que tous les fichiers du répertoire conf/userDefinedRules sont en UTF-8 et doivent être conservés dans ce codage. Par conséquent, pour utiliser cette fonction dans z/OS, travaillez avec les fichiers de UTF-8 dans un autre système, puis copiez-les à nouveau.

11. Exécutez l'outil de découverte, par exemple :

    bin/transformationadvisor -w <WAS home>
    

    ou

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

12. L'outil de découverte produira un fichier zip, par exemple default.zip, qui peut être téléchargée dans l'interface utilisateur pour la visualisation des résultats IBM Transformation Advisor Pour visualiser les résultats.