Install PE client tools on an unmanaged macOS workstation

You can install the client tools on a macOS workstation using Finder or the command line.

1. On the workstation, create the directory /etc/puppetlabs/puppet/ssl/certs.
2. On the primary server, navigate to /etc/puppetlabs/puppet/ssl/certs/ and copy ca.pem to the directory you created on the workstation.
3. On the workstation, make sure file permissions are correct:

   chmod 444 /etc/puppetlabs/puppet/ssl/certs/ca.pem

4. Verify that the checksum of ca.pem on the workstation matches the checksum of the same file on the primary server.
5. Install the client tools using Finder or the command line.
   • Finder

     1. Download the macOS pe-client-tools-package.

     2. Open the pe-client-tools .dmg and click the installer .pkg.

     3. Follow the prompts to install the client tools.

   • Command line

     1. Download the macOS pe-client-tools-package.

     2. Mount the disk image: sudo hdiutil mount <DMGFILE>.

        A line appears ending with /Volumes/puppet-agent-VERSION. This directory location is the mount point for the virtual volume created from the disk image.

     3. Run cd /Volumes/pe-client-tools-VERSION.
     4. Run sudo installer -pkg pe-client-tools-<VERSION>-installer.pkg -target /.
     5. Run cd ~ and then run sudo umount /Volumes/pe-client-tools-VERSION.