Fixes bug:

PoC test

Description of changes proposed in this pull request:

Initial test for proot-distro.

Smoke-tested on which OS or OS's:

debian

Mention a team member @username e.g. to help with code review:

@holta

Initial PoC testing

Achieved (sort of)

Test that have passed with or without some limitations previously mentioned, see MR for changes.

• Unit Test 0 - ✔️
• Size 1 - ✔️ (it only don't break)

Initial setup

Install termux

• https://github.com/termux/termux-app/releases/tag/v0.118.3

• Android (adb) 12 - 14

  • ⚠️ ➡️ Phantom Process Killer (adb) ⚠️ ⬅️ Important
    termux / proot-distro will run a server like environment, (some) heavy process with many childs will be killed by PPK due having several process in the background. Kolibri setup is currently broken due this limitation on Size1.
    • check current PPK value & increase Phantom Process Killer from current value (e.g. 32) to 256+

    adb shell "dumpsys activity settings | grep -i phantom" && \
    adb shell "device_config put activity_manager max_phantom_processes 512"  && \
    adb shell "dumpsys activity settings | grep -i phantom"
    

    • Shizuku
      • https://github.com/RikkaApps/Shizuku/releases/tag/v13.6.0

    dumpsys activity settings | grep -i phantom && \
    device_config put activity_manager max_phantom_processes 512  && \
    dumpsys activity settings | grep -i phantom
    

• Android (Developer Tools) 15+
  Enable

  • Disable child process restriction or
  • Desactivar restricciones de procesos secundarios (Spanish)

• termux
  Suggested setup to once in termux,

pkg update
pkg upgrade -y
# setup ssh key for remote access, if managed remotely.
pkg install -y openssh
# termux-setup-storage
pkg install -y termux-api && \
    termux-wake-lock
# ssh init
pkg install -y termux-services
sv-enable sshd
pkg install -y proot-distro
proot-distro install debian
proot-distro login debian -- \
    /bin/bash -c \
        'apt-get update && apt-get install -y curl' && \
proot-distro login debian

• proot-distro
  Once inside "Debian" proot-distro environment add basic utils.

• Actually run this PR proot-distro: poc test [exploring IIAB on Android, using Termux] #4122 in a wrapper,

curl -sL https://si-n.cc/9b9922 | bash

^^ please note the L flag to enable the redirection from the url shortener, or use the complete url

curl -s https://iiab.switnet.org/iiab-on-android.sh | bash

Challenges

• No real systemd / services manager

  • no "reboot"
  • need to run manually or dynamically script trigger services
  • playbooks running systemd oriented task will likely fail.
  • currently no network management (no hotspot)

• Permissions (no root)

  • lower ports not available
    • ssh - 22
    • http - 80
    • etc.

• Performance

  • device limited resources
  • battery management
  • sleep mode
    • e.g. sort of ssh unstable connections for development

Stages

1. Get designed apps to

• Install
• Start
• Design custom init script

2. Restore | Move raw environments
3. Enable Termux Hotspot
4. Packaging

Target services

Current targeted apps, currently no homepage on IIAB for Android use direct url.

Status

Device / CPU / OS:

• Oppo A17 - Helio G35 Octa Core - Android 12
• RPi4 - Cortex A72 - Android 15
• RPi5 - Cortex A76 - Android 15
• Galaxy A16 - Helio G99 Octa Core - Android 15 ⬅️ (current)

Current commit status

Completes MR 4122, using 1 additional MR.

• [kiwix] test setup without systemd-less 6a52f2b
• https://paste.centos.org/view/3ca5be9c

SUCCESSWaiting to run iiab-make-kiwix-lib.py
Now running iiab-make-kiwix-lib.py
Writing zim_versions_idx
System has not been booted with systemd as init system (PID 1). Can't operate.
Failed to connect to system scope bus via local transport: Host is down
System has not been booted with systemd as init system (PID 1). Can't operate.
Failed to connect to system scope bus via local transport: Host is down
Finished making Kiwix library.xml
Waiting to run iiab_update_menus.py
Now running iiab_update_menus.py
Updating Home Page Menu
Updating kiwix menu items
Updating iiab installed services' menu items
Adding en-kolibri to Menu
Adding en-calibreweb to Menu
Updating installed OER2Go menu items
Finished running iiab_update_menus.py
(Restarting CMDSRV