Online documentation - Websydian v6.0

Users Guide | Patterns Reference | WebsydianExpress | Search

 

J2eeProxy Servlet Property File

Contents

Introduction

The servlet property file is used to configure the J2eeProxy servlet used in J2EE environments.

The path to the servlet property file is configured in the servlet. Please look here for information on how to do this.

Required parameters section

Websydian Server section

Parameter Default Value Description
websydianserver.ipaddr no default value The IP address of the machine where the Websydian Server is started. This address together with the tcpport is used by the J2EE Proxy to connect to the Websydian Server.
websydianserver.tcpport no default value The TCP port of the Websydian Server. The port is used together with the IP address by the J2EE Proxy to connect to the Websydian Server.
servlet.service no default value Name of the Application Service to which requests are forwarded.

Log section

Parameter Default Value Description
servlet.log.level ERROR The log level affects how much the J2EE Proxy will write to the log file. The following values can be used:
  • TRACE

  • INFO

  • WARN

  • ERROR

  • FATAL

Use ERROR in a deployment environment whereas TRACE should be used in debug situations only.

servlet.log.file no default value If the media is File, this parameter is mandatory, and specifies the full path to a log file used by the J2EE Proxy Servlet. If the file does not exist it will be created. Otherwise, new log entries will be added to the existing file.

Plex runtime section

Parameter Default Value Description
servlet.plex.eventdispatchername no default value The implementation name of the Websydian EventDispatcher function. The servlet launches the Websydian application by invoking this function. Remember to qualify the function name with the fully scoped package name, e.g.

WEBSYDIANTESTMISC.testED

servlet.plex.propertyfilename no default value The path to the Plex property file. Specify only the path - not the file name (obxxxusr.properties).

Advanced parameters section

Log section

Parameter Default Value Description
servlet.log.media File The media where the log messages should be sent to. Legal values are:
servlet.log.rollfrequency ROLL_DAILY The frequency to be used by the log system to roll the log:

Valid values are:

  • NO_ROLL
  • ROLL_HOURLY
  • ROLL_DAILY
  • ROLL_WEEKLY
  • ROLL_MONTHLY
servlet.log.smtphost no value If this parameter is specified all log messages of type FATAL or ERROR will be sent in an e-mail to an administrator. This parameter specifies the host name of the SMTP server.
servlet.log.mailsubject no value The subject of the log mails.
servlet.log.mailsender no value If servlet.log.smtphost is specified, this parameter is mandatory and must contain the sender name to use when sending log mails.
servlet.log.mailrecipient no value The receiver of log mails.

Plex runtime section

Parameter Default Value Description
servlet.plex.environmentname Default The environment name to be used by the Application.
servlet.plex.callmethod Standard This option determines how the servlet should call the J2eeEventDispatcher.

Legal values are:

  • Standard
  • SingleRuntime
  • MultipleRuntimes

For more detailed information on these settings please look here.

servlet.plex.session.parametername WSYD_SID The implementation name of the session parameter in the session pattern.
servlet.plex.session.timeout 10 Timeout in minutes for a session. This value should be the same as the value specified in the session pattern in the Plex model.

Miscellaneous

Parameter Default Value Description
servlet.contentlength.max 0 Sets an upper limit for the length of the request in bytes.
Zero indicates that there is no upper limit
servlet.errorpage.url none Specifies a relative URL to an error page within the context of the WAR file where the J2EE Proxy is deployed.

On errors the J2EE Proxy will then call this error page which then is responsible of generating a response to the user.

The error page have to be placed within the scope of the WAR-file where / (slash) indicates the root of the WAR-file. E.g.
servlet.errorpage.url=/errorpage.jsp