Munki: Munki Report PHP Client Installation and Tour

Hey Guys. munki guide
I hope you liked my blog on getting your Munki Report PHP server running. I know I like using that Munki logo face again!
In this post, I aim to show you how to get your clients hooked up into the Report system and give you a mini tour of the web interface
Additional information can be found on the Munki Report PHP site.

Guide

You have your Mac Server installed and configured with 10.9.2 and Server app 3.1.1. This has both forward and reverse lookups configured and working fine.
I will also assume that you have already followed all the steps in the original Munki guide parts 1 to 5, e.g. you have a fully working Munki Repo Server, Administration Server and Client. You also have followed the previous Munki Report PHP server and have a running ‘Report server.

Grabbing the enrollment file and loading it into Munki.

1. Open up terminal and enter the following command. Replace “127.0.0.1” with the DNS name that your clients will use to submit reports.
open terminal
For example, if my server was at “munki.amsys.co.uk” I would use the following command:

curl –s http://munki.amsys.co.uk/index.php?/install/plist –o MunkiReport.plist

2. This will contact the Munki Report PHP server and grab a preference (plist) file to add into Munki and to enrol the clients.
3. Next, enter “open .” and press return. This will open the folder that the terminal window is currently in. This will contain a file called ‘MunkiReport.plist’. This is the file we need to add into your Munki Repo.
munki report plist
4. Copy this file into your Munki Repo under the “pkgsinfo” directory.
pkgs info
5. Finally, make Munki run a ‘Make Catalogs’ either through the ‘Make’ button in the Munki Admin application or by running the below command in terminal:

/usr/local/munki/makecatalogs

6. This will load the plist file as a ‘package’ into Munki. Use your normal methods to add this to your Catalogs and Manifests. Once complete, your clients will automatically install and start reporting in to your server!
Brief Tour of Munki Report PHP
Once you’ve got Munki Report PHP up and running (and a few clients reporting in), fire up the website and login. You’ll be presented with the main Dashboard:
main munki dashboard
Click on “Reports” then “Hardware” to see a summary of the Macs reporting into your server.
munki hardware reports
Click on the Name to be shown a much more detailed overview of the device.
detailed munki report
On the main page you’ll see the hardware specs and machine information in the top section…
hardware specs in munki
And the lower half will show the version of Munki tools installed, the last checks, and the status’ of any Managed Installs.
As expected, the Apple Software and Third party tabs will give you information on Apple Installed and ‘other’ installed applications.
installed apple apps in munki
The Inventory items tab shows all of the applications and binaries that Munki collects, along with their version numbers.
inventory of items in munki
And now, some of the cooler bits, The Network interfaces and Directory Services tabs show all of the devices interfaces, MAC addresses and IP details.
ethernet and wifi services view
With the last two tabs showing the Directory Services connections (if any) and FileVault 2 details (but no recovery keys!).
view directory services in munki
view file vault in munki
Summary
Well there you go. Munki Report PHP fully configured and clients reporting in, and another great tool to add to your Mac Administration / Munki toolkit.
Any hints, tips or opinions? Let us know in the comments below and I’ll try to respond to as many as I can.

Disclaimer:

While the author has taken care to provide our readers with accurate information, please use your discretion before acting upon information based on the blog post. Amsys will not compensate you in any way whatsoever if you ever happen to suffer a loss/inconvenience/damage because of/while making use of information in this blog.