puppet 2.7.19 → 2.7.20.rc1

data/ext/debian/puppetmaster.install

@@ -0,0 +1 @@
+debian/tmp/usr/sbin/puppetmasterd usr/sbin

data/ext/debian/puppetmaster.lintian-overrides

@@ -0,0 +1,3 @@
+# Man pages are automatically generated, not much to do here
+puppetmaster binary: manpage-has-bad-whatis-entry
+puppetmaster binary: manpage-has-errors-from-man

data/ext/debian/puppetmaster.manpages

@@ -0,0 +1 @@
+man/man8/puppetmasterd.8

data/ext/debian/puppetmaster.postinst

@@ -0,0 +1,20 @@
+#!/bin/sh
+
+set -e
+
+# Remove renamed configuration files which are now handled by other
+# packages
+if dpkg-maintscript-helper supports rm_conffile 2>/dev/null; then
+
+    dpkg-maintscript-helper rm_conffile \
+        /etc/logrotate.d/puppetmaster 2.7.16-1puppetlabs1 puppetmaster -- "$@"
+
+# For systems with dpkg < 1.15.7-2
+else
+
+    if [ -f /etc/logrotate.d/puppetmaster ]; then
+        rm /etc/logrotate.d/puppetmaster || true
+    fi
+fi
+
+#DEBHELPER#

data/ext/debian/puppetmaster.postrm

@@ -0,0 +1,5 @@
+#!/bin/sh -e
+
+#DEBHELPER#
+
+exit 0

data/ext/debian/puppetmaster.preinst

@@ -0,0 +1,22 @@
+#!/bin/sh
+
+set -e
+
+# Remove renamed configuration files which are now handled by other
+# packages
+if dpkg-maintscript-helper supports rm_conffile 2>/dev/null; then
+
+    dpkg-maintscript-helper rm_conffile \
+        /etc/logrotate.d/puppetmaster 2.7.16-1puppetlabs1 puppetmaster -- "$@"
+
+
+# For systems with dpkg < 1.15.7-2
+else
+
+    if [ -f /etc/logrotate.d/puppetmaster ]; then
+        rm /etc/logrotate.d/puppetmaster || true
+    fi
+fi
+
+
+#DEBHELPER#

data/ext/debian/rules

