Code Monkey home page Code Monkey logo

sal's Introduction

Sal

Sal is a multi-tenanted reporting dashboard for Munki with the ability to display information from Facter. It has a plugin system allowing you to easily build widgets to display your custom information from Facter or Munki's conditional items (or both!).

With Sal, you are able to allow access to reports on certain sets of machines to certain people - for example, giving a manager access to the reports on the machines in their department.

Sal

Getting Started

First off, you're going to need to get the Server and then the Client component of Sal installed. Instructions can be found here.

Once you've got clients reporting in, you're probably going to want to customise what you see on the various screens. Here is a full list of the various options that can be set in sal/settings.py.

If you would like a demo of setting up Sal along with some of the features please watch the following presentation Graham made at the 2014 Penn State MacAdmins Conference. Slides available from here.

Search

Sal has full search across machines, Facts and Munki conditions. For more information, see it's documentation.

Plugins

You can enable, disable and re-order your plugins from the Settings page, under the 'person' menu in the main menu bar. For more information on using and installing your own plugins, visit the Using Plugins page.

After re-ordering and hiding plugins from some screens, you might even want to make your own plugins. You can base your plugin off of one of the included ones, or one of mine in the repository of optional plugins. Trust me it's easy if you know python, and completely possible even if you don't. If you want more information on creating your own plugin you can follow a series of posts from my blog part 1, part 2, and part 3.

Brute force protection

Sal has built in brute force protection. See it's documentation for more details or if you're using Docker, see how to turn it on in the Readme.

LDAP Authentication

There is a variant of Sal that supports LDAP authenctication. At this time, only using the sal-ldap Docker image is supported.

Having problems?

You should check out the troubleshooting page.

API

There is a simple API available for Sal. Documentation can be found at docs/Api.md

Discussion

Discussion on the use and development of Sal is available on the Google Group.

Why Sal?

It's the Internet's fault! I asked on Twitter what I should call it, and Peter Bukowinski (@pmbuko) suggested the name, based on a Monkey puppet called Sal Minella.

Thank yous

First off, thanks to Greg Neagle and the rest of the Munki Project. Munki is an amazing product, and managing OS X at any scale would be miserable without it.

Thanks to Puppet Labs for basically giving away the crown jewels for nothing.

sal's People

Contributors

grahamgilbert avatar chasetb avatar clburlison avatar eyemyth avatar diwanicki avatar mrala avatar cabal95 avatar sheagcraig avatar arubdesu avatar wegotoeleven avatar ninjabong avatar np5 avatar eahrold avatar erikng avatar gerardkok avatar joshuagarr avatar lgalvez338 avatar macjustice avatar petertait avatar sebnash avatar kkunkel avatar

Watchers

James Cloos avatar Joaquín avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.