Low commit activity in last 3 years
A long-lived project that still receives updates
Foreman administrative commands plugin for Hammer CLI
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

 Project Readme

Hammer CLI Foreman Admin

Plugin for Hammer CLI for administrative tasks on the Foreman and Smart Proxy servers. Available sub-commands:

logging

Sets debug or normal (production) configuration options for all Foreman components. To set debug level for all components:

	# hammer admin logging --all --level-debug

To set production configuration:

	# hammer admin logging --all --level-production

Available options:

	# hammer admin logging --help
	Usage:
		hammer admin logging [OPTIONS]

	Options:
	 --no-backup                   Skip configuration backups creation.
	 --prefix PATH                 Operate on prefixed environment (e.g. chroot).
	 -a, --all                     Apply to all components.
	 -c, --components COMPONENTS   Components to apply, use --list to get them.
	 -d, --level-debug             Increase verbosity level to debug.
	 -h, --help                    print help
	 -l, --list                    List available components.
	 -n, --dry-run                 Do not apply specified changes.
	 -p, --level-production        Decrease verbosity level to standard.

Currently recognized components (files):

	# hammer admin logging --list
	-----------|-------------------------------------|-------------------------------------
	COMPONENT  | AUTO-DETECTED BY EXISTENCE OF       | DESTINATIONS
	-----------|-------------------------------------|-------------------------------------
	postgresql | /var/lib/pgsql/data/postgresql.conf | syslog /var/lib/pgsql/data/pg_log
	rails      | /etc/foreman/settings.yaml          | /var/log/foreman/production.log
	proxy      | /etc/foreman-proxy/settings.yml     | /var/log/foreman-proxy/proxy.log
	puppet     | /etc/puppet/puppet.conf             | /var/log/puppet/masterhttp.log
	dhcpd      | /etc/dhcp/dhcpd.conf                | syslog /var/log/dhcpd-debug.log
	named      | /etc/named.conf                     | syslog
	tftp       | /etc/xinetd.d/tftp                  | syslog
	qpidd      | /etc/qpid/qpidd.conf                | syslog
	tomcat     | /etc/candlepin/candlepin.conf       | /var/log/candlepin/ /var/log/tomcat/
	pulp       | /etc/pulp/server.conf               | syslog /var/log/pulp-debug.log
	virt-who   | /etc/sysconfig/virt-who             | syslog
	-----------|-------------------------------------|-------------------------------------

The tool uses search and replace approach declared in YAML configuration files foreman_admin_logging_core.yml and foreman_admin_logging_katello.yml.

Development

To test the logging subcommand, use the fixture examples and compare with git diff:

hammer -d admin logging --prefix $(pwd)/test/fixture_tree/ --no-backup -a -d