Mac OS X agents provide consistent automated management of Apple laptops and desktops from the same Puppet Enterprise infrastructure that manages your servers.
Capabilities include PE core functionality, plus OS X-specific capabilities:
Mac OS X agents can be installed with PE package management, from Finder, or from the command line.
See the system requirements for which Mac OS X versions PE supports.
Refer to Puppet Enterprise binaries and symlinks for information about the binaries and symlinks PE sets. You can also find instructions on disabling the symlinks.
Before you begin, download the OS X PE agent package and transfer it to the machine you’re installing the agent on.
Before you install a Puppet agent on your OS X machine, you need to ensure the name of your machine uses lowercase letters.
In PE, agent certnames need to be lowercase. For Mac OS X agents, the certname is derived from the name of the machine (e.g., My-Example-Mac). To prevent installation issues, you need to make sure the name of your machine uses lowercases letters.
Note: If you don’t want to change your computer’s name, you can also enter the agent certname in all lowercase letters when prompted by the installer.
To change the name to use lowercase letters, choose one of the following:
In System Preferences, select Sharing > Computer Name > Edit.
From the command line, run the following commands:
sudo scutil --set ComputerName <new machine name>
sudo scutil --set LocalHostName <new machine name>
sudo scutil --set HostName <new machine name>
PE provides its own package management to help you install Puppet agents in your PE infrastructure.
To install a Mac OS X agent using PE package management, refer to Installing Puppet agents with PE package management.
You can use Finder to install the agent on your Mac OS X machine.
Follow the instructions in the installer dialog. You will need to include the Puppet master’s hostname and the agent’s certname.
Tip: You can get the Puppet master’s hostname with
puppet cert list --all.
The installer generates a certificate signing request you must sign.
You can use the command line to install the agent on your Mac OS X machine.
sudo hdiutil mount <DMGFILE>.
You should see a line that ends,
/Volumes/puppet-agent-VERSION. This is the mount point for the virtual volume created from the disk image.
sudo installer -pkg puppet-agent-installer.pkg -target /.
To verify the install, run
PATH=/opt/puppetlabs/bin:$PATH;export PATHto add the PE binaries to your path.
sudo puppet agent -t. This generates a certificate signing request you must sign.