puppet-master8
The puppet master daemon
Usage
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]
Overview
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 executable 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 settings translate into '--setting' and '--no-setting' pairs.
See the configuration file documentation at https://puppet.com/docs/puppet/latest/configuration.html for the full list of acceptable settings. A commented list of all settings can also be generated 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-' prefix 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 debugging or verbosity is enabled, this defaults to 'console'. Otherwise, it defaults to 'syslog'.
-
A path ending with '.json' will receive structured output in JSON format. The log file will not have an ending ']' automatically 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. The default port is 8140. (This is a Puppet setting, 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 master. Uses facts contained in the $vardir/yaml/ directory to compile the catalog.
Examples
puppet master
Diagnostics
When running as a standalone daemon, puppet master accepts the following 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. |
Releases
5 releases since Debian 7 (Wheezy); the text changed 4 times.
--masterport since Debian 9 (Stretch).