AppDNA

Dépannage

Problèmes d’installation

Comment activer la journalisation détaillée AppDNA

Remarque : Pour plus d’informations sur tous les types de connexion dans AppDNA, reportez-vous à la sectionCTX219766.

Si vous rencontrez des problèmes lors de l’installation de Citrix AppDNA, ces étapes vous montrent comment activer la collection de fichiers journaux d’installation détaillés sur le serveur AppDNA.

Attention : Unemodification incorrecte du Registre peut entraîner de graves problèmes qui peuvent vous obliger à réinstaller votre système d’exploitation. Citrix ne peut pas garantir que les problèmes résultant de l’utilisation incorrecte de l’Éditeur du Registre peuvent être résolus. Utilisez l’Éditeur du Registre à vos propres risques. Veillez à sauvegarder le Registre avant de le modifier.

Pour activer la journalisation détaillée sur le serveur AppDNA, procédez comme suit :

  1. Ouvrez la boîte de dialogue Exécuter.
  2. Tapez regedit et cliquez sur OK.
  3. Dans la boîte de dialogue Contrôle d’accès utilisateur, cliquez sur Oui.
  4. Dans l’éditeur de Registre, accédez à la clé HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\AppDNA\appTitude\common\
  5. Recherchez ou créez le paramètre de Registre VerboseLogging (REG_DWORD) et modifiez la valeur sur 1 .

Lorsque AppDNA détecte que cette valeur de Registre a été définie, il écrit les journaux détaillés dans %temp%\AppDNAVerboseLog.log.

Notez que pour les processus serveur, ce sera le répertoire temporaire de l’identité sous laquelle AppdnaAppPool est exécuté dans IIS. Par défaut, ce sera la construction dans « ApplicationPoolIdentity » et le répertoire temporaire sera C:WindowsTemp.

Les journaux sont capturés séparément pour les processus client et serveur (sauf s’ils s’exécutent en tant que même utilisateur).

Utilisez un éditeur de texte pour lire le contenu du fichier AppdNaverBoselog.log.

Pour désactiver la journalisation détaillée, modifiez la valeur de Registre VerboseLogging sur 0.

Un processus similaire peut être suivi pour activer la journalisation détaillée pour Citrix AppDNA Service, QueueProcessor. Pour activer la journalisation détaillée pour le service QueueProcessor, suivez les étapes 1 à 4 ci-dessus. À l’étape 5, recherchez ou créez la valeur de Registre QueueProcessorVerBoseLogging. Les messages sont écrits dans le journal des événements Windows (plutôt qu’un fichier) dans :

EventViewer > Journaux des applications et des services > AppDNA > Source = Service AppDNA

Problèmes d’ouverture de session

« La demande a échoué avec le statut HTTP 503 : Service indisponible »

Cette erreur peut signifier que le mot de passe utilisé par le site Web AppDNA pour se connecter à la base de données AppDNA a expiré ou a été modifié. Pour corriger ce problème, reportez-vous à la sectionSite Web.

Échec de la connexion avec une erreur « L’opération a expiré »

Cette erreur se produit parfois parce que l’un des services AppDNA ou un autre service sur lequel AppDNA repose n’est pas en cours d’exécution.

Vérifiez les services IIS

  1. Ouvrez le Gestionnaire des services Internet : Dans l’écran de démarrage ou le menu Windows, sélectionnez Programmes > Accessoires > Exécuter, tapez inetmgr, puis cliquez sur OK.

  2. Vérifiez que le serveur IIS est en cours d’exécution et si ce n’est pas le cas, démarrez-le.

    Pour ce faire, dans le panneau Actions situé à droite de la fenêtre, sous Gérer le serveur, cliquez sur Démarrer. Le lien Démarrer est désactivé si le serveur est en cours d’exécution.

  3. Si le serveur IIS est en cours d’exécution, vérifiez que AppDNaAppPool est en cours d’exécution et, si ce n’est pas le cas, démarrez-le.

    Pour ce faire, développez l’arborescence sur le côté gauche de la fenêtre Gestionnaire des services Internet (IIS) et cliquez sur Pools d’applications. Cliquez sur AppDNaAppPool dans le panneau central, puis sur Démarrer dans le panneau à droite. Le lien Démarrer est désactivé si AppDNaAppPool est en cours d’exécution.

  4. Si le serveur IIS et AppDnaAppPool sont en cours d’exécution, vérifiez que le site Web AppDNA est en cours d’exécution et si ce n’est pas le cas, démarrez-le.

    Pour ce faire, développez le nœud Sites dans l’arborescence sur le côté gauche de la fenêtre Gestionnaire des services Internet (IIS Manager) et cliquez sur le site Web AppDNA (par défaut, il s’agit d’AppDNA). Cliquez ensuite sur Démarrer dans le panneau à droite. Le lien Démarrer est désactivé si le site Web AppDNA est en cours d’exécution.

