На этой странице описан процесс установки postmarketOS с использованием готовых образов.
Подготовка
Если в процессе установки у вас возникнут какие-либо проблемы или появятся вопросы, не стесняйтесь обращаться за помощью в наши чаты Matrix/IRC.
Возможно, вам стоит сначала прочитать всю статью, чтобы хорошо понять процесс установки.
Обязательно ознакомьтесь с вики-страницей, посвященной вашему устройству. Ее можно найти на странице «Устройства» или с помощью поиска.
Держите её под рукой во время установки — нам скоро понадобится информация, содержащаяся на ней.
Проверьте статус Pre-built images в информационном блоке на странице устройства или ознакомьтесь с таблицей на сайте postmarketos.org/download, чтобы узнать, доступен ли образ для вашего устройства.
Образы доступны для всех устройств из категорий «main» и «community», а также для некоторых отдельных устройств из категории «testing».
Помимо резервного копирования раздела userdata, также рекомендуется создать резервную копию заводской системы (или другой рабочей) на случай, если вам захочется вернуться к прежней ОС.
В данном руководстве предполагается, что вы используете Linux, имеете права root и доступ к терминалу.
Краткий словарь
Загрузочный раздел — раздел /boot на устройствах Android, в котором хранятся ядро и initramfs.
initramfs — начальная среда, загружаемая ядром в оперативную память. Именно она монтирует разделы и подготавливает систему к загрузке перед переключением на rootfs.
Корневая файловая система (rootfs) — основной системный раздел postmarketOS. Именно в нём хранятся все системные и пользовательские данные.
Загрузка образов
Приведенные ниже скриншоты носят иллюстративный характер и могут быть не актуальными.
Откройте postmarketos.org/install, затем прокрутите вниз. Найдите своё устройство в таблице.
Справа вы увидите ссылки на образы последнего стабильного (stable) выпуска или выпуска edge. Выберите интересующую вас версию.
➜
Выбор интерфейса и версии
После выбора версии вы перейдете на страницу выбора папки. На первом экране выберите папку, соответствующую интерфейсу, который вы хотите выбрать. На следующем экране выберите самый последний образ.
➜
Выбор образов для загрузки
Вам будет предложено загрузить несколько файлов. См. информацию ниже.
Сначала загрузите образ rootfs:
{кодовое название}-.img.xz — содержит корневую файловую систему (rootfs) — основной системный раздел.
В зависимости от вашего устройства вам также может потребоваться загрузить один из следующих образов:
{кодовое название}-boot.img.xz — содержит загрузочный раздел Android. Используется только в Android-устройствах.
{кодовое название}-bootpart.img.xz — используется в некоторых устройствах (например, ASUS MeMO Pad 7 (asus-me176c)), в которых загрузочный раздел и корневая файловая система разделены.
Они доступны только для некоторых устройств, так что не переживайте, если не найдёте их для своего. Как и всегда, если вы в чём-то не уверены, загляните на страницу вашего устройства в вики.
Проверка загруженных файлов
Настоятельно рекомендуется выполнить этот шаг. Это позволит вам избежать различных проблем, отладка которых в противном случае может оказаться затруднительной.
Для каждого загруженного файла на странице загрузки указана соответствующая контрольная сумма в форматах sha256 и sha512. Сравните контрольные суммы на сайте с контрольными суммами ваших локальных файлов, вычисленных с помощью следующих команд:
Скачанные вами образы находятся в сжатом виде. Чтобы их можно было прошить, необходимо извлечь их из архивов.
Переместите скачанные файлы в отдельный каталог, а затем для каждого из архивов выполните следующую команду:
$ xz--decompressпуть-к-файлу-образа.img.xz
У вас должны появиться файлы с расширением .img, соответствующие извлечённым архивам. Можете удалить файлы с расширением .xz.
Выбор места установки корневой файловой системы (rootfs)
Прежде чем приступить к прошивке postmarketOS, необходимо определиться, в какой раздел ее устанавливать.
В Android-устройствах стандартная ОС разделена на разделы «system» и «userdata» (в более новых устройствах вместо раздела «system» может присутствовать раздел «super» и/или использоваться система слотов A/B). Системный раздел меньше по размеру (около 1–2 ГБ, в зависимости от возраста вашего устройства), но установка на него позволяет пользователю быстро вернуться к исходной ОС Android без потери данных.
Однако некоторым графическим интерфейсам требуется больше места, и при установке нового программного обеспечения или добавлении новых файлов свободное место быстро закончится. Таким образом, наиболее распространёнными местами для установки являются:
Раздел userdata — это раздел, используемый Android для хранения пользовательских данных. Если вы выполните установку в этот раздел, ваши данные Android будут стёрты!
SD-карта — на устройствах, оснащённых слотом для внешней памяти, можно прошить образ системы postmarketOS в SD-карту.
Прошивка образов
WARNING: Это ваш последний шанс убедиться, что все важные данные с устройства были скопированы!
На этом этапе ознакомьтесь с разделом «Установка» на вики-странице вашего устройства. В этом разделе описан общий процесс прошивки образов, также на вики-странице вашего устройства может содержаться дополнительная информация или перечень предварительных условий для прошивки (например, для некоторых устройств перед прошивкой других образов потребуется сначала прошить дополнительный загрузчик, такой как lk2nd, U-Boot, или uniLoader).
Прошивка корневой файловой системы (rootfs)
В зависимости от выбранного вами места установки процесс прошивки корневой файловой системы (rootfs) будет немного отличаться.
Конкретные команды будут зависеть от того, какое у вас устройство и какой протокол прошивки оно использует. Следуйте инструкциям на вики-странице вашего устройства.
Если на странице нет инструкций, воспользуйтесь следующими общими командами:
Fastboot
Загрузите и установите Android platform tools или пакет android-tools из репозиториев вашего дистрибутива.
Подключите устройство к компьютеру и перейдите в режим прошивки.
Выполните команду fastboot devices, чтобы убедиться, что ваше устройство распознано.
Выполните команду fastboot flash раздел (замените на «userdata» или «system») путь-до-rootfs.img чтобы прошить образ.
Если вы выполняете прошивку в раздел «userdata», вам также может понадобиться очистить системный раздел с помощью команды fastboot erase system.
Когда процесс прошивки завершится, перезагрузите устройство командой fastboot reboot. Перезагрузка именно через эту команду, а не вручную (кнопкой питания), гарантирует, что все данные запишутся правильно.
Heimdall (Samsung Download Mode/Odin)
На многих устройствах Samsung, поддерживающих запуск ядра Linux ветки mainline или близкого к ней, используется загрузчик lk2nd. Он добавляет режим fastboot. Ещё раз: перед прошивкой обязательно ознакомьтесь с вики-страницей вашего устройства!
Вы также можете использовать heimdall через chroot-среду pmbootstrap; запустите pmbootstrap chroot apk add heimdall, а затем выполните следующие команды в режиме pmbootstrap chroot heimdall.
Выполните команду heimdall print-pit, чтобы получить список разделов. Системный раздел обычно называется SYSTEM, а раздел данных — USERDATA или DATA. Загрузочный раздел (необходимый для прошивки ядра) обычно называется BOOT или KERNEL.
Устройство перезагрузится; перезагрузите его обратно в Download Mode.
Выполните команду heimdall flash --PARTITION путь-к-rootfs.img, заменив PARTITION на раздел, полученный с помощью команды выше.
процесс практически одинаков для всех устройств:
Определите путь к вашей SD-карте с помощью команды lsblk. Вы должны получить путь вида /dev/mmcblk.... Обязательно убедитесь, что указали правильный путь — в противном случае вы ПОТЕРЯЕТЕ все свои данные!
Если вы сомневаетесь, выполните команду sudo fdisk -l /dev/[ваше_устройство], которая выведет информацию об этом устройстве.
Указывайте путь к самому устройству, без номера раздела (например, /dev/mmcblk0, а не /dev/mmcblk0p1).
Выполните команду sudo dd if=путь-к-rootfs.img of=/dev/mmcblk... bs=4M status=progress, заменив «путь-к-rootfs.img» на путь к файлу образа, который вы распаковали ранее, а «/dev/mmcblk...» — на путь к вашей SD-карте..
Если вы не хотите использовать dd, можно воспользоваться более простыми графическими утилитами с понятным интерфейсом для записи образа на SD-карту (например, Etcher).
Если ваше устройство поддерживает прямую загрузку с SD-карты (например, PINE64 PinePhone (pine64-pinephone)), вам не нужно прошивать ничего дополнительно.
При первой загрузке postmarketOS автоматически попытается расширить новый корневой раздел на весь объем SD-карты. Если этот процесс завершится ошибкой и раздел rootfs останется слишком маленьким, см. #Установка на SD-карту: Root partition is too small.
Прошивка образа boot
Если у вас Android-устройство, вам, скорее всего, также потребуется прошить образ boot. Процесс в основном аналогичен процедуре прошивки образов rootfs, но слово «userdata» или «system» заменяется на «boot».
Завершение прошивки
После того как вы прошили все необходимые образы, перезагрузите устройство. Если вы всё сделали правильно, на экране должен появиться экран входа в выбранный вами графический интерфейс.
По умолчанию учетная запись пользователя в готовых образах называется user, а пароль — 147147. У вас должно получиться войти в систему, используя эти учетные данные.
Если всё прошло успешно, у вас теперь должна работать postmarketOS! Приятного пользования!
Загрузка обновлений
Образ, с которого вы выполнили установку, может быть немного устаревшим. Поэтому после установки системы настоятельно рекомендуется выполнить обновление.
Для этого убедитесь, что у вас есть подключение к Интернету, а затем выполните в терминале команду sudo apk upgrade -U.
Завершая настройку
После установки из готового образа вам, возможно, захочется изменить некоторые настройки:
Часовой пояс по умолчанию не настроен; его можно изменить в приложении «Настройки» вашего графического интерфейса.
Возможно, вам захочется изменить пароль по умолчанию — это можно сделать либо через приложение «Настройки» вашего графического интерфейса, либо с помощью команды passwd в терминале.
В этом разделе описаны некоторые способы решения типичных проблем; более подробные инструкции по устранению неполадок см. в статье Устранение неполадок.
Fastboot/heimdall не обнаруживает устройства или выдаёт ошибку «permission denied»
Убедитесь, что ваше устройство загружено в Fastboot/Download Mode.
Попробуйте использовать другой кабель.
Установка на SD-карту: Root partition is too small
Обычно postmarketOS пытается расширить корневой раздел при первой загрузке, однако на некоторых устройствах (в частности, на тех, что работают не на ядре, близком к mainline) это может не сработать. Если при установке на SD-карту вы обнаружите, что корневой раздел на вашем устройстве не занимает всё доступное пространство, выполните следующие действия для его расширения:
Подключите SD-карту к компьютеру. Определите путь к устройству SD-карты без суффикса (номера раздела) (например, /dev/mmcblk0, а не /dev/mmcblk0p1).
Выполните команду sudo fdisk /dev/mmcblk..., где /dev/mmcblk...> — путь, полученный на предыдущем шаге.
Нажмите p для вывода списка разделов. Вы должны увидеть два раздела: pmOS_boot и pmOS_root. Запишите номер корневого раздела (обычно это 2), а также значение в столбце «Start» (начальный сектор).
Нажмите d для удаления раздела; при запросе введите номер корневого раздела, полученный на предыдущем шаге.
Это действие не приведет к потере данных, оно лишь удалит запись о разделе из таблицы разделов.
Нажмите n для пересоздания раздела. Следуйте подсказкам:
Partition type: p (primary / основной)
Partition number: номер раздела, который вы записали ранее.
First sector: значение «Start» исходного корневого раздела (то самое, которое вы записали).
Last sector: значение по умолчанию займёт всё доступное пространство, поэтому просто нажмите Enter.
Если вам нужен раздел определенного размера, можете ввести, например, +16GB (при условии, что на SD-карте достаточно свободного места).
Do you want to remove the signature?: введите N (нет). Сигнатуру удалять нельзя, так как это приведет к повреждению файловой системы и потере данных.
Снова нажмите p и убедитесь, что созданный раздел настроен правильно.
Нажмите w для записи изменений. После этого программа fdisk автоматически закроется.
Выполните команду sudo e2fsck -f /dev/mmcblk...pX, где /dev/mmcblk...pX — путь к устройству с номером раздела (суффиксом). Вместо X подставьте номер раздела, который вы определили ранее в fdisk.
Выполните команду sudo resize2fs -f /dev/mmcblk...pX (снова подставив нужный путь вместо /dev/mmcblk...pX), чтобы расширить файловую систему до размеров нового раздела.
После этого размер раздела должен измениться. Вы можете попробовать смонтировать его на компьютере, чтобы убедиться, что всё прошло успешно.
