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.
- 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.
- 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.
- 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.
- 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.
- If Oracle database server is not running then start it.
- If you have not already created an Oracle database for Servertec
Internet Server then follow the instructions below to create it.
- 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.
- Create admin user.
grant connect to admin identified by admin;
grant dba to admin;
commit;
exit
- Start SQLPLUS again and this time login using the new admin
user.
sqlplus admin/admin
- 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.
- Using the sample TNSNAMES.ORA file in
installdir/databases, define a new SQL Net entry named
iserver.oracle for Servertec Internet Server.
- Start SQL Net Listener.
lsnrctl start
- 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.
- Install and configure Servertec Persistent Object Store.
- 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.
- 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.
|