llng-fastcgi-server

llng-fastcgi-server(1)User Contributed Perl Documentatiollng-fastcgi-server(1)



NAME
       llng-fastcgi-server - FastCGI server used to provide Lemonldap::NG
       services to Nginx

SYNOPSIS
         # Start server listening to /run/llng.sock with 10 process
         llng-fastcgi-server -u nobody -g nobody -s /run/llng.sock -n 10

DESCRIPTION
       llng-fastcgi-server has been designed provides Lemonldap::NG services
       to Nginx.  Portal, manager and handler will be compiled only is used.
       So this FastCGI server can be used on every Lemonldap::NG server even
       if it needs only some parts (isolated handlers, portal,...).

PARAMETERS
       Each parameter can be set by an option or a environment variable.

       --pid    -p ($ENV{PID}):
           pid file

       --user   -u ($ENV{USER}):
           user

       --group  -g ($ENV{GROUP}):
           group

       --proc   -n ($ENV{NPROC}):
           Number of processus for FCGI

       --socket -s ($ENV{SOCKET}):
           Unix socket

       --listen -l ($ENV{LISTEN}):
           Listening address (HOST:PORT, :PORT, or PATH)

       --customFunctionsFile -f ($ENV{CUSTOM_FUNCTIONS_FILE}):
           file to load for custom functions

       --engine -e ($ENV{ENGINE}):
           Plack::Handler engine, default to FCGI (see below)

       --plackOptions:
           other options to pass to Plack. This multi-valued parameter must
           have "key=value" values.

           Example to use FCGI::ProcManager::Constrained instead of default
           FCGI manager (FCGI::ProcManager):

             llng-fastcgi-server -u nobody -g nobody -s /run/llng.sock -e FCGI -n 10 \
                                 --plackOptions manager=FCGI::ProcManager::Constrained

ENGINES
       By default, llng-fastcgi-server uses FCGI (= Plack::Handler::FCGI).
       Some other engines can be used:

   FCGI (default)
       It uses FCGI::ProcManager as manager. Other managers:

       FCGI::ProcManager::Constrained
           Example to launch it:

             llng-fastcgi-server -u nobody -g nobody -s /run/llng.sock -e FCGI -n 10 \
                                 --plackOptions manager=FCGI::ProcManager::Constrained

           You can then set environment values (in
           /etc/default/llng-fastcgi-server file for example):

             PM_MAX_REQUESTS=10000
             PM_SIZECHECK_NUM_REQUESTS=100
             PM_MAX_SIZE=300000

       FCGI::ProcManager::Dynamic
             llng-fastcgi-server -u nobody -g nobody -s /run/llng.sock -e FCGI -n 10 \
                                 --plackOptions manager=FCGI::ProcManager::Dynamic

   Other FCGI::ProcManager style engines
       FCGI::Engine

   Event engines
       AnyEvent::FCGI
       FCGI::Async
       FCGI::EV

SEE ALSO
       <http://lemonldap-ng.org/>

AUTHORS
       Clement Oudot, <clem.oudot@gmail.com>
       Xavier Guimard, <x.guimard@free.fr>

BUG REPORT
       Use OW2 system to report bug or ask for features:
       <https://gitlab.ow2.org/lemonldap-ng/lemonldap-ng/issues>

DOWNLOAD
       Lemonldap::NG is available at
       <http://forge.objectweb.org/project/showfiles.php?group_id=274>

COPYRIGHT AND LICENSE
       Copyright (C) 2008-2016 by Xavier Guimard, <x.guimard@free.fr>
       Copyright (C) 2008-2016 by Clement Oudot, <clem.oudot@gmail.com>

       This library is free software; you can redistribute it and/or modify it
       under the terms of the GNU General Public License as published by the
       Free Software Foundation; either version 2, or (at your option) any
       later version.

       This program is distributed in the hope that it will be useful, but
       WITHOUT ANY WARRANTY; without even the implied warranty of
       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
       General Public License for more details.

       You should have received a copy of the GNU General Public License along
       with this program.  If not, see <http://www.gnu.org/licenses/>.



perl v5.26.2                      2018-08-03            llng-fastcgi-server(1)