Si vous avez redémarré l’un des services IIS, essayez de vous connecter à AppDNA. Sinon, vérifiez que le service d’instance SQL Server est en cours d’exécution et, si nécessaire, démarrez-le, comme suit :

  1. Ouvrez la fenêtre Services Windows (Panneau de configuration > Outils d’administration > Services).
  2. Dans la liste des services, recherchez l’instance SQL Server utilisée pour la base de données AppDNA.
  3. Si la colonne Statut est vide, cliquez sur Démarrer pour démarrer le service. Si cela réussit, fermez la fenêtre Services Windows. Vous devriez maintenant pouvoir vous connecter à AppDNA.

La demande a échoué avec l’état HTTP 407 : authentification proxy requise

Cette erreur se produit si Internet Explorer est configuré pour utiliser un serveur proxy pour votre réseau local. Vous pouvez contourner ce problème comme suit :

  1. Dans les menus d’Internet Explorer, choisissez Outils > Options Internet.
  2. Sous l’onglet Connexions de la boîte de dialogue Options Internet, cliquez sur Paramètres LAN.
  3. Sous Serveur proxy dans la boîte de dialogue Paramètres du réseau local (LAN), activez la case à cocher Contourner le serveur proxy pour les adresses locales.
  4. Cliquez sur OK.

Problèmes de licence

Cette section fournit des informations pour vous aider à résoudre les problèmes de licence, y compris ceux qui provoquent le rouge de la bannière AppDNA. Lorsque cela se produit, regardez le message explicatif dans la section Résumé des licences du module de laTableau de bord. Cela indique généralement clairement si le problème est dû au fait qu’AppDNA ne peut pas contacter le service de licences AppDNA ou à un problème avec la licence réelle de la base de données elle-même. On trouvera ci-après des informations pour chacune de ces causes profondes sous des rubriques distinctes.

Vous pouvez continuer à utiliser AppDNA avec le problème de licence et la bannière rouge. Cependant, la fonctionnalité est très restreinte - vous pouvez importer des applications, mais la plupart des autres fonctionnalités sont bloquées. Une fois le problème de licence résolu, les fonctionnalités bloquées seront de nouveau disponibles.

AppDNA ne peut pas contacter le service de licence

Si AppDNA affiche un message indiquant qu’il ne peut pas contacter le service de licences, cela peut signifier que le serveur de licences AppDNA n’est pas en cours d’exécution. Vous pouvez vérifier cela et le redémarrer si nécessaire comme suit :

  1. Ouvrez la fenêtre Services Windows (Panneau de configuration > Outils d’administration > Services).
  2. Dans la liste des services, recherchez AppDNA LicenseServer.
  3. Si la colonne Statut est vide, cela signifie que le service n’a pas démarré. Cliquez sur Démarrer pour démarrer le service. Si cela réussit, fermez la fenêtre Services.
  4. Redémarrez AppDNA.

Licence de base de données interrompue après le déplacement du serveur AppDNA ou le transfert d’une licence

Les licences AppDNA sont liées à la base de données et à la machine sur laquelle le service de licences AppDNA s’exécute lorsque la licence est activée. Des problèmes peuvent survenir lorsque le lien entre la licence dans la base de données et l’emplacement du service de licences est rompu, par exemple parce que vous avez déplacé votre serveur AppDNA d’une machine à une autre ou que vous avez démarré, mais pas terminé, la procédure en deux étapes de transfert d’une licence.

  • Pour rendre la base de données utilisable avec un service de licences sur une autre machine, transférez la licence du service de licences AppDNA sur l’ancienne machine vers la nouvelle machine.

  • Si vous avez démarré la procédure de transfert de licence (par exemple, vous avez exporté le jeton de licence mais ne l’avez pas importé de nouveau dans la base de données avec le nouvel emplacement du serveur de licences), terminez la procédure. La base de données sera alors à nouveau disponible.

Pour plus d’informations, reportez-vous à la section Transférer des licences.

Remarque : En règle générale, le service de licences s’exécute sur la même machine que le serveur AppDNA. Cependant, cela peut ne pas être le cas si vous avez effectué une mise à niveau à partir d’une version antérieure d’AppDNA.

Le port du serveur de licences par défaut n’est pas disponible

