/usr/bin/iiab-apps-to-be-installed: Quick scan to see what's asked for but not yet installed

[holta]

/usr/bin/iiab-apps-to-be-installed is a command-line convenience for testers/devs primarily:

It intentionally scans the status of most all apps/services/roles (even a few ugly duckling stepchildren) to help with debugging — giving you a list of those apps that were requested to be installed, but are not yet recorded as installed.

Example: bluetooth_install: True is a very common setting in /etc/iiab/local_vars.yml and default_vars.yml, yet it rarely results in bluetooth_installed: True in /etc/iiab/iiab_state.yml (unless your hardware is Raspberry Pi!)

Summary: Whatever the reason for the app/service/role not having been fully installed, you can run iiab-apps-to-be-installed to quickly surface all such discrepancies, so you can immediately take action (or ignore these "to be installed" discrepancies, as you choose!)

Tested on Ubuntu 20.04

Refs:

• PR Prototype 'skip_role_on_error: True' in 4 roles {lokole, moodle, mongodb, sugarizer} #3255
• PR Support skip_role_on_error in 23+3 more roles (Stages 6-9) [and FreePBX module 'sipsettings' won't install?] #3256

[holta]

/usr/bin/iiab-apps-to-be-installed was further tested with an EXTRA-LARGE-sized IIAB install on Mint 20.3:

1. After running curl iiab.io/risky.txt | sudo bash it showed these 30 apps "to be installed" :

   root@box:~# iiab-apps-to-be-installed
   awstats
   bluetooth
   calibreweb
   captiveportal
   cups
   gitea
   internetarchive
   jupyterhub
   kalite
   kiwix
   kolibri
   mediawiki
   minetest
   moodle
   mosquitto
   munin
   mysql
   nextcloud
   nginx
   nodered
   openvpn
   osm_vector_maps
   remoteit
   samba
   sshd
   sugarizer
   transmission
   usb_lib
   vnstat
   wordpress
   

2. After editing /etc/iiab/local_vars.yml, it showed these 6 additional apps "to be installed" : (36 in total)

   calibre
   lokole
   monit
   pbx
   phpmyadmin
   squid
   

3. After ./iiab-install completed successfully, it showed this 1 single app remaining (of the 36) "to be installed" :

   root@box:~# iiab-apps-to-be-installed
   bluetooth
   

The VM's iiab-diagnostics are: http://sprunge.us/U4A1rM?en

[holta]

FYI of the 43+ XYZ_installed: True vars that can end up in /etc/iiab/iiab_state.yml, 4 of those vars (below) are rather different than the others — they're not declared or mentioned initially i.e. in places like default_vars.yml or in any of the local_vars_*.yml files in /opt/iiab/iiab/vars :

root@box:~# grep -r 'iiab_admin_install\|www_base_install\|pylibs_install\|www_options_install' /opt/iiab/iiab/vars

root@box:~# grep -r 'iiab_admin_install\|www_base_install\|pylibs_install\|www_options_install' /etc/iiab/iiab_state.yml
iiab_admin_installed: True
www_base_installed: True
pylibs_installed: True
www_options_installed: True