This topic applies only to the IBM Business Automation Workflow Advanced configuration.

manageTemplates.py command

Edit online
Draft comment:
This topic only applies to BAW, and is located in the BAW repository. Last updated on 2025-03-13 12:15
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

For Linux operating systemFor UNIX operating systeminstall_root/bin/wsadmin.sh 
For Windows operating systeminstall_root\bin\wsadmin
 -f manageTemplates.py
  -stop application_name
  -start application_name
  -uninstall BPEL_application_name [-force][-wait seconds]
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

-f
This parameter specifies the script file to run.
-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 Workflow 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.
-wait seconds
This option allows you to define a custom wait time in seconds so you can verify whether the application disappeared from the installed application list after a successful uninstallation. If no parameter is defined, the default wait time of 5 seconds is used.

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