puppet master Man Page

Included in Puppet Enterprise 3.2. A newer version is available; see the version menu above for details.

NAME

puppet-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 file|console|syslog] [-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 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 http://docs.puppetlabs.com/puppet/latest/reference/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 messages. Choose between syslog, the console, and a log file. Defaults to sending messages to syslog, or the console if debugging or verbosity is enabled.

--masterport

The port on which to listen for traffic. (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.

EXAMPLE

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.

AUTHOR

Luke Kanies

Copyright (c) 2012 Puppet Labs, LLC Licensed under the Apache 2.0 License

↑ Back to top