agitator

README

agitator

A reverse proxy for the FastAGI protocol

Features:

• Request based routing

Routes FastAGI sessions depending on the request URI.

• Load balancing

Distributes load evenly between FastAGI servers based on the number of active sessions or in a Round-Robin fashion.

• HA - Failover

Routes traffic to stand-by servers when main server is not reachable, or has reached the number of maximum allowed sessions.

• TLS

Offers strong encryption support for FastAGI sessions.

• On the fly config reloading

Routing rules can be reloaded/altered on the fly without restarting the proxy or dropping any connections.

• Syslog integration

Can send logging and debug data to a syslog server.

To install:

	go install github.com/zaf/agitator

To run:

	agitator -conf=/path/to/conf.file

There is also a simple Makefile that installs the agitator binary in /usr/local/bin and its config file in /usr/local/etc to help with system wide installation. Under the folder init startup scripts are provided for systemd based systems, for Red Hat and Debian based systems that use the old sysV init and for systems that use OpenRC.

Reloading the config file on-the-fly requires a Hangup signal to be sent to the agitator process. This can be done either by using the init scripts provided or with something like pkill -HUP agitator. This reloads the routing settings from the config file. To alter the general settings (like listening port or address) agitator must be restarted. A graceful shutdown option is available where agitator stops accepting new requests but waits for all active sessions to finish before exiting. To trigger it either use the init scripts or send an Interrupt signal (pkill -INT agitator) to the agitator process.

Topology examples:

A typical layout where agitator sits between one or more asterisk servers and one or more FastAGI servers routing AGI requests providing load balancing and/or high availability:

Agitator can make up for asterisk's lack of encryption support on the AGI protocol either by wrapping AGI sessions in TLS, sending the traffic over the network, unwrapping it and contacting the FastAGI server:

or by encrypting AGI traffic and directly communicating with TLS aware FastAGI servers:

An example of such a FastAGI server can be found here, using the Go AGI package. A Perl implementation can be found here using Asterisk::AGI and Net::Server::PreFork.

See sample config file for configuration details.

---

Copyright (C) 2014 - 2015, Lefteris Zafiris zaf@fastmail.com

This program is free software, distributed under the terms of the GNU General Public License Version 3. See the LICENSE file at the top of the source tree.