Integration Server Pre-Upgrade Analyzer

Knowledge base
, ,
#1

The Pre-Upgrade Analyzer analyzes your old Integration Server installation and generates reports that list the following:

  • Custom services using built-in services that were deprecated, removed, or changed in a later release. Full details about each deprecation, removal, or change is available in the Integration Server readme.
  • Custom packages using custom services or documents that do not exist.
  • Custom assets that are not used by any of your existing integrations.
  • Custom services using Integration Server debug services (pub.flow:debugLog, pub.flow:savePipelineToFile).

Supported Product Versions

Integration Server - 6.0 → 10.7

Supported Operating Systems

AIX, Linux ,macOS, Solaris, Windows

Download and Installation

  1. Download the analyzer into any directory and unzip the archive.
  2. Go to the wxanalyze-project.properties file, open it in a text editor, and set the user-defined properties.
  3. Make sure you have write access to the temp directory set on the wx.analyzer.tempdir property (by default, ./temp/).
  4. Go to the directory into which you unzipped the archive and run the command bat [wxanalyze.log].

By default, the Pre-Upgrade Analyzer outputs activity messages to the console. The wxanalyze.log options lets you persist the activity messages instead.

By default, the analyzer logs activity messages at the INFO log level to standard out/console. If the analyzer experiences any failures, it logs entries starting with WARN or ERROR. If you want to change the log level to DEBUG or TRACE, create a new file named log4j.properties in the same directory as the run.bat script and insert the content below.

log4j.logger.com.softwareag.wx_analyze={DEBUG | TRACE}, analyzer log4j_appender_analyzer=org.apache.log4j.ConsoleAppender log4j_appender_analyzer.layout=org.apache.log4j.PatternLayout log4j_appender_analyzer.layout.ConversionPattern=%-5p $d{dd-MMM-yyyy HH:mm:ss} - %c{1}: %m%n

Remark: The analyzer might not support analysis of very large installations.

Disclaimer

This tool is provided by Software AG as-is and without warranty or support. It does not constitute part of the Software AG product suite.

Pre-UpgradeAnalyzer_2021-02-05.zip (21.7 MB)

6 Likes