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.

For information, see general_options section in The tcman command.

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