CSP Gateway Configuration Guide - InterSystems Documentation

More documents

Recommendations

Info

Atypical Configurations for Microsoft Windows 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 A.4.3 Atypical Option 2: Apache API Module with NSD (mod_csp.dll) Note: This connectivity option is not used as often as the stand-alone API modules described in Option 1, however, it can be used if you need to use the NSD. The CSP module, built as a DLL (mod_csp.dll), performs better than the CGI-based solution (Option 2). The module is usually named mod_csp2.dll for Apache v2.0.x, and mod_csp22.dll for Apache v2.2.x. 1. Edit the Apache configuration file httpd.conf. For the standard Apache distribution this file is in: C:\Program Files>\Apache Group\Apache\conf To invoke CSP for files with the .csp, .cls, and .zen extensions, add the following section to the end of httpd.conf. For Apache v2.0.x, specify mod_csp2.dll (instead of mod_csp.dll). For Apache v2.2.x, specify mod_csp22.dll (instead of mod_csp.dll). LoadModule csp_module c:/cache-install-dir/csp/bin/mod_csp.dll SetHandler csp-handler Alias /csp/ /cache-install-dir/csp/ AllowOverride None Options MultiViews FollowSymLinks ExecCGI Order allow,deny Allow from all Deny from all Deny from all ScriptAlias /csp-bin/ "c:/cache-install-dir/csp/bin/" ScriptAliasMatch /csp/bin/Systems/Module.cxw \ "c:/cache-install-dir/csp/bin/nph-CSPcgiSys.exe" ScriptAliasMatch /csp/bin/RunTime/Module.cxw \ "c:/cache-install-dir/csp/bin/nph-CSPcgi.exe" AllowOverride None Options None Order allow,deny Allow from all 2. Optional step, if required: The above configuration block expects that the Regular Expressions (regex) processor is available to the Apache environment. If this is not the case (particularly with Windows 2000 systems), CSP files are not served (File not found errors are returned). To remedy this situation, replace the following configuration block: SetHandler csp-handler with: AddHandler csp-handler csp cls 3. Restart Apache after making changes to httpd.conf. A.4.3.1 Registering additional file types with CSP To configure additional file types to be processed by CSP, include the new file extension(s) in the list of usual file extensions (csp,. cls, zen) to be processed by the CGI module. For example, add them to the following line: 116 CSP Gateway Configuration Guide
Atypical Options for Windows Apache ScriptAliasMatch /*\.([Cc][Ss][Pp]|[Cc][Ll][Ss]|[Zz][En][Nn])$ "/cache-install-dir/csp/bin/nph-CSPcgi" If you need to serve other static files through the CSP Gateway or need to access the Management Portal through this web server, add mappings for file types .jpg, .gif, .png, and .js. The following directive can be used to map requests for all files to CSP for a given path. ScriptAliasMatch ^/csp/*/.* "/cache-install-dir/csp/bin/nph-CSPcgi" Therefore, a basic configuration block for mapping requests for all files in the /csp path to CSP would be: 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 A.4.3.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 A.4.4 Atypical Option 3: Apache and ISAPI Modules (CSPms.dll) This connectivity option is superseded by the stand-alone API modules described in the Recommended Option 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. A.4.4.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: CSP Gateway Configuration Guide 117
Page 1 and 2:
CSP Gateway Configuration Guide Ver
Page 3 and 4:
Table of Contents About this Book .
Page 5 and 6:
5.4 Operating the Network Service D
Page 7:
About this Book This book describes
Page 10 and 11:
Introduction to the CSP Gateway The
Page 12 and 13:
Introduction to the CSP Gateway To
Page 14 and 15:
Introduction to the CSP Gateway 3.
Page 16 and 17:
Introduction to the CSP Gateway 1.1
Page 18 and 19:
CSP Gateway Operation and Configura
Page 20 and 21:
Page 22 and 23:
Page 24 and 25:
Page 26 and 27:
Page 28 and 29:
Page 30 and 31:
Page 32 and 33:
Page 34 and 35:
Page 36 and 37:
Page 38 and 39:
Page 40 and 41:
Page 42 and 43:
Page 44 and 45:
Page 46 and 47:
Page 48 and 49:
Page 50 and 51:
Page 52 and 53:
Page 54 and 55:
Page 56 and 57:
Page 58 and 59:
Page 60 and 61:
Page 62 and 63:
Page 64 and 65:
Web Servers for Microsoft Windows 4
Page 66 and 67:
Web Servers for Microsoft Windows 3
Page 68 and 69:
Web Servers for Microsoft Windows R
Page 70 and 71:
Web Servers for Microsoft Windows I
Page 72 and 73: Web Servers for Microsoft Windows 1
Page 74 and 75: Web Servers for Microsoft Windows 3
Page 76 and 77: Web Servers for Microsoft Windows
Page 78 and 79: Web Servers for Microsoft Windows B
Page 80 and 81: Web Servers for UNIX®, Linux, and
Page 89 and 90: 5 Web Servers for HP OpenVMS If you
Page 91 and 92: Recommended Option: OpenVMS and Apa
Page 93 and 94: Locked-down Apache Environments for
Page 95: Operating the Network Service Daemo
Page 98 and 99: Atypical Configurations for Microso
Page 128 and 129: Atypical Configurations for UNIX®,
Page 149 and 150: C Atypical Configurations for HP Op
Page 151 and 152: D Apache Considerations UNIX®, Lin
Page 153 and 154: Apache Process Management and Capac
Page 155 and 156: State-Aware Sessions (Preserve mode
Page 157 and 158: E Building Apache for IBM AIX Note:
Page 159 and 160: Building Apache for IBM AIX # Rule
Page 161 and 162: Building Apache for IBM AIX @echo "
Page 167: Building Apache for IBM AIX Having
Page 171 and 172: G IIS Technical Notes For those int
Page 173 and 174:
Bitness — 32-bit Apps on 64-bit S
show all

CSP Gateway Configuration Guide - InterSystems Documentation

Create successful ePaper yourself

Delete template?

Save as template?