Home
Pages 93
- Home
- Adobe CS5 Update Dependencies
- Adobe CS6 Products
- Adobe Flash Player
- Adobe Reader
- App Dmg Package Notes
- App Store Apps
- Apple Software Updates With Munki
- Blocking Applications
- Bootstrapping With Munki
- Building Munki
- Building Munki2 Pkgs
- ChoiceChangesXML
- Client Customization
- Common Munki Setups
- Conditional Items
- CopyFromDMG
- Creating Disk Images
- Custom Help Content
- Demonstration Setup
- Discussion Group
- Documentation Ideas
- Dynamic Client Configurations Via Preflight Scripting
- Execute Munki With a LogoutHook
- FAQ
- GarageBand
- Glossary
- Google Code Wiki to Github Wiki Guide
- How Munki Decides What Needs To Be Installed
- Installing On Standalone Machine
- Installing OS X
- Known Issues and Workarounds
- Launchd Jobs and Changing When Munki Runs
- License Seat Tracking
- Localization Maintenance
- Makecatalogs
- makepkginfo
- managedsoftwareupdate
- Managing Admin Rights With Munki
- Managing Configuration Profiles
- Managing Printers With Munki
- Manifests
- manifestutil
- MCX Support In Munki
- Middleware
- More Links And Tools
- MSU Logging
- Munki And Acrobat 9 Pro
- Munki And Adobe CC
- Munki And Adobe CS3
- Munki And Adobe CS4
- Munki And Adobe CS5
- Munki And Adobe CS5 Updates
- Munki And Adobe CS6
- Munki And AdobeCS5
- Munki And AdobeCS5 Updates
- Munki And AdobeCS6
- Munki and AutoRemove
- Munki And Office 2008
- Munki And Office 2011 Updates
- Munki and Office 2016
- Munki Configuration Script
- Munki Dev Support
- Munki Links
- Munki With Git
- Munki2 Introduction
- munkiimport
- On Demand Items
- Overview
- Pkginfo Files
- Pkginfo For Apple Software Updates
- Pre And Postinstall Scripts
- Preferences
- Preflight And Postflight Scripts
- Product Icons
- Professional Support
- Release Notes
- Removing Munki
- Repackaging
- Report Broken Client
- Road Map Discussion
- Screenshots In Product Descriptions
- Supported Pkginfo Keys
- Troubleshooting
- Updating Munki Tools
- Upgrading To Munki2
- Using Basic Authentication
- Using Munki Catalogs
- Using Munki With SSL Client Certificates
- What Are Stupid Munki Tricks
- Workflow Example
- WPKG like Dynamic Manifests Without CGI
- Xcode
- Show 78 more pages…
Introduction
- Getting Started
- Overview
- Discussion Group
- Demonstration Setup
- Glossary
- Frequently Asked Questions
- Release Notes
New in Munki 2
- Introduction
- Munki Links
- Product Icons
- Screenshots In Product Descriptions
- Client Customization
- Custom Help Content
- Upgrading to Munki 2
Tools
Munki configuration
Manifests
Catalogs
Pkginfo
- Pkginfo Files
- Supported Pkginfo Keys
- Pre And Postinstall Scripts
- Munki And AutoRemove
- Blocking Applications
- ChoiceChangesXML
- CopyFromDMG
- Pkginfo For Apple Software Updates
- Managing Configuration Profiles
- How Munki Decides What Needs To Be Installed
Advanced configuration
- Securing the Munki repo
- Preflight And Postflight Scripts
- Report Broken Client
- MSU Logging
- Munki With Git
- Bootstrapping With Munki
- License Seat Tracking
- LaunchD Jobs and Changing When Munki Runs
- Web Request Middleware
Related tasks
- Repackaging
- Creating Disk Images
- Stupid Munki Tricks
More
- Troubleshooting
- Professional Support
- Known Issues and Workarounds
- Building Munki 2
- Removing Munki
- More Links And Tools
- Munki Configuration Script
Product-specific notes
- App Store Apps
- Adobe Products
- GarageBand
- Microsoft Office
- Xcode
- Installing OS X with Munki
- Updating Munki Tools
Legacy Documentation
Getting started with Munki
Overview
See here for a basic overview of what Munki does and does not do.
Details
See Demonstration Setup for a walk-through of setting up a functional Munki client and server on a single machine; no separate web server needed. This is a quick and easy way to get started with Munki, and is a recommended starting point for people new to Munki.
Munki Versions
- Munki 1.x and earlier support Mac OS X 10.5–10.9.x.
- Munki 2.x supports Mac OS X 10.6 – 10.11.x
- Munki 2.3.1 or higher is recommended for use with OS X 10.11 El Capitan.
Requirements:
Python
Munki requires Python 2.5 or higher with Objective-C Python bindings, which is included by default in Mac OS X. Munki 1.x is supported on Leopard through Mavericks (10.5-10.9). Munki 2 drops support for Leopard, and supports Snow Leopard or higher (10.6+).
To see how to report cases where Python dependencies are broken, see Report Broken Client.
Web server
A basic Munki server is simply a web server. You do not need the Munki tools installed on the server. You can set up a Munki server on any platform that supports a web server. You can use OS X client, OS X Server, Linux, Windows or even a NAS appliance as a Munki server. You are simply setting up a filesystem on a web server for clients to access.
A machine to administer your Munki server (Mac OS X 10.5+)
This machine will use the Munki admin tools to create pkginfo files, catalogs and manifests. This machine must be running Mac OS X and it needs the munkitools.mpkg installed. You can also use your Munki server for this (if the server is running Mac OS X or Mac OS X Server) but it's not required. Installing the munki tools prompts a reboot so maybe your server isn't the best choice depending what other services it hosts. Common choices for an admin machine: The Mac you do your day to day work on, a spare Mac, your Munki server (if it's running OS X).
If your Munki server is on an OS X Server and you do decide to also use it as an admin station, consider installing only the admin tools. Installing the full package will also cause the server to be an unconfigured Munki client, which could lead to unwanted consequences ranging from unexpected software installs to security exploits by bad actors.
User / Client Machines (Mac OS X 10.5+)
These are your users machines that you want to install updates and packages on via Munki. munkitools.mpkg must be installed on all client machines. munkitools.mpkg contains 4 sub packages: app, core, launchd and admin. The admin package is not required for your clients, but it's much simpler to just install the whole package.
The easiest way to start is by downloading the current packaged release here: https://github.com/munki/munki/releases
The installer package installs the munki command-line tools in /usr/local/munki/, and the GUI Managed Software Center.app in /Applications/ (alongside an Managed Software Update.app alias in /Applications/Utilities/).
Then follow the walkthrough here: Demonstration Setup to setup a demo Munki server and client.
Key tools
Admin tools:
munkiimport: A tool that helps an admin import software installation packages into the Munki server. See munkiimport for more info on this tool.
makepkginfo: A lower level tool. Given an installer package, creates basic pkginfo (metadata) for it. The admin should edit this and add to this metadata - if it was all automatically discoverable, we wouldn't need the separate pkginfo metadata file in the first place! See makepkginfo for more.
makecatalogs: Builds Munki catalogs from pkginfo files generated by makepkginfo or munkiimport. See makecatalogs for more.
manifestutil: A tool for manipulating manifest files. See manifestutil for documentation.
Client tools:
managedsoftwareupdate - checks with the server and retrieves current manifest(s); walks though the manifest(s), downloads catalogs, retrieves detail on individual manifest items and then builds a list of items that need to be installed, and a list of items that need to be removed. More info here: managedsoftwareupdate
Calling managedsoftwareupdate --installonly - installs or removes items.
GUI application:
Managed Software Center.app: Located at /Applications/Managed Software Center.app
This app is used to notify the user that there are updates to be installed. It also provides visual progress feedback during installs, even over the loginwindow. Additionally, it serves as an App Store-like source for on-demand/optional software installs and removals.
Users can also run this app to trigger a check for available updates; if there are no available updates (in InstallInfo.plist) when it is launched, it will run a check and return the results.
Demonstration setup of Munki server and client
See Demonstration Setup for a walkthrough of setting up a demo Munki server and client.
Where to go for more info and help
If, after working through the Demonstration Setup, and reading the documentation here, and checking out the MacTech "Introduction to Munki" articles (Part 1, Part 2, Part 3, Part 4) you are still perplexed and need some help, post a a question on the munki-discuss Google Group.
If you are looking for professional support or a managed solution, start here: Professional Support