Creating instances with TCMAN

Before you can create an instance of the Progress Application Server (PAS) using the TCMAN command line utility, you must:

Install the core Progress Application Server

Install JDK or JRE version 1.7 or later

Set the JAVA_HOME or JRE_HOME environment variable to the JDK/JRE install directory .

Note: TCMAN is a Progress extension of the basic Tomcat administrative utilities. TCMAN simplifies instance creation and management.

An instance runs the Tomcat executable of a core PAS, but it runs in a separate JVM, is configured with its own unique ports, and other properties. (You should not attempt to use the installed, core PAS as a development or production server.) Instances allow you to run a variety of server configurations without corrupting the files in the core server. They also allow you to update the core server without re-deploying or re-configuring your Web applications.

To create an instance using the TCMAN utility:

1. Open a command shell and navigate to $CATALINA_HOME/bin.

$CATALINA_HOME is the directory where you installed the core Progress Application Server.

2. Run tcman.sh create basepath (or tcman.bat on Windows systems) .

The base_path parameter specifies the path name where you will create the instance. It is the only required parameter for the create action. If you are creating multiple running instances, you should override the default port assignments by specifying the following parameters:

–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.

You can also activate these ports:

–s port_num	Specify the TCP port to use to stop an instance. (Required on Windows systems, optional on UNIX )
–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. (Optional on both Windows and UNIX systems)

See Create an instance (create) for information about other parameters.

3. (Optional) Deploy remote management applications from $CATALINA_HOME/extras to the instance.

Remote management applications are not pre-installed, and installing them is a security decision. For example, you might want to eliminate access to the configuration and control of instances by not deploying management applications to production servers, while deploying management applications to development servers.

To deploy a management application:

a. Open a command shell and navigate to $CATALINA_BASE/bin.

b. Run tcman.sh deploy '$CATALINA_HOME/extras/admin_webapp.war'.

The admin_webapp.war can be one of the following:

host-manager.war	A Tomcat administration application used to get server information and provide other functionality. It should not be necessary to deploy host-manager.war if you are using the TCMAN utilities.
manager.war	A Tomcat administration application which you must deploy in order to run some TCMAN actions. See the TCMAN Reference material for information on which TCMAN actions require deployment of manager.war.
Progress applications	Progress products can have web applications that enable the use of their own administrative tools.

For example the following command line creates an instance of /psc/pashome in /psc/acme1 and specifies its ports:

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