@@ -0,0 +1,127 @@
+#!/usr/bin/make -f
+# -*- makefile -*-
+
+# Uncomment this to turn on verbose mode.
+#export DH_VERBOSE=1
+
+INSTALL=install -Dp
+
+prefix := $(CURDIR)/debian/tmp
+bindir := $(prefix)/usr/bin
+sbindir := $(prefix)/usr/sbin
+libdir := $(prefix)/usr/lib
+localstatedir := $(prefix)/var
+rubylibdir := $(libdir)/ruby/1.8
+sysconfdir := $(prefix)/etc
+pkgconfdir := $(sysconfdir)/puppet
+
+ifneq (,$(findstring noopt,$(DEB_BUILD_OPTIONS)))
+	CFLAGS += -O0
+else
+	CFLAGS += -O2
+endif
+
+configure: configure-stamp
+configure-stamp:
+	dh_testdir
+	touch configure-stamp
+
+
+build-arch: build
+build-indep: build
+
+build: build-stamp
+build-stamp: configure-stamp
+	dh_testdir
+	touch build-stamp
+
+clean:
+	dh_testdir
+	dh_testroot
+	rm -f build-stamp configure-stamp
+	rm -f debian/puppet-common.logcheck.ignore.server
+	dh_clean
+
+install: build
+	dh_testdir
+	dh_testroot
+	dh_clean -k
+	dh_installdirs
+
+	# Note sbindir does nothing right now. Leaving in for future
+	# puppet versions where it is respected.
+	$(CURDIR)/install.rb --destdir=debian/tmp --bindir=/usr/bin \
+          --sbindir=/usr/sbin --sitelibdir=/usr/lib/ruby/1.8
+
+	# strip executable bit from all the non-executable files.
+	find debian/tmp/usr/lib/ruby/1.8 -type f -perm /u+x,g+x,o+x -exec chmod a-x {} \;
+	# fix the permissions on all of the directories
+	find debian/tmp/usr/lib/ruby/1.8 -type d -exec chmod 755 {} \;
+
+	# Vim auto-syntax-highlighting stuff
+	$(INSTALL) -m0644 ext/vim/syntax/puppet.vim				\
+		$(CURDIR)/debian/vim-puppet/usr/share/vim/addons/syntax/
+	$(INSTALL) -m0644 ext/vim/ftdetect/puppet.vim				\
+		$(CURDIR)/debian/vim-puppet/usr/share/vim/addons/ftdetect/
+	$(INSTALL) -m0644 debian/vim-puppet.yaml				\
+		$(CURDIR)/debian/vim-puppet/usr/share/vim/registry/
+
+	# Emacs mode
+	$(INSTALL) -m0644 ext/emacs/puppet-mode.el			\
+		$(CURDIR)/debian/puppet-el/usr/share/emacs/site-lisp/puppet-mode.el
+
+	# Install the rack README as README.rack
+	$(INSTALL) -m0644 ext/rack/README \
+		$(CURDIR)/debian/puppetmaster-passenger/usr/share/doc/puppetmaster-passenger/README.rack
+	# Install the config.ru
+	$(INSTALL) -m0644 ext/rack/files/config.ru \
+		$(CURDIR)/debian/puppetmaster-passenger/usr/share/puppet/rack/puppetmasterd
+	# Install apache2 site configuration template
+	$(INSTALL) -m0644 ext/rack/files/apache2.conf \
+		$(CURDIR)/debian/puppetmaster-passenger/usr/share/puppetmaster-passenger/apache2.site.conf.tmpl
+
+	# Add ext directory
+	cp -pr ext $(CURDIR)/debian/puppet-common/usr/share/puppet
+	# Remove misc packaging artifacts
+	rm -rf $(CURDIR)/debian/puppet-common/usr/share/puppet/ext/redhat
+	rm -rf $(CURDIR)/debian/puppet-common/usr/share/puppet/ext/osx
+	rm -rf $(CURDIR)/debian/puppet-common/usr/share/puppet/ext/project_data.yaml
+	rm -rf $(CURDIR)/debian/puppet-common/usr/share/puppet/ext/build_defaults.yaml
+
+	dh_installexamples -p puppet-common examples/*
+
+	$(INSTALL) -d -m0775 $(pkgconfdir)/templates
+	$(INSTALL) -d -m0775 $(pkgconfdir)/modules
+
+	# Logcheck rules.  Gee I wish you could specify a file to source
+	# in dh_installlogcheck.
+	ln ext/logcheck/puppet debian/puppet-common.logcheck.ignore.server
+
+# Build architecture-dependent files here.
+binary-arch: build install
+
+# Build architecture-independent files here.
+binary-indep: build install
+	dh_testdir
+	dh_testroot
+	dh_install -i
+	dh_installchangelogs -i CHANGELOG
+	dh_installdocs -i
+	dh_installemacsen
+	dh_installlogcheck
+	dh_installman
+	dh_installinit -ppuppetmaster
+	dh_installinit --name=puppetqd
+	dh_installinit -ppuppet --error-handler=true -- defaults 21
+	dh_installlogrotate -i
+	dh_lintian -i
+	dh_compress -i
+	dh_fixperms -i
+	dh_installdeb -i
+	dh_shlibdeps -i
+	dh_gencontrol -i
+	dh_md5sums -i
+	dh_builddeb -i
+
+binary: binary-indep binary-arch
+.PHONY: build clean binary-indep binary-arch binary install configure

data/ext/debian/source/format

@@ -0,0 +1 @@
+3.0 (quilt)

data/ext/debian/source/options

@@ -0,0 +1 @@
+single-debian-patch

data/ext/debian/vim-puppet.README.Debian

@@ -0,0 +1,13 @@
+Dear user, this package provides the vim addon puppet, but it is not enabled
+per default.
+
+If you want to enable it for your user account just execute
+
+	vim-addons install puppet
+
+Similarly, to enable it for all users of this system just execute (as root):
+
+	vim-addons -w install puppet
+
+vim-addons is provided by the vim-addon-manager package, have a look at its
+manpage for more information.

data/ext/debian/vim-puppet.dirs

@@ -0,0 +1,3 @@
+usr/share/vim/registry
+usr/share/vim/addons/syntax
+usr/share/vim/addons/ftdetect

data/ext/debian/vim-puppet.yaml

@@ -0,0 +1,5 @@
+addon: puppet
+description: "Syntax highlighting for puppet"
+files:
+  - ftdetect/puppet.vim
+  - syntax/puppet.vim

data/ext/debian/watch

@@ -0,0 +1,2 @@
+version=3
+http://pkg-ruby-extras.alioth.debian.org/cgi-bin/gemwatch/puppet .*/puppet-(.*).tar.gz

