Integration Server Pre-Upgrade Analyzer 10.15

 View Only
Wed February 17, 2021 08:00 PM

Introduction

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:

  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. The “Create Reports” section displays a link for each available 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. 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.
    PUA screen shot
    PUA screen shot866×592 32.7 KB

WxPreUpgradeAnalyzer.zip (18.5 MB)

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.

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


#Integration-Server-and-ESB
#Upgrade
#webMethods

Comments

webMethods Community Member
Wed August 02, 2023 07:12 PM

Hi Kiran. The analyzer only looks at enabled packages. As for packages that don’t show in the admin page, the only reason I can think of is that the packages failed to load, in which caser they cannot be analyzed.


#Integration-Server-and-ESB
#Upgrade
#webMethods

webMethods Community Member
Thu July 27, 2023 08:04 AM

Hi Engin SARLAK,

I Renamed the temp folder to WxPreUpgradeAnalyzer and I see tool under solutions.

However, wanted to confirm one more.

  1. Can I able to generate report for the packages which were not enabled.
  2. Few packages were installed in the server but not showing in IS admin page still can i generate the report for those type of package.

#Upgrade
#webMethods
#Integration-Server-and-ESB

webMethods Community Member
Wed July 26, 2023 05:01 PM


You need to see them as in the picture (not as deleted of course). Check your Anti-virus software, its probably renaming\blocking the package or wait a little bit more and refresh. It may also check it first and then rename it accordingly if allowed.
edit: Firefox downloaded the file as temp.zip, the zip file looks like this. Its the same file nevertheless.


#Integration-Server-and-ESB
#webMethods
#Upgrade

webMethods Community Member
Wed July 26, 2023 02:47 AM

Hi Team,

I am downloading the WxPreUpgradeAnalyzer.zip package for upgrade analysis for version 10.3 to 10.15. So, wanted to use the analyzer tool. However, when I click on the download option on the above to download package. The package is downloading like temp.zp. After unzip I see folder with temp only, I done see any folder with WxPreUpgradeAnalyzer.

Is this expected


#Integration-Server-and-ESB
#Upgrade
#webMethods

webMethods Community Member
Thu March 02, 2023 05:30 PM

fontconfig is a Linux package. On Ubuntu, for example, you would install it using this command: sudo apt-get install fontconfig

Install fontconfig on Ubuntu: sudo apt-get install fontconfig (devmanuals.net)


#Integration-Server-and-ESB
#webMethods
#Upgrade

webMethods Community Member
Mon February 27, 2023 12:34 PM

what is fontconfig ? is this the library that need to download and install from website ?


#Upgrade
#Integration-Server-and-ESB
#webMethods

webMethods Community Member
Wed October 26, 2022 10:36 AM

Thank you Holger and Theo for your prompt response.


#webMethods
#Upgrade
#Integration-Server-and-ESB

webMethods Community Member
Tue October 25, 2022 01:11 PM

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. :slight_smile:


#Integration-Server-and-ESB
#webMethods
#Upgrade

webMethods Community Member
Thu October 20, 2022 02:40 PM

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.
Best regards,
Theo


#Upgrade
#webMethods
#Integration-Server-and-ESB

webMethods Community Member
Thu October 20, 2022 10:28 AM

Hi Sai,

as far as I understood, it should be run on the new, target version.
10.11 in this case.

Regards,
Holger


#webMethods
#Integration-Server-and-ESB
#Upgrade

webMethods Community Member
Thu October 20, 2022 03:06 AM

Hi Experts,

We are doing upgrade from 10.5 to 10.11.

As per the instructions mentioned in the “Download and Installation: To use the analyzer” point no: 2.

So, do we need to run the WxPreUpgrade Analyzer in new server 10.11 or have to run in the old server 10.5.

Please confirm.

Regards,
Sai Pradeep.


#Integration-Server-and-ESB
#Upgrade
#webMethods

webMethods Community Member
Thu May 12, 2022 07:29 AM

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


#Upgrade
#webMethods
#Integration-Server-and-ESB

webMethods Community Member
Thu May 12, 2022 04:53 AM

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


#Upgrade
#Integration-Server-and-ESB
#webMethods

webMethods Community Member
Sat March 12, 2022 11:03 PM

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

-NP


#Integration-Server-and-ESB
#Upgrade
#webMethods

webMethods Community Member
Sat March 12, 2022 04:22 PM

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.


#webMethods
#Upgrade
#Integration-Server-and-ESB

webMethods Community Member
Wed March 09, 2022 11:33 PM

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.


#webMethods
#Integration-Server-and-ESB
#Upgrade

webMethods Community Member
Mon January 10, 2022 07:40 PM

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.


#Integration-Server-and-ESB
#Upgrade
#webMethods

webMethods Community Member
Mon January 10, 2022 04:55 PM

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


#Integration-Server-and-ESB
#Upgrade
#webMethods

webMethods Community Member
Tue December 28, 2021 12:00 PM

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.


#Upgrade
#Integration-Server-and-ESB
#webMethods

webMethods Community Member
Mon December 13, 2021 08:02 PM

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


#Integration-Server-and-ESB
#webMethods
#Upgrade

webMethods Community Member
Fri December 10, 2021 11:47 AM

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


#Upgrade
#webMethods
#Integration-Server-and-ESB

webMethods Community Member
Fri December 10, 2021 08:20 AM

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


#webMethods
#Integration-Server-and-ESB
#Upgrade