Servertec logger.ini
Content
Introduction
Release Notes
Features
FAQs
Requirements
Installation
Add-ons
How To
Change Log
Future Plans
Knowledge Base
Documentation
Conventions
Command Line
Administrator
Localization
Programming
Security
Performance
Deployment
Java API
Servlet API
CGI
SSI
Servlets
Config Files
acl.ini
aliases.ini
archives.ini
computers.ini
contexts.ini
country_codes.ini
dbpools.ini
groups.ini
hosts.ini
iws.ini
keystore.ini
locales.ini
logger.ini
messages.ini
mimetypes.ini
realms.ini
resources.ini
rights.ini
servlets.ini
session.ini
templates.ini
users.ini
workgroup.ini

Log Files
Classes
Directory Tree
Samples
Legal
Contact Us

 

logger.ini, contains values used by the Logger.

Syntax

ignore_exceptions = ignore_exceptions
log_access = log_access_enabled
log_events = log_events_enabled
log_errors = log_errors_enabled
service = class_file{?parameter{&parameter}...}

class_file the Java Class in the form package.class of the Logger to use.

The CLASSPATH will be searched for the specified Logger.

ignore_exceptions any exceptions to ignore.

Zero or more Java Exception classes can be specified.

java.net.SocketException is the default for Windows 9x/Me/NT/2000/2003/XP, java.net.SocketException, java.io.IOException is the default for Linux/Solaris/Unix and java.net.SocketException, java.io.IOException, java.io.InterruptedIOException is the default for Novell Netware.

log_access_enabled whether or not to log requests.

y is the default value.

Setting this value to n will result in no access log being maintained. Setting this value to y may have a negative impact on performance.

log_errors_enabled whether or not to log errors.

y is the default value.

Setting this value to n will result in no log being maintained for errors. Setting this value to y may have a negative impact on performance.

log_events_enabled whether or not to log events.

y is the default value.

Setting this value to n will result in no log being maintained for events. Setting this value to y may have a negative impact on performance.

parameter any parameters used during the initialization of the Logger.

Zero or more & delimited key=value pairs can be specified.

Notes

Changes made to configuration files will not be used until the server is restarted.

Example

log_access = y
log_events = y
log_errors = y
service = stec.iws.FileLogger
?basedir=./logs
&access_log_template=default
&log_rollover_interval=weekly
&interval=0

Configuration

Servertec Internet Server includes console, file, POS and database loggers. The console logger outputs events and requests to stdout and errors to stderr. The file logger is used to log client requests, errors and events to flat files. The POS logger uses Servertec Object Store and the database logger to any JDBC accessible database.

Select the method to use:
Console
Flat File
Microsoft Access
Oracle
Servertec Persistent Object Store


Use the following steps to configure the console logger.

  1. Set Class File to stec.iws.ConsoleLogger.

  2. Define the following Parameters:

    access_log_template=template
    access_log_header_template=header_template
    interval=interval

    header_template The header template to use.

    Header templates are defined using the Servertec Internet Server Administrator or directly by editing the templates.ini file located at /iws/config directory, assuming that the server was installed in /iws.

    interval The number of milliseconds that Logger waits between flushing queued logger entries.

    0 milliseconds is the default for the Logger.

    0 can be used to flush logger entries immediately.

    The number must be at least 50 milliseconds.

    Setting this value too small may have a negative impact on performance. Setting this value too large may have a negative impact on performance and may result in logger entries being lost if the server crashes or if it is aborted.

    template The template to use for access log entries.

    default is the default value.

    If None is the value then a template will not be used. Using None may improve performance.

    Templates are defined using the Servertec Internet Server Administrator or directly by editing the templates.ini file located at /iws/config directory, assuming that the server was installed in /iws.


