Synchronizing Governed Objects
For large-scale data, it takes a long time to synchronize all the governed objects with the ActiveMatrix entities using the UI. In such cases, to perform a bulk synchronization 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 synchronize all or specific governed objects. When you synchronize a top-level entity, the entity contained under it is also synchronized. For example, if you synchronize the host, the node and applications are automatically synchronized.
Before you begin
Warning: This tool must be used only under the supervision of TIBCO Support.
If you want to synchronize a specific ActiveMatrix entity, 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 synchronize all the governed objects with the ActiveMatrix entities, open
http://<host>:<port>/govcommon/syncAllGovObjs.jsp
.- Click Synchronize All AMX Entities.
- To synchronize 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 Synchronize Selected AMX Entity.
On synchronizing a specific entity, notice that all the entities under it are automatically synchronized. - 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 synchronization steps are completed.
Tracking ProgressFor larger deployment where the synchronization 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 on synchronizing 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/.