CSP Gateway Configuration Guide - InterSystems Documentation

More documents

Recommendations

Info

Web Servers for UNIX®, Linux, and Mac OS X xlc_r -c -DAIX -DAIX5 -I/usr/apache/include mod_csp.c \ -o mod_csp.o xlc_r -G -H512 -T512 -bM:SRE mod_csp.o -berok -bexpall \ -bnoentry -lm -lc -o mod_csp.so • IBM AIX®: 64-bit (IBM Compiler) OBJECT_MODE=64 export OBJECT_MODE xlc_r -c -DAIX -DAIX5 -I/usr/apache/include mod_csp.c \ -o mod_csp.o xlc_r -G -H512 -T512 -bM:SRE mod_csp.o -berok -bexpall \ -bnoentry -lm -lc -o mod_csp.so • Sun OS/Solaris: Opteron (Sun Compiler) cc -c -Xa -w -DSOLARIS -KPIC -I/usr/apache/include \ -o mod_csp.o mod_csp.c ld -G -o mod_csp.so mod_csp.o • Sun OS/Solaris: Opteron: 64-bit (Sun Compiler) cc -c -Xa -w -DSOLARIS -KPIC -xarch=amd64 -DBIT64PLAT \ -I/usr/apache/include -o mod_csp.o mod_csp.c ld -G -o mod_csp.so mod_csp.o • Sun OS/Solaris: Intel (Sun Compiler) cc -c -Xa -w -DSOLARIS -KPIC -I/usr/apache/include \ -o mod_csp.o mod_csp.c ld -G -o mod_csp.so mod_csp.o • Sun OS/Solaris: SPARC (Sun Compiler) cc -c -Xa -w -DSOLARIS -I/usr/apache/include -o mod_csp.o mod_csp.c old -G -o mod_csp.so mod_csp. • Sun OS/Solaris: SPAR 64-bit (Sun Compiler) cc -c -Xa -w -DSOLARIS -KPIC -xarch=v9 -DBIT64PLAT \ -I/usr/apache/include -o mod_csp.o mod_csp.c ld -G -o mod_csp.so mod_csp.o To match the instructions in this document you may want to rename the module produced as mod_csp2.so for Apache Version 2.0.x and mod_csp22.so for Apache Version 2.2.x. Copy mod_csp2.so or mod_csp22.so to: /usr/cachesys/csp/bin. 5.2.2.4 Runtime Configuration Edit the Apache configuration file httpd.conf. For the standard Apache distribution, this file is in: /usr/apache/conf For Red Hat Linux, the runtime version of httpd.conf is in: /etc/httpd/conf Assuming that you wish to invoke the CSP engine for requested files that contain a .csp, .cls, or .zen extension, add the following section to the end of httpd.conf. Of course, if you are using Apache Version 2.0.x, specify mod_csp2.so in the configuration block below. If you are using Apache Version 2.2.x, specify mod_csp22.so. The below configuration block relies on the Regular Expressions (regex) processor being available to the Apache environment. Sometimes this is not the case and CSP files are consequently not served (File not found errors are returned). To remedy this situation, replace the following lines in the configuration block: 112 CSP Gateway Configuration Guide
Apache Servers SetHandler csp-handler with: AddHandler csp-handler csp cls LoadModule csp_module /usr/cachesys/csp/bin/mod_csp.so SetHandler csp-handler Alias /csp/ /usr/cachesys/csp/ AllowOverride None Options MultiViews FollowSymLinks ExecCGI Order allow,deny Allow from all Deny from all Deny from all ScriptAlias /csp-bin/ "/usr/cachesys/csp/bin/" ScriptAliasMatch /csp/bin/Systems/Module.cxw \ "/usr/cachesys/csp/bin/nph-CSPcgiSys" ScriptAliasMatch /csp/bin/RunTime/Module.cxw \ "/usr/cachesys/csp/bin/nph-CSPcgi" AllowOverride None Options None Order allow,deny Allow from all Restart Apache after making changes to httpd.conf. Pooling Connections Between the Apache Module and the NSD This facility is available only in build 7 (and later) of the Apache module: mod_csp. This is supplied with the Caché v2008.2 distributions. The enhancement described in this section concerns connection pooling in the Apache module: mod_csp[n].so/dll. As discussed previously, this module is designed to implement the lines of communication between the Web Server environment and the Gateway NSD component (CSPnsd). Previous versions of the Apache module implemented an HTTP v1.0 style of communication between the Web Server and Gateway. This mode of operation was necessary because, prior to the enhancements made in later versions of the CSP Gateway, CSP responses were generally dispatched to the client without including any form of size notification. Therefore, the “connection close” event was the sole means of terminating a response. However, as with other HTTP v1.0 based applications, the following problems become apparent at times of peak usage: 1. The overhead of creating a new TCP connection to serve each request. 2. Production systems would inevitably experience a build-up of connections spending an unacceptable length of time in the “TIME_WAIT”state at times of peak usage. The problems listed above can be solved by maintaining a pool of persistent TCP connections between the module and NSD. On the sever side (i.e. NSD), a pool of threads is maintained alongside the persistent connections (connection-oriented thread pooling). It is anticipated that these enhancements result in a marked improvement in performance for Apache/UNIX® installations. The best improvements are seen with Apache v2 (and later) because this server is a multithreaded/multiprocess hybrid and it is possible to anticipate a single instance of mod_csp being able to maintain a large pool of persistent TCP connections to the server. However, the same optimizations should also improve the performance of the Apache Group’s earlier singlethreaded/multiprocess servers (v1.3 and earlier). CSP Gateway Configuration Guide 113
Page 1 and 2:
CSP Gateway Configuration Guide Ver
Page 3 and 4:
Table of Contents About this Book .
Page 5:
5 Web Servers for UNIX®, Linux, an
Page 9 and 10:
1 Introduction to the CSP Gateway T
Page 11 and 12:
Using the Network Service Daemon (N
Page 13 and 14:
Minimal Apache Web Server or Privat
Page 15 and 16:
2 CSP Gateway Operation and Configu
Page 17 and 18:
CSP Web Gateway Management Page The
Page 19 and 20:
CSP Web Gateway Management Page 2.1
Page 21 and 22:
CSP Web Gateway Management Page Use
Page 23 and 24:
Page 25 and 26:
CSP Web Gateway Management Page Log
Page 27 and 28:
Page 29 and 30:
CSP Web Gateway Management Page 2.1
Page 31 and 32:
CSP Web Gateway Management Page Par
Page 33 and 34:
CSP Gateway and Security 4. Click S
Page 35 and 36:
CSP Gateway and Security Windows Pa
Page 37 and 38:
CGI Environment Variables The clien
Page 39 and 40:
HTTP Response Headers by invoking o
Page 41 and 42:
Compressing the Response to Request
Page 43 and 44:
Compressing the Response to Request
Page 45 and 46:
CSP Page Output Caching 2.7.1 %resp
Page 47 and 48:
CSP with Microsoft Active Server Pa
Page 49 and 50:
Registering Additional File Types w
Page 51 and 52:
Registering Additional File Types w
Page 53 and 54:
Implementing HTTP authentication fo
Page 55:
Implementing HTTP authentication fo
Page 58 and 59:
Using Caché Server Pages with a Re
Page 60 and 61:
Page 62 and 63:
Page 65 and 66:
4 Web Servers for Microsoft Windows
Page 67 and 68: Microsoft Internet Information Serv
Page 97 and 98: Apache Servers This, for example, i
Page 99 and 100: Apache Servers 4.3.2 Option 1: Apac
Page 101 and 102: Apache Servers Duplicate this confi
Page 103 and 104: Apache Servers 4.3.4.1 Operating an
Page 105 and 106: Apache Servers copy c:\MyCache\csp\
Page 107 and 108: Operating the Network Service Daemo
Page 109 and 110: 5 Web Servers for UNIX®, Linux, an
Page 111 and 112: Sun Web Servers 3. HyperEvents Comp
Page 113 and 114: Apache Servers Locate the block of
Page 115 and 116: Apache Servers /usr/CSPGateway/bin
Page 117: Apache Servers To be consistent wit
Page 121 and 122: Apache Servers ScriptAliasMatch /*\
Page 123 and 124: Apache Servers 5.2.4.2 Check the Ap
Page 125 and 126: Apache Servers The Web server confi
Page 127 and 128: Operating the Network Service Daemo
Page 129: Operating the Network Service Daemo
Page 132 and 133: Web Servers for Hewlett-Packard (HP
show all

CSP Gateway Configuration Guide - InterSystems Documentation

Create successful ePaper yourself

Delete template?

Save as template?