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
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.
