Pre Release Testing

Full Test

Applies to: Core (iso)

Live boot and install to hard drive

• create new empty VM (using VirtualBox, VMware, Proxmox (KVM), etc)
• check that core boots in live mode
• reboot
• check that core installs to hard drive
• reboot
• check that install to hard drive works

Confconsole

• Loads after boot, shows TKLBAM not initialized

• Network configuration works (DHCP + Static IP)

  • Set DNS to 8.8.8.8, check /etc/network/interfaces

Console sysinfo

• test (as per below)

$ ssh testcore

Welcome to Core, TurnKey GNU/Linux 17.0rc1 (Debian 11/Bullseye)

  System information for Tue Dec 07 00:33:38 2021 (UTC+0000)
  
    System load:  0.00              Memory usage:  4.6%
    Processes:    107               Swap usage:    0.0%
    Usage of /:   7.5% of 15.64GB   IP address for eth0: 192.168.1.155
  
  TKLBAM (Backup and Migration):  NOT INITIALIZED
  
    To initialize TKLBAM, run the "tklbam-init" command to link this
    system to your TurnKey Hub account. For details see the man page or
    go to:
  
        https://www.turnkeylinux.org/tklbam
  

    For Advanced commandline config run:    confconsole

  For more info see: https://www.turnkeylinux.org/docs/confconsole

Linux tkldev 5.10.0-9-amd64 #1 SMP Debian 5.10.70-1 (2021-09-30) x86_64
Last login: Tue Dec  7 00:30:55 2021 from 192.168.1.56

Authentication

• log into console with root password
• log into webmin with root password
• log into webshell with root password

Service authentication

Applies to: LAMP LAPP Nodejs Tomcat Domain-Controller Fileserver

• log into web app (where relevant)
• log into Adminer
• test/log into others... (see confconsole services per appliance)

TKLBAM

Applies to: LAMP (could be tested on any - but LAMP an ideal option)

• install LAMP to VM
• add test data as per below

  adduser alon

  echo test > /root/test
  chown alon:alon /root/test

console cli - initialization

• Initialize TKLBAM

tklbam-init APIKEY

console cli - "dry run" backup

tklbam-backup --simulate

• examine /TKLBAM/fsdelta-olist

  • it should be empty (or close to it), since there is no delta!

• examine /var/lib/tklbam/profile/dirindex

  • file paths shouldn't have any weird prefix in them

console cli - "wet run" backup

tklbam-backup

• TotalDestinationSizeChange should be about 10KB

console cli - restore

• install 2nd LAMP VM (1st can be destroyed)

tklbam-init APIKEY

tklbam-list

• shows TESTBACKUPID

tklbam-restore TESTBACKPID

• check /root/test exists and is owned by alon:alon

• examine /var/log/tklbam-restore, make sure no error messages

tklbam-restore-rollback

• /root/test gone
• user alon in /etc/passwd gone

Webmin - initialization

• initialize tklbam

Webmin - backup

• download escrow key

• enable daily backups: yes

  • check /etc/cron.daily/tklbam-backup is +x

• enable daily backups: no

  • check /etc/cron.daily/tklbam-backup is -x

• change size of backup volume to 45 MBs

  • check /etc/tklbam/conf includes change

• change frequency of full backups to 1M

  • check /etc/tklbam/conf includes change

• add override: -/etc/.git

  • check /etc/tklbam/overrides includes change

• local simulation (/etc/.git)

• backup

  • set passphrase
  • check that Passphrase field updated on the Hub

Webmin - restore

• install 3rd LAMP VM (1st & 2nd can be destroyed)

• Initialize TKLBAM (via Webmin)

• Restore most recent backup (from previous Webmin backup)

  • Confirm asks for passphrase (it should because we've set one!)

Additional Tests

Applies to: all remaining appliances (iso)

• username &/or email set by inithook (where relevant)
• domain set by inithook (where relevant)
• password set by inithook (where relevant)
• web app is running, and:
  • secure (i.e. need to login prior to any level of access)
    • note framework apps are an exception to this rule
  • available via http
  • available via https
  • login credentials (entered via inithooks) enable login (where relevant)
• webapp appears to be displaying correctly (e.g. css applied):
  • without login:
    • via http
    • via https
  • logged in
    • via http
    • via https

Tests for Optimized Builds

Applies to: Core (or any other appliance)

OVA

• install latest VirtualBox (FLOSS)

  • right-click >> Open With "Oracle VM VirtualBox"
  • Vbox opens with import dialog for OVA
  • import completes successfully
  • vm boots successfully
  • complete inithooks (install sec updates)
  • reboot (even if not required)
  • log in local terminal (in Vbox window)
  • log in via SSH

• install latest VMware Workstation Player (freeware)