iTP Secure WebServer System Administrators Guide (Version 7.5+)

with its source. This application can be referred as a guideline and is available in the following
location:
<iTP WebServer installation directory>/samples/C_Demo/
You must provide the name of the logging serverclass using the following LoggingServerClass
configuration directive:
LoggingServerClass <serverclass name >
For example,
LoggingServerClass LogServ
“Logging Using External Serverclass” (page 267) displays the functional overview of the
LoggingServerClass directive.
Figure 12 Logging Using External Serverclass
Repository
HTTPD
User
User-written
logging server class
Sends the modified
log strings back to a
seprate log repository
Sends the modified
log strings back to
iTP WebServer
Sends the request containing
card information
HTTPD generates
log strings
Following are the design guidelines for developing the logging serverclass:
1. If a logging serverclass is used, httpd does not initially log any information to access.log
and httpd.log.
2. Log strings are sent to the configured logging serverclass through Pathsend.
3. If the Pathsend operation fails, corresponding Pathway error gets logged in the error log
4. httpd sends these log strings in the following format to the Pathway buffer:
ExtendedLog:\n<extended log string>\nCommonLog:\n<access logstring>\n
NOTE: If the logging server is not written as a CGI application, you must ignore any other
data in the Pathway buffer (which is used internally by the CGI library) other than the one
mentioned above.
5. If either one of the logs are not enabled in the iTP Secure WebServer configuration, then only
the corresponding log strings are sent.
6. You can retrieve these log strings, manipulate them if necessary and log them into a separate
log repository.
7. If a separate repository is not maintained, you can send back the modified log strings (one
or both) through Pathsend in the same format as mentioned above. httpd would retrieve
these strings and log them into the respective log files.
Logging through an External ServerClass 267