jserv.conf

LOCATION :

SIGNIFICANCE :

IMPORTANT POINTS :

FILE :

#########################################################################################################

# $Header: jserv_ux_ias1022.conf 115.21 2006/01/18 23:03:55 swkhande ship $

###############################################################################

#                     Apache JServ Configuration File                         #

###############################################################################

#

# ###############################################################

# 

# This file is automatically generated by AutoConfig.  It will be read and

# overwritten.  If you were instructed to edit this file, or if you are not

# able to use the settings created by AutoConfig, refer to Metalink document

# 165195.1 for assistance.

# 

# ###############################################################

#

# Note: this file should be appended to or included into your httpd.conf

# Tell Apache on win32 to load the Apache JServ communication module

# LoadModule jserv_module /eb_rao1_q/applmgr/qatora/iAS\Apache\Jserv\ApacheModuleJServ.dll

# Tell Apache on Unix to load the Apache JServ communication module

# For shared object builds only!!!

# ----- iAS 1022 -----

LoadModule jserv_module /eb_rao1_q/applmgr/qatora/iAS/Apache/Jserv/libexec/mod_jserv.so

<IfModule mod_jserv.c>

# Whether Apache must start Apache JServ or not (On=Manual Off=Autostart)

# Syntax: ApJServManual [on/off/auto]

# Default: "Off"

# ----- iAS 1022 -----

ApJServManual auto

# Properties filename for Apache JServ in Automatic Mode. 

# In manual mode this directive is ignored

# Syntax: ApJServProperties [filename]

# Default: "./conf/jserv.properties"

<IfDefine !RESTRICT>

ApJServProperties /eb_rao1_q/applmgr/qatora/iAS/Apache/Jserv/etc/jserv.properties

</IfDefine>

<IfDefine RESTRICT>

ApJServProperties /eb_rao1_q/applmgr/qatora/iAS/Apache/Jserv/etc/jserv_restrict.properties

</IfDefine>

# Log file for this module operation relative to Apache root directory.

# Set the name of the trace/log file.  To avoid possible confusion about

# the location of this file, an absolute pathname is recommended.

# 

# This log file is different than the log file that is in the

# jserv.properties file. This is the log file for the C portion of Apache

# JServ.

# 

# On Unix, this file must have write permissions by the owner of the JVM

# process. In other words, if you are running Apache JServ in manual mode

# and Apache is running as user nobody, then the file must have its

# permissions set so that that user can write to it.

# Syntax: ApJServLogFile [filename] 

# Default: "./logs/mod_jserv.log"

# Note: when set to "DISABLED", the log will be redirected to Apache error log

ApJServLogFile /eb_rao1_q/applmgr/qatora/iAS/Apache/Jserv/logs/mod_jserv.log

# Log Level for this module

# Syntax: ApJServLogLevel [debug|info|notice|warn|error|crit|alert|emerg]

# Default: info    (unless compiled w/ JSERV_DEBUG, in which case it's debug)

#ApJServLogLevel notice

ApJServLogLevel  warn

# Protocol used by this host to connect to Apache JServ

# (see documentation for more details on available protocols)

# Syntax: ApJServDefaultProtocol [name]

# Default: "ajpv12"

ApJServDefaultProtocol ajpv12

# Default host on which Apache JServ is running

# Syntax: ApJServDefaultHost [hostname]

# Default: "localhost"

ApJServDefaultHost tneda06n.adr.corp.com

# Default port that Apache JServ is listening to

# Syntax: ApJServDefaultPort [number]

# Default: protocol-dependant (for ajpv12 protocol this is "8007")

# ApJServDefaultPort @JVMPORT@

# The amount of time to give to the JVM to start up as well

# as the amount of time to wait to ping the JVM to see if it

# is alive. Slow or heavily loaded machines might want to 

# increase this value.

# Default: 10 seconds

ApJServVMTimeout 90

# Passes parameter and value to specified protocol.

# Syntax: ApJServProtocolParameter [name] [parameter] [value]

# Default: NONE

# Note: Currently no protocols handle this. Introduced for future protocols.

# Apache JServ secret key file relative to Apache root directory.

# Syntax: ApJServSecretKey [filename]

# Default: "./conf/jserv.secret.key"

# Warning: if authentication is DISABLED, everyone on this machine (not just

# this module) may connect to your servlet engine and execute servlet 

# bypassing web server restrictions. See the documentation for more information

#ApJServSecretKey /eb_rao1_q/applmgr/qatora/iAS/Apache/Jserv/etc/jserv.secret.key

ApjservSecretKey /eb_rao1_q/applmgr/qatora/iAS/Apache/Jserv/conf/jserv.secret.key

# Mount point for Servlet zones

# (see documentation for more information on servlet zones)

# Syntax: ApJServMount [name] [jserv-url]

