The Pre-Upgrade Analyzer has been updated for version 10.15. This release includes some bug fixes, improved UI, and some new reports. 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 Asset Inventory - Lists all custom assets, filterable by package name.
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.
Custom Services Using Built-in Debug Services - Lists services which reference built-in debug services.
Supported Product Versions
Integration Server - 10.7-10.15
Supported Operating Systems
AIX, Linux, macOS, Solaris, Windows
Download and Installation
To use the analyzer:
Follow the instructions in Upgrading Software AG Products to install the new Integration Server.
Install your custom packages in the new Integration Server.
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.
Install the WxPreUpgradeAnalyzer package and refresh the browser. Pre-Upgrade Analyzer should appear under the Solutions menu.
Clicking the link will open the Pre-Upgrade Analyzer in a new tab.
The “Create Reports” section displays a link for each available report.
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.+”.
The Download & Manage Reports contains a Report List link, which allows you to view the list of generated reports, download reports and/or delete reports.
Remarks: The analyzer might not support analysis of very large installations. Note that this package uses Apache POI which, on some Linux distributions, requires the ‘fontconfig’ package to be installed.
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.
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.
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.
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.
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
Holger is correct. The analyzer is designed to run on the target version. Also, due to dependencies on internal Integration Server code, it is only compatible with version 10.7 or higher.
This is why I suggested that the name of this tool should be Post-Upgrade Analyzer or maybe Post-Upgrade Review. One has to upgrade first, as noted in steps 1 and 2 of the instructions, then run the checks to determine what needs attention.