Table of Contents

Status pages

Portal Status (experimental)

The portal displays in JSON format its activity. Unlike handler, this is not the full activity of the server, but for now just the activity of 1 thread. This can give a view to all returned codes.

Configuration

* Set portalStatus = 1 in lemonldap-ng.ini file (section [Portal]) * Protect http://portal/portalStatus using your webserver configuration

Status is displayed by calling this URL.

Handler Status

Since 2.0, Handler status no more collects Portal returned codes.

Presentation

When status feature is activated, Handlers and portal will collect statistics and save them in their local cache. This means that if several Handlers are deployed, each will manage its own statistics.

This page can be browsed for example by MRTG using the MRTG monitoring script.

The statistics are collected trough a daemon launched by the Handler. It can be seen in system processes, for example:

perl -MLemonldap::NG::Handler::Status -I/etc/perl -I/usr/local/lib/perl/5.10.1 -I/usr/local/share/perl/5.10.1 -I/usr/lib/perl5 -I/usr/share/perl5 -I/usr/lib/perl/5.10 -I/usr/share/perl/5.10 -I/usr/local/lib/site_perl -I. -I/etc/apache2 -e &Lemonldap::NG::Handler::Status::run(Cache::FileCache,{?          'cache_depth' => 5,?          'cache_root' => '/tmp',?          'directory_umask' => '007',?          'default_expires_in' => 600,?          'namespace' => 'MyNamespace'?        }?);

Statistics are displayed when calling the status path on an Handler (for example: http://test1.example.com/status).

Example of status page:

Configuration

Apache

You need to give access to status path in the Handler Apache configuration:

    # Uncomment this to activate status module
    <Location /status>
        Order deny,allow
        Allow from 127.0.0.0/8
        PerlHeaderParserHandler Lemonldap::NG::Handler->status
    </Location>

Then restart Apache.

You should change the Allow directive to match administration IP, or use another Apache protection mean.

Nginx

You need to give access to status path in the Handler Nginx configuration:

server {
  listen __PORT__;
  server_name reload.__DNSDOMAIN__;
  root /var/www/html;
  ...
  location = /status {
    allow 127.0.0.1;
    deny all;
    include /etc/nginx/fastcgi_params;
    fastcgi_pass unix:__FASTCGISOCKDIR__/llng-fastcgi.sock;
    fastcgi_param LLTYPE status;
  }
}

LemonLDAP::NG

Edit lemonldap-ng.ini, and activate status in the handler section:

[handler]
# Set status to 1 if you want to have the report of activity (used for
# example to inform MRTG)
status = 1

Then restart webserver.