CSP Gateway Configuration Guide - InterSystems Documentation

More documents

Recommendations

Info

Web Servers for HP OpenVMS • By CSPFileTypes directive • By MIME type By CSPlocation directive Use the CSP directive to request that all files within a certain location be processed by CSP. The following requests that all files and directories under the /csp path be processed by CSP. CSP On SetHandler csp-handler For example, all the following would be sent to CSP for processing: /csp/ csp/samples/menu.csp csp/sys/ By file extension Traditionally, Apache has been configured to invoke CSP on the basis of the requested file’s extension. For example, the following configuration block (from httpd.conf) tells Apache to allow CSP to process requests for files of type *.csp, *.cls, *.zen, and *.cxw: LoadModule csp_module /apache$root/csp/bin/mod_csp2.exe AddHandler csp-handler csp cls zen cxw This method works well in Apache v1.3.x, but may no longer work in Apache v2.0.x (and later). By the CSPFileTypes directive The CSPFileTypes directive works for requests for files that have extensions (such /csp/menu.csp). It does not work for requests for files that do not have file extensions (such as/csp/menu). This parameter is processed by the Gateway’s Apache modules and can be globally defined at the server definition level (in httpd.conf) or restricted within the definition for a location or directory block. By file type: The following directive requests that files of type .xxx and .yyy be processed by CSP. CSPFileTypes .xxx .yyy By location: The following requests that files of type .xxx and .yyy be processed by CSP but only for locations under /csp (including subdirectories, such as /csp/samples and so on). CSPFileTypes .xxx .yyy Using the wildcard character, the following requests that all files under path /csp (and /csp/samples and so on) be processed by CSP. CSPFileTypes * By MIME type In addition to recognizing the file extensions listed above, CSP can also recognize files for the following MIME types: application/x-csp and text/csp 86 CSP Gateway Configuration Guide
Locked-down Apache Environments for Open VMS For example, to add the file extension xxx to the list of files processed by CSP, use: LoadModule csp_module /apache$root/csp/bin/mod_csp2.exe AddType application/x-csp csp cls zen xxx One of the problems with using MIME types to associate types of file with CSP is that Apache checks to ensure that the path to the resource (that is, the hosting directory) physically exists, and returns a file not found error if it does not. It does not, however, check to ensure that the file requested physically exists – which is appropriate for resources served by CSP since they are served by Caché and are virtual as far as the web server is concerned. The “By MIME type” approach is therefore only suitable for cases where the application’s path structure can be replicated on the web server. 5.2.2 Operating and Managing the Gateway with OpenVMS 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 (NSD)”. 2. Restart SWS/Apache after making changes to its configuration file (HTTPD.CONF). The order in which SWS/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*.EXE), 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 5.3 Locked-down Apache Environments for Open VMS The requirement that the CSP components be installed within the Apache directory structure for this server has been discussed in previous sections. Occasionally it is necessary to install the CSP Gateway components in the appropriate pre-configured Apache directories in order to avoid HTTP 403 Forbidden error codes being returned on attempting to access CSP resources. If this is the case for your installation then proceed as follows: 1. Copy CGI modules to: APACHE$ROOT:[cgi-bin] copy APACHE$ROOT:[csp.bin]*cgi*.exe;* APACHE$ROOT:[cgi-bin]*.*;* 2. Copy API modules to: APACHE$ROOT:[modules] copy APACHE$ROOT:[csp.bin]mod*.exe;* APACHE$ROOT:[modules]*.*;* copy APACHE$ROOT:[csp.bin]cspa*.exe;* APACHE$ROOT:[modules]*.*;* 3. Copy static files and subdirectories in these directories to locations under: APACHE$ROOT:[htdocs] copy APACHE$ROOT:[csp.samples]*.*;* APACHE$ROOT:[htdocs.csp.samples]*.*;* copy APACHE$ROOT:[csp.broker]*.*;* APACHE$ROOT:[htdocs.csp.broker]*.*;* copy APACHE$ROOT:[csp.sys]*.*;* APACHE$ROOT:[htdocs.csp.sys]*.*;* CSP Gateway Configuration Guide 87
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: CSP Gateway Operation and Configura
Page 64 and 65: Web Servers for Microsoft Windows 4
Page 68 and 69: Web Servers for Microsoft Windows R
Page 70 and 71: Web Servers for Microsoft Windows I
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: Recommended Option: OpenVMS and Apa
Page 95: Operating the Network Service Daemo
Page 98 and 99: Atypical Configurations for Microso
Page 128 and 129: Atypical Configurations for UNIX®,
Page 142 and 143:
Atypical Configurations for UNIX®,
Page 144 and 145:
Page 146 and 147:
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 163 and 164:
Page 165 and 166:
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?