# Assistente e problemas de inicialização ## A porta já está em uso Possível causa Outra instância do QV2QS ou outro aplicativo está usando a mesma porta de rede. O console exibe `ERROR: Port [number] is already in use.` Ação proposta Feche o outro aplicativo, ou especifique uma porta diferente com `--port`. Use `--port 0` para permitir que o sistema selecione uma porta disponível automaticamente. ## O assistente abre no Internet Explorer ou não é renderizado corretamente Possível causa O Internet Explorer é o navegador padrão na máquina. A interface de usuário do QV2QS requer um navegador moderno e não funciona no Internet Explorer. Ação proposta Instale o Google Chrome, o Microsoft Edge ou o Mozilla Firefox. QV2QS detecta o navegador padrão na inicialização e abre automaticamente um navegador compatível quando um estiver disponível. Se nenhum navegador compatível for encontrado, o console exibe links para download. No Windows Server 2019, o Internet Explorer é o único navegador instalado por padrão. Instale um navegador compatível antes de executar o QV2QS no modo assistente. Alternativamente, use a interface de linha de comando, que não requer um navegador. Veja [Referência de argumentos](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm) para a lista completa de argumentos da CLI. ## A conversão falha ou produz resultados inesperados no assistente Possível causa O assistente exibe um erro resumido, mas não expõe os detalhes diagnósticos completos necessários para identificar a causa raiz. Ação proposta Execute novamente a mesma conversão a partir da linha de comando com o log de depuração ativado. Faça o seguinte: 1. No assistente, navegue até a etapa de Revisão. 2. Clique em Copiar comando para copiar o comando CLI completo para a área de transferência. 3. Abra uma janela de terminal e cole o comando copiado. 4. Anexe `--logLevel DEBUG` ao final do comando e pressione Enter. O console exibe uma saída detalhada cobrindo cada decisão de conversão, chamada de API da nuvem e etapa de processamento de objeto. O log de depuração completo também é gravado na `logs/` subpasta no diretório de saída. Nota de dica O comando copiado inclui todas as configurações configuradas no assistente. Adicionar `--logLevel DEBUG` é a única alteração necessária para ativar o diagnóstico completo. Consulte [Registro de logs e diagnósticos](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/command-line-interface/logging-and-diagnostics.htm) para obter detalhes sobre o formato e a localização do arquivo de log. ## QV2QS parou modal aparece no navegador Possível causa O processo QV2QS foi fechado, travou ou foi encerrado enquanto o assistente ainda estava aberto no navegador. A interface do usuário monitora o serviço de backend com uma verificação de saúde periódica e exibe o modal quando o serviço se torna inalcançável. Ação proposta Realize uma das seguintes ações: * Reconectar à sessão atual. Copie o comando exibido no modal e execute o comando em um terminal. O comando inclui `--port` e `--noBrowser` para se reconectar à mesma aba do navegador na mesma porta. Após o servidor iniciar, clique em Reconectar no modal. O assistente é retomado com todas as configurações inseridas anteriormente intactas. * Feche a aba do navegador. Clique Fechar janela no modal. Quaisquer configurações não salvas na sessão atual do assistente serão perdidas. ## O arquivo de projeto de exemplo está faltando ou corrompido Possível causa O arquivo QVW de exemplo em `%TEMP%\QV2QS\examples\` foi excluído, movido ou modificado fora do QV2QS. Ação proposta Exclua o arquivo afetado de `%TEMP%\QV2QS\examples\` e reinicie o QV2QS. Uma nova cópia é extraída automaticamente no lançamento. Para manter uma cópia permanente de um arquivo de exemplo, copie o arquivo para uma pasta de trabalho local antes de modificar. Ver [Projetos de exemplo](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/getting-started/example-projects.htm). ## Saiba mais * [Início rápido](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/getting-started/quick-start.htm) * [Projetos de exemplo](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/getting-started/example-projects.htm) * [Passos do assistente](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/user-interface/wizard-steps.htm)