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.

Prerequisites

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

  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 synchronize all the governed objects with the ActiveMatrix entities, open http://<host>:<port>/govcommon/syncAllGovObjs.jsp.
    1. Click Synchronize All AMX Entities.
  4. Optional: To synchronize 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 Synchronize Selected AMX Entity.
    On synchronizing a specific entity, notice that all the entities under it are automatically synchronized.
  5. Restart MCR aggregator application after the synchronization steps are completed.
    Tracking Progress
    For 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 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 on synchronizing 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/.