puppet 3.1.0.rc1 → 3.1.0.rc2

Sign up to get free protection for your applications and to get access to all the features.

Potentially problematic release.


This version of puppet might be problematic. Click here for more details.

Files changed (127) hide show
  1. data/COMMITTERS.md +185 -0
  2. data/ext/debian/changelog.erb +6 -0
  3. data/ext/debian/puppet-common.manpages +1 -0
  4. data/ext/debian/puppet.default +3 -1
  5. data/ext/debian/puppetmaster.default +6 -3
  6. data/ext/redhat/puppet.spec.erb +16 -5
  7. data/lib/puppet.rb +3 -5
  8. data/lib/puppet/defaults.rb +6 -5
  9. data/lib/puppet/dsl.rb +3 -7
  10. data/lib/puppet/dsl/resource_api.rb +120 -0
  11. data/lib/puppet/dsl/resource_type_api.rb +34 -0
  12. data/lib/puppet/module_tool.rb +23 -11
  13. data/lib/puppet/network/formats.rb +1 -1
  14. data/lib/puppet/node/environment.rb +1 -3
  15. data/lib/puppet/parser/ast/definition.rb +5 -2
  16. data/lib/puppet/parser/ast/hostclass.rb +3 -2
  17. data/lib/puppet/parser/ast/node.rb +5 -2
  18. data/lib/puppet/parser/ast/resourceparam.rb +1 -1
  19. data/lib/puppet/parser/compiler.rb +0 -10
  20. data/lib/puppet/parser/lexer.rb +50 -39
  21. data/lib/puppet/parser/parser_support.rb +29 -11
  22. data/lib/puppet/parser/scope.rb +2 -2
  23. data/lib/puppet/parser/type_loader.rb +7 -31
  24. data/lib/puppet/provider/package/openbsd.rb +16 -2
  25. data/lib/puppet/provider/package/pip.rb +11 -2
  26. data/lib/puppet/provider/package/portage.rb +29 -12
  27. data/lib/puppet/provider/service/launchd.rb +19 -14
  28. data/lib/puppet/provider/service/upstart.rb +1 -1
  29. data/lib/puppet/provider/user/hpux.rb +37 -2
  30. data/lib/puppet/resource.rb +25 -38
  31. data/lib/puppet/resource/type.rb +6 -14
  32. data/lib/puppet/settings.rb +1 -1
  33. data/lib/puppet/ssl/certificate_authority.rb +4 -1
  34. data/lib/puppet/ssl/certificate_request.rb +3 -1
  35. data/lib/puppet/ssl/certificate_signer.rb +22 -0
  36. data/lib/puppet/type.rb +4 -4
  37. data/lib/puppet/util/methodhelper.rb +0 -19
  38. data/lib/puppet/util/rubygems.rb +3 -1
  39. data/lib/puppet/util/selinux.rb +1 -6
  40. data/lib/puppet/version.rb +1 -1
  41. data/man/man5/puppet.conf.5 +81 -95
  42. data/man/man8/extlookup2hiera.8 +23 -0
  43. data/man/man8/puppet-agent.8 +3 -3
  44. data/man/man8/puppet-apply.8 +2 -6
  45. data/man/man8/puppet-ca.8 +6 -7
  46. data/man/man8/puppet-catalog.8 +6 -7
  47. data/man/man8/puppet-cert.8 +4 -4
  48. data/man/man8/puppet-certificate.8 +6 -7
  49. data/man/man8/puppet-certificate_request.8 +6 -7
  50. data/man/man8/puppet-certificate_revocation_list.8 +6 -7
  51. data/man/man8/puppet-config.8 +4 -8
  52. data/man/man8/puppet-describe.8 +1 -1
  53. data/man/man8/puppet-device.8 +1 -1
  54. data/man/man8/puppet-doc.8 +3 -3
  55. data/man/man8/puppet-facts.8 +4 -8
  56. data/man/man8/puppet-file.8 +6 -7
  57. data/man/man8/puppet-filebucket.8 +1 -1
  58. data/man/man8/puppet-help.8 +2 -6
  59. data/man/man8/puppet-inspect.8 +1 -1
  60. data/man/man8/puppet-instrumentation_data.8 +3 -7
  61. data/man/man8/puppet-instrumentation_listener.8 +3 -7
  62. data/man/man8/puppet-instrumentation_probe.8 +3 -7
  63. data/man/man8/puppet-key.8 +6 -7
  64. data/man/man8/puppet-kick.8 +5 -1
  65. data/man/man8/puppet-man.8 +2 -6
  66. data/man/man8/puppet-master.8 +2 -2
  67. data/man/man8/puppet-module.8 +11 -9
  68. data/man/man8/puppet-node.8 +38 -37
  69. data/man/man8/puppet-parser.8 +2 -6
  70. data/man/man8/puppet-plugin.8 +2 -6
  71. data/man/man8/puppet-queue.8 +1 -1
  72. data/man/man8/puppet-report.8 +3 -7
  73. data/man/man8/puppet-resource.8 +1 -1
  74. data/man/man8/puppet-resource_type.8 +3 -7
  75. data/man/man8/puppet-secret_agent.8 +2 -6
  76. data/man/man8/puppet-status.8 +3 -7
  77. data/man/man8/puppet.8 +1 -1
  78. data/spec/integration/parser/ruby_manifest_spec.rb +128 -0
  79. data/spec/lib/puppet_spec/compiler.rb +0 -11
  80. data/spec/spec_helper.rb +3 -4
  81. data/spec/unit/dsl/resource_api_spec.rb +180 -0
  82. data/spec/unit/dsl/resource_type_api_spec.rb +53 -0
  83. data/spec/unit/module_tool_spec.rb +79 -46
  84. data/spec/unit/network/formats_spec.rb +4 -0
  85. data/spec/unit/node/environment_spec.rb +0 -13
  86. data/spec/unit/parser/compiler_spec.rb +0 -26
  87. data/spec/unit/parser/parser_spec.rb +14 -0
  88. data/spec/unit/parser/type_loader_spec.rb +4 -15
  89. data/spec/unit/provider/package/openbsd_spec.rb +148 -35
  90. data/spec/unit/provider/package/pip_spec.rb +49 -25
  91. data/spec/unit/provider/package/portage_spec.rb +65 -0
  92. data/spec/unit/provider/service/launchd_spec.rb +6 -5
  93. data/spec/unit/provider/user/hpux_spec.rb +39 -11
  94. data/spec/unit/provider/user/useradd_spec.rb +14 -14
  95. data/spec/unit/resource/type_spec.rb +7 -49
  96. data/spec/unit/resource_spec.rb +0 -32
  97. data/spec/unit/ssl/certificate_request_spec.rb +18 -0
  98. data/spec/unit/util/rubygems_spec.rb +1 -1
  99. data/spec/unit/util/selinux_spec.rb +0 -2
  100. metadata +17 -50
  101. data/lib/puppet/dsl/actions.rb +0 -283
  102. data/lib/puppet/dsl/blank_slate.rb +0 -55
  103. data/lib/puppet/dsl/context.rb +0 -393
  104. data/lib/puppet/dsl/parser.rb +0 -57
  105. data/lib/puppet/dsl/resource_decorator.rb +0 -56
  106. data/lib/puppet/dsl/resource_reference.rb +0 -95
  107. data/lib/puppet/dsl/type_reference.rb +0 -102
  108. data/lib/puppet/util/manifest_filetype_helper.rb +0 -22
  109. data/spec/integration/dsl/classes_spec.rb +0 -191
  110. data/spec/integration/dsl/defaults_spec.rb +0 -38
  111. data/spec/integration/dsl/definitions_spec.rb +0 -73
  112. data/spec/integration/dsl/functions_spec.rb +0 -95
  113. data/spec/integration/dsl/nodes_spec.rb +0 -96
  114. data/spec/integration/dsl/params_spec.rb +0 -146
  115. data/spec/integration/dsl/relationships_spec.rb +0 -46
  116. data/spec/integration/dsl/resources_spec.rb +0 -202
  117. data/spec/integration/dsl/type_loading_spec.rb +0 -64
  118. data/spec/lib/matchers/catalog.rb +0 -50
  119. data/spec/lib/puppet_spec/dsl.rb +0 -29
  120. data/spec/unit/dsl/actions_spec.rb +0 -402
  121. data/spec/unit/dsl/blank_slate_spec.rb +0 -27
  122. data/spec/unit/dsl/context_spec.rb +0 -678
  123. data/spec/unit/dsl/parser_spec.rb +0 -56
  124. data/spec/unit/dsl/resource_decorator_spec.rb +0 -94
  125. data/spec/unit/dsl/resource_reference_spec.rb +0 -150
  126. data/spec/unit/dsl/type_reference_spec.rb +0 -164
  127. data/spec/unit/util/manifest_filetype_helper_spec.rb +0 -29
