components/ruby/puppet/files/puppet.xml

   1 <!DOCTYPE service_bundle SYSTEM "/usr/share/lib/xml/dtd/service_bundle.dtd.1">
   2 <!--
   3  CDDL HEADER START
   4
   5  The contents of this file are subject to the terms of the
   6  Common Development and Distribution License (the "License").
   7  You may not use this file except in compliance with the License.
   8
   9  You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
  10  or http://www.opensolaris.org/os/licensing.
  11  See the License for the specific language governing permissions
  12  and limitations under the License.
  13
  14  When distributing Covered Code, include this CDDL HEADER in each
  15  file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  16  If applicable, add the following below this CDDL HEADER, with the
  17  fields enclosed by brackets "[]" replaced with your own identifying
  18  information: Portions Copyright [yyyy] [name of copyright owner]
  19
  20  CDDL HEADER END
  21
  22  Copyright (c) 2013, 2014, Oracle and/or its affiliates. All rights reserved.
  23
  24  NOTE:  This service manifest is not editable; its contents will
  25  be overwritten by package or patch operations, including
  26  operating system upgrade.  Make customizations in a different
  27  file.
  28 -->
  29 <service_bundle type="manifest" name="puppet">
  30   <service name="application/puppet" type="service" version="1">
  31     <dependency name="filesystem" grouping="require_all" restart_on="error" type="service">
  32       <service_fmri value="svc:/system/filesystem/minimal"/>
  33     </dependency>
  34     <dependency name="network" grouping="require_all" restart_on="error" type="service">
  35       <service_fmri value="svc:/milestone/network"/>
  36     </dependency>
  37     <dependency name="identity" grouping="require_all" restart_on="error" type="service">
  38       <service_fmri value="svc:/system/identity:node"/>
  39     </dependency>
  40     <exec_method type="method" name="start" exec=":true" timeout_seconds="60"/>
  41     <exec_method type="method" name="stop" exec=":kill" timeout_seconds="60"/>
  42     <property_group name="general" type="framework">
  43       <!-- to start stop puppet -->
  44       <propval name="action_authorization" type="astring" value="solaris.smf.manage.puppet"/>
  45       <!-- to change puppet properties -->
  46       <propval name="value_authorization" type="astring" value="solaris.smf.value.puppet"/>
  47     </property_group>
  48     <property_group name="puppet_stencil" type="configfile">
  49       <propval name="path" type="astring" value="/etc/puppet/puppet.conf"/>
  50       <propval name="stencil" type="astring" value="puppet.stencil"/>
  51       <propval name="mode" type="astring" value="0444"/>
  52     </property_group>
  53     <instance name="master" enabled="false">
  54       <exec_method type="method" name="start" exec="/usr/sbin/puppet master --logdest %{config/logdest}" timeout_seconds="600"/>
  55       <property_group name="config" type="application">
  56         <propval name="logdest" type="astring" value="/var/log/puppet/puppet-master.log"/>
  57       </property_group>
  58     </instance>
  59     <instance name="agent" enabled="false">
  60       <exec_method type="method" name="start" exec="/usr/sbin/puppet agent --logdest %{config/logdest}" timeout_seconds="600"/>
  61       <property_group name="config" type="application">
  62         <propval name="logdest" type="astring" value="/var/log/puppet/puppet-agent.log"/>
  63       </property_group>
  64     </instance>
  65     <stability value="Unstable"/>
  66     <template>
  67       <common_name>
  68         <loctext xml:lang="C">Puppet version 3.8.6</loctext>
  69       </common_name>
  70       <documentation>
  71         <manpage title="puppet-master" section="8" manpath="/usr/share/man"/>
  72       </documentation>
  73       <pg_pattern name="config" required="false" type="application">
  74         <prop_pattern name="agent_catalog_run_lockfile" required="false" type="astring">
  75           <description>
  76             <loctext xml:lang="C">
  77 A lock file to indicate that a puppet agent catalog run is currently in progress.
  78 The file contains the pid of the process that holds the lock on the catalog run.
  79             </loctext>
  80           </description>
  81         </prop_pattern>
  82         <prop_pattern name="agent_disabled_lockfile" required="false" type="astring">
  83           <description>
  84             <loctext xml:lang="C">
  85 A lock file to indicate that puppet agent runs have been administratively
  86 disabled.  File contains a JSON object with state information.
  87             </loctext>
  88           </description>
  89         </prop_pattern>
  90         <prop_pattern name="allow_duplicate_certs" required="false" type="boolean">
  91           <description>
  92             <loctext xml:lang="C">
  93 Whether to allow a new certificate
  94 request to overwrite an existing certificate.
  95             </loctext>
  96           </description>
  97         </prop_pattern>
  98         <prop_pattern name="allow_variables_with_dashes" required="false" type="boolean">
  99           <description>
 100             <loctext xml:lang="C">
 101 Permit hyphens (`-`) in variable names and issue deprecation warnings about
 102 them. This setting **should always be `false`;** setting it to `true`
 103 will cause subtle and wide-ranging bugs. It will be removed in a future version.
 104
 105 Hyphenated variables caused major problems in the language, but were allowed
 106 between Puppet 2.7.3 and 2.7.14. If you used them during this window, we
 107 apologize for the inconvenience --- you can temporarily set this to `true`
 108 in order to upgrade, and can rename your variables at your leisure. Please
 109 revert it to `false` after you have renamed all affected variables.
 110             </loctext>
 111           </description>
 112         </prop_pattern>
 113         <prop_pattern name="always_cache_features" required="false" type="boolean">
 114           <description>
 115             <loctext xml:lang="C">
 116 Affects how we cache attempts to load Puppet 'features'.  If false, then
 117 calls to `Puppet.features.&lt;feature&gt;?` will always attempt to load the
 118 feature (which can be an expensive operation) unless it has already been
 119 loaded successfully.  This makes it possible for a single agent run to,
 120 e.g., install a package that provides the underlying capabilities for
 121 a feature, and then later load that feature during the same run (even if
 122 the feature had been tested earlier and had not been available).
 123
 124 If this setting is set to true, then features will only be checked once,
 125 and if they are not available, the negative result is cached and returned
 126 for all subsequent attempts to load the feature.  This behavior is almost
 127 always appropriate for the server, and can result in a significant performance
 128 improvement for features that are checked frequently.
 129             </loctext>
 130           </description>
 131         </prop_pattern>
 132         <prop_pattern name="archive_file_server" required="false" type="host">
 133           <description>
 134             <loctext xml:lang="C">
 135 During an inspect run, the file bucket server to archive files to if archive_files is set.
 136             </loctext>
 137           </description>
 138         </prop_pattern>
 139         <prop_pattern name="archive_files" required="false" type="boolean">
 140           <description>
 141             <loctext xml:lang="C">
 142 During an inspect run, whether to archive files whose contents are audited to a file bucket.
 143             </loctext>
 144           </description>
 145         </prop_pattern>
 146         <prop_pattern name="async_storeconfigs" required="false" type="boolean">
 147           <description>
 148             <loctext xml:lang="C">
 149 Whether to use a queueing system to provide asynchronous database integration.
 150 Requires that `puppet queue` be running.
 151             </loctext>
 152           </description>
 153         </prop_pattern>
 154         <prop_pattern name="autoflush" required="false" type="boolean">
 155           <description>
 156             <loctext xml:lang="C">
 157 Whether log files should always flush to disk.
 158             </loctext>
 159           </description>
 160         </prop_pattern>
 161         <prop_pattern name="autosign" required="false" type="astring">
 162           <description>
 163             <loctext xml:lang="C">
 164 Whether (and how) to autosign certificate requests. This setting
 165 is only relevant on a puppet master acting as a certificate authority (CA).
 166
 167 Valid values are true (autosigns all certificate requests; not recommended),
 168 false (disables autosigning certificates), or the absolute path to a file.
 169
 170 The file specified in this setting may be either a **configuration file**
 171 or a **custom policy executable.** Puppet will automatically determine
 172 what it is: If the Puppet user (see the `user` setting) can execute the
 173 file, it will be treated as a policy executable; otherwise, it will be
 174 treated as a config file.
 175
 176 If a custom policy executable is configured, the CA puppet master will run it
 177 every time it receives a CSR. The executable will be passed the subject CN of the
 178 request _as a command line argument,_ and the contents of the CSR in PEM format
 179 _on stdin._ It should exit with a status of 0 if the cert should be autosigned
 180 and non-zero if the cert should not be autosigned.
 181
 182 If a certificate request is not autosigned, it will persist for review. An admin
 183 user can use the `puppet cert sign` command to manually sign it, or can delete
 184 the request.
 185
 186 For info on autosign configuration files, see
 187 [the guide to Puppet's config files](http://docs.puppetlabs.com/guides/configuring.html).
 188             </loctext>
 189           </description>
 190         </prop_pattern>
 191         <prop_pattern name="basemodulepath" required="false" type="astring">
 192           <description>
 193             <loctext xml:lang="C">
 194 The search path for **global** modules. Should be specified as a
 195 list of directories separated by the system path separator character. (The
 196 POSIX path separator is ':', and the Windows path separator is ';'.)
 197
 198 If you are using directory environments, these are the modules that will
 199 be used by _all_ environments. Note that the `modules` directory of the active
 200 environment will have priority over any global directories. For more info, see
 201 http://docs.puppetlabs.com/puppet/latest/reference/environments.html
 202
 203 This setting also provides the default value for the deprecated `modulepath`
 204 setting, which is used when directory environments are disabled.
 205             </loctext>
 206           </description>
 207         </prop_pattern>
 208         <prop_pattern name="bindaddress" required="false" type="net_address">
 209           <description>
 210             <loctext xml:lang="C">
 211 The address a listening server should bind to.
 212             </loctext>
 213           </description>
 214         </prop_pattern>
 215         <prop_pattern name="binder" required="false" type="boolean">
 216           <description>
 217             <loctext xml:lang="C">
 218 Turns the binding system on or off. This includes bindings in modules.
 219 The binding system aggregates data from modules and other locations and makes them available for lookup.
 220 The binding system is experimental and any or all of it may change.
 221             </loctext>
 222           </description>
 223         </prop_pattern>
 224         <prop_pattern name="binder_config" required="false" type="astring">
 225           <description>
 226             <loctext xml:lang="C">
 227 The binder configuration file. Puppet reads this file on each request to configure the bindings system.
 228 If set to nil (the default), a $confdir/binder_config.yaml is optionally loaded. If it does not exists, a default configuration
 229 is used. If the setting :binding_config is specified, it must reference a valid and existing yaml file.
 230             </loctext>
 231           </description>
 232         </prop_pattern>
 233         <prop_pattern name="bucketdir" required="false" type="astring">
 234           <description>
 235             <loctext xml:lang="C">
 236 Where FileBucket files are stored.
 237             </loctext>
 238           </description>
 239         </prop_pattern>
 240         <prop_pattern name="ca" required="false" type="boolean">
 241           <description>
 242             <loctext xml:lang="C">
 243 Whether the master should function as a certificate authority.
 244             </loctext>
 245           </description>
 246         </prop_pattern>
 247         <prop_pattern name="ca_name" required="false" type="astring">
 248           <description>
 249             <loctext xml:lang="C">
 250 The name to use the Certificate Authority certificate.
 251             </loctext>
 252           </description>
 253         </prop_pattern>
 254         <prop_pattern name="ca_port" required="false" type="integer">
 255           <description>
 256             <loctext xml:lang="C">
 257 The port to use for the certificate authority.
 258             </loctext>
 259           </description>
 260         </prop_pattern>
 261         <prop_pattern name="ca_server" required="false" type="host">
 262           <description>
 263             <loctext xml:lang="C">
 264 The server to use for certificate
 265 authority requests.  It's a separate server because it cannot
 266 and does not need to horizontally scale.
 267             </loctext>
 268           </description>
 269         </prop_pattern>
 270         <prop_pattern name="ca_ttl" required="false" type="integer">
 271           <description>
 272             <loctext xml:lang="C">
 273 The default TTL for new certificates.
 274 This setting can be a time interval in seconds (30 or 30s), minutes (30m), hours (6h), days (2d), or years (5y).
 275             </loctext>
 276           </description>
 277         </prop_pattern>
 278         <prop_pattern name="cacert" required="false" type="astring">
 279           <description>
 280             <loctext xml:lang="C">
 281 The CA certificate.
 282             </loctext>
 283           </description>
 284         </prop_pattern>
 285         <prop_pattern name="cacrl" required="false" type="astring">
 286           <description>
 287             <loctext xml:lang="C">
 288 The certificate revocation list (CRL) for the CA. Will be used if present but otherwise ignored.
 289             </loctext>
 290           </description>
 291         </prop_pattern>
 292         <prop_pattern name="cadir" required="false" type="astring">
 293           <description>
 294             <loctext xml:lang="C">
 295 The root directory for the certificate authority.
 296             </loctext>
 297           </description>
 298         </prop_pattern>
 299         <prop_pattern name="cakey" required="false" type="astring">
 300           <description>
 301             <loctext xml:lang="C">
 302 The CA private key.
 303             </loctext>
 304           </description>
 305         </prop_pattern>
 306         <prop_pattern name="capass" required="false" type="astring">
 307           <description>
 308             <loctext xml:lang="C">
 309 Where the CA stores the password for the private key.
 310             </loctext>
 311           </description>
 312         </prop_pattern>
 313         <prop_pattern name="caprivatedir" required="false" type="astring">
 314           <description>
 315             <loctext xml:lang="C">
 316 Where the CA stores private certificate information.
 317             </loctext>
 318           </description>
 319         </prop_pattern>
 320         <prop_pattern name="capub" required="false" type="astring">
 321           <description>
 322             <loctext xml:lang="C">
 323 The CA public key.
 324             </loctext>
 325           </description>
 326         </prop_pattern>
 327         <prop_pattern name="catalog_cache_terminus" required="false" type="astring">
 328           <description>
 329             <loctext xml:lang="C">
 330 How to store cached catalogs. Valid values are 'json', 'msgpack' and 'yaml'. The agent application defaults to 'json'.
 331             </loctext>
 332           </description>
 333         </prop_pattern>
 334         <prop_pattern name="catalog_format" required="false" type="astring">
 335           <description>
 336             <loctext xml:lang="C">
 337 (Deprecated for 'preferred_serialization_format') What format to
 338 use to dump the catalog.  Only supports 'marshal' and 'yaml'.  Only
 339 matters on the client, since it asks the server for a specific format.
 340             </loctext>
 341           </description>
 342         </prop_pattern>
 343         <prop_pattern name="catalog_terminus" required="false" type="astring">
 344           <description>
 345             <loctext xml:lang="C">
 346 Where to get node catalogs.  This is useful to change if, for instance,
 347 you'd like to pre-compile catalogs and store them in memcached or some other easily-accessed store.
 348             </loctext>
 349           </description>
 350         </prop_pattern>
 351         <prop_pattern name="cert_inventory" required="false" type="astring">
 352           <description>
 353             <loctext xml:lang="C">
 354 The inventory file. This is a text file to which the CA writes a
 355 complete listing of all certificates.
 356             </loctext>
 357           </description>
 358         </prop_pattern>
 359         <prop_pattern name="certdir" required="false" type="astring">
 360           <description>
 361             <loctext xml:lang="C">
 362 The certificate directory.
 363             </loctext>
 364           </description>
 365         </prop_pattern>
 366         <prop_pattern name="certdnsnames" required="false" type="astring">
 367           <description>
 368             <loctext xml:lang="C">
 369 The `certdnsnames` setting is no longer functional,
 370 after CVE-2011-3872. We ignore the value completely.
 371
 372 For your own certificate request you can set `dns_alt_names` in the
 373 configuration and it will apply locally.  There is no configuration option to
 374 set DNS alt names, or any other `subjectAltName` value, for another nodes
 375 certificate.
 376
 377 Alternately you can use the `--dns_alt_names` command line option to set the
 378 labels added while generating your own CSR.
 379             </loctext>
 380           </description>
 381         </prop_pattern>
 382         <prop_pattern name="certificate_expire_warning" required="false" type="integer">
 383           <description>
 384             <loctext xml:lang="C">
 385 The window of time leading up to a certificate's expiration that a notification
 386 will be logged. This applies to CA, master, and agent certificates. This setting can be a time interval in seconds (30 or 30s), minutes (30m), hours (6h), days (2d), or years (5y).
 387             </loctext>
 388           </description>
 389         </prop_pattern>
 390         <prop_pattern name="certificate_revocation" required="false" type="boolean">
 391           <description>
 392             <loctext xml:lang="C">
 393 Whether certificate revocation should be supported by downloading a
 394 Certificate Revocation List (CRL)
 395 to all clients.  If enabled, CA chaining will almost definitely not work.
 396             </loctext>
 397           </description>
 398         </prop_pattern>
 399         <prop_pattern name="certname" required="false" type="hostname">
 400           <description>
 401             <loctext xml:lang="C">
 402 The name to use when handling certificates. When a node
 403 requests a certificate from the CA puppet master, it uses the value of the
 404 `certname` setting as its requested Subject CN.
 405
 406 This is the name used when managing a node's permissions in
 407 [auth.conf](http://docs.puppetlabs.com/puppet/latest/reference/config_file_auth.html).
 408 In most cases, it is also used as the node's name when matching
 409 [node definitions](http://docs.puppetlabs.com/puppet/latest/reference/lang_node_definitions.html)
 410 and requesting data from an ENC. (This can be changed with the `node_name_value`
 411 and `node_name_fact` settings, although you should only do so if you have
 412 a compelling reason.)
 413
 414 A node's certname is available in Puppet manifests as `$trusted['certname']`. (See
 415 [Facts and Built-In Variables](http://docs.puppetlabs.com/puppet/latest/reference/lang_facts_and_builtin_vars.html)
 416 for more details.)
 417
 418 * For best compatibility, you should limit the value of `certname` to
 419   only use letters, numbers, periods, underscores, and dashes. (That is,
 420   it should match `/A[a-z0-9._-]+Z/`.)
 421 * The special value `ca` is reserved, and can't be used as the certname
 422   for a normal node.
 423
 424 Defaults to the node's fully qualified domain name.
 425             </loctext>
 426           </description>
 427         </prop_pattern>
 428         <prop_pattern name="cfacter" required="false" type="boolean">
 429           <description>
 430             <loctext xml:lang="C">
 431 Whether or not to use the native facter (cfacter) implementation instead of the Ruby one (facter). Defaults to false.
 432             </loctext>
 433           </description>
 434         </prop_pattern>
 435         <prop_pattern name="classfile" required="false" type="astring">
 436           <description>
 437             <loctext xml:lang="C">
 438 The file in which puppet agent stores a list of the classes
 439 associated with the retrieved configuration.  Can be loaded in
 440 the separate `puppet` executable using the `--loadclasses`
 441 option.
 442             </loctext>
 443           </description>
 444         </prop_pattern>
 445         <prop_pattern name="client_datadir" required="false" type="astring">
 446           <description>
 447             <loctext xml:lang="C">
 448 The directory in which serialized data is stored on the client.
 449             </loctext>
 450           </description>
 451         </prop_pattern>
 452         <prop_pattern name="clientbucketdir" required="false" type="astring">
 453           <description>
 454             <loctext xml:lang="C">
 455 Where FileBucket files are stored locally.
 456             </loctext>
 457           </description>
 458         </prop_pattern>
 459         <prop_pattern name="clientyamldir" required="false" type="astring">
 460           <description>
 461             <loctext xml:lang="C">
 462 The directory in which client-side YAML data is stored.
 463             </loctext>
 464           </description>
 465         </prop_pattern>
 466         <prop_pattern name="code" required="false" type="astring">
 467           <description>
 468             <loctext xml:lang="C">
 469 Code to parse directly.  This is essentially only used
 470 by `puppet`, and should only be set if you're writing your own Puppet
 471 executable.
 472             </loctext>
 473           </description>
 474         </prop_pattern>
 475         <prop_pattern name="color" required="false" type="astring">
 476           <description>
 477             <loctext xml:lang="C">
 478 Whether to use colors when logging to the console.  Valid values are
 479 `ansi` (equivalent to `true`), `html`, and `false`, which produces no color.
 480 Defaults to false on Windows, as its console does not support ansi colors.
 481             </loctext>
 482           </description>
 483         </prop_pattern>
 484         <prop_pattern name="confdir" required="false" type="astring">
 485           <description>
 486             <loctext xml:lang="C">
 487 The main Puppet configuration directory.  The default for this setting
 488 is calculated based on the user.  If the process is running as root or
 489 the user that Puppet is supposed to run as, it defaults to a system
 490 directory, but if it's running as any other user, it defaults to being
 491 in the user's home directory.
 492             </loctext>
 493           </description>
 494         </prop_pattern>
 495         <prop_pattern name="config" required="false" type="astring">
 496           <description>
 497             <loctext xml:lang="C">
 498 The configuration file for the current puppet application.
 499             </loctext>
 500           </description>
 501         </prop_pattern>
 502         <prop_pattern name="config_file_name" required="false" type="astring">
 503           <description>
 504             <loctext xml:lang="C">
 505 The name of the puppet config file.
 506             </loctext>
 507           </description>
 508         </prop_pattern>
 509         <prop_pattern name="config_version" required="false" type="astring">
 510           <description>
 511             <loctext xml:lang="C">
 512 How to determine the configuration version.  By default, it will be the
 513 time that the configuration is parsed, but you can provide a shell script to override how the
 514 version is determined.  The output of this script will be added to every log message in the
 515 reports, allowing you to correlate changes on your hosts to the source version on the server.
 516
 517 Setting a global value for config_version in puppet.conf is deprecated. Please set a
 518 per-environment value in environment.conf instead. For more info, see
 519 http://docs.puppetlabs.com/puppet/latest/reference/environments.html
 520             </loctext>
 521           </description>
 522         </prop_pattern>
 523         <prop_pattern name="configprint" required="false" type="astring">
 524           <description>
 525             <loctext xml:lang="C">
 526 Print the value of a specific configuration setting.  If the name of a
 527 setting is provided for this, then the value is printed and puppet
 528 exits.  Comma-separate multiple values.  For a list of all values,
 529 specify 'all'.
 530             </loctext>
 531           </description>
 532         </prop_pattern>
 533         <prop_pattern name="configtimeout" required="false" type="integer">
 534           <description>
 535             <loctext xml:lang="C">
 536 How long the client should wait for the configuration to be retrieved
 537 before considering it a failure.  This can help reduce flapping if too
 538 many clients contact the server at one time. This setting can be a time interval in seconds (30 or 30s), minutes (30m), hours (6h), days (2d), or years (5y).
 539             </loctext>
 540           </description>
 541         </prop_pattern>
 542         <prop_pattern name="couchdb_url" required="false" type="uri">
 543           <description>
 544             <loctext xml:lang="C">
 545 The url where the puppet couchdb database will be created.
 546 Only used when `facts_terminus` is set to `couch`.
 547             </loctext>
 548           </description>
 549         </prop_pattern>
 550         <prop_pattern name="csr_attributes" required="false" type="astring">
 551           <description>
 552             <loctext xml:lang="C">
 553 An optional file containing custom attributes to add to certificate signing
 554 requests (CSRs). You should ensure that this file does not exist on your CA
 555 puppet master; if it does, unwanted certificate extensions may leak into
 556 certificates created with the `puppet cert generate` command.
 557
 558 If present, this file must be a YAML hash containing a `custom_attributes` key
 559 and/or an `extension_requests` key. The value of each key must be a hash, where
 560 each key is a valid OID and each value is an object that can be cast to a string.
 561
 562 Custom attributes can be used by the CA when deciding whether to sign the
 563 certificate, but are then discarded. Attribute OIDs can be any OID value except
 564 the standard CSR attributes (i.e. attributes described in RFC 2985 section 5.4).
 565 This is useful for embedding a pre-shared key for autosigning policy executables
 566 (see the `autosign` setting), often by using the `1.2.840.113549.1.9.7`
 567 ("challenge password") OID.
 568
 569 Extension requests will be permanently embedded in the final certificate.
 570 Extension OIDs must be in the "ppRegCertExt" (`1.3.6.1.4.1.34380.1.1`) or
 571 "ppPrivCertExt" (`1.3.6.1.4.1.34380.1.2`) OID arcs. The ppRegCertExt arc is
 572 reserved for four of the most common pieces of data to embed: `pp_uuid` (`.1`),
 573 `pp_instance_id` (`.2`), `pp_image_name` (`.3`), and `pp_preshared_key` (`.4`)
 574 --- in the YAML file, these can be referred to by their short descriptive names
 575 instead of their full OID. The ppPrivCertExt arc is unregulated, and can be used
 576 for site-specific extensions.
 577             </loctext>
 578           </description>
 579         </prop_pattern>
 580         <prop_pattern name="csrdir" required="false" type="astring">
 581           <description>
 582             <loctext xml:lang="C">
 583 Where the CA stores certificate requests
 584             </loctext>
 585           </description>
 586         </prop_pattern>
 587         <prop_pattern name="daemonize" required="false" type="boolean">
 588           <description>
 589             <loctext xml:lang="C">
 590 Whether to send the process into the background.  This defaults
 591 to true on POSIX systems, and to false on Windows (where Puppet
 592 currently cannot daemonize).
 593             </loctext>
 594           </description>
 595         </prop_pattern>
 596         <prop_pattern name="data_binding_terminus" required="false" type="astring">
 597           <description>
 598             <loctext xml:lang="C">
 599 Where to retrive information about data.
 600             </loctext>
 601           </description>
 602         </prop_pattern>
 603         <prop_pattern name="dbadapter" required="false" type="astring">
 604           <description>
 605             <loctext xml:lang="C">
 606 The type of database to use. This setting is only used by the ActiveRecord storeconfigs and inventory backends, which are deprecated.
 607             </loctext>
 608           </description>
 609         </prop_pattern>
 610         <prop_pattern name="dbconnections" required="false" type="astring">
 611           <description>
 612             <loctext xml:lang="C">
 613 The number of database connections for networked
 614 databases.  Will be ignored unless the value is a positive integer. This setting is only used by the ActiveRecord storeconfigs and inventory backends, which are deprecated.
 615             </loctext>
 616           </description>
 617         </prop_pattern>
 618         <prop_pattern name="dblocation" required="false" type="astring">
 619           <description>
 620             <loctext xml:lang="C">
 621 The sqlite database file. This setting is only used by the ActiveRecord storeconfigs and inventory backends, which are deprecated.
 622             </loctext>
 623           </description>
 624         </prop_pattern>
 625         <prop_pattern name="dbmigrate" required="false" type="boolean">
 626           <description>
 627             <loctext xml:lang="C">
 628 Whether to automatically migrate the database. This setting is only used by the ActiveRecord storeconfigs and inventory backends, which are deprecated.
 629             </loctext>
 630           </description>
 631         </prop_pattern>
 632         <prop_pattern name="dbname" required="false" type="astring">
 633           <description>
 634             <loctext xml:lang="C">
 635 The name of the database to use. This setting is only used by the ActiveRecord storeconfigs and inventory backends, which are deprecated.
 636             </loctext>
 637           </description>
 638         </prop_pattern>
 639         <prop_pattern name="dbpassword" required="false" type="astring">
 640           <description>
 641             <loctext xml:lang="C">
 642 The database password for caching. Only
 643 used when networked databases are used. This setting is only used by the ActiveRecord storeconfigs and inventory backends, which are deprecated.
 644             </loctext>
 645           </description>
 646         </prop_pattern>
 647         <prop_pattern name="dbport" required="false" type="astring">
 648           <description>
 649             <loctext xml:lang="C">
 650 The database password for caching. Only
 651 used when networked databases are used. This setting is only used by the ActiveRecord storeconfigs and inventory backends, which are deprecated.
 652             </loctext>
 653           </description>
 654         </prop_pattern>
 655         <prop_pattern name="dbserver" required="false" type="host">
 656           <description>
 657             <loctext xml:lang="C">
 658 The database server for caching. Only
 659 used when networked databases are used.
 660             </loctext>
 661           </description>
 662         </prop_pattern>
 663         <prop_pattern name="dbsocket" required="false" type="astring">
 664           <description>
 665             <loctext xml:lang="C">
 666 The database socket location. Only used when networked
 667 databases are used.  Will be ignored if the value is an empty string. This setting is only used by the ActiveRecord storeconfigs and inventory backends, which are deprecated.
 668             </loctext>
 669           </description>
 670         </prop_pattern>
 671         <prop_pattern name="dbuser" required="false" type="astring">
 672           <description>
 673             <loctext xml:lang="C">
 674 The database user for caching. Only
 675 used when networked databases are used. This setting is only used by the ActiveRecord storeconfigs and inventory backends, which are deprecated.
 676             </loctext>
 677           </description>
 678         </prop_pattern>
 679         <prop_pattern name="default_file_terminus" required="false" type="astring">
 680           <description>
 681             <loctext xml:lang="C">
 682 The default source for files if no server is given in a
 683 uri, e.g. puppet:///file. The default of `rest` causes the file to be
 684 retrieved using the `server` setting. When running `apply` the default
 685 is `file_server`, causing requests to be filled locally.
 686             </loctext>
 687           </description>
 688         </prop_pattern>
 689         <prop_pattern name="default_manifest" required="false" type="astring">
 690           <description>
 691             <loctext xml:lang="C">
 692 The default main manifest for directory environments. Any environment that
 693 doesn't set the `manifest` setting in its `environment.conf` file will use
 694 this manifest.
 695
 696 This setting's value can be an absolute or relative path. An absolute path
 697 will make all environments default to the same main manifest; a relative
 698 path will allow each environment to use its own manifest, and Puppet will
 699 resolve the path relative to each environment's main directory.
 700
 701 In either case, the path can point to a single file or to a directory of
 702 manifests to be evaluated in alphabetical order.
 703             </loctext>
 704           </description>
 705         </prop_pattern>
 706         <prop_pattern name="default_schedules" required="false" type="boolean">
 707           <description>
 708             <loctext xml:lang="C">
 709 Boolean; whether to generate the default schedule resources. Setting this to
 710 false is useful for keeping external report processors clean of skipped schedule resources.
 711             </loctext>
 712           </description>
 713         </prop_pattern>
 714         <prop_pattern name="deviceconfig" required="false" type="astring">
 715           <description>
 716             <loctext xml:lang="C">
 717 Path to the device config file for puppet device.
 718             </loctext>
 719           </description>
 720         </prop_pattern>
 721         <prop_pattern name="devicedir" required="false" type="astring">
 722           <description>
 723             <loctext xml:lang="C">
 724 The root directory of devices' $vardir.
 725             </loctext>
 726           </description>
 727         </prop_pattern>
 728         <prop_pattern name="diff" required="false" type="astring">
 729           <description>
 730             <loctext xml:lang="C">
 731 Which diff command to use when printing differences between files. This setting
 732 has no default value on Windows, as standard `diff` is not available, but Puppet can use many
 733 third-party diff tools.
 734             </loctext>
 735           </description>
 736         </prop_pattern>
 737         <prop_pattern name="diff_args" required="false" type="astring">
 738           <description>
 739             <loctext xml:lang="C">
 740 Which arguments to pass to the diff command when printing differences between
 741 files. The command to use can be chosen with the `diff` setting.
 742             </loctext>
 743           </description>
 744         </prop_pattern>
 745         <prop_pattern name="digest_algorithm" required="false" type="astring">
 746           <description>
 747             <loctext xml:lang="C">
 748 Which digest algorithm to use for file resources and the filebucket.
 749 Valid values are md5, sha256. Default is md5.
 750             </loctext>
 751           </description>
 752         </prop_pattern>
 753         <prop_pattern name="disable_per_environment_manifest" required="false" type="boolean">
 754           <description>
 755             <loctext xml:lang="C">
 756 Whether to disallow an environment-specific main manifest. When set
 757 to `true`, Puppet will use the manifest specified in the `default_manifest` setting
 758 for all environments. If an environment specifies a different main manifest in its
 759 `environment.conf` file, catalog requests for that environment will fail with an error.
 760
 761 This setting requires `default_manifest` to be set to an absolute path.
 762             </loctext>
 763           </description>
 764         </prop_pattern>
 765         <prop_pattern name="disable_warnings" required="false" type="astring">
 766           <description>
 767             <loctext xml:lang="C">
 768 A comma-separated list of warning types to suppress. If large numbers
 769 of warnings are making Puppet's logs too large or difficult to use, you
 770 can temporarily silence them with this setting.
 771
 772 If you are preparing to upgrade Puppet to a new major version, you
 773 should re-enable all warnings for a while.
 774
 775 Valid values for this setting are:
 776
 777 * `deprecations` --- disables deprecation warnings.
 778             </loctext>
 779           </description>
 780         </prop_pattern>
 781         <prop_pattern name="dns_alt_names" required="false" type="host">
 782           <description>
 783             <loctext xml:lang="C">
 784 The comma-separated list of alternative DNS names to use for the local host.
 785
 786 When the node generates a CSR for itself, these are added to the request
 787 as the desired `subjectAltName` in the certificate: additional DNS labels
 788 that the certificate is also valid answering as.
 789
 790 This is generally required if you use a non-hostname `certname`, or if you
 791 want to use `puppet kick` or `puppet resource -H` and the primary certname
 792 does not match the DNS name you use to communicate with the host.
 793
 794 This is unnecessary for agents, unless you intend to use them as a server for
 795 `puppet kick` or remote `puppet resource` management.
 796
 797 It is rarely necessary for servers; it is usually helpful only if you need to
 798 have a pool of multiple load balanced masters, or for the same master to
 799 respond on two physically separate networks under different names.
 800             </loctext>
 801           </description>
 802         </prop_pattern>
 803         <prop_pattern name="document_all" required="false" type="boolean">
 804           <description>
 805             <loctext xml:lang="C">
 806 Whether to document all resources when using `puppet doc` to
 807 generate manifest documentation.
 808             </loctext>
 809           </description>
 810         </prop_pattern>
 811         <prop_pattern name="dynamicfacts" required="false" type="astring">
 812           <description>
 813             <loctext xml:lang="C">
 814 (Deprecated) Facts that are dynamic; these facts will be ignored when deciding whether
 815 changed facts should result in a recompile.  Multiple facts should be
 816 comma-separated.
 817             </loctext>
 818           </description>
 819         </prop_pattern>
 820         <prop_pattern name="environment" required="false" type="astring">
 821           <description>
 822             <loctext xml:lang="C">
 823 The environment Puppet is running in.  For clients
 824 (e.g., `puppet agent`) this determines the environment itself, which
 825 is used to find modules and much more.  For servers (i.e., `puppet master`)
 826 this provides the default environment for nodes we know nothing about.
 827             </loctext>
 828           </description>
 829         </prop_pattern>
 830         <prop_pattern name="environment_timeout" required="false" type="integer">
 831           <description>
 832             <loctext xml:lang="C">
 833 How long the Puppet master should cache data it loads from an
 834 environment.
 835 This setting can be a time interval in seconds (30 or 30s), minutes (30m), hours (6h), days (2d), or years (5y).
 836 A value of `0` will disable caching. This setting can also be set to
 837 `unlimited`, which will cache environments until the master is restarted
 838 or told to refresh the cache.
 839
 840 You should change this setting once your Puppet deployment is doing
 841 non-trivial work. We chose the default value of `0` because it lets new
 842 users update their code without any extra steps, but it lowers the
 843 performance of your Puppet master.
 844
 845 We recommend setting this to `unlimited` and explicitly refreshing your
 846 Puppet master as part of your code deployment process.
 847
 848 * With Puppet Server, you should refresh environments by calling the
 849   `environment-cache` API endpoint. See the docs for the Puppet Server
 850   administrative API.
 851 * With a Rack Puppet master, you should restart the web server or the
 852   application server. Passenger lets you touch a `restart.txt` file to
 853   refresh an application without restarting Apache; see the Passenger docs
 854   for details.
 855
 856 We don't recommend using any value other than `0` or `unlimited`, since
 857 most Puppet masters use a pool of Ruby interpreters which all have their
 858 own cache timers. When these timers drift out of sync, agents can be served
 859 inconsistent catalogs.
 860             </loctext>
 861           </description>
 862         </prop_pattern>
 863         <prop_pattern name="environmentpath" required="false" type="astring">
 864           <description>
 865             <loctext xml:lang="C">
 866 A search path for directory environments, as a list of directories
 867 separated by the system path separator character. (The POSIX path separator
 868 is ':', and the Windows path separator is ';'.)
 869
 870 This setting must have a value set to enable **directory environments.** The
 871 recommended value is `$confdir/environments`. For more details, see
 872 http://docs.puppetlabs.com/puppet/latest/reference/environments.html
 873             </loctext>
 874           </description>
 875         </prop_pattern>
 876         <prop_pattern name="evaltrace" required="false" type="boolean">
 877           <description>
 878             <loctext xml:lang="C">
 879 Whether each resource should log when it is
 880 being evaluated.  This allows you to interactively see exactly
 881 what is being done.
 882             </loctext>
 883           </description>
 884         </prop_pattern>
 885         <prop_pattern name="external_nodes" required="false" type="astring">
 886           <description>
 887             <loctext xml:lang="C">
 888 An external command that can produce node information.  The command's output
 889 must be a YAML dump of a hash, and that hash must have a `classes` key and/or
 890 a `parameters` key, where `classes` is an array or hash and
 891 `parameters` is a hash.  For unknown nodes, the command should
 892 exit with a non-zero exit code.
 893
 894 This command makes it straightforward to store your node mapping
 895 information in other data sources like databases.
 896             </loctext>
 897           </description>
 898         </prop_pattern>
 899         <prop_pattern name="factpath" required="false" type="astring">
 900           <description>
 901             <loctext xml:lang="C">
 902 Where Puppet should look for facts.  Multiple directories should
 903 be separated by the system path separator character. (The POSIX path
 904 separator is ':', and the Windows path separator is ';'.)
 905             </loctext>
 906           </description>
 907         </prop_pattern>
 908         <prop_pattern name="facts_terminus" required="false" type="astring">
 909           <description>
 910             <loctext xml:lang="C">
 911 The node facts terminus.
 912             </loctext>
 913           </description>
 914         </prop_pattern>
 915         <prop_pattern name="fileserverconfig" required="false" type="astring">
 916           <description>
 917             <loctext xml:lang="C">
 918 Where the fileserver configuration is stored.
 919             </loctext>
 920           </description>
 921         </prop_pattern>
 922         <prop_pattern name="filetimeout" required="false" type="integer">
 923           <description>
 924             <loctext xml:lang="C">
 925 The minimum time to wait between checking for updates in
 926 configuration files.  This timeout determines how quickly Puppet checks whether
 927 a file (such as manifests or templates) has changed on disk. This setting can be a time interval in seconds (30 or 30s), minutes (30m), hours (6h), days (2d), or years (5y).
 928             </loctext>
 929           </description>
 930         </prop_pattern>
 931         <prop_pattern name="forge_authorization" required="false" type="astring">
 932           <description>
 933             <loctext xml:lang="C">
 934 The authorization key to connect to the Puppet Forge. Leave blank for unauthorized or license based connections
 935             </loctext>
 936           </description>
 937         </prop_pattern>
 938         <prop_pattern name="freeze_main" required="false" type="boolean">
 939           <description>
 940             <loctext xml:lang="C">
 941 Freezes the 'main' class, disallowing any code to be added to it.  This
 942 essentially means that you can't have any code outside of a node,
 943 class, or definition other than in the site manifest.
 944             </loctext>
 945           </description>
 946         </prop_pattern>
 947         <prop_pattern name="genmanifest" required="false" type="boolean">
 948           <description>
 949             <loctext xml:lang="C">
 950 Whether to just print a manifest to stdout and exit.  Only makes
 951 sense when specified on the command line as `--genmanifest`.  Takes into account arguments specified
 952 on the CLI.
 953             </loctext>
 954           </description>
 955         </prop_pattern>
 956         <prop_pattern name="graph" required="false" type="boolean">
 957           <description>
 958             <loctext xml:lang="C">
 959 Whether to create dot graph files for the different
 960 configuration graphs.  These dot files can be interpreted by tools
 961 like OmniGraffle or dot (which is part of ImageMagick).
 962             </loctext>
 963           </description>
 964         </prop_pattern>
 965         <prop_pattern name="graphdir" required="false" type="astring">
 966           <description>
 967             <loctext xml:lang="C">
 968 Where to store dot-outputted graphs.
 969             </loctext>
 970           </description>
 971         </prop_pattern>
 972         <prop_pattern name="group" required="false" type="astring">
 973           <description>
 974             <loctext xml:lang="C">
 975 The group puppet master should run as.
 976             </loctext>
 977           </description>
 978         </prop_pattern>
 979         <prop_pattern name="hiera_config" required="false" type="astring">
 980           <description>
 981             <loctext xml:lang="C">
 982 The hiera configuration file. Puppet only reads this file on startup, so you must restart the puppet master every time you edit it.
 983             </loctext>
 984           </description>
 985         </prop_pattern>
 986         <prop_pattern name="hostcert" required="false" type="astring">
 987           <description>
 988             <loctext xml:lang="C">
 989 Where individual hosts store and look for their certificates.
 990             </loctext>
 991           </description>
 992         </prop_pattern>
 993         <prop_pattern name="hostcrl" required="false" type="astring">
 994           <description>
 995             <loctext xml:lang="C">
 996 Where the host's certificate revocation list can be found.
 997 This is distinct from the certificate authority's CRL.
 998             </loctext>
 999           </description>
1000         </prop_pattern>
1001         <prop_pattern name="hostcsr" required="false" type="astring">
1002           <description>
1003             <loctext xml:lang="C">
1004 Where individual hosts store and look for their certificate requests.
1005             </loctext>
1006           </description>
1007         </prop_pattern>
1008         <prop_pattern name="hostprivkey" required="false" type="astring">
1009           <description>
1010             <loctext xml:lang="C">
1011 Where individual hosts store and look for their private key.
1012             </loctext>
1013           </description>
1014         </prop_pattern>
1015         <prop_pattern name="hostpubkey" required="false" type="astring">
1016           <description>
1017             <loctext xml:lang="C">
1018 Where individual hosts store and look for their public key.
1019             </loctext>
1020           </description>
1021         </prop_pattern>
1022         <prop_pattern name="http_compression" required="false" type="boolean">
1023           <description>
1024             <loctext xml:lang="C">
1025 Allow http compression in REST communication with the master.
1026 This setting might improve performance for agent -&gt; master
1027 communications over slow WANs. Your puppet master needs to support
1028 compression (usually by activating some settings in a reverse-proxy in
1029 front of the puppet master, which rules out webrick). It is harmless to
1030 activate this settings if your master doesn't support compression, but
1031 if it supports it, this setting might reduce performance on high-speed LANs.
1032             </loctext>
1033           </description>
1034         </prop_pattern>
1035         <prop_pattern name="http_debug" required="false" type="boolean">
1036           <description>
1037             <loctext xml:lang="C">
1038 Whether to write HTTP request and responses to stderr. This should never be used in a production environment.
1039             </loctext>
1040           </description>
1041         </prop_pattern>
1042         <prop_pattern name="http_keepalive_timeout" required="false" type="integer">
1043           <description>
1044             <loctext xml:lang="C">
1045 The maximum amount of time a persistent HTTP connection can remain idle in the connection pool, before it is closed.  This timeout should be shorter than the keepalive timeout used on the HTTP server, e.g. Apache KeepAliveTimeout directive.
1046 This setting can be a time interval in seconds (30 or 30s), minutes (30m), hours (6h), days (2d), or years (5y).
1047             </loctext>
1048           </description>
1049         </prop_pattern>
1050         <prop_pattern name="http_proxy_host" required="false" type="host">
1051           <description>
1052             <loctext xml:lang="C">
1053 The HTTP proxy host to use for outgoing connections.  Note: You
1054 may need to use a FQDN for the server hostname when using a proxy. Environment variable
1055 http_proxy or HTTP_PROXY will override this value
1056             </loctext>
1057           </description>
1058         </prop_pattern>
1059         <prop_pattern name="http_proxy_password" required="false" type="astring">
1060           <description>
1061             <loctext xml:lang="C">
1062 The password for the user of an authenticated HTTP proxy.
1063 Requires the `http_proxy_user` setting.
1064
1065 Note that passwords must be valid when used as part of a URL. If a password
1066 contains any characters with special meanings in URLs (as specified by RFC 3986
1067 ` would become `%23`.)
1068             </loctext>
1069           </description>
1070         </prop_pattern>
1071         <prop_pattern name="http_proxy_port" required="false" type="integer">
1072           <description>
1073             <loctext xml:lang="C">
1074 The HTTP proxy port to use for outgoing connections
1075             </loctext>
1076           </description>
1077         </prop_pattern>
1078         <prop_pattern name="http_proxy_user" required="false" type="astring">
1079           <description>
1080             <loctext xml:lang="C">
1081 The user name for an authenticated HTTP proxy. Requires the `http_proxy_host` setting.
1082             </loctext>
1083           </description>
1084         </prop_pattern>
1085         <prop_pattern name="httplog" required="false" type="astring">
1086           <description>
1087             <loctext xml:lang="C">
1088 Where the puppet agent web server logs.
1089             </loctext>
1090           </description>
1091         </prop_pattern>
1092         <prop_pattern name="ignorecache" required="false" type="boolean">
1093           <description>
1094             <loctext xml:lang="C">
1095 Ignore cache and always recompile the configuration.  This is
1096 useful for testing new configurations, where the local cache may in
1097 fact be stale even if the timestamps are up to date - if the facts
1098 change or if the server changes.
1099             </loctext>
1100           </description>
1101         </prop_pattern>
1102         <prop_pattern name="ignoreimport" required="false" type="boolean">
1103           <description>
1104             <loctext xml:lang="C">
1105 If true, allows the parser to continue without requiring
1106 all files referenced with `import` statements to exist. This setting was primarily
1107 designed for use with commit hooks for parse-checking.
1108             </loctext>
1109           </description>
1110         </prop_pattern>
1111         <prop_pattern name="ignoremissingtypes" required="false" type="boolean">
1112           <description>
1113             <loctext xml:lang="C">
1114 Skip searching for classes and definitions that were missing during a
1115 prior compilation. The list of missing objects is maintained per-environment and
1116 persists until the environment is cleared or the master is restarted.
1117             </loctext>
1118           </description>
1119         </prop_pattern>
1120         <prop_pattern name="ignoreschedules" required="false" type="boolean">
1121           <description>
1122             <loctext xml:lang="C">
1123 Boolean; whether puppet agent should ignore schedules.  This is useful
1124 for initial puppet agent runs.
1125             </loctext>
1126           </description>
1127         </prop_pattern>
1128         <prop_pattern name="immutable_node_data" required="false" type="boolean">
1129           <description>
1130             <loctext xml:lang="C">
1131 When true, also prevents $trusted and $facts from being overridden in any scope
1132             </loctext>
1133           </description>
1134         </prop_pattern>
1135         <prop_pattern name="inventory_port" required="false" type="integer">
1136           <description>
1137             <loctext xml:lang="C">
1138 The port to communicate with the inventory_server.
1139             </loctext>
1140           </description>
1141         </prop_pattern>
1142         <prop_pattern name="inventory_server" required="false" type="host">
1143           <description>
1144             <loctext xml:lang="C">
1145 The server to send facts to.
1146             </loctext>
1147           </description>
1148         </prop_pattern>
1149         <prop_pattern name="inventory_terminus" required="false" type="astring">
1150           <description>
1151             <loctext xml:lang="C">
1152 Should usually be the same as the facts terminus
1153             </loctext>
1154           </description>
1155         </prop_pattern>
1156         <prop_pattern name="keylength" required="false" type="integer">
1157           <description>
1158             <loctext xml:lang="C">
1159 The bit length of keys.
1160             </loctext>
1161           </description>
1162         </prop_pattern>
1163         <prop_pattern name="lastrunfile" required="false" type="astring">
1164           <description>
1165             <loctext xml:lang="C">
1166 Where puppet agent stores the last run report summary in yaml format.
1167             </loctext>
1168           </description>
1169         </prop_pattern>
1170         <prop_pattern name="lastrunreport" required="false" type="astring">
1171           <description>
1172             <loctext xml:lang="C">
1173 Where puppet agent stores the last run report in yaml format.
1174             </loctext>
1175           </description>
1176         </prop_pattern>
1177         <prop_pattern name="ldapattrs" required="false" type="astring">
1178           <description>
1179             <loctext xml:lang="C">
1180 The LDAP attributes to include when querying LDAP for nodes.  All
1181 returned attributes are set as variables in the top-level scope.
1182 Multiple values should be comma-separated.  The value 'all' returns
1183 all attributes.
1184             </loctext>
1185           </description>
1186         </prop_pattern>
1187         <prop_pattern name="ldapbase" required="false" type="astring">
1188           <description>
1189             <loctext xml:lang="C">
1190 The search base for LDAP searches.  It's impossible to provide
1191 a meaningful default here, although the LDAP libraries might
1192 have one already set.  Generally, it should be the 'ou=Hosts'
1193 branch under your main directory.
1194             </loctext>
1195           </description>
1196         </prop_pattern>
1197         <prop_pattern name="ldapclassattrs" required="false" type="astring">
1198           <description>
1199             <loctext xml:lang="C">
1200 The LDAP attributes to use to define Puppet classes.  Values
1201 should be comma-separated.
1202             </loctext>
1203           </description>
1204         </prop_pattern>
1205         <prop_pattern name="ldapparentattr" required="false" type="astring">
1206           <description>
1207             <loctext xml:lang="C">
1208 The attribute to use to define the parent node.
1209             </loctext>
1210           </description>
1211         </prop_pattern>
1212         <prop_pattern name="ldappassword" required="false" type="astring">
1213           <description>
1214             <loctext xml:lang="C">
1215 The password to use to connect to LDAP.
1216             </loctext>
1217           </description>
1218         </prop_pattern>
1219         <prop_pattern name="ldapport" required="false" type="integer">
1220           <description>
1221             <loctext xml:lang="C">
1222 The LDAP port.  Only used if `node_terminus` is set to `ldap`.
1223             </loctext>
1224           </description>
1225         </prop_pattern>
1226         <prop_pattern name="ldapserver" required="false" type="host">
1227           <description>
1228             <loctext xml:lang="C">
1229 The LDAP server.  Only used if `node_terminus` is set to `ldap`.
1230             </loctext>
1231           </description>
1232         </prop_pattern>
1233         <prop_pattern name="ldapssl" required="false" type="boolean">
1234           <description>
1235             <loctext xml:lang="C">
1236 Whether SSL should be used when searching for nodes.
1237 Defaults to false because SSL usually requires certificates
1238 to be set up on the client side.
1239             </loctext>
1240           </description>
1241         </prop_pattern>
1242         <prop_pattern name="ldapstackedattrs" required="false" type="astring">
1243           <description>
1244             <loctext xml:lang="C">
1245 The LDAP attributes that should be stacked to arrays by adding
1246 the values in all hierarchy elements of the tree.  Values
1247 should be comma-separated.
1248             </loctext>
1249           </description>
1250         </prop_pattern>
1251         <prop_pattern name="ldapstring" required="false" type="astring">
1252           <description>
1253             <loctext xml:lang="C">
1254 The search string used to find an LDAP node.
1255             </loctext>
1256           </description>
1257         </prop_pattern>
1258         <prop_pattern name="ldaptls" required="false" type="boolean">
1259           <description>
1260             <loctext xml:lang="C">
1261 Whether TLS should be used when searching for nodes.
1262 Defaults to false because TLS usually requires certificates
1263 to be set up on the client side.
1264             </loctext>
1265           </description>
1266         </prop_pattern>
1267         <prop_pattern name="ldapuser" required="false" type="hostname">
1268           <description>
1269             <loctext xml:lang="C">
1270 The user to use to connect to LDAP.  Must be specified as a
1271 full DN.
1272             </loctext>
1273           </description>
1274         </prop_pattern>
1275         <prop_pattern name="legacy_query_parameter_serialization" required="false" type="boolean">
1276           <description>
1277             <loctext xml:lang="C">
1278 The serialization format to use when sending file_metadata
1279 query parameters.  Older versions of puppet master expect certain query
1280 parameters to be serialized as yaml, which is deprecated.
1281
1282 This should almost always be false. It can be temporarily set to true
1283 to let agents using this Puppet version connect to a puppet master
1284 running Puppet 3.0.0 through 3.2.x.
1285
1286 Note that this is set to true automatically if the agent detects an
1287 older master, so should never need to be set explicitly.
1288             </loctext>
1289           </description>
1290         </prop_pattern>
1291         <prop_pattern name="libdir" required="false" type="astring">
1292           <description>
1293             <loctext xml:lang="C">
1294 An extra search path for Puppet.  This is only useful
1295 for those files that Puppet will load on demand, and is only
1296 guaranteed to work for those cases.  In fact, the autoload
1297 mechanism is responsible for making sure this directory
1298 is in Ruby's search path
1299             </loctext>
1300           </description>
1301         </prop_pattern>
1302         <prop_pattern name="listen" required="false" type="boolean">
1303           <description>
1304             <loctext xml:lang="C">
1305 Whether puppet agent should listen for
1306 connections.  If this is true, then puppet agent will accept incoming
1307 REST API requests, subject to the default ACLs and the ACLs set in
1308 the `rest_authconfig` file. Puppet agent can respond usefully to
1309 requests on the `run`, `facts`, `certificate`, and `resource` endpoints.
1310             </loctext>
1311           </description>
1312         </prop_pattern>
1313         <prop_pattern name="localcacert" required="false" type="astring">
1314           <description>
1315             <loctext xml:lang="C">
1316 Where each client stores the CA certificate.
1317             </loctext>
1318           </description>
1319         </prop_pattern>
1320         <prop_pattern name="localconfig" required="false" type="astring">
1321           <description>
1322             <loctext xml:lang="C">
1323 Where puppet agent caches the local configuration.  An
1324 extension indicating the cache format is added automatically.
1325             </loctext>
1326           </description>
1327         </prop_pattern>
1328         <prop_pattern name="log_level" required="false" type="astring">
1329           <description>
1330             <loctext xml:lang="C">
1331 Default logging level for messages from Puppet. Allowed values are:
1332
1333 * debug
1334 * info
1335 * notice
1336 * warning
1337 * err
1338 * alert
1339 * emerg
1340 * crit
1341             </loctext>
1342           </description>
1343         </prop_pattern>
1344         <prop_pattern name="logdir" required="false" type="astring">
1345           <description>
1346             <loctext xml:lang="C">
1347 The directory in which to store log files
1348             </loctext>
1349           </description>
1350         </prop_pattern>
1351         <prop_pattern name="manage_internal_file_permissions" required="false" type="boolean">
1352           <description>
1353             <loctext xml:lang="C">
1354 Whether Puppet should manage the owner, group, and mode of files it uses internally
1355             </loctext>
1356           </description>
1357         </prop_pattern>
1358         <prop_pattern name="manifest" required="false" type="astring">
1359           <description>
1360             <loctext xml:lang="C">
1361 The entry-point manifest for puppet master. This can be one file
1362 or a directory of manifests to be evaluated in alphabetical order. Puppet manages
1363 this path as a directory if one exists or if the path ends with a / or \.
1364
1365 Setting a global value for `manifest` in puppet.conf is deprecated. Please use
1366 directory environments instead. If you need to use something other than the
1367 environment's `manifests` directory as the main manifest, you can set
1368 `manifest` in environment.conf. For more info, see
1369 http://docs.puppetlabs.com/puppet/latest/reference/environments.html
1370             </loctext>
1371           </description>
1372         </prop_pattern>
1373         <prop_pattern name="manifestdir" required="false" type="astring">
1374           <description>
1375             <loctext xml:lang="C">
1376 Used to build the default value of the `manifest` setting. Has no other purpose.
1377
1378 This setting is deprecated.
1379             </loctext>
1380           </description>
1381         </prop_pattern>
1382         <prop_pattern name="masterhttplog" required="false" type="astring">
1383           <description>
1384             <loctext xml:lang="C">
1385 Where the puppet master web server saves its access log. This is
1386 only used when running a WEBrick puppet master. When puppet master is
1387 running under a Rack server like Passenger, that web server will have
1388 its own logging behavior.
1389             </loctext>
1390           </description>
1391         </prop_pattern>
1392         <prop_pattern name="masterlog" required="false" type="astring">
1393           <description>
1394             <loctext xml:lang="C">
1395 This file is literally never used, although Puppet may create it
1396 as an empty file. For more context, see the `puppetdlog` setting and
1397 puppet master's `--logdest` command line option.
1398
1399 This setting is deprecated and will be removed in a future version of Puppet.
1400             </loctext>
1401           </description>
1402         </prop_pattern>
1403         <prop_pattern name="masterport" required="false" type="integer">
1404           <description>
1405             <loctext xml:lang="C">
1406 The port for puppet master traffic. For puppet master,
1407 this is the port to listen on; for puppet agent, this is the port
1408 to make requests on. Both applications use this setting to get the port.
1409             </loctext>
1410           </description>
1411         </prop_pattern>
1412         <prop_pattern name="max_deprecations" required="false" type="integer">
1413           <description>
1414             <loctext xml:lang="C">
1415 Sets the max number of logged/displayed parser validation deprecation
1416 warnings in case multiple deprecation warnings have been detected. A value of 0
1417 blocks the logging of deprecation warnings.  The count is per manifest.
1418             </loctext>
1419           </description>
1420         </prop_pattern>
1421         <prop_pattern name="max_errors" required="false" type="integer">
1422           <description>
1423             <loctext xml:lang="C">
1424 Sets the max number of logged/displayed parser validation errors in case
1425 multiple errors have been detected. A value of 0 is the same as a value of 1; a
1426 minimum of one error is always raised.  The count is per manifest.
1427             </loctext>
1428           </description>
1429         </prop_pattern>
1430         <prop_pattern name="max_warnings" required="false" type="integer">
1431           <description>
1432             <loctext xml:lang="C">
1433 Sets the max number of logged/displayed parser validation warnings in
1434 case multiple warnings have been detected. A value of 0 blocks logging of
1435 warnings.  The count is per manifest.
1436             </loctext>
1437           </description>
1438         </prop_pattern>
1439         <prop_pattern name="maximum_uid" required="false" type="integer">
1440           <description>
1441             <loctext xml:lang="C">
1442 The maximum allowed UID.  Some platforms use negative UIDs
1443 but then ship with tools that do not know how to handle signed ints,
1444 so the UIDs show up as huge numbers that can then not be fed back into
1445 the system.  This is a hackish way to fail in a slightly more useful
1446 way when that happens.
1447             </loctext>
1448           </description>
1449         </prop_pattern>
1450         <prop_pattern name="mkusers" required="false" type="boolean">
1451           <description>
1452             <loctext xml:lang="C">
1453 Whether to create the necessary user and group that puppet agent will run as.
1454             </loctext>
1455           </description>
1456         </prop_pattern>
1457         <prop_pattern name="module_groups" required="false" type="astring">
1458           <description>
1459             <loctext xml:lang="C">
1460 Extra module groups to request from the Puppet Forge
1461             </loctext>
1462           </description>
1463         </prop_pattern>
1464         <prop_pattern name="module_repository" required="false" type="uri">
1465           <description>
1466             <loctext xml:lang="C">
1467 The module repository
1468             </loctext>
1469           </description>
1470         </prop_pattern>
1471         <prop_pattern name="module_skeleton_dir" required="false" type="astring">
1472           <description>
1473             <loctext xml:lang="C">
1474 The directory which the skeleton for module tool generate is stored.
1475             </loctext>
1476           </description>
1477         </prop_pattern>
1478         <prop_pattern name="module_working_dir" required="false" type="astring">
1479           <description>
1480             <loctext xml:lang="C">
1481 The directory into which module tool data is stored
1482             </loctext>
1483           </description>
1484         </prop_pattern>
1485         <prop_pattern name="modulepath" required="false" type="astring">
1486           <description>
1487             <loctext xml:lang="C">
1488 The search path for modules, as a list of directories separated by the system
1489 path separator character. (The POSIX path separator is ':', and the
1490 Windows path separator is ';'.)
1491
1492 Setting a global value for `modulepath` in puppet.conf is deprecated. Please use
1493 directory environments instead. If you need to use something other than the
1494 default modulepath of `&lt;ACTIVE ENVIRONMENT'S MODULES DIR&gt;:$basemodulepath`,
1495 you can set `modulepath` in environment.conf. For more info, see
1496 http://docs.puppetlabs.com/puppet/latest/reference/environments.html
1497             </loctext>
1498           </description>
1499         </prop_pattern>
1500         <prop_pattern name="name" required="false" type="astring">
1501           <description>
1502             <loctext xml:lang="C">
1503 The name of the application, if we are running as one.  The
1504 default is essentially $0 without the path or `.rb`.
1505             </loctext>
1506           </description>
1507         </prop_pattern>
1508         <prop_pattern name="node_cache_terminus" required="false" type="astring">
1509           <description>
1510             <loctext xml:lang="C">
1511 How to store cached nodes.
1512 Valid values are (none), 'json', 'msgpack', 'yaml' or write only yaml ('write_only_yaml').
1513 The master application defaults to 'write_only_yaml', all others to none.
1514             </loctext>
1515           </description>
1516         </prop_pattern>
1517         <prop_pattern name="node_name" required="false" type="astring">
1518           <description>
1519             <loctext xml:lang="C">
1520 How the puppet master determines the client's identity
1521 and sets the 'hostname', 'fqdn' and 'domain' facts for use in the manifest,
1522 in particular for determining which 'node' statement applies to the client.
1523 Possible values are 'cert' (use the subject's CN in the client's
1524 certificate) and 'facter' (use the hostname that the client
1525 reported in its facts)
1526             </loctext>
1527           </description>
1528         </prop_pattern>
1529         <prop_pattern name="node_name_fact" required="false" type="astring">
1530           <description>
1531             <loctext xml:lang="C">
1532 The fact name used to determine the node name used for all requests the agent
1533 makes to the master. WARNING: This setting is mutually exclusive with
1534 node_name_value.  Changing this setting also requires changes to the default
1535 auth.conf configuration on the Puppet Master.  Please see
1536 http://links.puppetlabs.com/node_name_fact for more information.
1537             </loctext>
1538           </description>
1539         </prop_pattern>
1540         <prop_pattern name="node_name_value" required="false" type="astring">
1541           <description>
1542             <loctext xml:lang="C">
1543 The explicit value used for the node name for all requests the agent
1544 makes to the master. WARNING: This setting is mutually exclusive with
1545 node_name_fact.  Changing this setting also requires changes to the default
1546 auth.conf configuration on the Puppet Master.  Please see
1547 http://links.puppetlabs.com/node_name_value for more information.
1548             </loctext>
1549           </description>
1550         </prop_pattern>
1551         <prop_pattern name="node_terminus" required="false" type="astring">
1552           <description>
1553             <loctext xml:lang="C">
1554 Where to find information about nodes.
1555             </loctext>
1556           </description>
1557         </prop_pattern>
1558         <prop_pattern name="noop" required="false" type="boolean">
1559           <description>
1560             <loctext xml:lang="C">
1561 Whether to apply catalogs in noop mode, which allows Puppet to
1562 partially simulate a normal run. This setting affects puppet agent and
1563 puppet apply.
1564
1565 When running in noop mode, Puppet will check whether each resource is in sync,
1566 like it does when running normally. However, if a resource attribute is not in
1567 the desired state (as declared in the catalog), Puppet will take no
1568 action, and will instead report the changes it _would_ have made. These
1569 simulated changes will appear in the report sent to the puppet master, or
1570 be shown on the console if running puppet agent or puppet apply in the
1571 foreground. The simulated changes will not send refresh events to any
1572 subscribing or notified resources, although Puppet will log that a refresh
1573 event _would_ have been sent.
1574
1575 **Important note:**
1576 noop)
1577 allows you to apply individual resources in noop mode, and will override
1578 the global value of the `noop` setting. This means a resource with
1579 `noop =&gt; false` _will_ be changed if necessary, even when running puppet
1580 agent with `noop = true` or `--noop`. (Conversely, a resource with
1581 `noop =&gt; true` will only be simulated, even when noop mode is globally disabled.)
1582             </loctext>
1583           </description>
1584         </prop_pattern>
1585         <prop_pattern name="onetime" required="false" type="boolean">
1586           <description>
1587             <loctext xml:lang="C">
1588 Perform one configuration run and exit, rather than spawning a long-running
1589 daemon. This is useful for interactively running puppet agent, or
1590 running puppet agent from cron.
1591             </loctext>
1592           </description>
1593         </prop_pattern>
1594         <prop_pattern name="ordering" required="false" type="astring">
1595           <description>
1596             <loctext xml:lang="C">
1597 How unrelated resources should be ordered when applying a catalog.
1598 Allowed values are `title-hash`, `manifest`, and `random`. This
1599 setting affects puppet agent and puppet apply, but not puppet master.
1600
1601 * `title-hash` (the default) will order resources randomly, but will use
1602   the same order across runs and across nodes.
1603 * `manifest` will use the order in which the resources were declared in
1604   their manifest files.
1605 * `random` will order resources randomly and change their order with each
1606   run. This can work like a fuzzer for shaking out undeclared dependencies.
1607
1608 Regardless of this setting's value, Puppet will always obey explicit
1609 dependencies set with the before/require/notify/subscribe metaparameters
1610 and the `-&gt;`/`~&gt;` chaining arrows; this setting only affects the relative
1611 ordering of _unrelated_ resources.
1612             </loctext>
1613           </description>
1614         </prop_pattern>
1615         <prop_pattern name="parser" required="false" type="astring">
1616           <description>
1617             <loctext xml:lang="C">
1618 Selects the parser to use for parsing puppet manifests (in puppet DSL
1619 language/'.pp' files). Available choices are `current` (the default)
1620 and `future`.
1621
1622 The `current` parser means that the released version of the parser should
1623 be used.
1624
1625 The `future` parser is a "time travel to the future" allowing early
1626 exposure to new language features. What these features are will vary from
1627 release to release and they may be invididually configurable.
1628
1629 Available Since Puppet 3.2.
1630             </loctext>
1631           </description>
1632         </prop_pattern>
1633         <prop_pattern name="passfile" required="false" type="astring">
1634           <description>
1635             <loctext xml:lang="C">
1636 Where puppet agent stores the password for its private key.
1637 Generally unused.
1638             </loctext>
1639           </description>
1640         </prop_pattern>
1641         <prop_pattern name="path" required="false" type="astring">
1642           <description>
1643             <loctext xml:lang="C">
1644 The shell search path.  Defaults to whatever is inherited
1645 from the parent process.
1646             </loctext>
1647           </description>
1648         </prop_pattern>
1649         <prop_pattern name="pidfile" required="false" type="astring">
1650           <description>
1651             <loctext xml:lang="C">
1652 The file containing the PID of a running process.
1653 This file is intended to be used by service management frameworks
1654 and monitoring systems to determine if a puppet process is still in
1655 the process table.
1656             </loctext>
1657           </description>
1658         </prop_pattern>
1659         <prop_pattern name="plugindest" required="false" type="astring">
1660           <description>
1661             <loctext xml:lang="C">
1662 Where Puppet should store plugins that it pulls down from the central
1663 server.
1664             </loctext>
1665           </description>
1666         </prop_pattern>
1667         <prop_pattern name="pluginfactdest" required="false" type="astring">
1668           <description>
1669             <loctext xml:lang="C">
1670 Where Puppet should store external facts that are being handled by pluginsync
1671             </loctext>
1672           </description>
1673         </prop_pattern>
1674         <prop_pattern name="pluginfactsource" required="false" type="astring">
1675           <description>
1676             <loctext xml:lang="C">
1677 Where to retrieve external facts for pluginsync
1678             </loctext>
1679           </description>
1680         </prop_pattern>
1681         <prop_pattern name="pluginsignore" required="false" type="astring">
1682           <description>
1683             <loctext xml:lang="C">
1684 What files to ignore when pulling down plugins.
1685             </loctext>
1686           </description>
1687         </prop_pattern>
1688         <prop_pattern name="pluginsource" required="false" type="astring">
1689           <description>
1690             <loctext xml:lang="C">
1691 From where to retrieve plugins.  The standard Puppet `file` type
1692 is used for retrieval, so anything that is a valid file source can
1693 be used here.
1694             </loctext>
1695           </description>
1696         </prop_pattern>
1697         <prop_pattern name="pluginsync" required="false" type="boolean">
1698           <description>
1699             <loctext xml:lang="C">
1700 Whether plugins should be synced with the central server.
1701             </loctext>
1702           </description>
1703         </prop_pattern>
1704         <prop_pattern name="postrun_command" required="false" type="astring">
1705           <description>
1706             <loctext xml:lang="C">
1707 A command to run after every agent run.  If this command returns a non-zero
1708 return code, the entire Puppet run will be considered to have failed, even though it might have
1709 performed work during the normal run.
1710             </loctext>
1711           </description>
1712         </prop_pattern>
1713         <prop_pattern name="preferred_serialization_format" required="false" type="astring">
1714           <description>
1715             <loctext xml:lang="C">
1716 The preferred means of serializing
1717 ruby instances for passing over the wire.  This won't guarantee that all
1718 instances will be serialized using this method, since not all classes
1719 can be guaranteed to support this format, but it will be used for all
1720 classes that support it.
1721             </loctext>
1722           </description>
1723         </prop_pattern>
1724         <prop_pattern name="prerun_command" required="false" type="astring">
1725           <description>
1726             <loctext xml:lang="C">
1727 A command to run before every agent run.  If this command returns a non-zero
1728 return code, the entire Puppet run will fail.
1729             </loctext>
1730           </description>
1731         </prop_pattern>
1732         <prop_pattern name="preview_outputdir" required="false" type="astring">
1733           <description>
1734             <loctext xml:lang="C">
1735 The directory where catalog previews per node are generated.
1736             </loctext>
1737           </description>
1738         </prop_pattern>
1739         <prop_pattern name="priority" required="false" type="astring">
1740           <description>
1741             <loctext xml:lang="C">
1742 The scheduling priority of the process.  Valid values are 'high',
1743 'normal', 'low', or 'idle', which are mapped to platform-specific
1744 values.  The priority can also be specified as an integer value and
1745 will be passed as is, e.g. -5.  Puppet must be running as a privileged
1746 user in order to increase scheduling priority.
1747             </loctext>
1748           </description>
1749         </prop_pattern>
1750         <prop_pattern name="privatedir" required="false" type="astring">
1751           <description>
1752             <loctext xml:lang="C">
1753 Where the client stores private certificate information.
1754             </loctext>
1755           </description>
1756         </prop_pattern>
1757         <prop_pattern name="privatekeydir" required="false" type="astring">
1758           <description>
1759             <loctext xml:lang="C">
1760 The private key directory.
1761             </loctext>
1762           </description>
1763         </prop_pattern>
1764         <prop_pattern name="profile" required="false" type="boolean">
1765           <description>
1766             <loctext xml:lang="C">
1767 Whether to enable experimental performance profiling
1768             </loctext>
1769           </description>
1770         </prop_pattern>
1771         <prop_pattern name="publickeydir" required="false" type="astring">
1772           <description>
1773             <loctext xml:lang="C">
1774 The public key directory.
1775             </loctext>
1776           </description>
1777         </prop_pattern>
1778         <prop_pattern name="puppetdlog" required="false" type="astring">
1779           <description>
1780             <loctext xml:lang="C">
1781 The fallback log file. This is only used when the `--logdest` option
1782 is not specified AND Puppet is running on an operating system where both
1783 the POSIX syslog service and the Windows Event Log are unavailable. (Currently,
1784 no supported operating systems match that description.)
1785
1786 Despite the name, both puppet agent and puppet master will use this file
1787 as the fallback logging destination.
1788
1789 For control over logging destinations, see the `--logdest` command line
1790 option in the manual pages for puppet master, puppet agent, and puppet
1791 apply. You can see man pages by running `puppet &lt;SUBCOMMAND&gt; --help`,
1792 or read them online at http://docs.puppetlabs.com/references/latest/man/.
1793             </loctext>
1794           </description>
1795         </prop_pattern>
1796         <prop_pattern name="puppetport" required="false" type="integer">
1797           <description>
1798             <loctext xml:lang="C">
1799 Which port puppet agent listens on.
1800             </loctext>
1801           </description>
1802         </prop_pattern>
1803         <prop_pattern name="queue_source" required="false" type="uri">
1804           <description>
1805             <loctext xml:lang="C">
1806 Which type of queue to use for asynchronous processing.  If your stomp server requires
1807 authentication, you can include it in the URI as long as your stomp client library is at least 1.1.1
1808             </loctext>
1809           </description>
1810         </prop_pattern>
1811         <prop_pattern name="queue_type" required="false" type="astring">
1812           <description>
1813             <loctext xml:lang="C">
1814 Which type of queue to use for asynchronous processing.
1815             </loctext>
1816           </description>
1817         </prop_pattern>
1818         <prop_pattern name="rails_loglevel" required="false" type="astring">
1819           <description>
1820             <loctext xml:lang="C">
1821 The log level for Rails connections.  The value must be
1822 a valid log level within Rails.  Production environments normally use `info`
1823 and other environments normally use `debug`. This setting is only used by the ActiveRecord storeconfigs and inventory backends, which are deprecated.
1824             </loctext>
1825           </description>
1826         </prop_pattern>
1827         <prop_pattern name="railslog" required="false" type="astring">
1828           <description>
1829             <loctext xml:lang="C">
1830 Where Rails-specific logs are sent. This setting is only used by the ActiveRecord storeconfigs and inventory backends, which are deprecated.
1831             </loctext>
1832           </description>
1833         </prop_pattern>
1834         <prop_pattern name="report" required="false" type="boolean">
1835           <description>
1836             <loctext xml:lang="C">
1837 Whether to send reports after every transaction.
1838             </loctext>
1839           </description>
1840         </prop_pattern>
1841         <prop_pattern name="report_port" required="false" type="integer">
1842           <description>
1843             <loctext xml:lang="C">
1844 The port to communicate with the report_server.
1845             </loctext>
1846           </description>
1847         </prop_pattern>
1848         <prop_pattern name="report_serialization_format" required="false" type="astring">
1849           <description>
1850             <loctext xml:lang="C">
1851 The serialization format to use when sending reports to the
1852 `report_server`. Possible values are `pson` and `yaml`. This setting
1853 affects puppet agent, but not puppet apply (which processes its own
1854 reports).
1855
1856 This should almost always be set to `pson`. It can be temporarily set to
1857 `yaml` to let agents using this Puppet version connect to a puppet master
1858 running Puppet 3.0.0 through 3.2.x.
1859
1860 Note that this is set to 'yaml' automatically if the agent detects an
1861 older master, so should never need to be set explicitly.
1862             </loctext>
1863           </description>
1864         </prop_pattern>
1865         <prop_pattern name="report_server" required="false" type="host">
1866           <description>
1867             <loctext xml:lang="C">
1868 The server to send transaction reports to.
1869             </loctext>
1870           </description>
1871         </prop_pattern>
1872         <prop_pattern name="reportdir" required="false" type="astring">
1873           <description>
1874             <loctext xml:lang="C">
1875 The directory in which to store reports. Each node gets
1876 a separate subdirectory in this directory. This setting is only
1877 used when the `store` report processor is enabled (see the
1878 `reports` setting).
1879             </loctext>
1880           </description>
1881         </prop_pattern>
1882         <prop_pattern name="reportfrom" required="false" type="astring">
1883           <description>
1884             <loctext xml:lang="C">
1885 The 'from' email address for the reports.
1886             </loctext>
1887           </description>
1888         </prop_pattern>
1889         <prop_pattern name="reports" required="false" type="astring">
1890           <description>
1891             <loctext xml:lang="C">
1892 The list of report handlers to use. When using multiple report handlers,
1893 their names should be comma-separated, with whitespace allowed. (For example,
1894 `reports = http, tagmail`.)
1895
1896 This setting is relevant to puppet master and puppet apply. The puppet
1897 master will call these report handlers with the reports it receives from
1898 agent nodes, and puppet apply will call them with its own report. (In
1899 all cases, the node applying the catalog must have `report = true`.)
1900
1901 See the report reference for information on the built-in report
1902 handlers; custom report handlers can also be loaded from modules.
1903 (Report handlers are loaded from the lib directory, at
1904 `puppet/reports/NAME.rb`.)
1905             </loctext>
1906           </description>
1907         </prop_pattern>
1908         <prop_pattern name="reporturl" required="false" type="uri">
1909           <description>
1910             <loctext xml:lang="C">
1911 The URL that reports should be forwarded to. This setting
1912 is only used when the `http` report processor is enabled (see the
1913 `reports` setting).
1914             </loctext>
1915           </description>
1916         </prop_pattern>
1917         <prop_pattern name="req_bits" required="false" type="integer">
1918           <description>
1919             <loctext xml:lang="C">
1920 The bit length of the certificates.
1921             </loctext>
1922           </description>
1923         </prop_pattern>
1924         <prop_pattern name="requestdir" required="false" type="astring">
1925           <description>
1926             <loctext xml:lang="C">
1927 Where host certificate requests are stored.
1928             </loctext>
1929           </description>
1930         </prop_pattern>
1931         <prop_pattern name="resourcefile" required="false" type="astring">
1932           <description>
1933             <loctext xml:lang="C">
1934 The file in which puppet agent stores a list of the resources
1935 associated with the retrieved configuration.
1936             </loctext>
1937           </description>
1938         </prop_pattern>
1939         <prop_pattern name="rest_authconfig" required="false" type="astring">
1940           <description>
1941             <loctext xml:lang="C">
1942 The configuration file that defines the rights to the different
1943 rest indirections.  This can be used as a fine-grained
1944 authorization system for `puppet master`.
1945             </loctext>
1946           </description>
1947         </prop_pattern>
1948         <prop_pattern name="route_file" required="false" type="astring">
1949           <description>
1950             <loctext xml:lang="C">
1951 The YAML file containing indirector route configuration.
1952             </loctext>
1953           </description>
1954         </prop_pattern>
1955         <prop_pattern name="rrddir" required="false" type="astring">
1956           <description>
1957             <loctext xml:lang="C">
1958 The directory where RRD database files are stored.
1959 Directories for each reporting host will be created under
1960 this directory.
1961             </loctext>
1962           </description>
1963         </prop_pattern>
1964         <prop_pattern name="rrdinterval" required="false" type="integer">
1965           <description>
1966             <loctext xml:lang="C">
1967 How often RRD should expect data.
1968 This should match how often the hosts report back to the server. This setting can be a time interval in seconds (30 or 30s), minutes (30m), hours (6h), days (2d), or years (5y).
1969             </loctext>
1970           </description>
1971         </prop_pattern>
1972         <prop_pattern name="rundir" required="false" type="astring">
1973           <description>
1974             <loctext xml:lang="C">
1975 Where Puppet PID files are kept.
1976             </loctext>
1977           </description>
1978         </prop_pattern>
1979         <prop_pattern name="runinterval" required="false" type="integer">
1980           <description>
1981             <loctext xml:lang="C">
1982 How often puppet agent applies the catalog.
1983 Note that a runinterval of 0 means "run continuously" rather than
1984 "never run." If you want puppet agent to never run, you should start
1985 it with the `--no-client` option. This setting can be a time interval in seconds (30 or 30s), minutes (30m), hours (6h), days (2d), or years (5y).
1986             </loctext>
1987           </description>
1988         </prop_pattern>
1989         <prop_pattern name="sendmail" required="false" type="astring">
1990           <description>
1991             <loctext xml:lang="C">
1992 Where to find the sendmail binary with which to send email.
1993             </loctext>
1994           </description>
1995         </prop_pattern>
1996         <prop_pattern name="serial" required="false" type="astring">
1997           <description>
1998             <loctext xml:lang="C">
1999 Where the serial number for certificates is stored.
2000             </loctext>
2001           </description>
2002         </prop_pattern>
2003         <prop_pattern name="server" required="false" type="host">
2004           <description>
2005             <loctext xml:lang="C">
2006 The puppet master server to which the puppet agent should connect.
2007             </loctext>
2008           </description>
2009         </prop_pattern>
2010         <prop_pattern name="server_datadir" required="false" type="astring">
2011           <description>
2012             <loctext xml:lang="C">
2013 The directory in which serialized data is stored, usually in a subdirectory.
2014             </loctext>
2015           </description>
2016         </prop_pattern>
2017         <prop_pattern name="show_diff" required="false" type="boolean">
2018           <description>
2019             <loctext xml:lang="C">
2020 Whether to log and report a contextual diff when files are being replaced.
2021 This causes partial file contents to pass through Puppet's normal
2022 logging and reporting system, so this setting should be used with
2023 caution if you are sending Puppet's reports to an insecure
2024 destination. This feature currently requires the `diff/lcs` Ruby
2025 library.
2026             </loctext>
2027           </description>
2028         </prop_pattern>
2029         <prop_pattern name="signeddir" required="false" type="astring">
2030           <description>
2031             <loctext xml:lang="C">
2032 Where the CA stores signed certificates.
2033             </loctext>
2034           </description>
2035         </prop_pattern>
2036         <prop_pattern name="smtphelo" required="false" type="astring">
2037           <description>
2038             <loctext xml:lang="C">
2039 The name by which we identify ourselves in SMTP HELO for reports.
2040 If you send to a smtpserver which does strict HELO checking (as with Postfix's
2041 `smtpd_helo_restrictions` access controls), you may need to ensure this resolves.
2042             </loctext>
2043           </description>
2044         </prop_pattern>
2045         <prop_pattern name="smtpport" required="false" type="integer">
2046           <description>
2047             <loctext xml:lang="C">
2048 The TCP port through which to send email reports.
2049             </loctext>
2050           </description>
2051         </prop_pattern>
2052         <prop_pattern name="smtpserver" required="false" type="host">
2053           <description>
2054             <loctext xml:lang="C">
2055 The server through which to send email reports.
2056             </loctext>
2057           </description>
2058         </prop_pattern>
2059         <prop_pattern name="splay" required="false" type="boolean">
2060           <description>
2061             <loctext xml:lang="C">
2062 Whether to sleep for a pseudo-random (but consistent) amount of time before
2063 a run.
2064             </loctext>
2065           </description>
2066         </prop_pattern>
2067         <prop_pattern name="splaylimit" required="false" type="integer">
2068           <description>
2069             <loctext xml:lang="C">
2070 The maximum time to delay before runs.  Defaults to being the same as the
2071 run interval. This setting can be a time interval in seconds (30 or 30s), minutes (30m), hours (6h), days (2d), or years (5y).
2072             </loctext>
2073           </description>
2074         </prop_pattern>
2075         <prop_pattern name="srv_domain" required="false" type="host">
2076           <description>
2077             <loctext xml:lang="C">
2078 The domain which will be queried to find the SRV records of servers to use.
2079             </loctext>
2080           </description>
2081         </prop_pattern>
2082         <prop_pattern name="ssl_client_ca_auth" required="false" type="astring">
2083           <description>
2084             <loctext xml:lang="C">
2085 Certificate authorities who issue server certificates.  SSL servers will not be
2086 considered authentic unless they possess a certificate issued by an authority
2087 listed in this file.  If this setting has no value then the Puppet master's CA
2088 certificate (localcacert) will be used.
2089             </loctext>
2090           </description>
2091         </prop_pattern>
2092         <prop_pattern name="ssl_client_header" required="false" type="astring">
2093           <description>
2094             <loctext xml:lang="C">
2095 The header containing an authenticated client's SSL DN.
2096 This header must be set by the proxy to the authenticated client's SSL
2097 DN (e.g., `/CN=puppet.puppetlabs.com`).  Puppet will parse out the Common
2098 Name (CN) from the Distinguished Name (DN) and use the value of the CN
2099 field for authorization.
2100
2101 Note that the name of the HTTP header gets munged by the web server
2102 common gateway inteface: an `HTTP_` prefix is added, dashes are converted
2103 to underscores, and all letters are uppercased.  Thus, to use the
2104 `X-Client-DN` header, this setting should be `HTTP_X_CLIENT_DN`.
2105             </loctext>
2106           </description>
2107         </prop_pattern>
2108         <prop_pattern name="ssl_client_verify_header" required="false" type="astring">
2109           <description>
2110             <loctext xml:lang="C">
2111 The header containing the status message of the client
2112 verification. This header must be set by the proxy to 'SUCCESS' if the
2113 client successfully authenticated, and anything else otherwise.
2114
2115 Note that the name of the HTTP header gets munged by the web server
2116 common gateway inteface: an `HTTP_` prefix is added, dashes are converted
2117 to underscores, and all letters are uppercased.  Thus, to use the
2118 `X-Client-Verify` header, this setting should be
2119 `HTTP_X_CLIENT_VERIFY`.
2120             </loctext>
2121           </description>
2122         </prop_pattern>
2123         <prop_pattern name="ssl_server_ca_auth" required="false" type="astring">
2124           <description>
2125             <loctext xml:lang="C">
2126 Certificate authorities who issue client certificates.  SSL clients will not be
2127 considered authentic unless they possess a certificate issued by an authority
2128 listed in this file.  If this setting has no value then the Puppet master's CA
2129 certificate (localcacert) will be used.
2130             </loctext>
2131           </description>
2132         </prop_pattern>
2133         <prop_pattern name="ssldir" required="false" type="astring">
2134           <description>
2135             <loctext xml:lang="C">
2136 Where SSL certificates are kept.
2137             </loctext>
2138           </description>
2139         </prop_pattern>
2140         <prop_pattern name="statedir" required="false" type="astring">
2141           <description>
2142             <loctext xml:lang="C">
2143 The directory where Puppet state is stored.  Generally,
2144 this directory can be removed without causing harm (although it
2145 might result in spurious service restarts).
2146             </loctext>
2147           </description>
2148         </prop_pattern>
2149         <prop_pattern name="statefile" required="false" type="astring">
2150           <description>
2151             <loctext xml:lang="C">
2152 Where puppet agent and puppet master store state associated
2153 with the running configuration.  In the case of puppet master,
2154 this file reflects the state discovered through interacting
2155 with clients.
2156             </loctext>
2157           </description>
2158         </prop_pattern>
2159         <prop_pattern name="storeconfigs" required="false" type="boolean">
2160           <description>
2161             <loctext xml:lang="C">
2162 Whether to store each client's configuration, including catalogs, facts,
2163 and related data.  This also enables the import and export of resources in
2164 the Puppet language - a mechanism for exchange resources between nodes.
2165
2166 By default this uses ActiveRecord and an SQL database to store and query
2167 the data; this, in turn, will depend on Rails being available.
2168
2169 You can adjust the backend using the storeconfigs_backend setting.
2170             </loctext>
2171           </description>
2172         </prop_pattern>
2173         <prop_pattern name="storeconfigs_backend" required="false" type="astring">
2174           <description>
2175             <loctext xml:lang="C">
2176 Configure the backend terminus used for StoreConfigs.
2177 By default, this uses the ActiveRecord store, which directly talks to the
2178 database from within the Puppet Master process.
2179             </loctext>
2180           </description>
2181         </prop_pattern>
2182         <prop_pattern name="strict_hostname_checking" required="false" type="boolean">
2183           <description>
2184             <loctext xml:lang="C">
2185 Whether to only search for the complete
2186 hostname as it is in the certificate when searching for node information
2187 in the catalogs.
2188             </loctext>
2189           </description>
2190         </prop_pattern>
2191         <prop_pattern name="strict_variables" required="false" type="boolean">
2192           <description>
2193             <loctext xml:lang="C">
2194 Makes the parser raise errors when referencing unknown variables. (This does not affect
2195 referencing variables that are explicitly set to undef).
2196             </loctext>
2197           </description>
2198         </prop_pattern>
2199         <prop_pattern name="stringify_facts" required="false" type="boolean">
2200           <description>
2201             <loctext xml:lang="C">
2202 to_s. Means you can't have arrays or
2203 hashes as fact values. (DEPRECATED) This option will be removed in Puppet 4.0.
2204             </loctext>
2205           </description>
2206         </prop_pattern>
2207         <prop_pattern name="summarize" required="false" type="boolean">
2208           <description>
2209             <loctext xml:lang="C">
2210 Whether to print a transaction summary.
2211             </loctext>
2212           </description>
2213         </prop_pattern>
2214         <prop_pattern name="syslogfacility" required="false" type="astring">
2215           <description>
2216             <loctext xml:lang="C">
2217 What syslog facility to use when logging to syslog.
2218 Syslog has a fixed list of valid facilities, and you must
2219 choose one of those; you cannot just make one up.
2220             </loctext>
2221           </description>
2222         </prop_pattern>
2223         <prop_pattern name="tagmap" required="false" type="astring">
2224           <description>
2225             <loctext xml:lang="C">
2226 The mapping between reporting tags and email addresses.
2227             </loctext>
2228           </description>
2229         </prop_pattern>
2230         <prop_pattern name="tags" required="false" type="astring">
2231           <description>
2232             <loctext xml:lang="C">
2233 Tags to use to find resources.  If this is set, then
2234 only resources tagged with the specified tags will be applied.
2235 Values must be comma-separated.
2236             </loctext>
2237           </description>
2238         </prop_pattern>
2239         <prop_pattern name="templatedir" required="false" type="astring">
2240           <description>
2241             <loctext xml:lang="C">
2242 Where Puppet looks for template files.  Can be a list of colon-separated
2243 directories.
2244
2245 This setting is deprecated. Please put your templates in modules instead.
2246             </loctext>
2247           </description>
2248         </prop_pattern>
2249         <prop_pattern name="thin_storeconfigs" required="false" type="boolean">
2250           <description>
2251             <loctext xml:lang="C">
2252 Boolean; whether Puppet should store only facts and exported resources in the storeconfigs
2253 database. This will improve the performance of exported resources with the older
2254 `active_record` backend, but will disable external tools that search the storeconfigs database.
2255 Thinning catalogs is generally unnecessary when using PuppetDB to store catalogs.
2256             </loctext>
2257           </description>
2258         </prop_pattern>
2259         <prop_pattern name="trace" required="false" type="boolean">
2260           <description>
2261             <loctext xml:lang="C">
2262 Whether to print stack traces on some errors
2263             </loctext>
2264           </description>
2265         </prop_pattern>
2266         <prop_pattern name="trusted_node_data" required="false" type="boolean">
2267           <description>
2268             <loctext xml:lang="C">
2269 Stores trusted node data in a hash called $trusted.
2270 When true also prevents $trusted from being overridden in any scope.
2271             </loctext>
2272           </description>
2273         </prop_pattern>
2274         <prop_pattern name="use_cached_catalog" required="false" type="boolean">
2275           <description>
2276             <loctext xml:lang="C">
2277 Whether to only use the cached catalog rather than compiling a new catalog
2278 on every run.  Puppet can be run with this enabled by default and then selectively
2279 disabled when a recompile is desired.
2280             </loctext>
2281           </description>
2282         </prop_pattern>
2283         <prop_pattern name="use_srv_records" required="false" type="boolean">
2284           <description>
2285             <loctext xml:lang="C">
2286 Whether the server will search for SRV records in DNS for the current domain.
2287             </loctext>
2288           </description>
2289         </prop_pattern>
2290         <prop_pattern name="usecacheonfailure" required="false" type="boolean">
2291           <description>
2292             <loctext xml:lang="C">
2293 Whether to use the cached configuration when the remote
2294 configuration will not compile.  This option is useful for testing
2295 new configurations, where you want to fix the broken configuration
2296 rather than reverting to a known-good one.
2297             </loctext>
2298           </description>
2299         </prop_pattern>
2300         <prop_pattern name="user" required="false" type="astring">
2301           <description>
2302             <loctext xml:lang="C">
2303 The user puppet master should run as.
2304             </loctext>
2305           </description>
2306         </prop_pattern>
2307         <prop_pattern name="vardir" required="false" type="astring">
2308           <description>
2309             <loctext xml:lang="C">
2310 Where Puppet stores dynamic and growing data.  The default for this
2311 setting is calculated specially, like `confdir`_.
2312             </loctext>
2313           </description>
2314         </prop_pattern>
2315         <prop_pattern name="waitforcert" required="false" type="integer">
2316           <description>
2317             <loctext xml:lang="C">
2318 How frequently puppet agent should ask for a signed certificate.
2319
2320 When starting for the first time, puppet agent will submit a certificate
2321 signing request (CSR) to the server named in the `ca_server` setting
2322 (usually the puppet master); this may be autosigned, or may need to be
2323 approved by a human, depending on the CA server's configuration.
2324
2325 Puppet agent cannot apply configurations until its approved certificate is
2326 available. Since the certificate may or may not be available immediately,
2327 puppet agent will repeatedly try to fetch it at this interval. You can
2328 turn off waiting for certificates by specifying a time of 0, in which case
2329 puppet agent will exit if it cannot get a cert.
2330 This setting can be a time interval in seconds (30 or 30s), minutes (30m), hours (6h), days (2d), or years (5y).
2331             </loctext>
2332           </description>
2333         </prop_pattern>
2334         <prop_pattern name="yamldir" required="false" type="astring">
2335           <description>
2336             <loctext xml:lang="C">
2337 The directory in which YAML data is stored, usually in a subdirectory.
2338             </loctext>
2339           </description>
2340         </prop_pattern>
2341         <prop_pattern name="zlib" required="false" type="boolean">
2342           <description>
2343             <loctext xml:lang="C">
2344 Boolean; whether to use the zlib library
2345             </loctext>
2346           </description>
2347         </prop_pattern>
2348       </pg_pattern>
2349     </template>
2350   </service>
2351 </service_bundle>