1PUPPET-MASTER(8)                 Puppet manual                PUPPET-MASTER(8)
2
3
4

NAME

6       puppet-master - The puppet master daemon
7

SYNOPSIS

9       The  central  puppet  server.  Functions  as a certificate authority by
10       default.
11

USAGE

13       puppet master [-D|--daemonize|--no-daemonize] [-d|--debug]  [-h|--help]
14       [-l|--logdest    syslog|FILE|console]   [-v|--verbose]   [-V|--version]
15       [--compile NODE-NAME]
16

DESCRIPTION

18       This command starts an instance of puppet master, running as  a  daemon
19       and  using Ruby´s built-in Webrick webserver. Puppet master can also be
20       managed by other application servers; when this is the case, this  exe‐
21       cutable is not used.
22

OPTIONS

24       Note  that any Puppet setting that´s valid in the configuration file is
25       also a valid long argument. For example, ´server´ is a  valid  setting,
26       so  you  can specify ´--server servername´ as an argument. Boolean set‐
27       tings translate into ´--setting´ and ´--no-setting´ pairs.
28
29       See   the   configuration   file    documentation    at    https://pup
30       pet.com/docs/puppet/latest/configuration.html  for  the  full  list  of
31       acceptable settings. A commented list of all settings can also be  gen‐
32       erated by running puppet master with ´--genconfig´.
33
34       --daemonize
35              Send the process into the background. This is the default. (This
36              is a Puppet setting, and can go in puppet.conf. Note the special
37              ´no-´ prefix for boolean settings on the command line.)
38
39       --no-daemonize
40              Do  not  send the process into the background. (This is a Puppet
41              setting, and can go in puppet.conf. Note the special ´no-´  pre‐
42              fix for boolean settings on the command line.)
43
44       --debug
45              Enable full debugging.
46
47       --help Print this help message.
48
49       --logdest
50              Where  to  send log messages. Choose between ´syslog´ (the POSIX
51              syslog service), ´console´, or the path to a log file. If debug‐
52              ging or verbosity is enabled, this defaults to ´console´. Other‐
53              wise, it defaults to ´syslog´.
54
55              A path ending with ´.json´ will  receive  structured  output  in
56              JSON  format. The log file will not have an ending ´]´ automati‐
57              cally written to it due to the appending nature of  logging.  It
58              must be appended manually to make the content valid JSON.
59
60       --masterport
61              The  port  on  which  to listen for traffic. The default port is
62              8140. (This is a Puppet setting, and can go in puppet.conf.)
63
64       --verbose
65              Enable verbosity.
66
67       --version
68              Print the puppet version number and exit.
69
70       --compile
71              Compile a catalogue and output it in JSON from the  puppet  mas‐
72              ter. Uses facts contained in the $vardir/yaml/ directory to com‐
73              pile the catalog.
74

EXAMPLE

76       puppet master
77

DIAGNOSTICS

79       When running as a standalone daemon, puppet master accepts the  follow‐
80       ing signals:
81
82       SIGHUP Restart the puppet master server.
83
84       SIGINT and SIGTERM
85              Shut down the puppet master server.
86
87       SIGUSR2
88              Close  file descriptors for log files and reopen them. Used with
89              logrotate.
90

AUTHOR

92       Luke Kanies
93
95       Copyright (c) 2012 Puppet Inc.,  LLC  Licensed  under  the  Apache  2.0
96       License
97
98
99
100Puppet, Inc.                     January 2019                 PUPPET-MASTER(8)
Impressum