@@ -1,6 +1,7 @@
1
1
  require 'monitor'
2
2
  require 'puppet/ssl/host'
3
3
  require 'puppet/ssl/certificate_request'
4
+ require 'puppet/ssl/certificate_signer'
4
5
  require 'puppet/util'
5
6
 
6
7
  # The class that knows how to sign certificates. It creates
@@ -277,7 +278,9 @@ class Puppet::SSL::CertificateAuthority
277
278
  cert = Puppet::SSL::Certificate.new(hostname)
278
279
  cert.content = Puppet::SSL::CertificateFactory.
279
280
  build(cert_type, csr, issuer, next_serial)
280
- cert.content.sign(host.key.content, OpenSSL::Digest::SHA256.new)
281
+
282
+ signer = Puppet::SSL::CertificateSigner.new
283
+ signer.sign(cert.content, host.key.content)
281
284
 
282
285
  Puppet.notice "Signed certificate request for #{hostname}"
283
286
 
@@ -1,4 +1,5 @@
1
1
  require 'puppet/ssl/base'
2
+ require 'puppet/ssl/certificate_signer'
2
3
 
3
4
  # Manage certificate requests.
4
5
  class Puppet::SSL::CertificateRequest < Puppet::SSL::Base
@@ -59,7 +60,8 @@ class Puppet::SSL::CertificateRequest < Puppet::SSL::Base
59
60
  csr.add_attribute(OpenSSL::X509::Attribute.new("extReq", extReq))
