Integration Server Pre-Upgrade Analyzer

Knowledge base
, ,
#1

The Pre-Upgrade Analyzer for 10.11 has been re-written as an Integration Server package. This was to both make it much easier to use, as well as to take advantage of built-dependency management functionality. It analyzes your custom Integration Server packages, compares them to the new release, and generates reports that list the following:

  • Custom Adapter Connections, Services, Listeners and Notifications - Lists adapter assets, either for all installed adapters or a specific one.
  • Custom Assets that Depend on Changed Built-in Services - Lists custom services which reference changed built-in services.
  • Custom Assets that Depend on Deprecated Built-in Services - Lists custom services which reference deprecated built-in services.
  • Custom Services that Depend on a Specific Package - Lists custom services that depend on the specified package.
  • Custom Assets with Missing Dependencies - Lists services, document types, etc. being used by custom services that don’t actually exist on the current installation.
  • Custom Services Using Custom Java Services - Lists custom services which depend on custom Java services.

Supported Product Versions

Integration Server - 10.7->10.11

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.
  2. Install your custom packages in the new Integration Server.
  3. Open the WmPublic/config/fileAccessControl.cnf file and add the “packages/WxPreUpgradeAnalyzer/pub/reports;” directory to both the allowedReadPaths and allowedDeletePaths. Reload the WmPublic package.
  4. Install the WxPreUpgradeAnalyzer package and refresh the browser. Pre-Upgrade Analyzer should appear under the Solutions menu.
  5. Clicking the link will open the Pre-Upgrade Analyzer in a new tab.
  6. Expanding the “Create Reports” section displays a link for each report.
  7. Optional report inputs are italicized, while required inputs are not. Required inputs with no default a marked additionally with an asterisk. Filters use standard regular expression syntax. For example, to run a report against packages starting with “My”, the filter syntax would be “My.+”.
  8. Expand the Download & Manage Reports section the view the list of generated reports, download reports and/or delete reports.

screenshot
screenshot1006×530 22.6 KB

WxPreUpgradeAnalyzer.zip (18.1 MB) version 10.11.2 updated Feb 7, 2022.

Remark: The analyzer might not support analysis of very large installations. Note that this package uses Apache POI which, on some Linux distributions, requires on the ‘fontconfig’ package to be installed.

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.

The Legacy Pre-Upgrade Analyzer for versions 10.7 and below can be found here:
Legacy Integration Server Pre-Upgrade Analyzer

10 Likes
wM upgrade approach and guideline
WM upgrade from 9.7 to 10.7
Execute JAVA code in remote server(via remote aliases)
Tech Community 2021 Recap
#2

Hey and thanks for a brilliant solution!

I just wanted to clear; Does this tool only support upgrading from 10.7 to 10.11 or does it cover all supported upgrade paths for 10.11?

I ask because this tool is referenced in SOFTWARE AG UPGRADE PREPARATION AND PLANNING
GUIDE 10.11, and does not mention a certain upgrade path.

Regards
Atli

#3

Hi Atli,

this will be a 2-Step approach.
See links below the article above.
There is one version of the Analyzer covering upgrades from 9.7 up to 10.7 and another one (the one this article is about) for upgrades from 10.7 to 10.11.

Regards,
Holger

#4

This version should work for upgrades to 10.7 and 10.11. It’s the target version that matters.

1 Like
#5

Hi @Theodore_Ezell1

There are a lot of missing services that have been changed that are not included in this 10.11 version. For example pub.flatFile:convertToValues is not included which has been changed.

Also, the WxPreUpgradeAnalyzer.util:isSameOrHigherVersion fails with arrayOutofBound exception when comparing strings with longer version numbers. For example, version in 10.11.0.0 is compared with 6.5 which is in your changedServices.json file.

1 Like
#6

Hi Syed. Thanks for the feedback. I will work on fixes.

#7

An interesting tool but should it be called “Post-upgrade analyzer?” One has to install 10.11 and put everything to it first, then run the checks.

#8

For any report, getting the following error. What am I missing? I did update the fileAccessControl file with permissions.

report could not be created due to java.lang.reflect.InvocationTargetException in WxPreUpgradeAnalyzer.excel.pub.sheet:sheetAutoFitColumns.

#9

Hi Venkat,

I would try debugging it and checking where it fails. It looks like some of the parameters in the json files are not passed to the service. Try turning off file permissions check from the server watt settings or directly check if getFile service can read the json files used by the package.

#10

An InvocationTargetException is an exception that wraps another exception . You can check the full stacktrace to see the actual error here.

-NP

#11

Can some one let me know how to resolve Custom Assets that Depend on Deprecated Built-in Services report could not be created due to java.lang.reflect.InvocationTargetException in WxPreUpgradeAnalyzer.excel.pub.sheet:sheetAutoFitColumns. this issue

#12

we have installed the fontconfig package in the linux machine and rebooted the IS later it started working for us