Par défaut, le service de licences AppDNA utilise le port 8079. Si ce port n’est pas disponible, modifiez-le comme suit.

  1. Fermez AppDNA sur le serveur et tous les clients AppDNA connectés.

  2. Recherchez les fichiers du service de licences AppDNA.

    L’emplacement par défaut est C:\Program Files[ (x86)] \ Citrix \ AppDNA \ License Server.

  3. Ouvrez remoting.config dans un éditeur de texte.

  4. Dans la ligne suivante, modifiez 8079 pour un numéro de port différent, puis enregistrez le fichier. <channel ref="tcp" port="8079" bindTo="0.0.0.0">

  5. Dans l’écran ou le menu Démarrer de Windows, choisissez Panneau de configuration > Outils d’administration > Services.

  6. Dans le panneau Services Windows, recherchez le service de licences AppDNA dans la liste des services et cliquez sur Démarrer ou Redémarrer dans la barre d’outils pour redémarrer le service de licences AppDNA.

Problèmes d’importation et d’analyse

« Cette transaction est terminée et ne peut plus être utilisée »

Ce message d’erreur peut se produire pendant l’analyse ou tout type d’importation. Cela est généralement dû au fait que la base de données n’a pas assez d’espace disque pour se développer.

  1. Ouvrez Microsoft SQL Server Management Studio et connectez-vous à l’instance SQL Server qui héberge la base de données AppDNA.

  2. Vérifiez les journaux SQL Server pour confirmer si le manque d’espace disque est le problème.

    Pour ce faire, dans l’arborescence sur le côté gauche, ouvrez le dossier Gestion > Journaux SQL Server. Affichez les journaux récents et recherchez du texte indiquant qu’il n’y a pas assez d’espace sur le disque. Si l’espace disque est le problème, suivez les étapes ci-dessous.

  3. Assurez-vous que le fichier de données de base de données AppDNA et le fichier journal sont autorisés à croître.

    Dans l’arborescence du côté gauche, ouvrez le dossier Bases de données. Ensuite, cliquez avec le bouton droit sur la base de données AppDNA et dans le menu contextuel, choisissez Propriétés. La boîte de dialogue Propriétés de la base de données s’ouvre. Cliquez sur Fichiers dans la barre latérale et assurez-vous que le fichier de données et le fichier journal sont configurés pour croître en petits morceaux (par exemple, de 10 %) et qu’il n’y a pas de taille maximale définie.

  4. Définissez le modèle de récupération de base de données sur simple.

    Dans la boîte de dialogue Propriétés de la base de données, cliquez sur Options dans la barre latérale et assurez-vous que le modèle de récupération est défini sur Simple.

  5. Vérifiez l’espace disque disponible et, si nécessaire, augmentez l’espace disque libre en nettoyant les données indésirables ou en mettant à niveau le matériel.

L’importation de paquets App-V (.sft ou .appv) échoue

Lorsque vous importez des paquets .sft ou .appv, AppDNA décompresse automatiquement leur contenu dans un dossier intermédiaire, en préservant la structure du répertoire d’origine. Cette opération échoue si le nombre total de caractères dans le Forward Path au fichier résultant dépasse la limite Windows (généralement 256 caractères). Dans ce cas, le fichier journal d’importation contient le texte : create_deep_dir.

Par défaut, AppDNA décompresse les fichiers .sft et .appv dans le dossier temporaire spécifié dansParamètres des fichiers. Toutefois, vous pouvez spécifier un dossier intermédiaire distinct pour les fichiers .sft et .appv dans la zone dossier intermédiaire SFT dansImporter et analyser les paramètres.

Pour résoudre ce problème, définissez un chemin de fichier très court pour le dossier intermédiaire SFT. AppDNA n’efface pas automatiquement ce dossier. Si nécessaire, vous pouvez supprimer manuellement les fichiers décompressés une fois l’importation terminée.

L’importation a réussi mais mon application ne contient pas l’ADN attendu

Cela se produit parfois avec des applications importées via Install Capture ou Self-Provisioning lorsque l’installation échoue, mais le programme d’installation ne respecte pas la convention de renvoyer zéro pour succès et une valeur différente de zéro pour un échec. Lorsque cela se produit, AppDNA suppose par défaut que la capture a réussi, importe l’ADN capturé et marque l’importation comme réussie — bien qu’en fait, aucun ADN d’application réel n’ait été capturé du tout. Dans ce cas, l’ADN capturé se compose de tout changement mineur que l’échec tentative d’installation de l’application a fait sur le système d’exploitation sous-jacent.

Si vous avez exécuté la capture à l’aide d’un clic automatique, l’installation a peut-être échoué car elle attendait l’entrée de l’utilisateur. Par conséquent, exécutez à nouveau la capture sans clic automatique. Cela peut permettre l’installation, et donc la capture, de se terminer avec succès.