60
61
  end
61
62
 
62
- csr.sign(key, OpenSSL::Digest::SHA256.new)
63
+ signer = Puppet::SSL::CertificateSigner.new
64
+ signer.sign(csr, key)
63
65
 
64
66
  raise Puppet::Error, "CSR sign verification failed; you need to clean the certificate request for #{name} on the server" unless csr.verify(key.public_key)
65
67
 
@@ -0,0 +1,22 @@
1
+ # Take care of signing a certificate in a FIPS 140-2 compliant manner.
2
+ #
3
+ # @see http://projects.puppetlabs.com/issues/17295
4
+ #
5
+ # @api private
6
+ class Puppet::SSL::CertificateSigner
7
+ def initialize
8
+ if OpenSSL::Digest.const_defined?('SHA256')
9
+ @digest = OpenSSL::Digest::SHA256
10
+ elsif OpenSSL::Digest.const_defined?('SHA1')
11
+ @digest = OpenSSL::Digest::SHA1
12
+ else
13
+ raise Puppet::Error,
14
+ "No FIPS 140-2 compliant digest algorithm in OpenSSL::Digest"
15
+ end
16
+ @digest
17
+ end
18
+
19
+ def sign(content, key)
20
+ content.sign(key, @digest.new)
21
+ end
22
+ end
@@ -611,11 +611,11 @@ class Type
611
611
  @name_var_cache = (key_attributes.length == 1) && key_attributes.first
612
612
  end
613
613
 
614
- # Gets the 'is' (current state) value of a parameter or property by name.
615
- # To explicitly get the 'is' value use `o.is(:name)`, and to get the 'should' value
614
+ # Gets the 'should' (wanted state) value of a parameter or property by name.
615
+ # To explicitly get the 'is' (current state) value use `o.is(:name)`, and to explicitly get the 'should' value
616
616
  # use `o.should(:name)`
617
- # @param name [String] the name of the attribute to obtain the 'is' value for.
618
- # @return [Object] current value of the given attribute
617
+ # @param name [String] the name of the attribute to obtain the 'should' value for.
618
+ # @return [Object] 'should'/wanted value of the given attribute
619
619
  def [](name)
620
620
  name = name.intern
621
621
  fail("Invalid parameter #{name}(#{name.inspect})") unless self.class.validattr?(name)
@@ -1,7 +1,5 @@
1
1
  # Where we store helper methods related to, um, methods.
2
2
  module Puppet::Util::MethodHelper
3
- extend self
4
-
5
3
  def requiredopts(*names)
6
4
  names.each do |name|
7
5
  devfail("#{name} is a required option for #{self.class}") if self.send(name).nil?
@@ -31,21 +29,4 @@ module Puppet::Util::MethodHelper
31
29
  hash
32
30
  end
33
31
  end
34
-
35
- ##
36
- # Helper to validate options. Example:
37
- #
38
- # validate_options [:arguments, :inherits], options
39
- #
40
- # It expects list of valid options and a hash to validate as a last
41
- # argument.
42
- ##
43
- def validate_options(allow, options = {})
44
- options.each do |k, _|
45
- unless Array(allow).include? k
46
- raise ArgumentError, "unrecognized option #{k}"
47
- end
48
- end
49
- end
50
-
51
32
  end
@@ -39,7 +39,9 @@ module Puppet::Util::RubyGems
39
39
  # @api private
40
40
  class Gems18Source < Source
41
41
  def directories
42
- Gem::Specification.latest_specs.collect do |spec|
42
+ # `require 'mygem'` will consider and potentally load
43
+ # prerelease gems, so we need to match that behavior.
44
+ Gem::Specification.latest_specs(true).collect do |spec|
43
45
  File.join(spec.full_gem_path, 'lib')
44
46
  end
45
47
  end
@@ -43,13 +43,8 @@ module Puppet::Util::SELinux
43
43
  # matching. If not, we can pass a mode of 0.
44
44
  begin
45
45
  filestat = file_lstat(file)
46
- rescue Errno::EACCES, Errno::ENOENT => detail
47
- warning "Could not stat; #{detail}"
48
- end
49
-
50
- if filestat
51
46
  mode = filestat.mode
52
- else
47
+ rescue Errno::EACCES, Errno::ENOENT
53
48
  mode = 0
54
49
  end
55
50
 
@@ -7,7 +7,7 @@
7
7
 
8
8
 
9
9
  module Puppet
