Инструкция по переводу автоматизированных рабочих мест на использование операционной системы Linux

2. Выполнение сценариев миграции

2.5. Типичные ошибки и способы их устранения

Узел/Граф	Проявление	Причина возникновения	Способ устранения
До создания автоматизации	Windows-клиент не появляется в списке	Отсутствует сетевая связность или не синхронизированы модули SaltStack на мастере, синдике и рабочих станциях.	На мастере проверьте наличие ключа: `# salt-key -f <ID клиента>` Если клиент подключён к синдику, тогда выполните аналогичную проверку на синдике. Если вывод команды пустой, то ключа с таким именем не существует, в этом случае проверьте настройки клиента, а также связь между сервером и клиентом, доступность портов TCP/4505, TCP/4506 сервера Программы «Атом.Порт» с рабочей станции. Если клиент подключён к синдику, необходимо также выполнить синхронизацию хранилища синдика с мастером, для этого выполните: `# salt <ID синдика> state.apply states.syndic.sync` После успешного завершения проверьте доступность клиента с мастера и/или синдика, обновите модули и получите значения grains: `# salt <ID клиента> test.ping # salt <ID клиента> saltutil.sync_all # salt <ID клиента> state.apply # salt <ID клиента> grains.items # salt <ID клиента> grains.item charon_uuid` Все команды должны вернуть ответ true. Последняя команда должна вернуть уникальное значение идентификатора клиента.
До создания автоматизации	Возникает дублирование ключей.	Установка клиента Salt Minion на АРМ и его регистрация в программе "Атом.Порт" с последующим удалением и повторной установкой клиента (при повторной установке возникают дубликаты).	Удалите клиента Salt Minion с АРМ, включая ключи и все настройки. После удаления программа-установщик запросит подтверждение нажатием кнопки "ОК". Удалите обе задублированные рабочие станции в Программе «Атом.Порт». Удалите ключи на мастере/синдике командой: `salt-key -d minion.test.ru.` Установите клиента Salt Minion на АРМ.
install_helper	Не устанавливается загрузчик GRUB.	В антивирусной программе не настроены исключения для файлов и сетевых взаимодействий ПО «Атом.Порт».	В антивирусной программе настроить исключения в соответствии с руководством системного администратора Программы «Атом.Порт».
install_helper		Иное ПО (например, Acronis) блокирует запись в загрузочный раздел диска.	Запретить выполнение программ, блокирующих доступ к загрузочному разделу диска.
waiting_helper	Служебный клиент не появляется в записи рабочей станции. Ошибка выполнения узла waiting_helper.	Некорректная настройка параметров BIOS рабочей станции.	Проверить, что опция Secure Boot, отключена в BIOS. Отредактировать порядок загрузки в BIOS: отключить принудительную загрузку Windows, установить первым по порядку GRUB.
create_image_system_drive	Не проходит проверка логов после снятия образа диска с ОС Windows.	Неисправность диска.	Выполнить проверку HDD или SDD (запустить полную проверку поверхности).
create_image_system_drive	Образ диска с ОС Windows медленно копируется на сервер.	Недостаточная пропускная способность сети.	Обеспечить пропускную способность сети в соответствии с руководством системного администратора Программы «Атом.Порт».
create_image_system_drive		Сетевой интерфейс рабочей станции подключён через транзитный порт другого устройства (например, IP-телефона).	Подключить сетевой интерфейс рабочей станции к отдельному порту коммутатора.
create_image_system_drive	Во время перезагрузки после выполнения узла create_image_system_drive невозможно самостоятельно выбрать ОС для загрузки (служебную ОС или ОС Windows). Меню GRUB не отображается, происходит загрузка служебной ОС.	Невозможность создания файла с образом ОС Windows на сервере вследствие любой ошибки в процессе копирования образа (потеря соединения с сервером и т. п.).	Изменить приоритет загрузки ОС в загрузчике GRUB вручную (см. раздел 2.3).
waiting_linux	Клиент Linux не появляется в записи рабочей станции. Ошибка выполнения узла waiting_linux.	Некорректная настройка параметров BIOS рабочей станции.	Отредактировать порядок загрузки в BIOS, установив первым по порядку GRUB.
check_system_drive, collect_information, install_helper, create_image_system_drive, install_linux_system_drive, configure_minion, download_image_and_cre-ate_virtual_machine, install_software	В интерфейсе Программы «Атом.Порт» статус клиента «Оффлайн», при этом клиент фактически доступен для управления.	Сетевой интерфейс рабочей станции подключён через транзитный порт другого устройства (например, IP-телефона).	Подключить сетевой интерфейс рабочей станции к отдельному порту коммутатора.
Любой узел	В логе узла отображается “No more route”	Клиент недоступен, выключен либо неработоспособен.	Проверить работоспособность службы salt-minion на рабочей станции. Проверить доступность портов TCP/4505, TCP/4506 сервера Программы «Атом.Порт» с рабочей станции. После исправления ошибки перезапустить узел.
Любой узел	В логе узла отображается “SP reached deadline”	Превышен таймаут ожидания выполнения узла.	Перезапустить узел.
helper_backup_linux helper_backup_user_folders helper_create_image_system_drive helper_install_linux_drive_partition helper_install_linux_pxe helper_install_linux_rootfs_partition helper_install_linux_second_drive_with_crypto helper_install_linux_second_drive_with_virtual_machine helper_install_linux_second_drive helper_install_linux_system_drive helper_resize_windows_partition helper_restore_linux helper_restore_user_folders helper_restore_windows_from_image helper_upgrade_linux	Утечка памяти во вспомогательной ОС, если используется система виртуализации zvirt.	На виртуальной машине должны стоят гостевые дополнения которые в себя включают механизм ballooning для управления и освобождения памяти	Установка гостевых дополнений: В самом zvirt библиотека управления памятью должна быть не ниже версии vdsm-4.30.34. Если используется zvirt версии 3, необходимо обновиться. На данный момент актуальная версия zvirt - 4.2.