# Assistant et problèmes de démarrage

## Le port est déjà utilisé

Cause possible

Une autre instance de QV2QS ou une autre application utilise le même port réseau. La console affiche `ERROR: Port [number] is already in use.`

Action proposée

Fermez l'autre application, ou spécifiez un port différent avec `--port`. Utilisez `--port 0` pour permettre au système de sélectionner automatiquement un port disponible.

## L'assistant s'ouvre dans Internet Explorer ou ne s'affiche pas correctement

Cause possible

Internet Explorer est le navigateur par défaut sur la machine. L'interface utilisateur QV2QS nécessite un navigateur moderne et ne fonctionne pas dans Internet Explorer.

Action proposée

Installez Google Chrome, Microsoft Edge ou Mozilla Firefox. QV2QS détecte le navigateur par défaut au démarrage et ouvre automatiquement un navigateur pris en charge lorsqu'il est disponible. Si aucun navigateur pris en charge n'est trouvé, la console affiche des liens de téléchargement.

Sur Windows Server 2019, Internet Explorer est le seul navigateur installé par défaut. Installez un navigateur pris en charge avant d'exécuter QV2QS en mode assistant. Alternativement, utilisez l'interface de ligne de commande, qui ne nécessite pas de navigateur. Voir [Référence des arguments](https://help.qlik.com/fr-FR/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm) pour la liste complète des arguments de la CLI.

## La conversion échoue ou produit des résultats inattendus dans l'assistant

Cause possible

L'assistant affiche une erreur récapitulative mais n'expose pas les détails diagnostiques complets nécessaires pour identifier la cause première.

Action proposée

Réexécuter la même conversion à partir de la ligne de commande avec la journalisation de débogage activée. Vous pouvez :

1. Dans l'assistant, accédez à l'étape Révision.
2. Cliquez sur Copier la commande pour copier la commande CLI complète dans le Presse-papiers.
3. Ouvrez une fenêtre de terminal et collez la commande copiée.
4. Ajoutez `--logLevel DEBUG` à la fin de la commande et appuyez sur Entrée.

La console affiche une sortie détaillée couvrant chaque décision de conversion, appel d'API cloud, et étape de traitement d'objet. Le journal de débogage complet est également écrit dans le `logs/` sous-dossier du répertoire de sortie.

Note Conseil

La commande copiée inclut tous les paramètres configurés dans l'assistant. L'ajout de `--logLevel DEBUG` est le seul changement nécessaire pour activer les diagnostics complets.

Voir [Journalisation et diagnostics](https://help.qlik.com/fr-FR/migration/Content/Qv2qsMigration/command-line-interface/logging-and-diagnostics.htm) pour plus de détails sur le format et l'emplacement des fichiers journaux.

## La modale QV2QS a cessé de fonctionner s'affiche dans le navigateur.

Cause possible

Le processus QV2QS a été fermé, a planté ou s'est terminé pendant que l'assistant était encore ouvert dans le navigateur. L'interface utilisateur surveille le service backend avec un contrôle de santé périodique et affiche la modale lorsque le service devient inaccessible.

Action proposée

Procédez de l'une des manières suivantes :

* Se reconnecter à la session actuelle. Copiez la commande affichée dans la modale et exécutez la commande dans un terminal. La commande inclut `--port` et `--noBrowser` pour se rattacher au même onglet de navigateur sur le même port. Après le démarrage du serveur, cliquez sur Se reconnecter dans la modale. L'assistant reprend avec tous les paramètres précédemment saisis intacts.
* Fermer l'onglet du navigateur. Cliquez sur Fermer la fenêtre dans la fenêtre modale. Tous les paramètres non enregistrés de la session de l'assistant actuelle sont perdus.

## Le fichier de projet exemple est manquant ou corrompu

Cause possible

Le fichier QVW d'exemple dans `%TEMP%\QV2QS\examples\` a été supprimé, déplacé ou modifié en dehors de QV2QS.

Action proposée

Supprimez le fichier affecté de `%TEMP%\QV2QS\examples\` et redémarrez QV2QS. Une nouvelle copie est extraite automatiquement au lancement. Pour conserver une copie permanente d'un fichier d'exemple, copiez le fichier dans un dossier de travail local avant de le modifier. Voir [Exemples de projets](https://help.qlik.com/fr-FR/migration/Content/Qv2qsMigration/getting-started/example-projects.htm).

## En savoir plus

* [Démarrage rapide](https://help.qlik.com/fr-FR/migration/Content/Qv2qsMigration/getting-started/quick-start.htm)
* [Projets exemples](https://help.qlik.com/fr-FR/migration/Content/Qv2qsMigration/getting-started/example-projects.htm)
* [Étapes de l'assistant](https://help.qlik.com/fr-FR/migration/Content/Qv2qsMigration/user-interface/wizard-steps.htm)