Deleting a deployed solution

Edit online
Draft comment:
This topic is shared by BAW, CP4BA. Last updated on 2025-03-13 12:15
You can delete a deployed solution folder contents from the target object store by using the Case administration client.

About this task

Important: It is critical that a full backup of the environment is taken before deleting a solution. This includes a backup of IBM® Business Automation Workflow, Content Platform Engine, and/or IBM Content Navigator.
The following procedure deletes only the specified solution and any associated contents in the target object store. The objects that are removed in the target object store include the following:
  • Solution folder and all child folders and objects in the object store.
  • Case type folder, Case folders, activity objects, process instances, document references, and so on.
  • Class definitions associated with the solution.
  • Case type class definitions, activity definitions.
  • The subscriptions associated with the solution.
Artifacts that are not removed:
  • Content Platform Engine workflow system artifacts - Application space, event logs, queues, rosters, and so on
  • Documents filed in Cases - References are removed from the case folders. You can still find the documents if they are filed in folders outside of the solution or in the unfiled folder.
  • Events that are associated with cases and activity tasks - Content Platform Engine events and workflow system events are not removed.
  • Events that are published for analytics
    • Events in reporting tools such as Case Analyzer, Case History, or Business Automation Insights through Case Emitter are not removed.
    • Inaccurate reporting due to missing events for certain cases and/or activity processes.
  • Before deleting a deployed solution in the Business Automation Workflow case administration application (BAWAdmin), ensure that the solution manifest has been applied to the deployed solution. Additionally, the user performing the deletion must have the “Manage Case” permissions. For more information, see Privilege definition reference
As there are still artifacts that remain, deleting a solution is not recommended, as doing so can result in reference issues. Deleting a solution is also not recommended if the reporting tools like Case Analyzer, Case Emitter, or Case History Visualizer are used as these tools cannot work accurately after a solution is deleted. After deleting the solution, you can no longer interact or see the solution, cases, or work items related to the solution in case client at run-time. The Content Platform Engine server should be restarted after deleting a deployed solution, in case you plan to redeploy the solution to the same environment.

Procedure

To delete a deployed solution:

  1. Using the BAWAdmin select Target Object Store > Deployed Solutions.
  2. From the Solutions page on the right side, select the solution that you want to remove.
  3. Click Actions > Remove deployed solution.