PUPPET-MASTER(8) Puppet manual PUPPET-MASTER(8)NAMEpuppet-master - The puppet master daemon
SYNOPSIS
The central puppet server. Functions as a certificate authority by
default.
USAGE
puppet master [-D|--daemonize|--no-daemonize] [-d|--debug] [-h|--help]
[-l|--logdest syslog|FILE|console] [-v|--verbose] [-V|--version]
[--compile NODE-NAME]
DESCRIPTION
This command starts an instance of puppet master, running as a daemon
and using Ruby´s built-in Webrick webserver. Puppet master can also be
managed by other application servers; when this is the case, this exe‐
cutable is not used.
OPTIONS
Note that any Puppet setting that´s valid in the configuration file is
also a valid long argument. For example, ´server´ is a valid setting,
so you can specify ´--server servername´ as an argument. Boolean set‐
tings translate into ´--setting´ and ´--no-setting´ pairs.
See the configuration file documentation at http://docs.puppet‐
labs.com/references/stable/configuration.html for the full list of
acceptable settings. A commented list of all settings can also be gen‐
erated by running puppet master with ´--genconfig´.
--daemonize
Send the process into the background. This is the default. (This
is a Puppet setting, and can go in puppet.conf. Note the special
´no-´ prefix for boolean settings on the command line.)
--no-daemonize
Do not send the process into the background. (This is a Puppet
setting, and can go in puppet.conf. Note the special ´no-´ pre‐
fix for boolean settings on the command line.)
--debug
Enable full debugging.
--help Print this help message.
--logdest
Where to send log messages. Choose between ´syslog´ (the POSIX
syslog service), ´console´, or the path to a log file. If debug‐
ging or verbosity is enabled, this defaults to ´console´. Other‐
wise, it defaults to ´syslog´.
A path ending with ´.json´ will receive structured output in
JSON format. The log file will not have an ending ´]´ automati‐
cally written to it due to the appending nature of logging. It
must be appended manually to make the content valid JSON.
--masterport
The port on which to listen for traffic. (This is a Puppet set‐
ting, and can go in puppet.conf.)
--verbose
Enable verbosity.
--version
Print the puppet version number and exit.
--compile
Compile a catalogue and output it in JSON from the puppet mas‐
ter. Uses facts contained in the $vardir/yaml/ directory to com‐
pile the catalog.
EXAMPLE
puppet master
DIAGNOSTICS
When running as a standalone daemon, puppet master accepts the follow‐
ing signals:
SIGHUP Restart the puppet master server.
SIGINT and SIGTERM
Shut down the puppet master server.
SIGUSR2
Close file descriptors for log files and reopen them. Used with
logrotate.
AUTHOR
Luke Kanies
COPYRIGHT
Copyright (c) 2012 Puppet Labs, LLC Licensed under the Apache 2.0
License
Puppet Labs, LLC May 2015 PUPPET-MASTER(8)
