BPMUpdateSystemApp command

The BPMUpdateSystemApp command applies interim fixes to toolkits and process apps. This command must only be used if you are directed to use it by IBM Software Support or by the instructions in an interim fix file. Before running the command, read the instructions included with the interim fix.

The BPMUpdateSystemApp command is run using the AdminTask object of the wsadmin scripting client.

Prerequisites

The following conditions must be met:

Run the command in disconnected mode; that is, with the server stopped. Use the -conntype none option.
Run the command on the deployment manager node.
To avoid out-of-memory problems, add the following options when you start the wsadmin command: -javaoption -Xms256m -javaoption -Xmx1024m. The default Java virtual machine settings for the memory allocation pool (-Xmx) and maximum heap size (-Xms) are sometimes not large enough for running the BPMUpdateSystemApp command.

Location

Start the wsadmin scripting client from the install_root/profiles/deployment_manager_profile/bin directory.

Syntax

BPMUpdateSystemApp 
-twxFile full_path_of_the_updated_system_.twx_file
[ -clusterName cluster_name ]

Parameters

-twxFile path_to_twx_file: A required parameter that identifies the full path of the .twx file that Installation Manager updated when an interim fix was applied. The snapshot of the project in the package.xml is used to update the corresponding snapshot in the database. See the readme documentation for the interim fix for the name of the .twx file to use with this parameter.
-clusterName cluster_name: The name of the cluster to update, where Process Center or Process Server is configured. For a network deployment environment, you must specify either this parameter or the -nodeName and -serverName parameters.

Example for a stand-alone server

In this example, you apply an interim fix to the database for a stand-alone server. After you use Installation Manager to install an interim fix, the .twx file in this path is updated: install_root/BPM/Lombardi/imports. The following commands show you how to use that updated file to apply the interim fix to the database.

wsadmin -lang jython -conntype none -javaoption -Xms256m -javaoption -Xmx1024m

wsadmin>AdminTask.BPMUpdateSystemApp( ['-twxFile', 'install_root/BPM/Lombardi/imports/system-toolkit.twx' ] )

Example for a network deployment environment

In this example, you apply an interim fix to the database for a network deployment environment. After you use Installation Manager to install an interim fix, the .twx file in this path is updated: install_root/BPM/Lombardi/imports. The following commands show you how to use that updated file to apply the interim fix to the database.

wsadmin -lang jython -conntype none -javaoption -Xms256m -javaoption -Xmx1024m

wsadmin>AdminTask.BPMUpdateSystemApp( [ '-twxFile', 'install_root/BPM/Lombardi/imports/system-toolkit.twx', '-clusterName', 'PC_clusterName' ] )

Applying an interim fix

To apply an interim fix using BPMUpdateSystemApp when you are directed to use it by IBM Software Support or by the instructions in an interim fix file, follow these steps:

Use Installation Manager to install an interim fix into the install_root path.
If under one installation you created multiple application clusters that point to a different Process database server, use the command to apply the interim fix to those clusters one by one. To apply an interim fix to a cluster, you can use one member of the cluster.
If the interim fix requires a profile upgrade (as stated in the post-IM installation steps section of the interim fix readme file), you must run the profile upgrade command before you run the BPMUpdateSystemApp command to update the toolkits or process apps.
Switch to the /bin directory of a profile.
Run the wsadmin command and pass the path of the .twx file that was changed by the interim fix. See the interim fix readme for the name of the .twx file to use for the -twxFile parameter.

Rolling back an interim fix

To roll back an interim fix, follow these steps:

Use Installation Manager to uninstall an interim fix from the install_root.
If under one installation you created multiple profiles, use the wsadmin command to roll back the interim fix against those profiles one by one.
If the interim fix requires a profile upgrade (as stated in the post-IM installation steps section of the interim fix readme file) as part of the uninstallation procedure, you must run the profile upgrade command before you run the BPMUpdateSystemApp command to roll back the toolkits or process apps.
Switch to the /bin directory of a profile.
Run the wsadmin command and pass the path of the .twx file that was changed by the interim fix. See the interim fix readme for the name of the .twx file to use for the -twxFile parameter.