Running the StarTeam Web Server as a Windows Service

This topic describes how to set up and run the StarTeam Web Server as a Windows Service.

Setting up the StarTeam Web Server as a Windows Service

If you are running the StarTeam Web Server as a Microsoft Windows service, you must first change the following parameters in the file StarTeamService32.bat for 32-bit installations or StarTeamService64.bat for 64-bit installation:

  1. JvmMx - The maximum memory provided to the StarTeam Web Server in MB.The default value is 4096.
  2. Startup - auto/manual - Determines if the Microsoft Windows service will start up automatically or manually. The default value is auto.
  3. Prior to running StarTeamService.bat, set the CATALINA_HOME environment variable on Microsoft Windows to point to <Install Directory>.
  4. To set up the StarTeam Web Server as a Microsoft Windows service, run <Install Directory>/StarTeamService32.bat or <Install Directory>/StarTeamService64.bat.

To remove the StarTeam Web Server as a Microsoft Windows service, run <Install Directory>/service.bat remove located in the installation folder.

For more information, see the Tomcat documentation.

Back to top

Setting environment variables for Tomcat

The setenv.bat command is used to modify or set environment variables for the Tomcat application server. These setting only apply when using the catalina.bat or startup.bat methods for starting the tomcat application server.

The primary environment variables used by Tomcat are:

Variable Description
CATALINA_HOME The Catalina build directory.
CATALINA_BASE (Optional) Base directory for resolving dynamic portions of a Catalina installation. If not present, resolves to the same directory that CATALINA_HOME points to.
CATALINA_OPTS (Optional) Java runtime options used when the start, or run command is executed.
CATALINA_TMPDIR (Optional) Directory path location of temporary directory the JVM should use (java.io.tmpdir). Defaults to %CATALINA_BASE%\temp.
JAVA_HOME Must point to your Java Development Kit installation. Required to run the with the debug argument.
JRE_HOME Must point to your Java Runtime installation. Defaults to JAVA_HOME if empty.
JAVA_OPTS (Optional) Java runtime options used when the start, stop, or run command is executed.
JSSE_HOME (Optional) May point at your Java Secure Sockets Extension (JSSE) installation, whose JAR files will be added to the system class path used to start Tomcat.
JPDA_TRANSPORT (Optional) JPDA transport used when the jpda start command is executed. The default is dt_shmem.
JPDA_ADDRESS (Optional) Java runtime options used when the jpda start command is executed. The default is dbconn.
JPDA_SUSPEND (Optional) Java runtime options used when the jpda start command is executed. Specifies whether JVM should suspend execution immediately after startup. Default is n.
JPDA_OPTS (Optional) Java runtime options used when the jpda start command is executed. If used, JPDA_TRANSPORT, JPDA_ADDRESS, and JPDA_SUSPEND are ignored. Thus, all required jpda options MUST be specified. The default is: 
-Xdebug 
-Xrunjdwp:transport=%JPDA_TRANSPORT%, address=%JPDA_ADDRESS%,server=y,suspend=%JPDA_SUSPEND%

StarTeam Defaults

The following are the StarTeam Web Server defaults:

Variable Description
JPDA_TRANSPORT dt_socket
JPDA_ADDRESS 8000
JPDA_SUSPEND y
JAVA_OPTS 
JAVA_OPTS=-Xmx4096M -Dcom.borland.configdir="%CATALINA_HOME%\shared\lib" -Djava.library.path="%CATALINA_HOME%\shared\lib"
JRE_HOME C:\Program Files\Micro Focus\StarTeam 16 Web Server\jre

Back to top

Manually install the Tomcat service

To manually install Tomcat as a service, use service.bat provided by Apache Tomcat. You must have administrator privileges in order to run this script.

Note: On Microsoft Windows Vista or any other operating system with User Account Control (UAC) you must either disable UAC or right-click on cmd.exe and select Run as administrator in order to run this script. If UAC is enabled, being logged on with an Administrator account is not sufficient.

Script Options

Install Install the service using Tomcat as service name. Service is installed using default settings.
Remove Remove the service from the system.
Name (Optional) If the second argument is present it is considered to be a new service name.
Default Service Name tomcat
Default Display Name Apache Tomcat

Back to top