err.no Git - sope/blob - sope-appserver/mod_ngobjweb/README

   1 # $Id$
   2
   3 mod_ngobjweb
   4 ============
   5
   6 This is an Apache module for forwarding HTTP requests to SOPE application
   7 server instances. It has the ability to ask the snsd load balancer to
   8 distribute requests between processes and/or hosts.
   9
  10 Apache Config Directives
  11 ------------------------
  12 SetSNSPort
  13 SetAppPrefix
  14 SetAppPort
  15 SNSUseHTTP (experimental)
  16
  17 Loading the Module with apache 1.3.x
  18 ------------------------------------
  19 LoadModule ngobjweb_module modules/ngobjweb_1.3.x.so
  20
  21 AddModule ngobjweb_module.c
  22
  23 Loading the Module with apache 2.0.x
  24 ------------------------------------
  25 LoadModule ngobjweb_module modules/ngobjweb_2.0.x.so
  26
  27 Example Apache Config
  28 ---------------------
  29 <LocationMatch "^/OpenGroupware*">
  30 SetHandler ngobjweb-adaptor
  31 SetAppPort 20000
  32 </LocationMatch>
  33
  34 Apache on Debian SID
  35 ====================
  36
  37 Apache is not named 'httpd' on Debian, so you need to invoke make with a
  38 parameter.
  39
  40 Compilation for Apache2:
  41
  42   make HTTPD=/usr/sbin/apache
  43
  44 Afterwards move the build module to /usr/lib/apache/1.3/mod_ngobjweb.so and
  45 copy the *.info file to the same directory.
  46
  47 Then run:
  48   modules-config apache enable mod_ngobjweb
  49
  50 Finally create a proper OGo.conf in /etc/apache/conf.d.
  51
  52 Apache2 on SuSE 9.0
  53 ===================
  54
  55 Compilation for Apache2:
  56
  57   make \
  58     apxs=/usr/sbin/apxs2   \
  59     HTTPD=/usr/sbin/httpd2
  60
  61 Just create a new config file in "/etc/apache2/conf.d/OGo.conf" and add the
  62 directives you need. Be sure to use "apache2" to restart instead of "apache"
  63 (which will restart Apache 1.3 ...).
  64 You should probably not use a threaded Apache 2 MPM, which may have issues
  65 with mod_ngobjweb but something like prefork.
  66
  67 And finally: in the long run you should remove SuSE 9.0 from your machine and
  68 rather install a free distribution like Debian.
  69
  70 Note: /etc/rc.d/apache2 stop does not work on SuSE 9.0 ... you need to killall
  71 the httpd-prefork processes manually, sigh.