inspectIT 1.3 Upgrade Guide

This document helps you upgrading an existing installation of inspectIT with version 1.2.2 to 1.3. For a new installation please have a look at the Installation Guide.

How to install the new version?

  • Extract the complete releases for agent, CMR and UI. Do not try to only copy selected artefacts to the old installation (This is for sure possible, but can lead to many problems)
  • Especially: Do not re-use the startup scripts for the CMR as this script has changed
  • Note that the licence files for 1.2.1 still work for 1.3

Things that still work, but differently

  • The CMR still work exactly the same but the memory handling is changed.

Necessary adaptations

  • The communication port the agent uses to contact the CMR changed from 1099 to 9070. You must therefore change your inspectit-agent.cfg file and change the repository definition.
  • As inspectIT 1.3 now support Core classes instrumentation, you need to add the -Xbootclasspath option to your application. Please see the core class instrumentation page for more details.
  • inspectIT 1.3 now comes with a new "simple mode" for the exception sensor. This necessitates that in all case the exception sensor must be defined in the agent configuration (see this page for more information: Exception Sensor)