skip to main content
TCMAN Reference : Server actions : Create an instance (create)
 

Create an instance (create)

Purpose

Create a new instance of the core PAS server by running this action from /bin directory of the core server ( $CATALINA_HOME/bin/tcman.sh create).

Syntax

tcman.sh create [general_options][-f][–p port_num] [-P port_num]
[-s port_num] [-j port_num] [-W pathname] [-N instance_name]
[-U user_id ] [–G group_id] base_path

Parameters

general_options
Specify one or more of the general TCMAN options. Run tcman.sh help create to see which general options are appropriate.
–f
Copy all deployed web application archives (.war files) from $CATALINA_HOME to the new instance.
–p port_num
Specify the TCP port that listens for HTTP messages. The default is 8080.
–P port_num
Specify the TCP port that listens for HTTPS messages. The default is 8443.
–s port_num
Specify the TCP port to use to stop an instance. On Windows systems, you must specify a shutdown port. On UNIX, shutdown ports are optional.
–j port_num
Specify the TCP port that listens for AJP13 messages (an Apache protocol for handling requests from a web server to an application server). The default is 8009.
–W pathname
Specify the directory where web applications will be deployed. The default is $CATALINA_BASE/webapps.
–N instance_alias
Specify an alias for the instance. If you do not specify an alias, the instance name will be the name of the directory where the instance is created.
All instances are automatically registered for tracking when they are created. However, for tracking to function, the instance name must not contain spaces or any of the following characters: "[ . # | ] $ ? + = { / , }"
–U user_id
Specify the user-id of the owner of all the files and directories of the instance. The default is the user-id of the current process. –G must be specified if you use this option.
–G group_id
Specify the group-id of the owner of all the files and directories of the instance. The default is the group-id of the current process. –U must be specified if you use this option.
base_path
Specify the pathname where you will create the instance.

Example

Create an instance of /psc/pashome in /psc/acme1:
$: /psc/pashome/bin/tcman.sh create -p 8501 -P 8601 -s 8701 /psc/acme1
Server instance acme1 created at /psc/acme1