Устранение неполадок

Вы можете выбрать, какая ОС загружается, временно или постоянно, с помощью встроенного в систему средства выбора загрузки. Для этого необходимо полностью выключить устройство:

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

Вы также можете выбрать самый правый значок «Параметры», чтобы войти в систему recoveryOS, которую можно использовать для выполнения операций восстановления. Вам могут быть предложены ввести учетные данные для входа в macOS, в зависимости от состояния безопасности вашего компьютера. На главном экране параметров recoveryOS вы можете открыть окно терминала, нажав Shift-Command-T.

Если во время обновления пакета ядра возникла проблема или какая-либо другая проблема, которая препятствует правильной загрузке ядра, вам может потребоваться войти в меню GRUB, чтобы выбрать другое ядро или изменить параметры загрузки.

Серверные и минимальные установки должны отображать меню GRUB по умолчанию. При установке на настольный компьютер вам необходимо в нужный момент нажать Escape, чтобы войти в меню GRUB. Когда система загрузится, вы увидите цикл отображения m1n1 (логотипы Asahi Linux или Fedora) и U-Boot (текстовый экран с логотипом U-Boot в правом верхнем углу). На экране U-Boot отобразится краткий обратный отсчет. Нажмите Escape сразу после того, как обратный отсчет достигнет 0, чтобы войти в меню загрузки GRUB.

Отсюда вы можете выбрать более старую версию ядра (например, для восстановления после неудачной установки ядра) или изменить параметры загрузки (например, для сброса пароля или восстановления после других системных проблем).

У U-Boot могут возникнуть проблемы с некоторыми типами USB-устройств. Если вы наблюдаете странное поведение или журналы U-Boot, попробуйте отключить все USB-устройства (кроме одной клавиатуры для настольных компьютеров).

Если у вас возникли проблемы с работой внешней клавиатуры в меню U-Boot или GRUB, вы можете попробовать использовать другой порт USB (например, USB C с адаптером вместо USB A) или другую клавиатуру. Поскольку U-Boot поддерживает только одну клавиатуру, убедитесь, что другие USB-устройства, имитирующие клавиатуру, не подключены. Сюда входят некоторые USB-мыши, а также определенные USB-токены, считыватели штрих-кодов и т. д. (YubiKeys уже должны быть исключены и проигнорированы в U-Boot).

Если на консоли m1n1 отображается сообщение Running proxy…​, это обычно означает, что на stage 1 в m1n1 возникли проблемы с загрузкой stage 2 в m1n1.

Если это произошло после обновления системы, возможно, новый обновленный двоичный файл 2 этапа был установлен неправильно. Вы можете загрузиться в macOS или recoveryOS (см. раздел Изменение запускаемой операционной системы) и выполните следующие шаги, чтобы вернуться к предыдущей версии m1n1 stage 2 и U-Boot..

Если вы используете macOS, вы также можете выполнить действия по управлению файлами с помощью Finder. После монтирования раздела с помощью diskutil он появится на боковой панели Finder.

После возврата m1n1.bin загрузитесь обратно в Fedora Asahi Remix, чтобы протестировать восстановленную версию m1n1 stage 2 и U-Boot в частности.

Обратите внимание, что возврат двоичного файла m1n1 stage 2 к предыдущей версии не гарантирует корректную работу, поскольку иногда происходят несовместимые изменения в дереве устройств, которые сопровождают обновления версии ядра. После восстановления вы можете обнаружить, что некоторое оборудование работает некорректно. После успешной загрузки Linux вам следует запустить sudo update-m1n1 для обновления до текущей версии и снова перезагрузиться.

Иногда политика загрузки системы для Fedora Asahi Remix может быть повреждена. Иногда это происходит после обновлений macOS (из-за ошибок в процессе обновления Apple). Если это произойдет, попытка загрузки этой операционной системы приведет к немедленной перезагрузке. Если эта ОС является загрузочной ОС по умолчанию, компьютер будет неоднократно перезагружаться, пока не появится экран восстановления ОС. Если это произойдет, вам необходимо восстановить stage 1 m1n1 и связанную с ним политику загрузки.

Обновление встроенного ПО системы также может вызвать несовместимость в stage 1 m1n1, требующую обновления. Это может произойти, если вы обновитесь до macOS Sonoma 14.5 или более поздней версии с версией m1n1 stage 1 старше 1.4.13 (выпущенной в мае 2024 г.) из-за ошибки в этих старых версиях m1n1. Чтобы решить эту проблему, обновите stage 1 m1n1.

The process for both of the above situations is the same. First, follow the steps in Изменение запускаемой операционной системы to boot into recoveryOS (preferred) or macOS, and open a Terminal. Ensure you are connected to the internet, and then run the Fedora Asahi Remix installer again, using the instructions in the Installation page (or the steps available on asahilinux.org). Once the installer starts, one of the available options should be to Repair an incomplete installation (p) or Upgrade m1n1 on an existing OS (m). Choose the appropriate option and follow the instructions to upgrade or reinstall m1n1 stage 1.

If you need to reinstall m1n1 stage 1 or otherwise reset the Boot Policy but the installer does not prompt with either of the above two options, you can run bputil -f and then select the UUID corresponding to the installation that you wish to repair (this will be displayed when you start up the installer, in the partition list). Follow the prompts to reset your Boot Policy, which will erase the m1n1 bootloader and place the installation into the "incomplete" state. Once this is complete, you may follow the steps above again to launch the installer and select the "Repair" option, which should now be available. We have heard some reports that this situation can occur after machines are sent to Apple for servicing.

If your machine is stuck displaying an exclamation mark icon (laptops and iMacs) or SOS LED blink pattern (desktops), you may need to perform a DFU Revive or Restore. To determine if this is necessary, first try to boot using both the current paired recoveryOS and the System recoveryOS.

To boot using the current recoveryOS:

To boot using the System RecoveryOS:

If either of those processes succeeds and shows the Boot Picker, you can choose an alternate OS to boot or select the "Options" icon to boot recoveryOS and troubleshoot the issue or reinstall another OS from that environment.

If your machine fails to boot or enter Startup Options, you may have to perform a DFU Revive or Restore.

A DFU Revive will restore and update System Firmware and Recovery (SFR), while leaving operating systems and data intact. This may be able to resolve some issues, but is not guaranteed to work (e.g. a DFU Revive cannot recover a missing System Recovery partition, but it can reinstall recoveryOS into an existing but blank System Recovery partition with the appropriate subvolume).

A DFU Restore will completely wipe all data on the internal storage and restore the machine to factory condition. It is also the only way to downgrade System Firmware to a prior version. This process can recover from any kind of corruption or problem with the internal NVMe storage, and even corruption of the internal NOR Flash storage and several other firmware components. Note that if you perform a DFU Restore, you will lose all data stored on the machine, and it will be returned to its factory condition.

To perform a DFU Revive or Restore, you will need either another Mac running macOS, or a Fedora Linux machine (any hardware) with an available USB port. You will also need an appropriate USB cable to connect both machines together.