README.md

What?

A rework of my now ancient Exim agent for MCollective. The old agent predated
SimpleRPC so it was a protocol on it's own, this new agent is fully SimpleRPC
based.

This version will handle bigger spools better - it will still be slow to fetch an
entire spool with 10s of thousands of mails on it but you now have the ability to
dig into the spool using the usual exigrep features. The filters are done server
side so should be much more efficient than before.

A new Dialog interface was written that provides a lot of the same functionality
minux some of the finer grained matching options. The Dialog interface is particularly
good for commands like retry, rm, giveup etc where you need to operate on a message id
as it will give you a convenient chooser to pick messages to operate on. It requires
the rdialog gem to be installed

I am toying with a web interface but it's still a work in progress. Some of this code
is not particularly DRY I will refactor once I have the worklow/approach of the web
app down 100% and will then look at common points

Usage?

The included application plugin does most of what is needed in general use:

Retrieve the mail queue

The mail queue can be retrieved in whole or in part by using filters, the display will
match what the built in mailq application would show so you can pipe the network wide
mail queue into whatever existing scripts you have.

Managing the mail queue and its contents

You can remove, edit, freeze and thaw messages on the queue.

Most of these actions are limited to single messages or the entire queue
we hope to add matchers to retry, freeze, thaw and rm so that these actions
can be taken on all messages matching recipient, sender etc.

You can also do a network wide exigrep to find all log lines relating some activity, you should
use this with caution as on busy servers the files can be huge and it can put considerable load
on your servers, just like when you use exigrep on the CLI.