Servertec AdminServlet
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
AdminServlet
CgiServlet
ClusterProxy
ClusterRedirector
CommandServlet
FileServlet
InvokerServlet
MessageServlet
RedirectServlet
ServletTagServlet
SSIncludeServlet
StatusServlet

Config Files
Log Files
Classes
Directory Tree
Samples
Legal
Contact Us

 

AdminServlet implements the Servertec Internet Server Administrator.

Parameters

archivesdir The directory where archives created by the Administrator are located.

./archives is the default directory.

If a relative directory is specified then the archives directory is relative to the server's base directory.

event_handler An optional MonitorEventHandler class file.
interval Used optionally to specify the default number of seconds to wait before rechecking the workgroup.

A value greater than or equal to 1 second.

30 seconds is the default interval.

If an interval is not specified or if the interval specified is less than 1 then the default interval is used.

A value too small may have a negative impact on performance and a value too large may result in the monitor not reflecting the current state of the workgroup.

tempdir The temporary directory used by the Administrator.

./temp is the default directory.

If a relative directory is specified then the temporary directory is relative to the server's base directory.

templatesdir The directory where templates used by the Administrator are located.

./templates is the default directory.

If a relative directory is specified then the templates directory is relative to the server's base directory.

timeout the number of seconds to wait for the workgroup server to respond before closing the connection.

30 seconds is the default value.

If -1 is used then the connection will never timeout. Using this value is dangerous and can cause the monitor to hang waiting for a response that will never arrive.

If the value is less 1 second then 30 seconds will be used.

Aliases

Alias: /admin.html
Type: Servlet
Resource: AdminServlet

Servlets

Alias: AdminServlet
Class File: stec.iws.admin.AdminServlet
Parameters:

Configuration

Servertec Internet Server includes console, file, POS, database and email monitor event handler. The console monitor event handler outputs events to stdout. The file monitor event handler writes events to the specified file. The POS monitor event handler uses Servertec Persistent Object Store. The database monitor event handler saves events to any JDBC accessible database and the email monitor event handler sends events in an email to the specified email address.

Console
Flat File
Microsoft Access
Oracle
Servertec Persistent Object Store
eMail


Use the following steps to configure the console monitor event handler.

  1. Define the following Parameters in the AdminServlet Servlet definition.

    event_handler=stec.iws.admin.ConsoleMonitorEventHandler
    event_interval=event_interval

    event_interval Used optionally to specify the default number of minutes to wait before reissuing a monitor event.

    A value greater than or equal to 0 minutes.

    0 minutes is the default interval.

    0 is used to issue a monitor event for every monitor event.

    If an interval is not specified or if the interval specified is less than 1 then the default interval is used.

    A value too small may have a negative impact on performance and a value too large may result in monitor event not being reported.


Use the following steps to configure the file monitor event handler.

  1. Define the following Parameters in the AdminServlet Servlet definition.

    event_handler=stec.iws.admin.FileMonitorEventHandler
    event_interval=event_interval
    monitordir=monitordir
    log_rollover_interval=rollover_interval

    monitordir The directory that will contain the monitor event log files.

    ./logs is the default directory.

    event_interval Used optionally to specify the default number of minutes to wait before reissueing a monitor event.

    A value greater than or equal to 0 minutes.

    0 minutes is the default interval.

    0 is used to issue a monitor event for every monitor event.

    If an interval is not specified or if the interval specified is less than 1 then the default interval is used.

    A value too small may have a negative impact on performance and a value too large may result in monitor event not being reported.

    rollover_interval How often to rollover the monitor event 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_monitor.log when Daily, Weekly and Daily is selected and monitor.log when None is selected.


Use the following steps to configure the database monitor event handler 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. Define the following Parameters in the AdminServlet Servlet definition.

    event_handler=stec.iws.admin.DatabaseMonitorEventHandler
    event_interval=event_interval
    driver=sun.jdbc.odbc.JdbcOdbcDriver
    url=jdbc:odbc:iserver.msaccess

    event_interval Used optionally to specify the default number of minutes to wait before reissueing a monitor event.

    A value greater than or equal to 0 minutes.

    0 minutes is the default interval.

    0 is used to issue a monitor event for every monitor event.

    If an interval is not specified or if the interval specified is less than 1 then the default interval is used.

    A value too small may have a negative impact on performance and a value too large may result in monitor event not being reported.

The database monitor event handler 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 monitor event handler 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. Define the following Parameters in the AdminServlet Servlet definition.

    event_handler=stec.iws.admin.DatabaseMonitorEventHandler
    event_interval=event_interval
    driver=oracle.jdbc.driver.OracleDriver
    url=jdbc:oracle:oci8:@iserver.oracle
    user=admin
    password=admin

    event_interval Used optionally to specify the default number of minutes to wait before reissueing a monitor event.

    A value greater than or equal to 0 minutes.

    0 minutes is the default interval.

    0 is used to issue a monitor event for every monitor event.

    If an interval is not specified or if the interval specified is less than 1 then the default interval is used.

    A value too small may have a negative impact on performance and a value too large may result in monitor event not being reported.


Use the following steps to configure the Servertec Persistent Object Store monitor event handler.
  1. Install and configure Servertec Persistent Object Store.

  2. Define the following Parameters in the AdminServlet Servlet definition.

    event_handler=stec.iws.admin.PosMonitorEventHandler
    event_interval=event_interval
    monitor_store=monitor_store
    monitor_capacity=monitor_capacity
    server_store=server_store

    event_interval Used optionally to specify the default number of minutes to wait before reissueing a monitor event.

    A value greater than or equal to 0 minutes.

    0 minutes is the default interval.

    0 is used to issue a monitor event for every monitor event.

    If an interval is not specified or if the interval specified is less than 1 then the default interval is used.

    A value too small may have a negative impact on performance and a value too large may result in monitor event not being reported.

    monitor_store the base file name of the Monitor store. If not specified defaults to iws_dir/databases/monitor.store.
    monitor_capacity the average number of entries in the Monitor 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.

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


Use the following steps to configure the email monitor event handler.

  1. Define the following Parameters in the AdminServlet Servlet definition.

    event_handler=stec.iws.admin.EMailMonitorEventHandler
    event_interval=event_interval
    email_server=email_server
    email_address=email_address

    email_address The email address to send the monitor event email to.
    email_server The email server to used to send the email.
    event_interval Used optionally to specify the default number of minutes to wait before reissueing a monitor event.

    A value greater than or equal to 0 minutes.

    0 minutes is the default interval.

    0 is used to issue a monitor event for every monitor event.

    If an interval is not specified or if the interval specified is less than 1 then the default interval is used.

    A value too small may have a negative impact on performance and a value too large may result in monitor event not being reported.

Notes

Normally defined as a Servlet aliased as /admin.html.

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