Unsupported content

 

This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Updating JAR files to use the Health Dashboard

To use the BMC Atrium Orchestrator Health Dashboard you must replace some JAR files in your BMC Atrium Orchestrator Platform environment.

Warning

You must update the JAR files on every peer in your BMC Atrium Orchestrator Platform environment, except the repository and Operator Control Panel. If you update the JAR files on one peer and not all peers in your environment, the peers will fail to communicate, which can cause grid failure.

Before you begin

Back up the following existing JAR files for each peer in your BMC Atrium Orchestrator Platform environment, except the repository and Operator Control Panel. For most peers, the JAR files are located in the <BAOinstallationDirectory>/tomcat/webapps/<peer>/WEB-INF/lib directory. For the Development Studio peer, the JAR files are located in the <DevelopmentStudioInstallationDirectory>/configuration/org.eclipse.osgi/bundles/5/1/.cp/lib directory.

  • api-7.7.02.jar
  • foundation-7.7.02.jar
  • models-7.7.02.jar

To replace the JAR files

  1. Create a directory in which to download the patch file.
  2. Download the 7702-healthdashboard-patch.zip file from BMC Communities.
  3. Unzip the 7702-healthdashboard-patch.zip file. It contains the following JAR files:
    • api-7.7.02.jar
    • foundation-7.7.02.jar
    • models-7.7.02.jar
  4. If you have not made a backup of the existing versions of these JAR files for each peer in your environment, back them up now (Before you begin).
  5. For the Development Studio peer, complete the following steps:
    1. Shut down Development Studio.
    2. Replace the existing JAR files in the <DevelopmentStudioInstallationDirectory>/configuration/org.eclipse.osgi/bundles/5/1/.cp/lib directory with the new JAR files. 
    3. Restart Development Studio.

  6. For each remaining peer in your BMC Atrium Orchestrator Platform environment (except the repository and Operator Control Panel), complete the following steps:
    1. Stop the peer server.
    2. Replace the existing JAR files in the <BAOinstallationDirectory>/tomcat/webapps/<peer>/WEB-INF/lib directory with the new JAR files. 
    3. Restart the peer server.

After completing these steps, install the dashboard files, as described in Installing the dashboard.

Related topics

Health Dashboard

Was this page helpful? Yes No Submitting... Thank you

Comments

  1. Robin Elliott

    Installing these jar files in my Grid, made testing workflows in Developer Studio fail 100% of the time.  The Developer Studio grid.log showed re-occurring errors related to missing code pieces for this enhancement:

    02 Nov 2014 19:32:47,427 WARN JmsMessageListener : Unexpected error occurred when processing JMS message.
    com.realops.foundation.gridframework.JmsMessageConversionFailedException: javax.jms.JMSException: Failed to build body from bytes. Reason: java.io.InvalidObjectException: Unknown health metric: PRODUCT_VERSION

    These instructions need to be updated to include the step to copy these files into the following Developer Studio folder, replacing the existing files.

    <DevStudioInstallationDirectory>\configuration\org.eclipse.osgi\bundles\5\1\.cp\lib

     

    Nov 02, 2014 09:47
    1. Dorothy Poole

      Thank you for this comment. I'm following up with the development team and will address this when I have confirmation.

      Nov 03, 2014 06:05
    1. Dorothy Poole

      Hi Robin,

      Thank you for pointing this out. I've verified this with the development team and updated the information on the page.

      Nov 04, 2014 12:12