10
- PUPPETVERSION = '3.1.0-rc1'
10
+ PUPPETVERSION = '3.1.0-rc2'
11
11
 
12
12
  ##
13
13
  # version is a public API method intended to always provide a fast and
@@ -1,8 +1,8 @@
1
1
  .\" generated with Ronn/v0.7.3
2
2
  .\" http://github.com/rtomayko/ronn/tree/0.7.3
3
3
  .
4
- .TH "PUPPETCONF" "5" "May 2012" "Puppet Labs, LLC" "Puppet manual"
5
- \fBThis page is autogenerated; any changes will get overwritten\fR \fI(last generated on Thu May 17 14:19:16 \-0700 2012)\fR
4
+ .TH "PUPPETCONF" "5" "January 2013" "Puppet Labs, LLC" "Puppet manual"
5
+ \fBThis page is autogenerated; any changes will get overwritten\fR \fI(last generated on Tue Jan 15 12:33:09 \-0800 2013)\fR
6
6
  .
7
7
  .SH "Configuration Settings"
8
8
  .
@@ -19,6 +19,9 @@ Settings can be interpolated as \fB$variables\fR in other settings; \fB$environm
19
19
  Multiple values should be specified as comma\-separated lists; multiple directories should be separated with the system path separator (usually a colon)\.
20
20
  .
21
21
  .IP "\(bu" 4
22
+ Settings that represent time intervals should be specified in duration format: an integer immediately followed by one of the units \'y\' (years of 365 days), \'d\' (days), \'h\' (hours), \'m\' (minutes), or \'s\' (seconds)\. The unit cannot be combined with other units, and defaults to seconds when omitted\. Examples are \'3600\' which is equivalent to \'1h\' (one hour), and \'1825d\' which is equivalent to \'5y\' (5 years)\.
23
+ .
24
+ .IP "\(bu" 4
22
25
  Settings that take a single file or directory can optionally set the owner, group, and mode for their value: \fBrundir = $vardir/run { owner = puppet, group = puppet, mode = 644 }\fR
23
26
  .
24
27
  .IP "\(bu" 4
@@ -29,6 +32,14 @@ The Puppet executables will ignore any setting that isn\'t relevant to their fun
29
32
  .P
30
33
  See the configuration guide \fIhttp://docs\.puppetlabs\.com/guides/configuring\.html\fR for more details\.
31
34
  .
35
+ .SS "agent_catalog_run_lockfile"
36
+ A lock file to indicate that a puppet agent catalog run is currently in progress\. The file contains the pid of the process that holds the lock on the catalog run\.
37
+ .
38
+ .IP "\(bu" 4
39
+ \fIDefault\fR: $statedir/agent_catalog_run\.lock
40
+ .
41
+ .IP "" 0
42
+ .
32
43
  .SS "agent_disabled_lockfile"
33
44
  A lock file to indicate that puppet agent runs have been administratively disabled\. File contains a JSON object with state information\.
34
45
  .
@@ -37,16 +48,16 @@ A lock file to indicate that puppet agent runs have been administratively disabl
37
48
  .
38
49
  .IP "" 0
39
50
  .
40
- .SS "agent_pidfile"
41
- A lock file to indicate that a puppet agent run is currently in progress\. File contains the pid of the running process\.
51
+ .SS "allow_duplicate_certs"
52
+ Whether to allow a new certificate request to overwrite an existing certificate\.
42
53
  .
43
54
  .IP "\(bu" 4
44
- \fIDefault\fR: $statedir/agent\.pid
55
+ \fIDefault\fR: false
45
56
  .
46
57
  .IP "" 0
47
58
  .
48
- .SS "allow_duplicate_certs"
49
- Whether to allow a new certificate request to overwrite an existing certificate\.
59
+ .SS "allow_variables_with_dashes"
60
+ Permit hyphens (\fB\-\fR) in variable names and issue deprecation warnings about them\. This setting \fBshould always be \fBfalse\fR;\fR setting it to \fBtrue\fR will cause subtle and wide\-ranging bugs\. It will be removed in a future version\. Hyphenated variables caused major problems in the language, but were allowed between Puppet 2\.7\.3 and 2\.7\.14\. If you used them during this window, we apologize for the inconvenience \-\-\- you can temporarily set this to \fBtrue\fR in order to upgrade, and can rename your variables at your leisure\. Please revert it to \fBfalse\fR after you have renamed all affected variables\.
50
61
  .
51
62
  .IP "\(bu" 4
52
63
  \fIDefault\fR: false
@@ -70,21 +81,13 @@ During an inspect run, whether to archive files whose contents are audited to a
70
81
  .IP "" 0
71
82
  .
72
83
  .SS "async_storeconfigs"
73
- Whether to use a queueing system to provide asynchronous database integration\. Requires that \fBpuppet queue\fR be running and that \'PSON\' support for ruby be installed\.
84
+ Whether to use a queueing system to provide asynchronous database integration\. Requires that \fBpuppet queue\fR be running\.
74
85
  .
