README.md

NOTE: the Python 2 version of this project is no longer supported. Most of the documentation refers to the Python 2 version and has yet to be updated. A Python 3 version of this project is availble in the py3 branch.

https://github.com/munki/mwa2/tree/py3

Introduction

This is version 2 of MunkiWebAdmin, a web-based administration tool for Munki.

All reporting (formerly part of MunkiWebAdmin) has been removed from MunkiWebAdmin2 — consider using Sal or MunkiReport-PHP for reporting. Both are excellent.

MunkiWebAdmin2 focuses on web-based editing of manifests and pkginfo files.

This is in-development code. Use it with a production Munki repo with care -- make sure you have functioning backups!

Getting started

On OS X (10.7+):

• You'll need git installed; either via Xcode, the command-line developer tools, or a standalone install of git.

• Download and expand this zip:
  https://github.com/munki/contrib/raw/master/mwa2_demo.zip

• Via the command-line, run the script within the expanded zip: /Users/me/Downloads/mwa2_demo/run_mwa2.sh

• Follow the script prompts. Of note, at one place you'll be advised to edit a settings file. Specifically, you'll edit mwa2/munkiwebadmin/settings.py. Near the end of this file is this:

# MUNKI_REPO_DIR holds the local filesystem path to the Munki repo
MUNKI_REPO_DIR = '/Users/Shared/munki_repo'

• Edit MUNKI_REPO_DIR to point to a Munki repo to use with MWA2. This repo should be writable by the user running MWA2. Please do initial testing on a non-production repo. Since MWA2 can make changes to your repo, if you do decide to use it with a production repo -- make sure you have functioning backups!

• After editing settings.py, run run_mwa2.sh again to continue the setup process.

• Once all the setup tasks are complete, a development server will be launched, and MWA2 should be available at http://localhost:8080

run_mwa2.sh script details

• git clones https://github.com/munki/mwa2.git from GitHub into the script directory. (if needed)
• Copies settings_template.py to settings.py and asks you to edit it. (if needed)
• Creates the needed sqlite3 database. (if needed)
• Prompts you to create the initial superuser. (if needed)
• Uses the included CherryPy dev server to serve MWA2.

Linux

See https://github.com/munki/mwa2/wiki/RHEL7-setup-notes for some notes on installing and configuring MWA2 on RedHat Enterprise Linux 7.

Docker

A Docker file for running MWA2 under Docker is available here: https://github.com/macadmins/docker-mwa2
This is maintained by a third-party; please direct support questions about the Docker file to the maintainers of that project.

Acknowledgements

MunkiWebAdmin2 makes use of the following open source components:

• Python (tested version 2.7.10) - https://www.python.org
• Django (tested versions 1.9.1 and 1.9.13) - https://www.djangoproject.com
• jQuery (version 1.11.3 included) - http://jquery.com
• jQuery-UI (version 1.11.4 included) - http://jqueryui.com
• Bootstrap (version 3.3.6 included) - http://getbootstrap.com
• Bootstrap itself includes Glyphicons - http://glyphicons.com
• DataTables (version 1.10.10 included) - http://datatables.net
• Ace - (version as of 06 Jan 2016 included) - https://ace.c9.io/
• The GUI plist editor was inspired by and borrows code from David Durman's FlexiJsonEditor - https://github.com/DavidDurman/FlexiJsonEditor
• The JavaScript plist parser was adapted from Todd Gehman's PlistParser: https://github.com/pugetive/plist_parser
• Chosen - (verson 1.4.2 included) - http://harvesthq.github.io/chosen/

Additionally, the demo files make use of:

• Virtualenv - https://virtualenv.readthedocs.org/en/latest/
• Pip - https://pypi.python.org/pypi/pip
• django-wsgiserver - https://pypi.python.org/pypi/django-wsgiserver -- with a small modification by me to get it to run on Django 1.9 - specifically changing line 326 of django_wsgiserver/management/commands/runwsgiserver.py from: self.validate(display_num_errors=True) to self.check(display_num_errors=True)