Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

puppet-master (8)

Name

puppet-master - The puppet master daemon

Synopsis

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

Description

PUPPET-MASTER(8)                 Puppet manual                PUPPET-MASTER(8)



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    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   https://docs.puppet-
       labs.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-'  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. 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  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 Inc.,  LLC  Licensed  under  the  Apache  2.0
       License



ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+--------------------------+
       |ATTRIBUTE TYPE |     ATTRIBUTE VALUE      |
       +---------------+--------------------------+
       |Availability   | system/management/puppet |
       +---------------+--------------------------+
       |Stability      | Volatile                 |
       +---------------+--------------------------+
NOTES
       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source  was  downloaded  from  https://github.com/puppetlabs/puppet/ar-
       chive/5.5.0.tar.gz

       Further information about this software can be found on the open source
       community website at http://puppetlabs.com/.



Puppet, Inc.                      March 2018                  PUPPET-MASTER(8)