Sinon, si vous savez qu’un programme d’installation ne suit pas la convention de renvoyer un code de sortie zéro en cas de succès, vous pouvez spécifier le code de sortie réussite dans le profil d’exécution de cette application. Pour plus d’informations sur la façon de procéder, reportez-vous à la section Modifier un profil d’exécution.

L’importation de l’image du système d’exploitation échoue avec l’erreur 404 : Fichier introuvable

Lorsque l’importation d’une image du système d’exploitation échoue avec une erreur « 404 : Fichier introuvable », cela signifie généralement que les limites sur la taille de la longueur maximale du contenu ont été dépassées dans IIS. Pour augmenter la longueur maximale autorisée du contenu, reportez-vous aux instructions sous « Optimiser IIS » dansOptimiser AppDNA.

Signaler des problèmes

Les vues de rapport sont très lentes à afficher

Ce problème se produit parfois lorsque le nombre d’enregistrements par page a été défini par inadvertance sur une très grande valeur. Si la page est si lente qu’elle est inutilisable, quittez la vue de rapport et modifiez le nombre d’enregistrements par page, comme suit.

  1. Dans le menu Edition dans AppDNA, choisissez Paramètres.
  2. Dans la barre latérale de la boîte de dialogue Paramètres, cliquez sur Rapport.
  3. Dans la zone Enregistrements par page, entrez une valeur inférieure (par exemple, 200).
  4. Cliquez sur Enregistrer.

Pour modifier le nombre d’enregistrements par page dans le client Web :

  • Ajoutez les éléments suivants à l’URL de la vue de rapport : &FRMKEY_PAGE_SIZE=n

Où n est la taille de page par défaut requise, comme indiqué dans l’exemple suivant. Pour plus de clarté, cette URL est affichée sur plusieurs lignes. En pratique, l’URL doit être saisie sous la forme d’une chaîne ininterrompue.

http://appdna-machine:8199/appdna/Reporting/AssessmentReport.aspx? FRMKEY_TOKEN=1dd82045-b9a3-4840-af46-75e112bfcbb0 &FRMKEY_MODULE_ID=Win8Module &FRMKEY_CUSTOMISATION=&FRMKEY_POSTIMAGE=-2147483637 &FRMKEY_PREIMAGE=-2147483647&FRMKEY_RESOLUTION=app_group_summary &FRMKEY_PAGE_SIZE=5

Les images ne s’affichent pas dans les vues de rapport

Ce problème a été rencontré lors de la première visualisation des rapports après l’installation d’AppDNA sur Windows 8. Le problème a été causé par une configuration incomplète des services Internet (IIS).

Pour résoudre ce problème :

  1. Fermez AppDNA et arrêtez les clients AppDNA.
  2. Sur la machine serveur AppDNA, assurez-vous que toutes les fonctionnalités IIS requises sont activées. Pour plus d’informations, reportez-vous à la section Configuration système requise pour AppDNA 7.6.
  3. Utilisez la commande iisreset pour réinitialiser IIS.

La calculatrice d’effort est illisible

L’écran principal de la Calculatrice d’effort n’est pas lisible lorsque l’option d’affichage « Faciliter la lecture de ce qui est sur votre écran » du Panneau de configuration permet d’augmenter la taille du texte et des autres éléments de votre écran de, par exemple, de 125 %. Cette option est parfois activée par défaut sur Windows 8.

Lorsque cette option est utilisée, le Calculateur d’effort augmente la taille du texte. Le texte est ainsi tronqué ou exécuté sur d’autres éléments, ce qui les rend illisibles. D’autres rapports sont affectés de la même manière.

La solution consiste à réinitialiser la taille d’affichage au paramètre 100 % dans Panneau de configuration > Affichage.

Échec de l’exportation PDF

Si vous tentez d’effectuer une exportation PDF après avoir installé Adobe Reader mais avant d’avoir réellement exécuté Adobe Reader ou ouvert un fichier PDF, l’exportation PDF échoue avec une erreur (« Cette application ne peut pas être activée lorsque le contrôle de compte d’utilisateur est désactivé »). En effet, l’exportation PDF AppDNA ne fonctionne pas tant que vous n’avez pas accepté le contrat de licence Adobe Reader.

Pour résoudre ce problème, ouvrez un fichier PDF sur la machine sur laquelle vous exécutez AppDNA et acceptez le contrat de licence Adobe Reader.

Les colonnes se chevauchent dans la section Données du rapport des exportations PDF

Lorsqu’un rapport comporte un grand nombre de groupes d’algorithmes, les colonnes de la section Données de rapport des exportations PDF peuvent se chevaucher et devenir illisibles. Pour résoudre ce problème, désactivez la case à cocher Afficher les comptes dans les exportations PDF,Paramètres de reportingpuis exécutez à nouveau l’exportation PDF.

Dépannage