75
86
  .IP "\(bu" 4
76
87
  \fIDefault\fR: false
77
88
  .
78
89
  .IP "" 0
79
90
  .
80
- .SS "authconfig"
81
- The configuration file that defines the rights to the different namespaces and methods\. This can be used as a coarse\-grained authorization system for both \fBpuppet agent\fR and \fBpuppet master\fR\.
82
- .
83
- .IP "\(bu" 4
84
- \fIDefault\fR: $confdir/namespaceauth\.conf
85
- .
86
- .IP "" 0
87
- .
88
91
  .SS "autoflush"
89
92
  Whether log files should always flush to disk\.
90
93
  .
@@ -102,7 +105,12 @@ Whether to enable autosign\. Valid values are true (which autosigns any key requ
102
105
  .IP "" 0
103
106
  .
104
107
  .SS "bindaddress"
105
- The address a listening server should bind to\. WEBrick defaults to 0\.0\.0\.0\.
108
+ The address a listening server should bind to\.
109
+ .
110
+ .IP "\(bu" 4
111
+ \fIDefault\fR: 0\.0\.0\.0
112
+ .
113
+ .IP "" 0
106
114
  .
107
115
  .SS "bucketdir"
108
116
  Where FileBucket files are stored\.
@@ -120,17 +128,6 @@ Whether the master should function as a certificate authority\.
120
128
  .
121
129
  .IP "" 0
122
130
  .
123
- .SS "ca_days"
124
- How long a certificate should be valid, in days\. This setting is deprecated; use \fBca_ttl\fR instead
125
- .
126
- .SS "ca_md"
127
- The type of hash used in certificates\.
128
- .
129
- .IP "\(bu" 4
130
- \fIDefault\fR: md5
131
- .
132
- .IP "" 0
133
- .
134
131
  .SS "ca_name"
135
132
  The name to use the Certificate Authority certificate\.
136
133
  .
@@ -156,7 +153,7 @@ The server to use for certificate authority requests\. It\'s a separate server b
156
153
  .IP "" 0
157
154
  .
158
155
  .SS "ca_ttl"
159
- The default TTL for new certificates; valid values must be an integer, optionally followed by one of the units \'y\' (years of 365 days), \'d\' (days), \'h\' (hours), or \'s\' (seconds)\. The unit defaults to seconds\. If this setting is set, ca_days is ignored\. Examples are \'3600\' (one hour) and \'1825d\', which is the same as \'5y\' (5 years)
156
+ The default TTL for new certificates\. If this setting is set, ca_days is ignored\. Can be specified as a duration\.
160
157
  .
161
158
  .IP "\(bu" 4
162
159
  \fIDefault\fR: 5y
@@ -218,6 +215,13 @@ The CA public key\.
218
215
  \fIDefault\fR: $cadir/ca_pub\.pem
219
216
  .
220
217
  .IP "" 0
218
+ .
219
+ .SS "catalog_cache_terminus"
220
+ How to store cached catalogs\. Valid values are \'json\' and \'yaml\'\. The agent application defaults to \'json\'\.
221
+ .
222
+ .TP
223
+ \fIDefault\fR:
224
+
221
225
  .
222
226
  .SS "catalog_format"
223
227
  (Deprecated for \'preferred_serialization_format\') What format to use to dump the catalog\. Only supports \'marshal\' and \'yaml\'\. Only matters on the client, since it asks the server for a specific format\.
@@ -249,6 +253,14 @@ The certificate directory\.
249
253
  .SS "certdnsnames"
250
254
  The \fBcertdnsnames\fR setting is no longer functional, after CVE\-2011\-3872\. We ignore the value completely\. For your own certificate request you can set \fBdns_alt_names\fR in the configuration and it will apply locally\. There is no configuration option to set DNS alt names, or any other \fBsubjectAltName\fR value, for another nodes certificate\. Alternately you can use the \fB\-\-dns_alt_names\fR command line option to set the labels added while generating your own CSR\.
251
255
  .
256
+ .SS "certificate_expire_warning"
257
+ The window of time leading up to a certificate\'s expiration that a notification will be logged\. This applies to CA, master, and agent certificates\. Can be specified as a duration\.
258
+ .
259
+ .IP "\(bu" 4
260
+ \fIDefault\fR: 60d
261
+ .
262
+ .IP "" 0
263
+ .
252
264
  .SS "certificate_revocation"
253
265
  Whether certificate revocation should be supported by downloading a Certificate Revocation List (CRL) to all clients\. If enabled, CA chaining will almost definitely not work\.
254
266
  .
@@ -261,7 +273,7 @@ Whether certificate revocation should be supported by downloading a Certificate
261
273
  The name to use when handling certificates\. Defaults to the fully qualified domain name\.
262
274
  .
263
275
  .IP "\(bu" 4
264
- \fIDefault\fR: wyclef\.puppetlabs\.lan
276
+ \fIDefault\fR: sirrus\.puppetlabs\.lan
265
277
  .
266
278
  .IP "" 0
267
279
  .
@@ -339,10 +351,10 @@ How to determine the configuration version\. By default, it will be the time tha
339
351
  Print the value of a specific configuration setting\. If the name of a setting is provided for this, then the value is printed and puppet exits\. Comma\-separate multiple values\. For a list of all values, specify \'all\'\.
340
352
  .
341
353
  .SS "configtimeout"
342
- How long the client should wait for the configuration to be retrieved before considering it a failure\. This can help reduce flapping if too many clients contact the server at one time\.
354
+ How long the client should wait for the configuration to be retrieved before considering it a failure\. This can help reduce flapping if too many clients contact the server at one time\. Can be specified as a duration\.
343
355
  .
344
356
  .IP "\(bu" 4
345
- \fIDefault\fR: 120
357
+ \fIDefault\fR: 2m
346
358
  .
347
359
  .IP "" 0
348
360
  .
@@ -494,16 +506,8 @@ Document all resources
494
506
  .
495
507
  .IP "" 0
496
508
  .
497
- .SS "downcasefacts"
498
- Whether facts should be made all lowercase when sent to the server\.
499
- .
500
- .IP "\(bu" 4
501
- \fIDefault\fR: false
502
- .
503
- .IP "" 0
504
- .
505
509
  .SS "dynamicfacts"
506
- Facts that are dynamic; these facts will be ignored when deciding whether changed facts should result in a recompile\. Multiple facts should be comma\-separated\.
510
+ (Deprecated) Facts that are dynamic; these facts will be ignored when deciding whether changed facts should result in a recompile\. Multiple facts should be comma\-separated\.
507
511
  .
508
512
  .IP "\(bu" 4
509
513
  \fIDefault\fR: memorysize,memoryfree,swapsize,swapfree
@@ -559,10 +563,10 @@ Where the fileserver configuration is stored\.
559
563
  .IP "" 0
560
564
  .
561
565
  .SS "filetimeout"
562
- The minimum time to wait (in seconds) between checking for updates in configuration files\. This timeout determines how quickly Puppet checks whether a file (such as manifests or templates) has changed on disk\.
566
+ The minimum time to wait between checking for updates in configuration files\. This timeout determines how quickly Puppet checks whether a file (such as manifests or templates) has changed on disk\. Can be specified as a duration\.
563
567
  .
564
568
  .IP "\(bu" 4
565
- \fIDefault\fR: 15
569
+ \fIDefault\fR: 15s
566
570
  .
567
571
  .IP "" 0
568
572
  .
@@ -785,14 +789,6 @@ The LDAP attributes to use to define Puppet classes\. Values should be comma\-se
785
789
  .
786
790
  .IP "" 0
787
791
  .
788
- .SS "ldapnodes"
789
- Whether to search for node configurations in LDAP\. See http://projects\.puppetlabs\.com/projects/puppet/wiki/LDAP_Nodes for more information\.
790
- .
791
- .IP "\(bu" 4
792
- \fIDefault\fR: false
793
- .
794
- .IP "" 0
795
- .
796
792
  .SS "ldapparentattr"
797
793
  The attribute to use to define the parent node\.
798
794
  .
@@ -805,7 +801,7 @@ The attribute to use to define the parent node\.
805
801
  The password to use to connect to LDAP\.
806
802
  .
807
803
  .SS "ldapport"
808
- The LDAP port\. Only used if \fBldapnodes\fR is enabled\.
804
+ The LDAP port\. Only used if \fBnode_terminus\fR is set to \fBldap\fR\.
809
805
  .
810
806
  .IP "\(bu" 4
811
807
  \fIDefault\fR: 389
@@ -813,7 +809,7 @@ The LDAP port\. Only used if \fBldapnodes\fR is enabled\.
813
809
  .IP "" 0
814
810
  .
815
811
  .SS "ldapserver"
816
- The LDAP server\. Only used if \fBldapnodes\fR is enabled\.
812
+ The LDAP server\. Only used if \fBnode_terminus\fR is set to \fBldap\fR\.
817
813
  .
818
814
  .IP "\(bu" 4
819
815
  \fIDefault\fR: ldap
@@ -855,14 +851,6 @@ Whether TLS should be used when searching for nodes\. Defaults to false because
855
851
  .SS "ldapuser"
856
852
  The user to use to connect to LDAP\. Must be specified as a full DN\.
857
853
  .
858
- .SS "lexical"
859
- Whether to use lexical scoping (vs\. dynamic)\.
860
- .
861
- .IP "\(bu" 4
862
- \fIDefault\fR: false
863
- .
864
- .IP "" 0
865
- .
866
854
  .SS "libdir"
867
855
  An extra search path for Puppet\. This is only useful for those files that Puppet will load on demand, and is only guaranteed to work for those cases\. In fact, the autoload mechanism is responsible for making sure this directory is in Ruby\'s search path
868
856
  .
@@ -970,7 +958,7 @@ Whether to create the necessary user and group that puppet agent will run as\.
970
958
  The module repository
971
959
  .
972
960
  .IP "\(bu" 4
973
- \fIDefault\fR: http://forge\.puppetlabs\.com
961
+ \fIDefault\fR: https://forge\.puppetlabs\.com
974
962
  .
975
963
  .IP "" 0
976
964
  .
@@ -996,6 +984,13 @@ The name of the application, if we are running as one\. The default is essential
996
984
  .TP
997
985
  \fIDefault\fR:
998
986
 
987
+ .
988
+ .SS "node_cache_terminus"
989
+ How to store cached nodes\. Valid values are (none), \'json\', \'yaml\' or write only yaml (\'write_only_yaml\')\. The master application defaults to \'write_only_yaml\', all others to none\.
990
+ .
991
+ .TP
992
+ \fIDefault\fR:
993
+
999
994
  .
1000
995
  .SS "node_name"
1001
996
  How the puppet master determines the client\'s identity and sets the \'hostname\', \'fqdn\' and \'domain\' facts for use in the manifest, in particular for determining which \'node\' statement applies to the client\. Possible values are \'cert\' (use the subject\'s CN in the client\'s certificate) and \'facter\' (use the hostname that the client reported in its facts)
@@ -1057,7 +1052,7 @@ The shell search path\. Defaults to whatever is inherited from the parent proces
1057
1052
  .IP "" 0
1058
1053
  .
1059
1054
  .SS "pidfile"
1060
- The pid file
1055
+ The file containing the PID of a running process\. This file is intended to be used by service management frameworks and monitoring systems to determine if a puppet process is still in the process table\.
1061
1056
  .
1062
1057
  .IP "\(bu" 4
1063
1058
  \fIDefault\fR: $rundir/${run_mode}\.pid
@@ -1218,7 +1213,7 @@ The directory in which to store reports received from the client\. Each client g
1218
1213
  The \'from\' email address for the reports\.
1219
1214
  .
1220
1215
  .IP "\(bu" 4
1221
- \fIDefault\fR: report@wyclef\.puppetlabs\.lan
1216
+ \fIDefault\fR: report@sirrus\.puppetlabs\.lan
1222
1217
  .
1223
1218
  .IP "" 0
1224
1219
  .
@@ -1230,14 +1225,6 @@ The list of reports to generate\. All reports are looked for in \fBpuppet/report
1230
1225
  .
1231
1226
  .IP "" 0
1232
1227
  .
1233
- .SS "reportserver"
1234
- (Deprecated for \'report_server\') The server to which to send transaction reports\.
1235
- .
1236
- .IP "\(bu" 4
1237
- \fIDefault\fR: $server
1238
- .
1239
- .IP "" 0
1240
- .
1241
1228
  .SS "reporturl"
1242
1229
  The URL used by the http reports processor to send reports
1243
1230
  .
@@ -1295,19 +1282,12 @@ The directory where RRD database files are stored\. Directories for each reporti
1295
1282
  .IP "" 0
1296
1283
  .
1297
1284
  .SS "rrdinterval"
1298
- How often RRD should expect data\. This should match how often the hosts report back to the server\.
1285
+ How often RRD should expect data\. This should match how often the hosts report back to the server\. Can be specified as a duration\.
1299
1286
  .
1300
1287
  .IP "\(bu" 4
1301
1288
  \fIDefault\fR: $runinterval
1302
1289
  .
1303
1290
  .IP "" 0
1304
- .
1305
- .SS "run_mode"
1306
- The effective \'run mode\' of the application: master, agent, or user\.
1307
- .
1308
- .TP
1309
- \fIDefault\fR:
1310
-
1311
1291
  .
1312
1292
  .SS "rundir"
1313
1293
  Where Puppet PID files are kept\.
@@ -1317,10 +1297,10 @@ Where Puppet PID files are kept\.
1317
1297
 
1318
1298
  .
1319
1299
  .SS "runinterval"
1320
- How often puppet agent applies the client configuration; in seconds\. Note that a runinterval of 0 means "run continuously" rather than "never run\." If you want puppet agent to never run, you should start it with the \fB\-\-no\-client\fR option\.
1300
+ How often puppet agent applies the client configuration; in seconds\. Note that a runinterval of 0 means "run continuously" rather than "never run\." If you want puppet agent to never run, you should start it with the \fB\-\-no\-client\fR option\. Can be specified as a duration\.
1321
1301
  .
1322
1302
  .IP "\(bu" 4
1323
- \fIDefault\fR: 1800
1303
+ \fIDefault\fR: 30m
1324
1304
  .
1325
1305
  .IP "" 0
1326
1306
  .
@@ -1356,14 +1336,6 @@ The directory in which serialized data is stored, usually in a subdirectory\.
1356
1336
  .
1357
1337
  .IP "" 0
1358
1338
  .
1359
- .SS "servertype"
1360
- The type of server to use\. Currently supported option is webrick\.
1361
- .
1362
- .IP "\(bu" 4
1363
- \fIDefault\fR: webrick
1364
- .
1365
- .IP "" 0
1366
- .
1367
1339
  .SS "show_diff"
1368
1340
  Whether to log and report a contextual diff when files are being replaced\. This causes partial file contents to pass through Puppet\'s normal logging and reporting system, so this setting should be used with caution if you are sending Puppet\'s reports to an insecure destination\. This feature currently requires the \fBdiff/lcs\fR Ruby library\.
1369
1341
  .
@@ -1397,7 +1369,7 @@ Whether to sleep for a pseudo\-random (but consistent) amount of time before a r
1397
1369
  .IP "" 0
1398
1370
  .
1399
1371
  .SS "splaylimit"
1400
- The maximum time to delay before runs\. Defaults to being the same as the run interval\.
1372
+ The maximum time to delay before runs\. Defaults to being the same as the run interval\. Can be specified as a duration\.
1401
1373
  .
1402
1374
  .IP "\(bu" 4
1403
1375
  \fIDefault\fR: $runinterval
@@ -1411,6 +1383,13 @@ The domain which will be queried to find the SRV records of servers to use\.
1411
1383
  \fIDefault\fR: puppetlabs\.lan
1412
1384
  .
1413
1385
  .IP "" 0
1386
+ .
1387
+ .SS "ssl_client_ca_auth"
1388
+ Certificate authorities who issue server certificates\. SSL servers will not be considered authentic unless they posses a certificate issued by an authority listed in this file\. If this setting has no value then the Puppet master\'s CA certificate (localcacert) will be used\.
1389
+ .
1390
+ .TP
1391
+ \fIDefault\fR:
1392
+
1414
1393
  .
1415
1394
  .SS "ssl_client_header"
1416
1395
  The header containing an authenticated client\'s SSL DN\. This header must be set by the proxy to the authenticated client\'s SSL DN (e\.g\., \fB/CN=puppet\.puppetlabs\.com\fR)\.
@@ -1427,6 +1406,13 @@ The header containing the status message of the client verification\. This heade
1427
1406
  \fIDefault\fR: HTTP_X_CLIENT_VERIFY
1428
1407
  .
1429
1408
  .IP "" 0
1409
+ .
1410
+ .SS "ssl_server_ca_auth"
1411
+ Certificate authorities who issue client certificates\. SSL clients will not be considered authentic unless they posses a certificate issued by an authority listed in this file\. If this setting has no value then the Puppet master\'s CA certificate (localcacert) will be used\.
1412
+ .
1413
+ .TP
1414
+ \fIDefault\fR:
1415
+
1430
1416
  .
1431
1417
  .SS "ssldir"
1432
1418
  Where SSL certificates are kept\.
@@ -1512,7 +1498,7 @@ Where Puppet looks for template files\. Can be a list of colon\-separated direct
1512
1498
  .IP "" 0
1513
1499
  .
1514
1500
  .SS "thin_storeconfigs"
1515
- Boolean; whether storeconfigs store in the database only the facts and exported resources\. If true, then storeconfigs performance will be higher and still allow exported/collected resources, but other usage external to Puppet might not work
1501
+ Boolean; whether Puppet should store only facts and exported resources in the storeconfigs database\. This will improve the performance of exported resources with the older \fBactive_record\fR backend, but will disable external tools that search the storeconfigs database\. Thinning catalogs is generally unnecessary when using PuppetDB to store catalogs\.
1516
1502
  .
1517
1503
  .IP "\(bu" 4
1518
1504
  \fIDefault\fR: false
@@ -1568,10 +1554,10 @@ Where Puppet stores dynamic and growing data\. The default for this setting is c
1568
1554
  .IP "" 0
1569
1555
  .
1570
1556
  .SS "waitforcert"
1571
- The time interval, specified in seconds, \'puppet agent\' should connect to the server and ask it to sign a certificate request\. This is useful for the initial setup of a puppet client\. You can turn off waiting for certificates by specifying a time of 0\.
1557
+ The time interval \'puppet agent\' should connect to the server and ask it to sign a certificate request\. This is useful for the initial setup of a puppet client\. You can turn off waiting for certificates by specifying a time of 0\. Can be specified as a duration\.
1572
1558
  .
1573
1559
  .IP "\(bu" 4
1574
- \fIDefault\fR: 120
1560
+ \fIDefault\fR: 2m
1575
1561
  .
1576
1562
  .IP "" 0
1577
1563
  .
@@ -1592,4 +1578,4 @@ Boolean; whether to use the zlib library
1592
1578
  .IP "" 0
1593
1579
  .
1594
1580
  .P
1595
- \fIThis page autogenerated on Thu May 17 14:19:16 \-0700 2012\fR
1581
+ \fIThis page autogenerated on Tue Jan 15 12:33:09 \-0800 2013\fR