CSP Gateway Configuration Guide - InterSystems Documentation

More documents

Recommendations

Info

CSP Gateway Operation and Configuration 2. The section that describes the mapping between CSP files and the Gateway modules must be modified to include the home-page-path directive as follows: Service method=(GET|HEAD|POST) fn=csp_req \ home-page-path="/cache-install-dir/csp/samples" \ Service method=(GET|HEAD|POST) fn=csp_req \ home-page-path="/cache-install-dir/csp/samples" \ Service method=(GET|HEAD|POST) fn=csp_req \ home-page-path="/cache-install-dir/csp/samples" Service method=(GET|HEAD|POST) fn=csp_req_sys Service method=(GET|HEAD|POST) fn=csp_req It is not entirely necessary to specify the path to the home page in the home-page-path property within the Service directive, but if you do, it results in the PATH_TRANSLATED environment variable taking the value that it would have done had /csp/samples/menu.csp been requested directly. In other words, PATH_TRANSLATED for the home-page (/) is returned as: /cachesys/csp/samples/inspector.csp instead of: /csp/samples/inspector.csp 2.5.3 Apache Servers Find the DirectoryIndex directive in the Apache configuration file. For example: DirectoryIndex index.html index.html.var Add the new default page for the Web server at the head of the list: DirectoryIndex /csp/samples/menu.csp index.html index.html.var 2.6 Compressing the Response to Requests for CSP Forms (GZIP/ZLIB) Compressing the response generated by the CSP engine before dispatching it to the client is advantageous because it can dramatically reduce the network bandwidth required to transport the response to the client. From the client’s perspective the performance of the application is improved. This is particularly true for clients accessing the application through mobile devices over slower telecommunications networks. There is, of course, a cost in terms of the Web server host’s CPU time that’s required to actually compress the data but this is a small price to pay for the advantages. The advantage of serving compressed response data is particularly marked for CSP pages for which large volumes of response data are generated. There are two methods for implementing GZIP in a Web server environment. • Using the Gateway’s own interface to the GZIP library described here. • Using a GZIP output filter as an add-on to the hosting Web server. 40 CSP Gateway Configuration Guide
Compressing the Response to Requests for CSP Forms (GZIP/ZLIB) Most Web servers offer add-on facilities for compressing data. Windows/IIS offers a gzip filter (implemented as an ISAPI filter). The Apache Group offer a compression filter implemented as an add-on module (mod_deflate.c – which, rather confusingly, implements gzip compression not deflate). There is also a third-party module for Apache called mod_gzip.c. There are a number of third-party GZIP products available as add-ons for most Web servers. The advantages of implementing a compression solution directly in the CSP Gateway are as follows: • Ease of setup and configuration. • Greater flexibility in controlling which CSP files are to be compressed. • The Gateway receives the response content from Caché in fairly large chunks; therefore the performance of the compression and the degree of compression achieved is better if the data is submitted to the compressor functions in large buffers. • Finally, it has been discovered that if Chunked Transfer Encoding is enabled at the CSP Gateway level and if the Apache mod_deflate output filter is enabled for the same resources, then Windows browsers are occasionally unable to display the response content. The Gateway makes use of the freely available GZIP (or zlib) library for implementing data compression. The compression algorithm used is described in RFCs (Request for Comments) 1950 to 1952. 2.6.1 Installing the GZIP/ZLIB Library You can download the GZIP/ZLIB library from the following site: http://www.zlib.net/ This resource was developed by Jean-loup Gailly and Mark Adler (Copyright (C) 1995-2006). The library is freely available for all platforms on which the Gateway is supported. It is implemented as a DLL for Windows (zlib.dll), a shared object (or shared library) for UNIX® systems (libz.so or libz.sl) and a ZLIB library is available as a shareable image for OpenVMS. The library libz.so (or libz.sl) is usually pre-installed on all Linux systems (it is usually installed in /usr/lib/ or /usr/local/lib). The Gateway dynamically links to the ZLIB library when response compression is requested for the first time. Thereafter the ZLIB library remains loaded until the Gateway is closed down. For Windows, the ZLIB library should be installed in the Windows System32 directory: C:\WINDOWS\SYSTEM32\ZLIB.DLL It should be noted that in the latest distributions, the library is named as ZLIB1.dll. This must be renamed to ZLIB.DLL in order for the Gateway to find it. For UNIX® systems, the library (libz.so or libz.sl) is usually installed in one of the following locations: • /usr/lib/ • /usr/local/lib/ If the Gateway is able to load the ZLIB library on demand and identify all the required functions, the following initialization message is written to the Event Log: CSP Gateway Initialization The ZLIB library is loaded - Version 1.2.3. (This library is used for the optional GZIP compression facility) If the Gateway cannot find or link to the ZLIB library, it operates as before (pages are returned without being compressed). A statement of failure is written to the Event Log. CSP Gateway Configuration Guide 41
Page 1 and 2: CSP Gateway Configuration Guide Ver
Page 3 and 4: Table of Contents About this Book .
Page 5: 4.4.1 Starting NSD on Alternative T
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: Minimal Apache Web Server or Privat
Page 18 and 19: CSP Gateway Operation and Configura
Page 60 and 61: Using Caché Server Pages with a Re
Page 67 and 68: 4 Web Servers for Microsoft Windows
Page 69 and 70: Microsoft Internet Information Serv
Page 97 and 98:
Microsoft Internet Information Serv
Page 99 and 100:
Microsoft Internet Information Serv
Page 101 and 102:
Apache Servers Note: There are sepa
Page 103 and 104:
Apache Servers is hard-coded into t
Page 105 and 106:
Apache Servers Allow from all The
Page 107 and 108:
Apache Servers This results in all
Page 109 and 110:
Apache Servers ScriptAliasMatch ^/c
Page 111 and 112:
Apache Servers Specify appropriate
Page 113 and 114:
Operating the Network Service Daemo
Page 115:
Locked-down Apache environments Usi
Page 118 and 119:
Web Servers for UNIX®, Linux, and
Page 120 and 121:
Page 122 and 123:
Page 124 and 125:
Page 126 and 127:
Page 128 and 129:
Page 130 and 131:
Page 132 and 133:
Page 134 and 135:
Page 136 and 137:
Page 138 and 139:
Page 140 and 141:
Page 142 and 143:
Page 144 and 145:
Web Servers for Hewlett-Packard (HP
Page 146 and 147:
Page 148 and 149:
show all

CSP Gateway Configuration Guide - InterSystems Documentation

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?