view README @ 46:92125e266aa4 draft

Keepalive: note the module is included into nginx 1.1.4.
author Maxim Dounin <mdounin@mdounin.ru>
date Tue, 26 Jun 2012 02:52:10 +0400
parents 489c5d4318ff
children
line wrap: on
line source

Keepalive balancer module for nginx.

This module implements cache for backend connections.

As of nginx 1.1.4 the module is included into nginx, and compiled in
by default.  There is no need to install this module separately.

Configuration directives:

    keepalive <num> [single]

        Scope: upstream

        Switches on keepalive module for the upstream in question.

        Parameters:

            - <num>
              Maximum number of connections to cache.  If there isn't enough
              room to cache new connections - last recently used connections
              will be kicked off the cache.

Sample configuration:

    upstream memd {
        server 127.0.0.1:11211;
        server 10.0.0.2:11211;
        keepalive 10;
    }

This module was tested to work with standard round-robin balancing, but
it's believed to be compatible with more sophisticated balancers.  The only
requirement is to activate them *before* this module, e.g.:

    upstream memd {
        server 127.0.0.1:11211;
        server 10.0.0.2:11211;
        ip_hash;
        keepalive 10;
    }

To compile nginx with keepalive module, use "--add-module <path>" option to
nginx configure.