Use the following steps to configure the file logger.

  1. Set Class File to stec.iws.FileLogger.

  2. Define the following Parameters:

    basedir=basedir
    access_log_template=template
    access_log_header_template=header_template
    log_rollover_interval=rollover_interval
    interval=interval

    basedir The directory that will contain the log files.

    ./logs is the default directory.

    header_template The header template to use.

    Header templates are defined using the Servertec Internet Server Administrator or directly by editing the templates.ini file located at /iws/config directory, assuming that the server was installed in /iws.

    interval The number of milliseconds that Logger waits between flushing queued logger entries.

    0 milliseconds is the default for the Logger.

    0 can be used to flush logger entries immediately.

    The number must be at least 50 milliseconds.

    Setting this value too small may have a negative impact on performance. Setting this value too large may have a negative impact on performance and may result in logger entries being lost if the server crashes or if it is aborted.

    rollover_interval How often to rollover the log files.

    None do not rollover the log files.
    Daily rollover the log files every day.
    Weekly rollover the log files every week.
    Monthly rollover the log files every month.

    Weekly is the default value.

    On a very active site log files should be rollover every day.

    The Logger uses yyyymmdd_logfile.log when Daily, Weekly and Daily is selected and logfile.log when None is selected.

    template The template to use for access log entries.

    default is the default value.

    If None is the value then a template will not be used. Using None may improve performance.

    Templates are defined using the Servertec Internet Server Administrator or directly by editing the templates.ini file located at /iws/config directory, assuming that the server was installed in /iws.


Use the following steps to configure the database logger for Microsoft Access.

  1. Defined a System DSN for the database using the ODBC Data Source Administrator from the Control Panel.

    Driver: Microsoft Access Driver (*mdb)
    Data Source Name: iserver.msaccess
    Database: iws_dir\databases\iserver.mdb

    iws_dir is the directory where the server was installed, normally c:\iws.

  2. Set Class File to stec.iws.DatabaseLogger.

  3. Define the following Parameters:

    driver=sun.jdbc.odbc.JdbcOdbcDriver
    url=jdbc:odbc:iserver.msaccess
    interval=interval

    interval The number of milliseconds that Logger waits between flushing queued logger entries.

    0 milliseconds is the default for the Logger.

    0 can be used to flush logger entries immediately.

    The number must be at least 50 milliseconds.

    Setting this value too small may have a negative impact on performance. Setting this value too large may have a negative impact on performance and may result in logger entries being lost if the server crashes or if it is aborted.

Notes

Requires that iws_dir/classes/optional.jar be present in the CLASSPATH.

The database logger makes use of the JDBC-ODBC bridge to access the iserver.mdb database. It will only work under Microsoft Windows 9x/Me/NT/2000/2003/XP and may not work with JView.


Use the following steps to configure the database logger for Oracle.

  1. If Oracle database server is not running then start it.

  2. If you have not already created an Oracle database for Servertec Internet Server then follow the instructions below to create it.

    1. Start SQLPLUS and login as an administrator.

      sqlplus system/manager

      The user name and password shown above may not be correct on all systems. Please consult the appropriate Oracle documentation or a system database administrator for the correct user name and password.

    2. Create admin user.

      grant connect to admin identified by admin;
      grant dba to admin;
      commit;
      exit

    3. Start SQLPLUS again and this time login using the new admin user.

      sqlplus admin/admin

    4. Assuming that Servertec Internet Server was installed in /iws, create the database.

      @/iws/databases/iserver.sql
      exit

      If Servertec Internet Server was installed in a directory other than /iws then edit installdir/databases/iserver.sql and change the directory path of the iserver.dbf database to the proper path.

    5. Using the sample TNSNAMES.ORA file in installdir/databases, define a new SQL Net entry named iserver.oracle for Servertec Internet Server.

    6. Start SQL Net Listener.

      lsnrctl start

  3. Set Class File to stec.iws.DatabaseLogger.

  4. Define the following Parameters:

    driver=oracle.jdbc.driver.OracleDriver
    url=jdbc:oracle:oci8:@iserver.oracle
    user=admin
    password=admin
    interval=interval

    interval The number of milliseconds that Logger waits between flushing queued logger entries.

    0 milliseconds is the default for the Logger.

    0 can be used to flush logger entries immediately.

    The number must be at least 50 milliseconds.

    Setting this value too small may have a negative impact on performance. Setting this value too large may have a negative impact on performance and may result in logger entries being lost if the server crashes or if it is aborted.

