Deleting Governed Objects

For large-scale data, it takes a long time to delete all the governed objects with the ActiveMatrix entities using the UI. In such cases, to perform a bulk deletion of the governed objects, use the Governed Object Synchronization Utility. The utility is available under TIBCO_HOME\administrator\<version_number>\scripts\governance\util\sync.

Follow the steps listed here or in the readme.txt file available under TIBCO_HOME\administrator\<version_number>\scripts\governance\util\sync. You can delete all or specific governed objects. When you delete a top-level entity, the entity contained under it is also deleted. For example, if you delete the host, the node and applications are automatically deleted.

Prerequisites

Warning: This tool must be used only under the supervision of TIBCO Support.
If you want to delete a specific governed object, ensure that you are a super user.

Procedure

  1. Navigate to TIBCO_HOME\administrator\<version_number>\scripts\governance\util\sync.
  2. Copy syncAllGovObjs.jsp to TIBCO_HOME/config.home/tibcohost/Admin-amxadmin-instanceOne/data_<version_number>/nodes/SystemNode/work/jetty-govcommon-3.x.x-govcommon/.
  3. Optional: To delete all the governed objects, open http://<host>:<port>/govcommon/syncAllGovObjs.jsp.
    1. Click Delete All Governed Objects.
  4. To delete a specific ActiveMatrix entity, perform the following steps:
    1. Open http://<host>:<port>/amxadministrator/viewdata.jsp. The following table provides the name and link to access a specific ActiveMatrix entity:
      Entity Link
      Application http://<host>:<port>/amxadministrator/viewdata.jsp?objectType=Application&epackagename=AdminmodelPackage
      Environment http://<host>:<port>/amxadministrator/viewdata.jsp?objectType=Environment&epackagename=AdminmodelPackage
      Host http://<host>:<port>/amxadministrator/viewdata.jsp?objectType=Host&epackagename=AdminmodelPackage
      Node http://<host>:<port>/amxadministrator/viewdata.jsp?objectType=Node&epackagename=AdminmodelPackage
      Perform the following steps on syncAllGovObjs.jsp:
    2. Select the Entity Type.
    3. Specify the Entity Name.
    4. Specify the Entity ID.
    5. Click Deleted Selected Governed Object.
    On deleting a specific entity, notice that entities under it are automatically deleted.
  5. Restart MCR aggregator application after the steps are completed.
    Tracking Progress
    For larger deployment where the deletion takes some time to process, the progress can be tracked by using the SystemNode log. Look for the information logs for syncAllGovObjs.jsp. Enable the logger org.apache.jsp.syncAllGovObjs_jsp at INFO level on SystemNode. For example, [INFO ] [] org.apache.jsp.syncAllGovObjs_jsp - Governed Object synchronization completed . For a detailed information about the deleting governed objects, on the SystemNode, set com.tibco.governance.lifecycle to trace.

What to do next

After completing the procedure, remove the syncAllGovObjs.jsp file from TIBCO_HOME/config.home/tibcohost/Admin-amxadmin-instanceOne/data_<version_number>/nodes/SystemNode/work/jetty-govcommon-3.x.x-govcommon/.