Astra Mobile(Astra Linux - режим функионирования "Мобильный") - инструкция по установке и настройке
===================================================================================================

Public Wiki: https://www.astralinux.ru/ALSE_Mobile_doc

Архитектура: Intel amd64 (x86-64) UEFI / aarch64(arm64)

имя администратора: administrator
пароль: administrator (новый пароль задается при первой загрузке ОС)


Cоздание загрузочной установочной USB Flash на intel ПК:
--------------------------------------------------------
Linux:
- проверьте контрольную сумму GOST или MD5 загруженного образа командой md5sum usb-astra-mobile-Y.Y.Y.mobileXX-ARCH.img 
  или gostsum usb-astra-mobile-Y.Y.Y.mobileXX-ARCH.img и сравните с usb-astra-mobile-Y.Y.Y.mobileXX-ARCH.img.md5 или с usb-astra-mobile-Y.Y.Y.mobileXX-ARCH.img.gost
- запустите ОС AstraLinux 1.7/1.8 (или другую ОС семейства Linux)
- войдите администратором, откройте терминал и выполните команду sudo -s (или войдите под root в других системах)
- установите в ПК исправную USB Flash размером 16Гб или более
- выполните команду:
  dd if=./usb-astra-mobile-Y.Y.Y.mobileXX-ARCH.img of=/dev/XXX bs=1M status=progress
  (где XXX - имя уcтройства USB Flash, после подключения имя можно получить из вывода команды dmesg, Y - версии, ARCH - архитектура)

  Время выполнения операции создания загрузочной установочной USB Flash на ПК составляет в среднем около 5 минут, 
  если у Вас время значительно больше или возникают ошибки при установке - необходимо использовать новый скоростной USB Flash накопитель.
  (рекомендуемая модель USB Flash: Transcend Jetflash 780 32ГБ USB3.0 TS32GJF780)

Windows:
- проверьте контрольную сумму MD5 загруженного образа командой certutil -hashfile путь_к_файлу\usb-installer-astra-mobile-amd64.img 
  и сравните с usb-astra-mobile-Y.Y.Y.mobileXX-ARCH.img.md5
- Скачайте программу Rufus из поставочного комплекта файлов или с сайта https://rufus.ie/ru/
- Создайте загрузочную USB Flash из образа usb-astra-mobile-Y.Y.Y.mobileXX-ARCH.img используя программу Rufus выбрав устройство USB Flash и образ
macOS:
- проверьте контрольную сумму MD5 загруженного образа командой: md5 usb-astra-mobile-Y.Y.Y.mobileXX-ARCH.img 
  и сравните с usb-astra-mobile-Y.Y.Y.mobileXX-ARCH.img.md5
- скачайте программу balenaEtcher https://www.balena.io/etcher/
- Создайте загрузочную USB Flash из образа usb-astra-mobile-Y.Y.Y.mobileXX-ARCH.img используя программу balenaEtcher выбрав устройство USB Flash и образ


Установка/обновление с загрузочной установочной USB Flash:
----------------------------------------------------------
- подключите Usb Flash к мобильному устройству
- подключите Usb клавиатуру
- перезагрузите
- войдите в bios
- установите пароль на вход в bios(рекомендуемая настройка)
- установите корректную дату и время
- выберите вручную вариант загрузки UEFI: Usb flash name
- автоматически стартует программа установки: /opt/astra-mobile-install-tui
- выберите действие, диск и тип устройства
- в конце установки нажмите Enter, устройство завершит работу.
- отключите установочную USB Flash

Дополнительные опции:
 - Для выхода в консоль выберите действие Exit)

 - Для установки вручную из консоли можно выполнить команду:
 /opt/astra-mobile-install -d /dev/DISK_NAME
 (где DISK_NAME - имя уcтройства внутренней flash памяти, например /dev/mmcblk1 для некоторых моделей mig/iru, /dev/mmcblk0 для некоторых моделей lenovo, вывести список устройств: lsblk)

- Для обновления системы вручную при котором /opt и /home разделы будут сохранены, выполнить команды после автологина под root:
  /opt/astra-mobile-install -u -d /dev/DISK_NAME
  (где DISK_NAME - имя уcтройства внутренней flash памяти, например /dev/mmcblk1 для некоторых моделей mig/iru, /dev/mmcblk0 для некоторых моделей lenovo, вывести список устройств: lsblk)

  Время выполнения операции установки ОС на устройство с загрузочной установочной USB Flash на ПК составляет в среднем около 3 минут, 
  если у Вас время значительно больше или возникают ошибки при установке - необходимо использовать новый скоростной USB Flash накопитель.
  (рекомендуемая модель USB Flash: Transcend Jetflash 780 32ГБ USB3.0 TS32GJF780)


