manageTemplates.py command

Use the manageTemplates.py administrative script to start, or stop, process and task templates that belong to a particular application. It can also uninstall BPEL applications and human task applications.

Prerequisites

The following conditions must be met:
  • Run the script in connected mode, that is, do not use the wsadmin -conntype none option.
  • At least one cluster member must be running.
  • If your user ID does not have administrator authority, include the wsadmin -user and -password options to specify a user ID that has administrator authority.
  • If you are not working with the default profile, use the wsadmin -profileName profile option to specify the profile.

Location

The manageTemplates.py administrative script is in the Business Process Choreographer admin directory.
For Windows operating systeminstall_root\ProcessChoreographer\admin
For Linux operating systemFor UNIX operating systeminstall_root/ProcessChoreographer/admin

Syntax

wsadmin -f manageTemplates.py
  -stop application_name
  -start application_name
  -uninstall BPEL_application_name [-force]
Remember: If the Business Process Choreographer admin directory is not your current directory and is not on your search path, you must specify the full path to the manageTemplates.py script.

Parameters

-stop application_name
Stops all templates that belong to the named application.
-start application_name
Starts all templates that belong to the named application.
-uninstall application_name
This parameter specifies the name of the BPEL application or human task application to be uninstalled.
Important: Do not use this option for applications that were deployed by the Process Center. The related business-level applications are not uninstalled. You must uninstall related business-level applications manually before you can delete the whole snapshot with BPMDeleteSnapshot. For more information, see BPMDeleteSnapshot command.
-force
This option causes any running instances to be stopped and deleted before the application is uninstalled. Use this option with care because it also deletes all of the data that is associated with the running instances.

Example: Starting an application

The following example illustrates how to start the process and task templates that belong to the application, application_name.
For Windows operating systemwsadmin -f manageTemplates.py -start application_name
For Linux operating systemFor UNIX operating systemwsadmin.sh -f manageTemplates.py -start application_name

Example: Stopping an application

The following example illustrates how to stop the process and task templates that belong to the application, application_name.
For Windows operating systemwsadmin -f manageTemplates.py -stop application_name
For Linux operating systemFor UNIX operating systemwsadmin.sh -f manageTemplates.py -stop application_name

Example: Uninstalling a BPEL application

The following example illustrates how to uninstall the BPEL application, application_name.
For Windows operating systemwsadmin -f manageTemplates.py -uninstall application_name
For Linux operating systemFor UNIX operating systemwsadmin.sh -f manageTemplates.py -uninstall application_name