Upgrading the Monitoring Agent web service

The Monitoring Agent web service Role runs as (part of) a web application. Either redeploy the web application, or update its resources. The Monitoring feature is deprecated as of SDL Tridion Sites 9.1.

Procedure

  1. On the installation media, go to Content Delivery\roles\monitoring\agent-service\webapp\war\.
  2. If your Monitoring Agent web service runs as a standalone web application that you did not change, stop it and deploy the monitoring.war file from the installation media instead of it.
  3. Alternatively, if your Monitoring Agent web service runs inside of a larger web application or if you changed the web application, unpack monitoring.war and do the following:
    1. In the WEB-INF/lib/ folder, add the following files from the monitoring.war on the installation media:
      • animal-sniffer-annotations-1.17.jar
      • checker-qual-2.5.2.jar
      • error_prone_annotations-2.2.0.jar
      • failureaccess-1.0.1.jar
      • j2objc-annotations-1.1.jar
      • javax.annotation-api-1.3.2.jar (if upgrading from SDL Web 8.5)
      • jsr305-3.0.2.jar
      • listenablefuture-9999.0-empty-to-avoid-conflict-with-guava.jar
    2. In the WEB-INF/lib/ folder, update the following resources (if present) with new ones from the monitoring.war on the installation media, where VERSION represents any version number:
      Old fileNew file
      guava-18.0.jar guava-27.1-jre.jar
      jcl-over-slf4j-VERSION.jar jcl-over-slf4j-1.7.26.jar
      log4j-over-slf4j-VERSION.jar log4j-over-slf4j-1.7.26.jar
      logback-classic-1.1.7.jarlogback-classic-1.2.3.jar
      logback-core-1.1.7.jarlogback-core-1.2.3.jar
      slf4j-api-VERSION.jar slf4j-api-1.7.26.jar
      monitor-data-8.5.0-1014 udp-monitor-data-11.1.0-VERSION.jar
      udp-monitor-data-11.0.0-1025.jar udp-monitor-data-11.1.0-VERSION.jar
      wsdl4j-1.6.2.jar wsdl4j-1.6.3.jar

      where VERSION is a number indicating the specific build of this JAR.

    3. Replace or merge the following files:
      • WEB-INF/web.xml
      • WEB-INF/server-config.wsdd
      • META-INF/MANIFEST.MF
  4. Restart the web application.