Notes

Requires that iws_dir/classes/optional.jar be present in the CLASSPATH.


Use the following steps to configure the Servertec Persistent Object Store logger.
  1. Install and configure Servertec Persistent Object Store.

  2. Set Class File to stec.iws.PosLogger.

  3. Define the following Parameters:

    access_store=access_store
    access_capacity=access_capacity
    errors_store=errors_store
    errors_capacity=errors_capacity
    events_store=events_store
    events_capacity=events_capacity
    server_store=server_store
    interval=interval

    access_store the base file name of the Access store. If not specified defaults to iws_dir/databases/access.store.
    access_capacity the average number of entries in the Access store.

    The number must be at least 1.

    If not specified defaults to 65536.

    Setting this value too small may have a negative impact on performance.

    Setting this value too large will waste disk space.

    errors_store the base file name of the Errors store. If not specified defaults to iws_dir/databases/errors.store.
    errors_capacity the average number of entries in the Errors store.

    The number must be at least 1.

    If not specified defaults to 65536.

    Setting this value too small may have a negative impact on performance.

    Setting this value too large will waste disk space.

    events_store the base file name of the Events store. If not specified defaults to iws_dir/databases/events.store.
    events_capacity the average number of entries in the Events store.

    The number must be at least 1.

    If not specified defaults to 65536.

    Setting this value too small may have a negative impact on performance.

    Setting this value too large will waste disk space.

    server_store the base file name of the Server store. If not specified defaults to iws_dir/databases/iws.store.
    interval The number of milliseconds that Logger waits between flushing queued logger entries.

    0 milliseconds is the default for the Logger.

    0 can be used to flush logger entries immediately.

    The number must be at least 50 milliseconds.

    Setting this value too small may have a negative impact on performance. Setting this value too large may have a negative impact on performance and may result in logger entries being lost if the server crashes or if it is aborted.

    Notes

    Requires that iws_dir/classes/optional.jar be present in the CLASSPATH.

    Each entry in the Access store is a stec.pos.Blob containing:
    Field Type Length (Bytes)
    Timestamp long 8
    RemoteAddress UTF8 String 4 + utf8 string length
    RemoteHost UTF8 String 4 + utf8 string length
    RemoteUser UTF8 String 4 + utf8 string length
    Host UTF8 String 4 + utf8 string length
    Port int 4
    LocalAddress UTF8 String 4 + utf8 string length
    ContentLength long 8
    RequestLength long 8
    ResponseTime long 8
    StatusCode int 4
    ErrorCode int 4
    RequestMethod UTF8 String 4 + utf8 string length
    RequestURI UTF8 String 4 + utf8 string length
    QueryString UTF8 String 4 + utf8 string length
    UserAgent UTF8 String 4 + utf8 string length
    Referer UTF8 String 4 + utf8 string length
    Protocol UTF8 String 4 + utf8 string length
    ServerService UTF8 String 4 + utf8 string length

    Each entry in the Errors store is a stec.pos.Blob containing:
    Field Type Length (Bytes)
    Timestamp long 8
    Message UTF8 String 4 + utf8 string length
    Exception UTF8 String 4 + utf8 string length

    Each entry in the Events store is a stec.pos.Blob containing:
    Field Type Length (Bytes)
    Timestamp long 8
    Message UTF8 String 4 + utf8 string length

 top of page
Copyright © 1998-2005 Servertec. All rights reserved.
Privacy Statement.
Last Modified: Sun Sep 04 14:56:49 EDT 2005