Server Configuration Parameters

The following is a list of configurable parameters used by the BackOnline Server:

• init.server.port
  A valid port number which the server should "listen" to. This should be set to a port number not in use by another server on the same machine. Default: 55555
• init.autostart
  If set to "y", automatically starts the server when it is invoked. Default: n.
• init.trace.file
  Name of file where trace (log) messages should be stored. If no file name is specified, the trace messages are sent to the standard output (stdout) device. Default: <none>.
• init.server.db
  Partial or absolute path name of the user database file. Default: users.dat.
• init.server.db.jdbc.driver
  Java Database Connectivity (JDBC) driver name
• init.server.db.url
  JDBC URL.
• init.server.db.user
  Database user.
• init.server.db.password
  Database password.
• init.server.http.port
  Port number for built-in HTTP server (e.g. for admin purposes).
• init.sql.getUserId
  SQL query statement to obtain a userid from database.
• runtime.http.documentroot
  Document root directory for internal HTTP functions.
• runtime.http.workdir
  Directory for HTTP's temporary working file.
• runtime.insert.audittrail
  Flag to determine if an UserAuditTrail record should be created or not (e.g. for login events).
• runtime.super.user
  Super user. This user is permitted to login into system even when logins are disabled.
• runtime.super.password
  Super user's password.
• runtime.trace.level
  Types of messages to trace; 0=NONE, 1 = WARNINGS, 2 = ERRORS, 3 = DIAGNOSTICS, 99 = ALL. Default: 0.
• runtime.smtp.notify
  This should be set to a "y" (or "Y") if warnings are to be sent when a user's disk usage soft limit is exceeded. For example, the warnings can be sent to a system administrator or the user directly. Default: y.
• runtime.smtp.host
  The host name of the machine where the SMTP (mail) server is running. Default: localhost.
• runtime.smtp.port
  The port number the SMTP server is listening on. Default: 25.
• runtime.client.idle_timeout
  Number of minutes after which a client is logged out automatically if they have been inactive during that period. Default: 30.
• DataInterfaceClassName
  This parameter should only be used for special cases when Java developers wish to extend the BackOnline Server via custom data classes. Default: DataInterfaceFile.

This is a sample configuration file:

init.autostart=y
init.server.db.jdbc.driver=org.enhydra.instantdb.jdbc.idbDriver
init.server.db.url=jdbc:idb=upstreamdb.properties
init.server.db.password=xxx
init.server.db.user=user
init.server.port=55555
init.sql.getUserId=SELECT UserId FROM UserAuthentication WHERE UserName=?
runtime.client.idle_timeout=30
runtime.client.max_login_attempts=3
runtime.smtp.host=localhost
runtime.smtp.notify=n
runtime.smtp.port=25
runtime.super.user=xyz
runtime.trace.level=99
runtime.http.servlet.Monitor=com.freeback.servlet.ClientMonitor
runtime.http.documentroot=/inetpub/wwwroot/freeback

Copyright © Visual Patterns, Inc. All rights reserved.