The Tomcat tab enables you to configure the Apache Tomcat Server.
The Tomcat tab
You can download a preconfigured package for Tomcat support in the Add-On Packages topic.
The http.ini fields specific to configuration
of the Apache Tomcat Server are shown below. The Java section is detailed
below:
[Java] Home=##DWEBPRO_PATH##\engine\java
Java Home
Home
Java Home specifies the path that will
be used to set the JAVA_HOME environment
variable. Refer to the DWebPro Internal Constants for more information.
Accepted values: string
The Tomcat section is detailed below:
[Tomcat] ; Tomcat Engine settings Start=1 CatalinaHome=##DWEBPRO_PATH##\engine\tomcat CatalinaBase=##TEMP##\dwebpro\tomcat CatalinaOpts= CatalinaTmpDir= JavaEndorsedDirs= JavaOpts= JSSEHome= JPDAAddress= JPDATransport= DebugOpts= ClassPath=##ENV_CLASSPATH##;.;##DWEBPRO_PATH##\engine\tomcat\lib\servlet-api.jar;##DWEBPRO_PATH##\engine\tomcat\common\lib\jsp-api.jar;..;..\.. ; Network settings Port=8082 FindFreePort=1 ; Startup / Shutdown settings RunLocally=0 StartCommand=run StopCommand=stop ShowStartupTimeOutMessage=1 StartupTimeOut=10000 ShowShutDownTimeOutMessage=0 ShutDownTimeout=5000 ShowLog=0 ShutDownOnExit=1 ; File Copy settings ShowCopyProgressWindow=1 ClearOnShutDown=0 AskUserForClearOnShutDown=0 AskUserForClearOnShutDownDefaultButton=Yes ; Interactive Install settings UseInteractiveInstall=0 SpaceNeeded=0
Tomcat Engine settings
Start Tomcat
Start
Start Tomcat specifies whether the Tomcat
Server is started upon start up of DWebPro.
Accepted values: 0, 1
Catalina Home
CatalinaHome
Catalina Home specifies the path used
for the CATALINA_HOME environment
variable. Refer to the DWebPro Internal Constants topic for additional information on paths.
Accepted values: string
Catalina Base
CatalinaBase
Catalina Base specifies the path used
for the CATALINA_BASE environment
variable. The path specified must be on the user's file system, otherwise
Tomcat will not start correctly. Refer to the DWebPro Internal Constants topic for additional information
on paths.
Accepted values: string
Catalina Options
CatalinaOpts
Catalina Options specifies Tomcat startup/shutdown
parameters used by DWebPro. To use this field correctly, please refer
to the official Tomcat documentation, available online at: http://tomcat.apache.org.
Accepted values: string
Catalina Temp Dirs
CatalinaTmpDir
Catalina Temp Dir specifies Tomcat startup/shutdown
parameters used by DWebPro. To use this field correctly, please refer
to the official Tomcat documentation, available online at: http://tomcat.apache.org.
Accepted values: string
Java Endorsed Dirs
JavaEndorsedDirs
Java Endorsed Dirs specifies Tomcat startup/shutdown
parameters used by DWebPro. To use this field correctly, please refer
to the official Tomcat documentation, available online at: http://tomcat.apache.org.
Accepted values: string
Java Options
JavaOpts
Java Options specifies Tomcat startup/shutdown
parameters used by DWebPro. To use this field correctly, please refer
to the official Tomcat documentation, available online at: http://tomcat.apache.org.
Accepted values: string
JSSE Home
JSSEHome
JSSE Home specifies Tomcat startup/shutdown
parameters used by DWebPro. To use this field correctly, please refer
to the official Tomcat documentation, available online at: http://tomcat.apache.org.
Accepted values: string
JPDA Address
JPDAAddress
JPDA Address specifies Tomcat startup/shutdown
parameters used by DWebPro. To use this field correctly, please refer
to the official Tomcat documentation, available online at: http://tomcat.apache.org.
Accepted values: string
JPDA Transport
JPDATransport
JPDA Transport specifies Tomcat startup/shutdown
parameters used by DWebPro. To use this field correctly, please refer
to the official Tomcat documentation, available online at: http://tomcat.apache.org.
Accepted values: string
Debug Options
DebugOpts
Debug Options specifies Tomcat startup/shutdown
parameters used by DWebPro. To use this field correctly, please refer
to the official Tomcat documentation, available online at: http://tomcat.apache.org.
Accepted values: string
Class Path
ClassPath
Class Path specifies the path used for
the CLASS_PATH environment variable.
Refer to the DWebPro Internal Constants topic for
additional information on paths.
Accepted values: string
Network settings
Port
Port
Port specifies the port on which the
Apache Tomcat server listens.
Accepted values: integer
Find Free Port
FindFreePort
Find Free Port specifies whether DWebPro
should search for a free port on which to start the Tomcat server.
Accepted values: 0, 1
Startup / Shutdown settings
Run Locally
RunLocally
Run Locally specifies whether DWebPro
should copy files to the user's file system for running Tomcat. Selecting
this option (1), bypasses the copy process and
runs Tomcat locally. Note that you can run locally only when you run
DWebPro from a hard drive or other writable media. Using this option
can be useful during the development phase. Keep in mind that when
you use this option, you should change the Catalina Base field to something like ##DWEBPRO_PATH##\engine\tomcat.If you want to run your Web application on CD/DVD, you must
not select this option (0).
Accepted values: 0, 1
Start Command
StartCommand
Start Command specifies the parameter
used in
catalina.bat to start the Tomcat server. Accepted values: string
Stop Command
StopCommand
Stop Command specifies the parameter
used in
catalina.bat to stop the Tomcat server. Accepted values: string
Show Startup Timeout Message
ShowStartupTimeOutMessage
Show Startup Timeout Message specifies
whether DWebPro prompts the user whether to wait for Tomcat to complete
its startup initialization.
Accepted values: 0, 1
Startup Timeout
StartupTimeOut
Startup Timeout specifies the timeout
allowed, in milliseconds, for Tomcat to startup. DWebPro waits the
amount of time specified here before continuing the initialization
process. If the Show Startup Timeout Message option is selected, DWebPro prompts the user whether to wait for
Tomcat to complete its startup initialization.
Accepted values: integer
Show Shutdown Timeout Message
ShowShutDownTimeOutMessage
Show Shutdown Timeout Message specifies
whether DWebPro prompts the user before closing Tomcat due to a shutdown
timeout.
Accepted values: 0, 1
Shutdown Timeout
ShutDownTimeout
Shutdown Timeout specifies the timeout,
in milliseconds, before closing Tomcat. If the Show Shutdown
Timeout Message option is selected, DWebPro prompts the
user whether to wait for Tomcat to complete its shutdown process.
Accepted values: integer
Show Tomcat Logs (startup/shutdown)
ShowLog
Show Tomcat Logs (startup/shutdown) specifies
whether DWebPro displays the Tomcat startup/shutdown messages. Using
this option is helpful during development.
Accepted values: 0, 1
Shutdown on Exit
ShutDownOnExit
Shutdown on Exit specifies whether the
Tomcat server should be closed upon DWebPro shutdown.
Accepted values: 0, 1
dd File Copy settings
Show Copy Progress Window
ShowCopyProgressWindow
Show Copy Progress Window specifies whether
the progress window displays during file copy routines.
Accepted values: 0, 1
Clear on Shutdown
ClearOnShutdown
Clear on Shutdown specifies whether DWebPro
should delete the files copied to the user's file system prior to
closing.
Accepted values: 0, 1
Ask User for Clear on Shutdown
AskUserForClearOnShutDown
Ask User Clear on Shutdown specifies whether DWebPro
prompts the user to confirm the deletions of the files in the destination
directory prior to closing.
Accepted values: 0, 1
Default Button
AskUserForOverwriteDefaultButton
Default Button specifies the default
button on the confirmation form for files deletion.
Accepted values: Yes, No
Interactive Install settings
Use Interactive Install
UseInteractiveInstall
Use Interactive Install specifies whether
DWebPro should use the Interactive Install procedure. Refer to the Interactive Install Workflow topic for more information.
Accepted values: 0, 1
Space Needed
SpaceNeeded
Space Needed specifies the needed space
for the copy. Use the drop-down box to the right of this field to
specify the units of space desired. This option is relevant only when
using the Use Interactive Install option. Refer
to the Interactive Install Workflow topic for more
information.
Accepted values: integer
DWebPro copies the following folder into the folder specified in the Catalina Base field:
-
CatalinaHome\webapps
-
CatalinaHome\conf
-
CatalinaHome\logs
-
CatalinaHome\shared
-
CatalinaHome\work
-
CatalinaHome\temp
-
Create an XML file (for example,
dwebpro_root.xml) in the deploy\engine\tomcat\conf\Catalina\localhost folder. This file should contain content such as the following:<?xml version='1.0' encoding='utf-8'?> <Content displayName="dwebpro_project" docBase="${dwebpro.root}" path="/dwebpro_root" workDir="work\Catalina\localhost\dwebpro_root"> </Context> -
Change the Java Options field as follows:
JavaOptions=-Ddwebpro.root=##DWEBPRO_PATH##\www
-
Put all of your webapp Tomcat files in the ##DWEBPRO_PATH##\www folder.