skip to main content
TCMAN Reference : Server actions : Start an instance (start)
 

Start an instance (start)

Purpose

Start an instance of a PAS, optionally in debug mode.

Syntax

tcman.sh start [general_options] [-D|-J]

Parameters

general_options
Specify one or more of the general TCMAN options. Run tcman.sh help start to see which general options are appropriate.
-D
Start the server in Tomcat debug mode. –D overrides the –J option.
-J
Start the server in debug mode using the JDPA (Java Platform Debugger Architecture) APIs for debugging. –J cannot be used if the –D option is specified.
Before you run a server with the –J option, you must define a port for the JDPA debugger by setting the JDPA_ADDRESS environment variable to a unique TCP network port number.

Example

Start the server in /psc/acme1, which is an instance of the core server in /psc/pashome:
/psc/acme1/bin/tcman.sh start
Using CATALINA_BASE: /psc/acme1
Using CATALINA_HOME: /psc/pashome
Using CATALINA_TMPDIR: /psc/acme1/temp
Using JRE_HOME: /tools/linuxx86_64/java64/jdk1.7.0_02/
Using CLASSPATH: /psc/pashome/bin/bootstrap.jar:/psc/pashome/bin/tomcat-juli.jar
Using CATALINA_PID: /psc/acme1/temp/catalina.pid

Notes

*When the TCMAN utility starts the server, it verifies the creation of the OS process and then records the server's process-id in a .pid file. The location of the .pid file is:
OS
PID File Path
UNIX
$CATALINA_BASE/temp/catalina-instance_name.pid
Windows
$CATALINA_BASE\logs\catalina-instance_name.pid
*You can obtain the process id of a server by running the TCMAN env action.