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.