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

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