Первый запуск системы(OEM настройка) и первичная настройка:
-----------------------------------------------------------
- установите пароль для учетной записи administrator, уровень защищенности и включите необходимые механизмы защиты.
- после запуска если устройством будет пользоваться один пользователь для удобства можно включить автоматический вход для этого пользователя и отключить 
  разблокировку без пароля в разделе "Безопасность"


Гироскоп(поворот/автоповорот):
------------------------------
- для устройств/виртуальных машин где нет гироскопа(или проблемы с его драйвером) можно включить программные кнопки поворота интерфейса в разделе "Панель быстрого доступа" 
 в настройках системы


Настройка аппаратных платформ: 
------------------------------
(выполняйте только при наличии проблем, настройки в общем случае применяются инсталлятором при выборе устройства)
запустите программы настройки, специфичные для аппаратной платформы из каталога /root/hardware/[platform_name],например:
- для настройки камеры МИГ T8X исп.51 запустите: sh /root/hardware/mig/t8s-v51-fix
- для исправления ориентации экрана МИГ T8X запустите: sh /root/hardware/mig/calibrate-screen
- для исправления ориентации экрана МИГ T10 и работы тачскрина запустите: sh /root/hardware/mig/calibrate-screen-and-fix-touch-t10 
- для исправления ориентации экрана IRU celeron  запустите: sh /root/hardware/iru1/calibrate-screen
- для работы тачскрина IRU Onyx i7 запустите: sh /root/hardware/iru1/fix-touch-onyx-i7

Настройка автовхода(автологин):
-------------------------------
- для работы автовхода в настройках в разделе "Безопасность" настройте автоматический вход в систему.
или запустите sh /root/hardware/all/enable_autologin
Примечание:
для однопользовательского режима в некоторых случаях можно включить автоматический вход и отключить разблокировку без пароля.


Запуск готового образа qcow2 в Astra Linux в virt-manager:
----------------------------------------------------------
- установить Astra Linux 1.7, установить virt-manager, ovmf
  (при создании новой машины указать объем ОЗУ не менее 4Гб, выбрать импорт диска, указать qcow2 образ, 
   на крайнем шаге указать доп.настройку машины и выбрать тип загрузки EFI)


Запуск готового образа qcow2 в Astra Linux в virtualbox:
----------------------------------------------------------
- установить Virtualbox и VirtualBox Extension Pack с сайта https://www.virtualbox.org/
- выполнить конвертацию образа следующими командами:
    qemu-img convert -f qcow2 disk-astra-mobile-1.7.X.mobileXX-x86_64-1.qcow2 -O raw disk-astra-mobile-1.7.X.mobileXX-x86_64-1.raw
    VBoxManage convertfromraw disk-astra-mobile-1.7.X.mobileXX-x86_64-1.raw disk-astra-mobile-1.7.X.mobileXX-x86_64-1.vdi --format vdi
- добавить диск в процессе создание виртуальной машины(в настройках машины включить EFI)


Запуск приложений android:
--------------------------
Запуск приложений для android выполняется средствами waydroid - https://docs.waydro.id/
- для работы на системе сначала надо установить waydroid из расширенного репозитория и выполнить команду sudo waydroid init (она загрузит открытый образ андроид контейнера lineage)
- перезагрузите ПК (при необходимости в сессии пользователя выполнить команду waydroid session start)
- установить apk(должен быть для текущей архитектуры процессора) можно командой: waydroid app install apkname.apk
- просмотреть список доступных программ можно командой: waydroid app list
- запуск команды (если не появилась в меню): waydroid app launch com.xxx.progname ( com.xxx.progname - имя из waydroid app list)
(загрузить apk для нужной архитектуры можно с сайта разработчика или c https://www.apkmirror.com/ установив фильтр для архитектуры при поиске)


Запуск мобильной сессии без менеджера входа fly-dm:
---------------------------------------------------
- в консоли войти под administrator c паролем 1
- запустить dbus-run-session /usr/bin/kwinwrapper


Запуск менеджера входа fly-dm через Xwayland:
---------------------------------------------
- в файле /etc/X11/fly-dm/fly-dmrc параметр ServerCmd=/usr/lib/xorg/Xorg -br ...заменить на ServerCmd=/usr/bin/Xwayland
- перезагрузить устройство


Запуск Мобильной Астры aarсh64(arm64) в виртуальной машине на intel хосте:
--------------------------------------------------------------------------
- Установите AstraLinux 1.7.1
- Установите пакеты ovmf qemu-efi-aarch64 ( qemu-efi-aarch64 из debian)
- Запустите virt-manager
- Создайте машину c архитектурой aarch64
(при создании новой машины выбрать импорт диска, указать qcow2 образ, на крайнем шаге указать доп.настройку машины и выбрать тип загрузки EFI)
- Добавьте в виртуальную машину устройства: Видео(Virtio), Дисплей(SPICE), Клавиатуру, Мышь
