CSP Gateway Configuration Guide - InterSystems Documentation

More documents

Recommendations

Info

Web Servers for Microsoft Windows ScriptAliasMatch ^/csp/*/.* "/cache-install-dir/csp/bin/nph-CSPcgi" Directory "/cache-install-dir/csp/bin/"> AllowOverride None Options None Order allow,deny Allow from all 4.3.4.2 Operating and Managing the Gateway with Apache API and NSD This connectivity option depends on the CSP Gateway’s Network Service Daemon (NSD). 1. Start the CSP NSD as described in Operating the Network Service Daemon. 2. Restart Apache after making changes to its configuration (httpd.conf). The order in which Apache and the NSD are started is unimportant. 3. To access the CSP Web Gateway Management page, point your browser at one of the following locations. Although CSP pages are served through the higher-performing module (mod_csp.dll), the CSP Web Gateway Management page is accessed through the CGI module dedicated to this purpose (nph-CSPcgiSys.exe). http://localhost:/csp/bin/Systems/Module.cxw http://localhost:/csp-bin/nph-CSPcgiSys.exe If you see an Unauthorized User error message, refer to the section on security considerations. The CSP engine is automatically invoked for requested files that contain a .csp, .cls, or .zen extension. For example: http://localhost:/csp/samples/menu.csp 4.3.5 Option 4: Apache and ISAPI Modules (CSPms.dll) This connectivity option is superseded by the stand-alone API modules described in Option 1 and should not be used. It is documented here as a reference for legacy systems that have used it in the past. The Apache Group provides a module that attempts to emulate Microsoft’s ISAPI interface. If Apache is configured to use this module then ISAPI extensions may be run. However, there are significant differences between the Apache Group ISAPI interface and Microsoft’s original. The most troublesome feature of the Apache ISAPI module is that it unloads its ISAPI extensions (DLLs) after servicing each and every request. This behavior is unacceptable for CSP because the CSP Gateway relies on its ISAPI DLLs remaining in memory in order for it to manage a persistent pool of connections to Caché. The modified ISAPI module supplied with CSP allows the CSP Gateway’s ISAPI extensions to remain loaded between requests. The modifications only affect the Gateway’s ISAPI DLLs; all other ISAPI DLLs are subject to the original Apache Group’s functionality. 4.3.5.1 Rebuilding the Apache Executable 1. Upgrade the Apache ISAPI module (mod_isapi.c) Overwrite the Apache Group’s ISAPI module with the version contained in the CSP distribution: C:\Program Files\Apache Group\Apache\src\os\win32\mod_isapi.c 2. Rebuild the Apache executable In order to perform this step you need version 5.0 (or later) of the Microsoft C Compiler (Microsoft Visual C++). Change to the following directory: C:\Program Files\Apache Group\Apache\src\os\win32\mod_isapi.c Build Apache with: 112 CSP Gateway Configuration Guide
Apache Servers nmake /f Makefile.nt installr INSTDIR=d:\progra~1\apache~1\apache You can safely ignore the many warning messages that the build process displays. 3. Runtime configuration Edit the Apache configuration file httpd.conf. For the standard Apache distribution this file is in: C:\Program Files\Apache Group\Apache\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: AddHandler isapi-isa dll AddHandler isapi-isa csp AddHandler isapi-isa cls AddHandler isapi-isa zen AddHandler isapi-isa cxw Alias /csp/ /cache-install-dir/csp/ AllowOverride None Options MultiViews FollowSymLinks ExecCGI Order allow,deny Allow from all Deny from all Alias /csp/bin/Systems/Module.cxw /csp/bin/CSPmsSys.dll 4. Restart Apache after making changes to httpd.conf. 4.3.5.2 Operating and Managing the Gateway with Apache and ISAPI To access the CSP Web Gateway Management page, point your browser at one of the following locations: http://localhost:/csp/bin/Systems/Module.cxw http://localhost:/csp/bin/CSPmsSys.dll If you see an Unauthorized User error message, refer to the section on security considerations. The CSP engine is automatically invoked for requested files that contain a .csp, .cls, or .zen extension. For example: http://localhost:/csp/samples/menu.csp 4.3.6 Locked-down Apache Environments Occasionally Apache is locked-down such that you cannot easily configure the server to access files outside the Apache file system. For configurations locked down in this way, the CSP Gateway configurations discussed in previous sections result in HTTP 403 Forbidden error codes being returned when you try to access CSP resources. To work with these secure configurations is to copy the file system under: \cache-install-dir\csp\ to a location under the Apache root: C:\Program Files\Apache Group\Apache\ Specify appropriate changes to the paths specified in the Apache configuration. An alternative approach is to configure the CSP Gateway to work within the pre-configured directories provided by Apache. 1. Copy CGI modules to: C:\Program Files\Apache Group\Apache\cgi-bin\ as follows: 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:
4.2.6 IIS Application Protection Le
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:
Conventions Used in this Document
Page 15 and 16:
Minimal Apache Web Server or Privat
Page 17 and 18:
2 CSP Gateway Operation and Configu
Page 19 and 20:
CSP Web Gateway Management Page You
Page 21 and 22:
CSP Web Gateway Management Page •
Page 23 and 24:
CSP Web Gateway Management Page 4.
Page 25 and 26:
CSP Web Gateway Management Page Que
Page 27 and 28:
CSP Web Gateway Management Page /op
Page 29 and 30:
CSP Web Gateway Management Page Log
Page 31 and 32:
CSP Web Gateway Management Page The
Page 33 and 34:
CSP Web Gateway Management Page SSL
Page 35 and 36:
CSP Web Gateway Management Page •
Page 37 and 38:
CSP Web Gateway Management Page Par
Page 39 and 40:
CSP Web Gateway Management Page 2.1
Page 41 and 42:
CSP Gateway and Security • Key Ta
Page 43 and 44:
CSP Gateway and Security space, the
Page 45 and 46:
HTTP Response Headers Environment V
Page 47 and 48:
Making a CSP Page the Home Page for
Page 49 and 50:
Compressing the Response to Request
Page 51 and 52:
CSP Page Output Caching 2.6.3 Speci
Page 53 and 54:
CSP Page Output Caching Weather.csp
Page 55 and 56:
CSP with Microsoft Active Server Pa
Page 57 and 58:
Implementing HTTP authentication fo
Page 59 and 60:
Load Balancing and Failover Class %
Page 61 and 62:
Process Affinity and State-Aware Mo
Page 63:
Process Affinity and State-Aware Mo
Page 66 and 67:
Using Caché Server Pages with a Re
Page 68 and 69: Using Caché Server Pages with a Re
Page 70 and 71: Using Caché Server Pages with a Re
Page 73 and 74: 4 Web Servers for Microsoft Windows
Page 75 and 76: Microsoft Internet Information Serv
Page 109 and 110: Apache Servers 4.3 Apache Servers A
Page 111 and 112: Apache Servers persist in memory fr
Page 113 and 114: Apache Servers by CSP since they ar
Page 115 and 116: Apache Servers Finally, note that b
Page 117: Apache Servers To invoke CSP for fi
Page 121 and 122: Operating the Network Service Daemo
Page 123 and 124: Locked-down Apache environments htt
Page 125 and 126: 5 Web Servers for UNIX®, Linux, an
Page 127 and 128: Sun Web Servers 3. HyperEvents Comp
Page 129 and 130: Sun Web Servers To access the CSP W
Page 131 and 132: Apache Servers 1. If you are using
Page 133 and 134: Apache Servers /etc/Apache2/conf 1.
Page 135 and 136: Apache Servers Notice the use of th
Page 137 and 138: Apache Servers • MaxSpareThreads
Page 139 and 140: Apache Servers As an example, consi
Page 141 and 142: Apache Servers Note: For further in
Page 143 and 144: Apache Servers with: AddHandler csp
Page 145 and 146: Apache Servers For example, all the
Page 147 and 148: Apache Servers These directives wor
Page 149 and 150: Apache Servers For example, to add
Page 151 and 152: Apache Servers 5.2.5.4 Registering
Page 153 and 154: Operating the Network Service Daemo
Page 155: Operating the Network Service Daemo
Page 158 and 159: Web Servers for Hewlett-Packard (HP
Page 167 and 168: A Building Apache for IBM AIX Note:
Page 169 and 170:
Building Apache for IBM AIX # Rule
Page 171 and 172:
Building Apache for IBM AIX @echo "
Page 173 and 174:
Page 175 and 176:
Page 177:
Building Apache for IBM AIX Having
show all

CSP Gateway Configuration Guide - InterSystems Documentation

Create successful ePaper yourself

Delete template?

Save as template?