# Default: NONE

# Note: [name] is the name of the Apache URI path to mount jserv-url on

#       [jserv-url] is something like "protocol://host:port/zone"

#  If protocol, host or port are not specified, the values from 

#  "ApJServDefaultProtocol", "ApJServDefaultHost" or "ApJServDefaultPort" 

#  will be used. 

#  If zone is not specified, the zone name will be the first subdirectory of

#  the called servlet.

# Example: "ApJServMount /servlets /myServlets"

#  if user requests "http://host/servlets/TestServlet"

#  the servlet "TestServlet" in zone "myServlets" on default host

#  thru default protocol on defaul port will be requested

# Example: "ApJServMount /servlets ajpv12://localhost:8007"

#  if user requests "http://host/servlets/myServlets/TestServlet"

#  the servlet "TestServlet" in zone "myServlets" will be requested

# Example: "ApJServMount /servlets ajpv12://jserv.mydomain.com:15643/myServlets"

#  if user requests "http://host/servlets/TestServlet" the servlet 

#  "TestServlet" in zone "myServlets" on host "jserv.mydomain.com" using 

#  "ajpv12" protocol on port "15643" will be executed

#

# Commented out single JServ, "ApJServManual off" mounts. See ApJServGroupMounts below.

# ApJServMount /oa_servlets /root

# ApJServMount /servlets /root

# ApJServMount /servlet /root

# ApJServMount /jsp /root

# ApJServMount /configurator /root

# ApJServMount /mobile /mobile

# ----- iAS 1022 -----

# ApJServMount /forms        /forms

# ApJServMount /discoverer4i /viewer4i

# ApJServMount /dms1         /root

# ApJServMount /dms2         /forms

# ApJServMount /dms3         /viewer4i

# --------------------

# Whether <VirtualHost> inherits base host mount points or not

# Syntax: ApJServMountCopy [on/off]

# Default: "On"

# Note: This directive is meaninful only when virtual hosts are being used

ApJServMountCopy on

# Commented out this example of "ApJServStartManual on" load balancing. 

# See ApJServGroupMounts below.

#

# ApJServMount /jsp balance://set1/oraclejsp

# ApJServMount /configurator balance://set1/configurator

# Executes a servlet passing filename with proper extension in PATH_TRANSLATED 

# property of servlet request.

# Syntax: ApJServAction [extension] [servlet-uri]

# Defaults: NONE

# Notes: This is used for external tools.

#ApJServAction .jsp /servlets/org.gjt.jsp.JSPServlet

#ApJServAction .gsp /servlets/com.bitmechanic.gsp.GspServlet

#ApJServAction .jhtml /servlets/org.apache.servlet.ssi.SSI

#ApJServAction .xml /servlets/org.apache.cocoon.Cocoon

<IfDefine !RESTRICT>

ApjservAction .jsp /oa_servlets/oracle.jsp.JspServlet

ApjservAction .sqljsp /oa_servlets/oracle.jsp.JspServlet

</IfDefine>

<IfDefine RESTRICT>

ApjservAction .jsp /servlets/oracle.jsp.JspServlet

ApjservAction .sqljsp /servlets/oracle.jsp.JspServlet

</IfDefine>

# Commented out this example of "ApJServStartManual on" load balancing.

# See ApJServGroupMounts below.

#

# ApJServBalance set1  jserv1

# ApJServHost jserv1 ajpv12://tneda06n.adr.corp.com:@JVMPORT@

# ApJServRoute j1 jserv1

# ApJServShmFile ./logs/jserv_shm

# Enable the Apache JServ status handler with the URL of 

# "http://servername/jserv/" (note the trailing slash!)

# Change the "deny" directive to restrict access to this status page.

#<Location /jserv/>

#  SetHandler jserv-status

#  order deny,allow

#  deny from all

#  allow from localhost 

#</Location>

############################## W A R N I N G ##################################

# Remember to disable or otherwise protect the execution of the Apache JServ  #

# Status Handler (see right above) on a production environment since this may #

# give untrusted users the ability to obtain restricted information on your   #

# servlets and their initialization arguments such as JDBC passwords and      #

# other important information. The Apache JServ Status Handler should be      #

# accessible only by system administrators.                                   #

###############################################################################

</IfModule>

# ----- iAS 1022 ----- DMS configuration

ApJServRetryAttempts 3

# set this directive when ApJServManual mode=auto, ignored in "on" and "off" modes.

# A group is a set of processes across which request traffic is distributed.In

# a multi-node setup a group may exist on multiple hosts by defining this

# directive, using an identical groupname in each hosts configuration.

# Syntax: ApJServGroup <groupname> <nprocs> <weight> <propfile>

# <groupname> is the name assigned to the group,

# <nprocs> is the number of processes to start for this group on the local node,

