# Мастер и проблемы с запуском

## Порт уже используется

Возможная причина

Другой экземпляр QV2QS или другое приложение использует тот же сетевой порт. Консоль отображает `ERROR: Port [number] is already in use.`

Предлагаемые меры

Закройте другое приложение или укажите другой порт с помощью `--port`. Используйте `--port 0`, чтобы система автоматически выбрала доступный порт.

## Мастер открывается в Internet Explorer или отображается некорректно

Возможная причина

Internet Explorer является браузером по умолчанию на компьютере. Пользовательский интерфейс QV2QS требует современного браузера и не работает в Internet Explorer.

Предлагаемые меры

Установите Google Chrome, Microsoft Edge или Mozilla Firefox. QV2QS обнаруживает браузер по умолчанию при запуске и автоматически открывает поддерживаемый браузер, когда он доступен. Если не найден поддерживаемый браузер, консоль отображает ссылки для загрузки.

На Windows Server 2019 Internet Explorer — единственный браузер, установленный по умолчанию. Установите поддерживаемый браузер перед запуском QV2QS в режиме мастера. В качестве альтернативы используйте интерфейс командной строки, который не требует браузера. См. [Справочник аргументов](https://help.qlik.com/ru-RU/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm) для полного списка аргументов CLI.

## Преобразование завершается сбоем или дает неожиданные результаты в мастере

Возможная причина

Мастер отображает сводную ошибку, но не раскрывает полную диагностическую информацию, необходимую для выявления первопричины.

Предлагаемые меры

Повторно запустите то же преобразование из командной строки с включенным отладочным логированием. Выполните следующие действия.

1. В мастере перейдите к шагу Проверка.
2. Щелкните Копировать команду, чтобы скопировать полную команду CLI в буфер обмена.
3. Откройте окно терминала и вставьте скопированную команду.
4. Добавьте `--logLevel DEBUG` в конец команды и нажмите Enter.

Консоль отображает подробный вывод, охватывающий каждое решение о преобразовании, вызов облачного API и шаг обработки объекта. Полный отладочный журнал также записывается в `logs/` подпапку в выходном каталоге.

Примечание к подсказке

Скопированная команда включает все настройки, заданные в мастере. Добавление `--logLevel DEBUG` — это единственное изменение, необходимое для включения полной диагностики.

См. [Ведение журнала и диагностика](https://help.qlik.com/ru-RU/migration/Content/Qv2qsMigration/command-line-interface/logging-and-diagnostics.htm) для получения подробных сведений о формате файла журнала и Местоположение.

## Модальное окно QV2QS остановился появляется в браузере

Возможная причина

Процесс QV2QS был закрыт, завершился с ошибкой или был прекращен, пока мастер был еще открыт в браузере. Пользовательский интерфейс отслеживает работу серверной службы с помощью периодической проверки работоспособности и отображает модальное окно, когда служба становится недоступной.

Предлагаемые меры

Выполните одно из следующих действий:

* Переподключиться к текущему сеансу. Скопируйте команду, отображаемую в модальном окне, и запустите команду в терминале. Команда включает `--port` и `--noBrowser` для повторного подключения к той же вкладке браузера на том же порту. После запуска сервера нажмите Переподключиться в модальном окне. Мастер возобновляет работу, сохраняя все ранее введенные настройки.
* Закройте вкладку браузера. Нажмите Закрыть окно в модальном окне. Любые несохраненные настройки в текущем сеансе мастера будут потеряны.

## Файл примера проекта отсутствует или поврежден

Возможная причина

Пример файла QVW в `%TEMP%\QV2QS\examples\` был удален, перемещен или изменен вне QV2QS.

Предлагаемые меры

Удалите затронутый файл из `%TEMP%\QV2QS\examples\` и перезапустите QV2QS. Новая копия извлекается автоматически при запуске. Чтобы сохранить постоянную копию файла-примера, скопируйте файл в локальную рабочую папку перед изменением. См. [Примеры проектов](https://help.qlik.com/ru-RU/migration/Content/Qv2qsMigration/getting-started/example-projects.htm).

## Узнать больше

* [Быстрый старт](https://help.qlik.com/ru-RU/migration/Content/Qv2qsMigration/getting-started/quick-start.htm)
* [Примеры проектов](https://help.qlik.com/ru-RU/migration/Content/Qv2qsMigration/getting-started/example-projects.htm)
* [Шаги мастера](https://help.qlik.com/ru-RU/migration/Content/Qv2qsMigration/user-interface/wizard-steps.htm)