Try OpenEdge Now
skip to main content
Administration Guide
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] [-m uid:pwd] [-W pathname] [-N instance_name]
[-U user_id ] [–G group_id] [-Z {prod | dev}] 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.
-m uid:pwd
Specify a user name and password that will be required to access Tomcat container-level security, which includes the manager and oemanager web applications. Replaces the defaults (tomcat:tomcat) in /conf/tomcat-users.xml.
–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.
-Z {dev | prod}
Specify the security model of the instance to development (dev) or secure (prod).
A typical use of this option is for testing web applications in a secure server environment before packaging and deploying.
Note: The -Z prod option does not create a production server. To actually create a production server, you must have a production server license.
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