# <weight> is the request distribution skew factor assigned to this group on

# this host. This factor is used by the groups to determine which host to route

# to. In the "on" mode a process with weight 2 gets twice as many requests as a

# process with weight 1. In the "auto" mode with a singe node setup this value

# has no consequence. In the multi-node setup a group with weight 2, on host1

# will handle twice as many requests, as the same group with a weight 1 on

# host2.

# <propfile> the path to the jserv.properties file

# Default: NONE

# Example: ApJServGroup group1 2 1 /eb_rao1_q/applmgr/qatora/iAS/Apache/Jserv/etc/jserv.properties

<IfDefine !RESTRICT>

ApJServGroup OACoreGroup 4 1 /eb_rao1_q/applmgr/qatora/iAS/Apache/Jserv/etc/jserv.properties

ApJServGroup DiscoGroup  1 1 /eb_rao1_q/applmgr/qatora/iAS/Apache/Jserv/etc/viewer4i.properties

#ApJServGroup FormsGroup  1 1 /eb_rao1_q/applmgr/qatora/iAS/Apache/Jserv/etc/forms.properties

ApJServGroup XmlSvcsGrp  1 1 /eb_rao1_q/applmgr/qatora/iAS/Apache/Jserv/etc/xmlsvcs.properties 

</IfDefine>

<IfDefine RESTRICT>

ApJServGroup OACoreGroup 4 1 /eb_rao1_q/applmgr/qatora/iAS/Apache/Jserv/etc/jserv_restrict.properties

</IfDefine>

# Set this directive when mode=auto, ignored in "on" and "off" modes.

# Mount point associated with group and zone

# Syntax: ApJServGroupMount /<mountpoint> balance://<groupname>/<zone>

# <mountpoint> is the name of the Apache URI path to mount jserv-url on

# <groupname> is one of the groups defined in the ApJServGroup directive

# <zone> (see documentation for more information on servlet zones)

# Default: NONE

# Example: ApJServGroupMount /servlet balance://group1/root

<IfDefine !RESTRICT>

ApJServGroupMount /servlet      balance://OACoreGroup/roottneda06n

</IfDefine>

ApJServGroupMount /servlets     balance://OACoreGroup/roottneda06n

<IfDefine !RESTRICT>

ApJServGroupMount /oa_servlets  balance://OACoreGroup/roottneda06n

ApJServGroupMount /jsp                 balance://OACoreGroup/roottneda06n

ApJServGroupMount /configurator balance://OACoreGroup/roottneda06n

ApJServGroupMount /mobile          balance://OACoreGroup/mobile

ApJServGroupMount /discoverer4i balance://DiscoGroup/viewer4i

#ApJServGroupMount /forms        balance://FormsGroup/forms

#ApJServGroupMount /emailcenter   balance://OACoreGroup/emailcenter

ApJServGroupMount /soap/servlet   balance://XmlSvcsGrp/soap

ApJServGroupMount /webservices    balance://XmlSvcsGrp/soap

ApJServGroupMount /dmsOACore         balance://OACoreGroup/roottneda06n

ApJServGroupMount /dmsDisco          balance://DiscoGroup/viewer4i

#ApJServGroupMount /dmsForms          balance://FormsGroup/forms

ApJServGroupMount /pricing          balance://OACoreGroup/roottneda06n

</IfDefine>

# Set this directive when ApJServManual mode=auto, ignored in "on" and "off" modes.

# Apache JServ secret key file relative to Apache root directory.

# Syntax: ApJServSecretKey [<groupname>] <secretkeyfilename|DISABLED>

# Without a group name, the secret key filename (or DISABLED) is used by

# all groups. If groupname is supplied as the first argument, then secret

# key is applied only to the specific group.The 1-arg and 2-arg syntaxes

# may NOT be combined. If using the 2-arg syntax, groups without a group

# specific secret key directive default to DISABLED.

# Default: DISABLED

# Warning: if authentication is DISABLED, everyone on this machine (not just

# this module) may connect to your servlet engine and execute servlet

# bypassing web server restrictions. See the documentation for more information

# Example: ApJServGroupSecretKey DISABLED

#     secret key disabled for all groups

# Example: ApJServGroupSecretKey /usr/local/apache/Jserv/etc/jserv.secret.key

#     secret key applied to all groups

# Example: ApJServGroupSecretKey group1

#                                /usr/local/apache/Jserv/etc/jserv.secret.key

#     specified secret key applied to group1

#ApJServGroupSecretKey /eb_rao1_q/applmgr/qatora/iAS/Apache/Jserv/etc/jserv.secret.key

ApJServGroupSecretKey /eb_rao1_q/applmgr/qatora/iAS/Apache/Jserv/conf/jserv.secret.key

ApJServLocalRouteAffinity ON