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.
Before you begin
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
- Navigate to TIBCO_HOME\administrator\<version_number>\scripts\governance\util\sync.
- Copy syncAllGovObjs.jsp to TIBCO_HOME/config.home/tibcohost/Admin-amxadmin-instanceOne/data_<version_number>/nodes/SystemNode/work/jetty-govcommon-3.x.x-govcommon/.
- To delete all the governed objects, open
http://<host>:<port>/govcommon/syncAllGovObjs.jsp
.- Click Delete All Governed Objects.
- To delete a specific ActiveMatrix entity, perform the following steps:
- Open
http://<host>:<port>/amxadministrator/viewdata.jsp. The following table provides the name and link to access a specific ActiveMatrix entity:
Perform the following steps on syncAllGovObjs.jsp: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 - Select the Entity Type.
- Specify the Entity Name.
- Specify the Entity ID.
- Click Deleted Selected Governed Object.
On deleting a specific entity, notice that entities under it are automatically deleted. - Open
http://<host>:<port>/amxadministrator/viewdata.jsp. The following table provides the name and link to access a specific ActiveMatrix entity:
- Restart MCR aggregator application after the steps are completed.
Tracking ProgressFor 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 forsyncAllGovObjs.jsp
. Enable the loggerorg.apache.jsp.syncAllGovObjs_jsp
atINFO
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, setcom.tibco.governance.lifecycle
totrace
.
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/.