puppet 0.24.4 → 0.24.5

data/man/man8/puppetrun.8

@@ -0,0 +1,151 @@
+.TH   "" "" ""
+.SH NAME
+ \- 
+
+.\" Man page generated from reStructeredText.
+
+.SH SYNOPSIS
+Trigger a puppetd run on a set of hosts.
+
+
+.SH USAGE
+
+.\" visit_block_quote
+
+.TP
+.B puppetrun [\-a|\-\-all] [\-c|\-\-class <class>] [\-d|\-\-debug] [\-f|\-\-foreground]
+[\-h|\-\-help] [\-\-host <host>] [\-\-no\-fqdn] [\-\-ignoreschedules]
+[\-t|\-\-tag <tag>] [\-\-test]
+
+
+.\" depart_block_quote
+
+.SH DESCRIPTION
+This script can be used to connect to a set of machines running
++puppetd+ and trigger them to run their configurations. The most common
+usage would be to specify a class of hosts and a set of tags, and
++puppetrun+ would look up in LDAP all of the hosts matching that class,
+then connect to each host and trigger a run of all of the objects with
+the specified tags.
+
+If you are not storing your host configurations in LDAP, you can specify
+hosts manually.
+
+You will most likely have to run +puppetrun+ as root to get access to
+the SSL certificates.
+
++puppetrun+ reads +puppetmaster+\'s configuration file, so that it can
+copy things like LDAP settings.
+
+
+.SH USAGE NOTES
++puppetrun+ is useless unless +puppetd+ is listening. See its
+documentation for more information, but the gist is that you must enable
++listen+ on the +puppetd+ daemon, either using +\-\-listen+ on the command
+line or adding \'listen: true\' in its config file. In addition, you need
+to set the daemons up to specifically allow connections by creating the
++namespaceauth+ file, normally at \'/etc/puppet/namespaceauth.conf\'. This
+file specifies who has access to each namespace; if you create the file
+you must add every namespace you want any Puppet daemon to allow \-\- it
+is currently global to all Puppet daemons.
+
+An example file looks like this:
+
+
+.nf
+[fileserver]
+    allow *.madstop.com
+
+[puppetmaster]
+    allow *.madstop.com
+
+[puppetrunner]
+    allow culain.madstop.com
+.fi
+This is what you would install on your Puppet master; non\-master hosts
+could leave off the \'fileserver\' and \'puppetmaster\' namespaces.
+
+Expect more documentation on this eventually.
+
+
+.SH OPTIONS
+Note that any configuration parameter that\'s valid in the configuration
+file is also a valid long argument. For example, \'ssldir\' is a valid
+configuration parameter, so you can specify \'\-\-ssldir <directory>\' as an
+argument.
+
+See the configuration file documentation at
+http://reductivelabs.com/projects/puppet/reference/configref.html for
+the full list of acceptable parameters. A commented list of all
+configuration options can also be generated by running puppetmasterdd
+with \'\-\-genconfig\'.
+
+
+.TP
+.B all:             Connect to all available hosts. Requires LDAP support
+at this point.
+
+
+.TP
+.B class:           Specify a class of machines to which to connect. This
+only works if you have LDAP configured, at the moment.
+
+debug:           Enable full debugging.
+
+
+.TP
+.B foreground:      Run each configuration in the foreground; that is, when
+connecting to a host, do not return until the host has
+finished its run. The default is false.
+
+help:            Print this help message
+
+
+.TP
+.B host:            A specific host to which to connect. This flag can be
+specified more than once.
+
+
+.TP
+.B ignoreschedules: Whether the client should ignore schedules when running
+its configuration. This can be used to force the client
+to perform work it would not normally perform so soon.
+The default is false.
+
+
+.TP
+.B parallel:        How parallel to make the connections. Parallelization
+is provided by forking for each client to which to
+connect. The default is 1, meaning serial execution.
+
+
+.TP
+.B tag:             Specify a tag for selecting the objects to apply. Does
+not work with the \-\-test option.
+
+
+.TP
+.B test:            Print the hosts you would connect to but do not
+actually connect. This option requires LDAP support at
+this point.
+
+
+.SH EXAMPLE
+
+.\" visit_block_quote
+sudo puppetrun \-p 10 \-\-host host1 \-\-host host2 \-t remotefile \-t webserver
+
+
+.\" depart_block_quote
+
+.SH AUTHOR
+Luke Kanies
+
+
+.SH COPYRIGHT
+Copyright (c) 2005 Reductive Labs, LLC Licensed under the GNU Public
+License
+
+
+.\" Generated by docutils manpage writer on 2008-05-05 09:33.
+.\" 