data/ext/emacs/puppet-mode.el

@@ -333,6 +333,7 @@ The variable puppet-indent-level controls the amount of indentation.
   (setq mode-name "Puppet")
   (setq major-mode 'puppet-mode)
   (set-syntax-table puppet-mode-syntax-table)
+  (set (make-local-variable 'parse-sexp-ignore-comments) t)
   (set (make-local-variable 'local-abbrev-table) puppet-mode-abbrev-table)
   (set (make-local-variable 'comment-start) "# ")
   (set (make-local-variable 'comment-start-skip) "#+ *")

data/ext/osx/file_mapping.yaml

@@ -0,0 +1,38 @@
+directories:
+  lib:
+    path: 'usr/lib/ruby/site_ruby/1.8'
+    owner: 'root'
+    group: 'wheel'
+    perms: '0644'
+  bin:
+    path: 'usr/bin'
+    owner: 'root'
+    group: 'wheel'
+    perms: '0755'
+  sbin:
+    path: 'usr/sbin'
+    owner: 'root'
+    group: 'wheel'
+    perms: '0755'
+  'man/man8':
+    path: 'usr/share/man/man8'
+    owner: 'root'
+    group: 'wheel'
+    perms: '0755'
+files:
+  'conf/auth.conf':
+    path: 'private/etc/puppet'
+    owner: 'root'
+    group: 'wheel'
+    perms: '0644'
+  'man/man5/puppet.conf.5':
+    path: 'usr/share/man/man5'
+    owner: 'root'
+    group: 'wheel'
+    perms: '0644'
+  '[A-Z]*':
+    path: 'usr/share/doc/puppet'
+    owner: 'root'
+    group: 'wheel'
+    perms: '0644'
+

data/ext/osx/preflight.erb

@@ -0,0 +1,37 @@
+#!/bin/bash
+#
+# Make sure that old puppet cruft is removed
+# This also allows us to downgrade puppet as
+# it's more likely that installing old versions
+# over new will cause issues.
+#
+# ${3} is the destination volume so that this works correctly
+# when being installed to volumes other than the current OS.
+
+<% begin %>
+<% require 'rubygems' %>
+<% rescue LoadError %>
+<% end %>
+<% require 'rake' %>
+
+<% Dir.chdir("lib") %>
+<% FileList["**/*"].select {|i| File.file?(i)}.each do |file| %>
+/bin/rm -Rf "${3}<%= @apple_libdir %>/<%=file%>"
+<% end %>
+
+<% Dir.chdir("../bin") %>
+<% FileList["**/*"].select {|i| File.file?(i)}.each do |file| %>
+/bin/rm -Rf "${3}<%= @apple_bindir %>/<%=file%>"
+<% end %>
+<% Dir.chdir("..") %>
+
+# remove old doc files
+/bin/rm -Rf "${3}<%= @apple_docdir %>/<%= @package_name %>"
+
+# These files used to live in the sbindir but were
+# removed in Pupppet >= 3.0. Remove them
+/bin/rm -Rf "${3}<%= @apple_sbindir %>/puppetca"
+/bin/rm -Rf "${3}<%= @apple_sbindir %>/puppetd"
+/bin/rm -Rf "${3}<%= @apple_sbindir %>/puppetmasterd"
+/bin/rm -Rf "${3}<%= @apple_sbindir %>/puppetqd"
+/bin/rm -Rf "${3}<%= @apple_sbindir %>/puppetrun"

data/ext/packaging/README-Solaris.md

@@ -0,0 +1,117 @@
+## Create self signed certificate
+
+- Generate the key pair
+
+        | keytool -genkey -keyalg RSA -alias selfsigned -keystore keystore.jks -storepass password -validity 360 -keysize 2048
+
+
+- Extract Certificate
+
+        | keytool -export -rfc -keystore keystore.jks -storepass password -alias selfsigned -file mycert.pem
+
+- Extract Cert Key to PEM format
+
+        | keytool -importkeystore -srcstoretype JKS -srckeystore keystore.jks -deststoretype PKCS12 -destkeystore mykey.der
+        | openssl pkcs12 -in mykey.der -nodes -out mykey.pem
+
+## For installation.
+
+- Check the publishers
+
+        | pkg publisher
+        solaris                               origin   online   http://pkg.oracle.com/solaris/release/
+
+- Add puppetlabs.com as a publisher
+
+        | pkg set-publisher -p http://solaris-11-ips-repo.acctest.dc1.puppetlabs.net puppetlabs.com
+
+- Check that we have it correct
+
+        | pkg publisher
+        solaris                               origin   online   http://pkg.oracle.com/solaris/release/
+        puppetlabs.com                        origin   online   http://solaris-11-ips-repo.acctest.dc1.puppetlabs.net/
+
+- Verify that puppetlabs.com was set correctly,
+
+        | pkg publisher puppetlabs.com
+                Publisher: puppetlabs.com
+                    Alias:
+               Origin URI: http://solaris-11-ips-repo.acctest.dc1.puppetlabs.net/
+                  SSL Key: None
+                 SSL Cert: None
+              Client UUID: 37084c4a-fdc6-11e1-832b-8800273bd610
+          Catalog Updated: September 13, 2012 08:31:25 PM
+                  Enabled: Yes
+         Signature Policy: verify
+
+- Try installing puppet
+
+        | pkg install puppet
+        Creating Plan |
+        pkg install: Chain was rooted in an untrusted self-signed certificate.
+          The package involved is:pkg://puppetlabs.com/system/management/puppet@3.0.0,5.11-6.192:20120913T212942Z
+
+- We have two choices here, first, to ignore the signature policy for both publisher and image
+
+        | pkg set-publisher --set-property=signature-policy=ignore  puppetlabs.com
+        | pkg publisher puppetlabs.com
+                Publisher: puppetlabs.com
+                    Alias: 
+               Origin URI: http://solaris-11-ips-repo.acctest.dc1.puppetlabs.net/
+                  SSL Key: None
+                 SSL Cert: None
+              Client UUID: 140bb5c8-fe62-11e1-af70-8800273bd610
+          Catalog Updated: September 14, 2012 05:11:45 PM 
+                  Enabled: Yes
+         Signature Policy: ignore
+        | pkg set-property signature-policy ignore
+        | pkg install puppet
+
+- Or trust the self signed certificate from puppetlabs.com (this certificate needs to be published in our web site)
+
+        | pkg set-publisher --approve-ca-cert /root/mycert.pem puppetlabs.com
+
+- Verify that approve cert went well.
+
+        | pkg publisher puppetlabs.com
+
+                Publisher: puppetlabs.com
+                    Alias: 
+               Origin URI: http://solaris-11-ips-repo.acctest.dc1.puppetlabs.net/
+                  SSL Key: None
+                 SSL Cert: None
+              Client UUID: 37084c4a-fdc6-11e1-832b-8800273bd610
+          Catalog Updated: September 13, 2012 08:31:25 PM 
+             Approved CAs: 791b5791a81e9c2eb3fb9f84f4f86f8ea6fcd672
+                  Enabled: Yes
+         Signature Policy: verify
+
+        | pkg install puppet
+
+- Checking about information on the package (See the human readable version string)
+
+        | pkg info -r puppet
+                  Name: system/management/puppet
+               Summary: Puppet, an automated configuration management tool
+           Description: Puppet, an automated configuration management tool
+              Category: System/Administration and Configuration
+                 State: Not installed
+             Publisher: puppetlabs.com
+               Version: 3.0.0 (3.0.0-rc6)
+         Build Release: 5.11
+                Branch: 6.170
+        Packaging Date: September 14, 2012 06:11:05 PM 
+                  Size: 2.43 MB
+                  FMRI: pkg://puppetlabs.com/system/management/puppet@3.0.0,5.11-6.170:20120914T181105Z
+
+- Check license
+
+        | pkg info -r --license puppet
+           Puppet - Automating Configuration Management.
+
+           Copyright (C) 2005-2012 Puppet Labs Inc
+
+
+- Reference
+
+http://docs.oracle.com/cd/E19963-01/html/820-6572/managepkgs.html

data/ext/packaging/README.md

@@ -0,0 +1,255 @@
+#Packaging
+
+This is a repository for packaging automation for Puppet Labs software.
+The goal is to abstract and automate packaging processes beyond individual
+software projects to a level where this repo can be cloned inside any project
+and used to build Debian and Redhat packages, as well as gems, apple packages
+and tarballs.
+
+##Using the Packaging Repo
+
+Several Puppet Labs projects have been migrated to the packaging repo,
+including puppet, facter, puppet-dashboard, and hiera. Generally speaking,
+ruby 1.9.3 and rake 0.9.x seem to work best. To pull the packaging tasks into
+your source repo, do a `rake package:bootstrap`. This will clone this repo
+into the ext directory of the project and make many packaging tasks
+available. The tasks are generally grouped into two categories, `package:`
+namespaced tasks and `pl:` namespaced tasks.
+
+`package:` namespaced tasks are general purpose tasks that are set up to use
+the most minimal tool chain possible for creating packages. These tasks will
+create rpms and debs, but any build dependencies will need to be satisifed by
+the building host, and any dynamically generated dependencies may result in
+packages that are only suitable for the OS/version of the build host. However,
+for rolling one's own debs and rpms or for use in environments without many
+OSes/versions, this may work just fine.
+
+`pl:` namespaced tasks rely on a slighly more complex toolchain for packaging
+inside clean chroot environments for the various operating systems and
+versions that Puppet Labs supports. On the rpm side, this is done with
+[mock](http://fedoraproject.org/wiki/Projects/Mock) and for debs, we use
+pdebuild and [cowbuilder](http://wiki.debian.org/cowbuilder). For the most
+part, these tasks are keyed to puppetlabs infrastructure, and are used by the
+Release Engineering team to create release packages. However, they can
+certainly be modified to suit other environments, and much effort went into
+making tasks as modular and reusable as possible.
+
+A puppet module,
+[puppetlabs-debbuilder](https://github.com/puppetlabs/puppetlabs-debbuilder),
+has been created to stand up a debian build host compatible with the debian
+side this packaging repo. The rpm-side module,
+[puppetlabs-rpmbuilder](https://github.com/puppetlabs/puppetlabs-rpmbuilder),
+is currently a work in progress and.
+
+To remove the packaging repo, remove the ext/packaging directory or run `rake
+package:implode`.
+
+##Setting up projects for the Packaging Repo
+
+The packaging repo requires many project-side artifacts inside the ext
+directory at the top level.  It expects the following directory structure in
+the project
+
+*   ext/{debian,redhat,osx}
+
+each of which contains templated erb files using the instance variables
+specified in the setupvars task. These include a debian changelog, a redhat
+spec file, and an osx preflight and plist.
+
+The top level Rakefile in the project should have the following added:
+
+```ruby
+Dir['ext/packaging/tasks/**/*.rake'].sort.each { |t| load t }
+
+build_defs_file = 'ext/build_defaults.yaml'
+if File.exist?(build_defs_file)
+  begin
+    require 'yaml'
+    @build_defaults ||= YAML.load_file(build_defs_file)
+  rescue Exception => e
+    STDERR.puts "Unable to load yaml from #{build_defs_file}:"
+    STDERR.puts e
+  end
+  @packaging_url  = @build_defaults['packaging_url']
+  @packaging_repo = @build_defaults['packaging_repo']
+  raise "Could not find packaging url in #{build_defs_file}" if @packaging_url.nil?
+  raise "Could not find packaging repo in #{build_defs_file}" if @packaging_repo.nil?
+
+  namespace :package do
+    desc "Bootstrap packaging automation, e.g. clone into packaging repo"
+    task :bootstrap do
+      if File.exist?("ext/#{@packaging_repo}")
+        puts "It looks like you already have ext/#{@packaging_repo}. If you don't like it, blow it away with package:implode."
+      else
+        cd 'ext' do
+          %x{git clone #{@packaging_url}}
+        end
+      end
+    end
+    desc "Remove all cloned packaging automation"
+    task :implode do
+      rm_rf "ext/#{@packaging_repo}"
+    end
+  end
+end
+```
+
+Also in ext should be two files, build_defaults.yaml and project_data.yaml.
+
+This is the sample build_defaults.yaml file from Hiera:
+```yaml
+---
+packaging_url: 'git@github.com:puppetlabs/packaging --branch=master'
+packaging_repo: 'packaging'
+default_cow: 'base-squeeze-i386.cow'
+cows: 'base-lucid-amd64.cow base-lucid-i386.cow base-natty-amd64.cow base-natty-i386.cow base-oneiric-amd64.cow base-oneiric-i386.cow base-precise-amd64.cow base-precise-i386.cow base-sid-amd64.cow base-sid-i386.cow base-squeeze-amd64.cow base-squeeze-i386.cow base-testing-amd64.cow base-testing-i386.cow base-wheezy-i386.cow'
+pbuild_conf: '/etc/pbuilderrc'
+packager: 'puppetlabs'
+gpg_name: 'info@puppetlabs.com'
+gpg_key: '4BD6EC30'
+# Whether to require tarball signing as a prerequisite of other package building
+sign_tar: FALSE
+# a space separated list of mock configs, one set for final releases, another for devel
+final_mocks: 'pl-5-i386 pl-5-x86_64 pl-6-i386 pl-6-x86_64 fedora-15-i386 fedora-15-x86_64 fedora-16-i386 fedora-16-x86_64 fedora-17-i386 fedora-17-x86_64'
+rc_mocks: 'pl-5-i386-dev pl-5-x86_64-dev pl-6-i386-dev pl-6-x86_64-dev fedora-15-i386-dev fedora-15-x86_64-dev fedora-16-i386-dev fedora-16-x86_64-dev fedora-17-i386-dev fedora-17-x86_64-dev'
+# The host that contains the yum repository to ship to
+yum_host: 'burji.puppetlabs.com'
+# The remote path the repository on the yum_host
+yum_repo_path: '~/repo/'
+# The host that contains the apt repository to ship to
+apt_host: 'burji.puppetlabs.com'
+# The URL to use for the apt dependencies in cow building
+apt_repo_url: 'http://apt.puppetlabs.com'
+# The path on the remote apt host that debs should ship to
+apt_repo_path: '/opt/repository/incoming'
+# Whether to present the gem and apple tasks
+build_gem: TRUE
+build_dmg: TRUE
+```
+This is the sample project_data.yaml file:
+```yaml
+---
+project: 'hiera'
+author: 'Puppet Labs'
+email: 'info@puppetlabs.com'
+homepage: 'https://github.com/puppetlabs/hiera'
+summary: 'Light weight hierarchical data store'
+description: 'A pluggable data store for hierarcical data'
+# file containing hard coded version information, if present
+version_file: '/lib/hiera.rb'
+# files and gem_files are space separated lists
+# files to be packaged into a tarball and released with deb/rpm
+files: '[A-Z]* ext lib bin spec acceptance_tests'
+# space separated list of files to *exclude* from the tarball
+# note that each listing in files, above, is recursively copied into the tarball, so
+# 'tar_excludes' only needs to include any undesired subdirectories/files of the 'files'
+# list to exclude
+tar_excludes: 'ext/packaging lib/some_excluded_file'
+# files to be packaged into a gem
+gem_files: '{bin,lib}/**/* CHANGELOG COPYING README.md LICENSE'
+# To exclude specific files from inclusion in a gem:
+gem_excludes: 'lib/hiera/file_to_exclude.rb lib/hiera/directory_to_exclude'
+# If gem name differs in some way from project name, e.g. only build gem for a client end
+gem_name: hiera_the_gem
+# If gem summary and/or description differs from general summary
+gem_summary: 'A sub-set of the Hiera pluggable data store'
+gem_description: 'A gem of the pluggable data store for hierarchical data'
+gem_require_path: 'lib'
+gem_test_files: 'spec/**/*'
+gem_executables: 'hiera'
+gem_default_executables: 'hiera'
+# To add gem dependencies, indent.
+# This is an example only, hiera doesn't really depend on hiera-puppet/json/facter
+# For no specific version, leave version empty
+gem_runtime_dependencies:
+  hiera-puppet: '1.0.0rc'
+  hiera-json:
+gem_development_dependencies:
+  facter: '>= 1.6.11'
+# rdoc options as an array
+gem_rdoc_options:
+  - --line-numbers
+  - --main
+  - Hiera.README
+```
+For basic mac packaging, add an osx directory in ext containing the following files:
+1. a preflight.erb template for any pre-flight actions, perhaps removing the old package if present.
+2. a prototype.plist.erb that is templated into the pkginfo.plist file for the package. This is the one from puppet. Note that these variable names aren't mutable here, but there's no need to worry about their value assignment, it's done in the apple task:
+```
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleIdentifier</key>
+  <string><%= @title %></string>
+  <key>CFBundleShortVersionString</key>
+  <string><%= @version %></string>
+  <key>IFMajorVersion</key>
+  <integer><%= @package_major_version %></integer>
+  <key>IFMinorVersion</key>
+  <integer><%= @package_minor_version %></integer>
+  <key>IFPkgBuildDate</key>
+  <date><%= @build_date %></date>
+  <key>IFPkgFlagAllowBackRev</key>
+  <false/>
+  <key>IFPkgFlagAuthorizationAction</key>
+  <string>RootAuthorization</string>
+  <key>IFPkgFlagDefaultLocation</key>
+  <string>/</string>
+  <key>IFPkgFlagFollowLinks</key>
+  <true/>
+  <key>IFPkgFlagInstallFat</key>
+  <false/>
+  <key>IFPkgFlagIsRequired</key>
+  <false/>
+  <key>IFPkgFlagOverwritePermissions</key>
+  <false/>
+  <key>IFPkgFlagRelocatable</key>
+  <false/>
+  <key>IFPkgFlagRestartAction</key>
+  <string><%= @pm_restart %></string>
+  <key>IFPkgFlagRootVolumeOnly</key>
+  <true/>
+  <key>IFPkgFlagUpdateInstalledLanguages</key>
+  <false/>
+</dict>
+</plist>
+```
+A file_mapping.yaml file that specifies a set of files and a set of directories from the source to install, with destinations, ownership, and permissions. The directories are top level directories in the source to install. The files are files somewhere in the source to install. This is the one from puppet 3.x:
+```yaml
+---
+directories:
+# this will take the contents of lib, e.g. puppet/lib/* and place them in /usr/lib/ruby/site_ruby/1.8
+  lib:
+    path: 'usr/lib/ruby/site_ruby/1.8'
+    owner: 'root'
+    group: 'wheel'
+    perms: '0644'
+  bin:
+    path: 'usr/bin'
+    owner: 'root'
+    group: 'wheel'
+    perms: '0755'
+  'man/man8':
+    path: 'usr/share/man/man8'
+    owner: 'root'
+    group: 'wheel'
+    perms: '0755'
+files:
+# this will take the file puppet/conf/auth.conf and place it in /private/etc/puppet/, creating the directory if not present
+  'conf/auth.conf':
+    path: 'private/etc/puppet'
+    owner: 'root'
+    group: 'wheel'
+    perms: '0644'
+  'man/man5/puppet.conf.5':
+    path: 'usr/share/man/man5'
+    owner: 'root'
+    group: 'wheel'
+    perms: '0644'
+  '[A-Z]*':
+    path: 'usr/share/doc/puppet'
+    owner: 'root'
+    group: 'wheel'
+    perms: '0644'
+```