Installing Puppet under OS X 10.6

(Make sure you are running at least 10.6.1)

First, download and install the Facter and Puppet packages from the DMG files at puppet.org.

The config file is /etc/puppet/puppet.conf - it is used for both puppetmasterd and the client puppetd.

It has three sections [main] used for config options used by all puppet software, [puppetd] used to configure the client and [puppetmasterd] used for the server.

I use a non-standard name for the server and also a name that is an alias of the definitive name for the box. So that this works properly we need to tell puppetmasterd what name to use for it's security certificates. Add a line to the [puppetmasterd] section 'certname = mpuppet.example.com'

So that the client can find the server add the line 'server = mpuppet.example.com' to the [puppetd] section.

So that we can magically shift the config file onto a client let's make that our first manifest. They go in /etc/puppet/manifests and this one should be called “site.pp”

# make sure we have the puppet config file
file { "/etc/puppet.puppet.conf":
    type => 'file',
    ensure => 'file',
    owner => 'root',
    group => 'wheel',
    mode => 644,
    content => '
[main]
server = mpuppet.newcastle.edu.au
 
[puppetd]
 
[puppetmasterd]
certname = mpuppet.newcastle.edu.au
 
'
}

Note that you should be root or use sudo to run all these commands.

On our server we need to run puppetmasterd. Since I have yet to discover a way of specifying verbose in the config file the line we need is “puppetmasterd –verbose”.

To run the client for the first time

puppetd –server mpuppet.example.com –verbose –waitforcert 30

Once you have done that go to the server and run

puppetca –list –all

then when you have the client listed as asking for a cert

puppetca –grant –all

Now when you open Console on both machines you should see them reporting success. Oh, even on verbose puppetd might say very little, though if it does an operation it will report it.

Once you have the puppet.conf file in place from our first manifest then just

puppetd –verbose

is all you need to run puppetd on a client.