Trouble Maker: Modules

Trouble Modules

A trouble module is a fancy name for a tar file that contains a config file and a few scripts. To work with them, either grab unpacked_kitbag from CVS or download the release and issue mkdir /usr/local/trouble-maker/unpacked_kitbag; /usr/local/trouble-maker/bin/unpack_kitbag.pl /usr/local/trouble-maker/kitbag /usr/local/trouble-maker/unpacked_kitbag.

config.yaml

The config.yaml file controls points of commonality between modules. It contains the following pieces of information:

Backup Files - In order to minimize real system damage, these files will get copied into the backup directory.
Backup Script - In order to minimize real system damage, this optional script will run and output to a file named backup.info in the backup directory. This is intended to help restore environmental state.
Description - One or many descriptions of the type that a user would report to the system administrator. Users do not always understand the system, and may report problems inaccurately. However, for the purpose of this project, all descriptions will, in some way, relate to the trouble scenario.
- This is a sub-select item. Therefore, even if multiple descriptions are listed, only one will be displayed to the user.
Details - This is a long-winded explanation of exactly what is broken and how to fix it. This file exists so that the user may have a reference if needed.
Check Script - This script can be run to verify that the problem was actually fixed. Its use is optional but strongly encouraged. It may be written in whatever language you like.
OS Requirements - List of OS/Versions to which the module applies.
Package Requirements - List of package names that must be installed on the system for the trouble module to be valid.
System Requirements - List of system and Perl commands that must return true for the trouble module to be valid. If a command starts with - or ! it indicates a Perl file test. This allows us to test for specific configurations.
Authors - List of authors that have worked on the module.
Trouble Script - Actual script to be executed to cause the problem. It may be written in whatever language you like.

Example

# This file exists as an example.  It does nothing of any interest.
#
# REMEMBER THAT YAML DOESN'T SUPPORT TABS!!!!
#
# ==========================================================================================================
# In order to minimize real system damage, these files will get copied into the backup directory.
backup files:
  - "/path/to/file1"
  - "/path/to/file2"
  - "/path/to/file3"
# This script will run and output to a file named backup.info in the backup directory.  Its use is optional but strongly encouraged.
backup script: donothing.sh
# One or many descriptions of the type that a user would report to the system administrator.
description:
  - description 1
  - description 2
# This is a long-winded explanation of exactly what is broken and how to fix it. This file only exists if the user decides to give up and needs a reference.
details: If this were a real script, it would have deleted all your files, caused various things to explode, and made prank calls to the local pizzaria.  To fix it, do nothing.
# This script can be run to verify that the problem was actually fixed. Its use is optional but strongly encouraged.
check script: donothing.sh
# List of OS/Versions to which the module applies.
os requirements:
  - RHEL_3
  - Fedora_2
  - SUSE_9
# These packages must be installed for this package to be valid
package requirements:
  COMMON:
    - nopackage
  RHEL_3:
    - httpd
    - bash
    - vsftpd
  Fedora_2:
    - vsftpd
# These system calls must return true in order for this package to be valid, a - or ! preficing the the command indicates a perl file test, may need to enclose in quotes
system requirements:
  COMMON:
    - '! -e "/tmp/bob"'
  RHEL_3:
    - cat /dev/null
  Fedora_2:
    - cat /dev/null
  SUSE_9:
    - '-d "/tmp"'
# Actual trouble script
trouble script: donothing.sh

Tips

YAML requires certain items to be escaped. To check that your YAML file is correct, run tools/check-trouble-config.pl on your YAML file.
To test, use tools/pack_kitbag.pl to pack up all the troubles to your kitbag location.
If your module doesn't do what you expect, edit trouble-maker.pl and %debug variable to turn on debugging.
All modules do not work on all distros. Add what you can, we'll help out with the rest.
Once you have a working module, let us know on the module forum, and we'll start the official testing process for inclusion.

Trouble-Maker

Trouble Modules

config.yaml

Example

Tips