NAME

Lemonldap::Config::SOAPserver - handler SOAP::Lite under mod_perl for configuration of lemonldap SSO system

DESCRIPTION

 With version of Config::parameters > 0.3 we can use an unique file of configuration 
 whi can be retrieve by the lemonldap SSO boxes with SOAP agents .
 On the central server you MUST use SOAP server in combinaison with apache , mod_perl and SOAP::Lite 
 Like this :
 (httpd.conf)  
  <location /conf_lemonldap>
    Options +execcgi
    SetHandler perl-script
    PerlHandler Apache::SOAP
    PerlSetVar dispatch_to  'Lemonldap::Config::SOAPserver'
  </location>
  
 In XML file config :
  
   <cache  id="config1"
        ConfigIpcKey="CONF"
        ConfigTtl ="10000000"
        LastModified='1'
        Method="SOAP" 
        SoapUri="http://www.portable.appli.cp/SOAPserver"
        SoapProxy="http://www.portable.appli.cp/conf_lemonldap"
        SoapAgent="['http://localhost/cgi-bin/refresh.cgi','http://www.portable.appli.cp/perl/refresh.cgi']"
     >

 with :SoapUri and SoapProxy : see SOAP::Lite documentation 
       SoapAgent : the list of agents CGI  on lemonldap server who must to be call in the case of modification

  After that agent receive notification , they do a soap request upon the administration server  for reload the lastnew config .
  If it's fail , slave lemonldap uses a local file XML which is the lastest copy of file config .

 An agent lemonldap MAY to be in same server that the SOAP manager. So SOAP manager uses 'conf' instead 'CONF' for the IPC glue .
 It 'll be two IPC segments 'CONF' and 'conf'  'CONF' for agent 'conf' for SOAP server ,but don't worry it's an internal process ,
 stay to use 'CONF' .

SEE ALSO

Lemonldap(3), Lemonldap::Portal::Standard(3) , Lemonldap::Config::Parameters(3)

http://lemonldap.sourceforge.net/

"Writing Apache Modules with Perl and C" by Lincoln Stein & Doug MacEachern - O'REILLY

 See the examples directory

AUTHORS

Eric German, <germanlinux@yahoo.fr>

Xavier Guimard, <x.guimard@free.fr>

COPYRIGHT AND LICENSE

Copyright (C) 2004 by Eric German & Xavier Guimard

Lemonldap originaly written by Eric german who decided to publish him in 2003 under the terms of the GNU General Public License version 2.

This package is under the GNU General Public License, Version 2.

The primary copyright holder is Eric German.

Portions are copyrighted under the same license as Perl itself.

Portions are copyrighted by Doug MacEachern and Lincoln Stein. This library is under the GNU General Public License, Version 2.

  This program 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; version 2 dated June, 1991.

  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.

  A copy of the GNU General Public License is available in the source tree;
  if not, write to the Free Software Foundation, Inc.,
  59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.