Integration Server Pre-Upgrade Analyzer

Knowledge base
, ,
#1

The Pre-Upgrade Analyzer analyzes your old Integration Server installation, compares it to the new release, 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

To use the analyzer:

  1. Follow the instructions in Upgrading Software AG Products to install the new Integration Server and prepare the old installation.
    If you install the new Integration Server on a new machine, preparation will include copying ZIP files containing the packages from the old installation to the new machine.
  2. Download the analyzer into any directory on that machine and unzip the archive.
  3. Go to the wxanalyze-project.properties file, open it in a text editor, and set the user-defined properties.
  4. Make sure you have write access to the temp directory set on the wx.analyzer.tempdir property (by default, ./temp/).
  5. 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)

7 Likes