This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Installing HeartSuite Core Secure – Part 2

Auto-allowlisting essential startup programs with hs-os-boot-setup.

    Overview: After rebooting into the HeartSuite Core Secure kernel, build the initial allowlist of startup and shutdown programs. This completes Phase 1 (System Verification) on the Local Path. The Dashboard then appears and guides you into Phase 2 (Program Allowlisting).

    Building the Initial Allowlist

    After booting into the HeartSuite Core Secure kernel, the management UI appears on the console automatically. The System Setup screen opens on first boot.

    Each cycle follows the same pattern:

    1. Press [a] to run the setup step — the UI scans startup and shutdown logs and adds the programs it finds to the allowlist.
    2. When the step completes, the UI reboots the system automatically (5-second countdown — press any key to cancel if needed).
    3. At the GRUB menu, select the HeartSuite Core Secure kernel again.
    4. The System Setup screen resumes at the next step automatically.

    Repeat until the setup screen shows Setup Complete in green — no manual commands are needed between cycles.

    After three to five cycles (depending on the distribution), the setup screen confirms that all startup and shutdown programs have been allowlisted.

    After Phase 1 Completes

    When the setup screen shows the completion message, press [q] to return to the Dashboard. The Dashboard displays your current progress and the Suggested Next Step guides you into Phase 2 (Program Allowlisting).

    If the UI Does Not Appear After Boot

    If the management UI does not appear on the console after booting into the HeartSuite Core Secure kernel:

    1. Switch to TTY2 (Ctrl+Alt+F2), log in as root, and check the service:
      systemctl status heartsuite-ui.service
      
    2. Verify the HeartSuite Core Secure kernel is loaded:
      uname -r
      
      Expected output: 5.19.6-HeartSuite-1.0
    3. If the wrong kernel booted, reboot and select the correct entry from the GRUB menu.

    If the Setup Screen Does Not Progress

    If after several cycles the setup screen does not show the completion message:

    1. Check the Dashboard’s Programs review queue ([p]) for any pending events and approve missing programs.
    2. Verify the HeartSuite Core Secure kernel is loaded (the Dashboard System Info Strip shows “Kernel: HS”).