A lot of things can go wrong when running tests in Beaker. Currently, there's no mechanism for capturing info about hard to diagnose common mistakes and their solutions in the project documentation. A simple troubleshooting guide may make a useful point of reference for tips and tricks like: - for systems with 2 network cards attached, ensure ksdevice is set appropriately in the kernel parameters - when triggering a reboot in a test, ensure that test correctly checks if the reboot has already happened etc
Here's one we see a lot in eng-ops. Error: After installation, the console is filled with 'ls: cannot access /var/run/beah/rhts-compat/launchers: No such file or directory' Causes: 1. Network connection may be offline. (most likely) 2. Some kind of installation error occurred, which is 'fixed' by rebooting the host. 3. The system is incompatible with rhts-compat, so it must be disabled in the job xml.
Something else the Troubleshooting guide should cover is the different levels where things can go wrong: For the task authors and submitters to fix: * in the task * in the job specification * in any job level custom kickstart snippets/templates For the Beaker instance maintainers to fix: * in the physical machine * in the network configuration * in the conserver setup * in the distro import * in the power controller setup * in the log archiver configuration * in any site level custom kickstart snippets/templates For the Beaker developers to fix: * in the default kickstart templates * in the default tasks * in the test harness * in the lab controller * in the main server
(In reply to Nick Coghlan from comment #4) > Something else the Troubleshooting guide should cover is the different > levels where things can go wrong: > > For the task authors and submitters to fix: > * in the task > * in the job specification > * in any job level custom kickstart snippets/templates > > For the Beaker instance maintainers to fix: > * in the physical machine > * in the network configuration > * in the conserver setup > * in the distro import > * in the power controller setup > * in the log archiver configuration > * in any site level custom kickstart snippets/templates > Ideally we want troubleshooting guides for these admin related tasks. I've created the following bug to track this, BZ#1035059 > For the Beaker developers to fix: > * in the default kickstart templates > * in the default tasks > * in the test harness > * in the lab controller > * in the main server
Patch filed in gerrit: https://gerrit.beaker-project.org/#/c/4796/
This has been published under: https://beaker-project.org/docs-develop/user-guide/
Beaker 23.0 has been released.