data/man/man8/ralsh.8

@@ -0,0 +1,135 @@
+.TH   "" "" ""
+.SH NAME
+ \- 
+
+.\" Man page generated from reStructeredText.
+vim: softtabstop=4 shiftwidth=4 expandtab
+
+
+.SH SYNOPSIS
+Use the Puppet RAL to directly interact with the system.
+
+
+.SH USAGE
+
+.\" visit_block_quote
+
+.TP
+.B ralsh [\-h|\-\-help] [\-d|\-\-debug] [\-v|\-\-verbose] [\-e|\-\-edit] [\-H|\-\-host <host>]
+[\-p|\-\-param <param>] [\-t|\-\-types] type <name>
+
+
+.\" depart_block_quote
+
+.SH DESCRIPTION
+This command provides simple facilities for converting current system
+state into Puppet code, along with some ability to use Puppet to affect
+the current state.
+
+By default, you must at least provide a type to list, which case ralsh
+will tell you everything it knows about all instances of that type. You
+can optionally specify an instance name, and ralsh will only describe
+that single instance.
+
+You can also add +\-\-edit+ as an argument, and ralsh will write its
+output to a file, open that file in an editor, and then apply the file
+as a Puppet transaction. You can easily use this to use Puppet to make
+simple changes to a system.
+
+
+.SH OPTIONS
+Note that any configuration parameter that\'s valid in the configuration
+file is also a valid long argument. For example, \'ssldir\' is a valid
+configuration parameter, so you can specify \'\-\-ssldir <directory>\' as an
+argument.
+
+See the configuration file documentation at
+http://reductivelabs.com/projects/puppet/reference/configref.html for
+the full list of acceptable parameters. A commented list of all
+configuration options can also be generated by running puppet with
+\'\-\-genconfig\'.
+
+debug: Enable full debugging.
+
+edit:
+
+
+.\" visit_block_quote
+Write the results of the query to a file, open the file in an editor,
+and read the file back in as an executable Puppet manifest.
+
+
+.\" depart_block_quote
+host:
+
+
+.\" visit_block_quote
+When specified, connect to the resource server on the named host
+and retrieve the list of resouces of the type specified.
+
+
+.\" depart_block_quote
+help:
+
+
+.\" visit_block_quote
+Print this help message.
+
+
+.\" depart_block_quote
+param:
+
+
+.\" visit_block_quote
+Add more parameters to be outputted from queries.
+
+
+.\" depart_block_quote
+types:
+
+
+.\" visit_block_quote
+List all available types.
+
+
+.\" depart_block_quote
+verbose: Print extra information.
+
+
+.SH EXAMPLE
+This example uses 
+.\" visit_literal
+ralsh
+.\" depart_literal
+ to return Puppet configuration for the user
+
+.\" visit_literal
+luke
+.\" depart_literal
+:
+
+
+.nf
+$ ralsh user luke
+user { \'luke\':
+  home => \'/home/luke\',
+  uid => \'100\',
+  ensure => \'present\',
+  comment => \'Luke Kanies,,,\',
+  gid => \'1000\',
+  shell => \'/bin/bash\',
+  groups => [\'sysadmin\',\'audio\',\'video\',\'puppet\']
+}
+.fi
+
+.SH AUTHOR
+Luke Kanies
+
+
+.SH COPYRIGHT
+Copyright (c) 2005\-2007 Reductive Labs, LLC Licensed under the GNU
+Public License
+
+
+.\" Generated by docutils manpage writer on 2008-05-05 09:33.
+.\" 

data/test/README

@@ -0,0 +1,24 @@
+$Id$
+
+To run all tests, run: 'rake test'.  To run an individual suite, run the file
+directly.  e.g. cd test/util; ./utiltest.rb
+
+You might need to run some tests as root.
+
+If you do not have rake installed:
+  gem install rake
+
+## The following information is possibly out of date?
+
+Tests are organized into a dual hierarchy: each subdirectory is
+considered a test suite, and each file in the subdirectory is considered
+a test case.  You can use any test case as an example of how to write
+more of them, but basically the only requirements are that they each have
+their own class names, their names each match /tc_.+\.r/, and that they have
+the following header:
+
+if __FILE__ == $0
+    $:.unshift '..'
+    $:.unshift '../../lib'
+    $blinkbase = "../.."
+end

data/test/certmgr/support.rb

@@ -78,5 +78,32 @@ class TestCertSupport < Test::Unit::TestCase
             @user.ca_cert
         end
     end
-end
 
+    # Fixing #1382.  This test will always fail on Darwin, because its
+    # FS is case-insensitive.
+    unless Facter.value(:operatingsystem) == "Darwin"
+        def test_uppercase_files_are_renamed_and_read
+            # Write a key out to disk in a file containing upper-case.
+            key = OpenSSL::PKey::RSA.new(32)
+            should_path = Puppet[:hostprivkey]
+            puts "%s: %s" % [should_path, FileTest.exist?(should_path).inspect]
+
+            dir, file = File.split(should_path)
+            newfile = file.sub(/^([a-z.]+)\./) { $1.upcase + "."}
+            puts "%s: %s" % [should_path, FileTest.exist?(should_path).inspect]
+            upper_path = File.join(dir, newfile)
+            puts "%s: %s" % [should_path, FileTest.exist?(should_path).inspect]
+            puts "%s: %s" % [upper_path, FileTest.exist?(upper_path).inspect]
+            File.open(upper_path, "w") { |f| f.print key.to_s }
+            puts "%s: %s" % [should_path, FileTest.exist?(should_path).inspect]
+            puts "%s: %s" % [upper_path, FileTest.exist?(upper_path).inspect]
+
+            user = CertUser.new
+
+            assert_equal(key.to_s, user.read_key.to_s, "Did not read key in from disk")
+            assert(! FileTest.exist?(upper_path), "Upper case file was not removed")
+            assert(FileTest.exist?(should_path), "File was not renamed to lower-case file")
+            assert_equal(key.to_s, user.read_key.to_s, "Did not read key in from disk")
+        end
+    end
+end

data/test/data/failers/badclassnoparam

@@ -0,0 +1,10 @@
+class comp() {
+    file { "/etc/passwd":
+        mode => 644
+    }
+}
+
+# this argument is invalid, thus we should get a falure
+comp {
+    fakearg => "yay"
+}

data/test/data/failers/badclassparam

@@ -0,0 +1,10 @@
+class comp(arg1) {
+    file { "/etc/passwd":
+        mode => 644
+    }
+}
+
+# i've specified an arg but it's an invalid one
+comp {
+    fakearg => "yay"
+}

data/test/data/failers/badcompnoparam

@@ -0,0 +1,9 @@
+define comp() {
+    file { "/etc/passwd":
+        mode => 644
+    }
+}
+
+comp {
+    fakearg => "yay"
+}

data/test/data/failers/badcompparam

@@ -0,0 +1,9 @@
+define comp($arg1) {
+    file { "/etc/passwd":
+        mode => 644
+    }
+}
+
+comp {
+    fakearg => "yay"
+}

data/test/data/failers/badtypeparam

@@ -0,0 +1,3 @@
+file { "/etc/passwd":
+    fakeparam => 644
+}

data/test/data/failers/noobjectrvalue

@@ -0,0 +1 @@
+$variable = file { "/etc/passwd": owner => root }

data/test/data/providers/cron/crontab.allthree

@@ -0,0 +1,17 @@
+--- 
+- |
+  # comment 1
+  # Puppet Name: name2
+  env3=val
+  * * * * * command4
+  # comment 5
+
+- - :record_type: :comment
+    :line: "# comment 1"
+  - :command: command4
+    :environment: 
+    - env3=val
+    :name: name2
+    :record_type: :crontab
+  - :record_type: :comment
+    :line: "# comment 5"

data/test/data/providers/cron/crontab.envNcomment

@@ -0,0 +1,12 @@
+--- 
+- |
+  # comment 9
+  env10=val
+  * * * * * command11
+
+- - :record_type: :comment
+    :line: "# comment 9"
+  - :record_type: :environment
+    :line: env10=val
+  - :command: command11
+    :record_type: :crontab

data/test/data/providers/cron/crontab.envNname

@@ -0,0 +1,11 @@
+--- 
+- |
+  env6=val
+  # Puppet Name: name7
+  * * * * * command8
+
+- - :record_type: :environment
+    :line: env6=val
+  - :command: command8
+    :record_type: :crontab
+    :name: name7

data/test/data/providers/cron/crontab.multirecords

@@ -0,0 +1,12 @@
+--- 
+- |
+  # comment 9
+  env10=val
+  * * * * * command11
+
+- - :record_type: :comment
+    :line: "# comment 9"
+  - :record_type: :environment
+    :line: env10=val
+  - :command: command11
+    :record_type: :crontab