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.

2 Replies to "Munki: Munki Report PHP Client Installation and Tour"

  • Marta

    Thanks a lot for all your posts guys,
    Managing 250 Macs for whole college on your own its not an easy task.
    I only recently came across Munki and thanks to your blog I’ve set it all up now in only couple of days.

    Its awesome.

    Thank you for making it so easy.

    Marta

  • Darren Wallace

    Hi Marta,

    You are very welcome, I’m glad it helps you out and thank for your kind words.

    It’s messages like that that make me willing to share the knowledge!

    If you’re in London, I’d suggest keeping an eye on our news section and / or http://www.londonappleadmins.org.uk for two London admin meet up groups that are worth attending.

    Hope that helps.

    Darren

Leave a Reply

Your email address will not be published. Required fields are marked *