wM Integration Server Service Profiler, v1.4

This version is required for compliance with v9.6 of the Integration Server. However, a few extra features have also been added, along with some corrections.

Check the Version History for information about any corrections or new features introduced by released patches.

This version of the Service Profiler is still compatible with Integration Servers v6.x, v7.x, v8x and v9.x prior to v9.6.

webMethods v9.6

The file structure and startup of the Integration Server has been changed considerably, affecting the setup of the environment for the Service Profiler and which files need to be edited and also the nature of the changes. Nevertheless, we have managed to normalize the instructions for all Integration Server v9.x.

Changes to Installation Instruction

The installation instructions are no longer in plain text file and are neither detailed in the User Guide.

Now, the detailed installation instructions are available as a dynamic webpage accessible from the download page at the website.

You choose your environment configuration, apply it, and the instructions text changes accordingly.

Package Coverage Analysis

• Code Coverage dashboard has been renamed to package Coverage
• Package Coverage can now be analyzed agaist the Integration Server's service usage statistics.

• Corrected some incompatibility issues with Internet Explorer, from IE8 onwards;

  These ranged from wrong placement of overlay icons on the snapshot tree, to forms not being submitted or being submitted without the selected options.

  These problems have been corrected.

• Blaze Services would be shown without icon.
  Icon(s) to this service type have been added.

Because the Code Coverage dashboard is now known as Package Coverage, the services wia.pub.issprofiler\..*\.codeCoverage$ have been deprecated and replaced by the corresponding wia.pub.issprofiler\..*\.packageCoverage$.

For upgrading from a version prior to v1.3, it is recommended to completely uninstall the previous version and install the new version from scratch.

For upgrading from v1.3.4 to v1.4, a patch is available: patch #5 for v1.3.

The Service Profiler has been successfully tested using SUN, ORACLE, HP and IBM JVMs v1.3.1, v1.4.x, v1.5.0, v1.6^* and v1.7^**.

When using JREs other than the Integration default one, make sure to make the tools.jar available, usually by putting it into the ext folder. This library is not included with the JRE installations, but is part of the JDK. The Integration Server default JVM includes this library (even though it is not guaranteed that it will always do so) for it's needed for some functionality, such as JSPs.

^* Only with webMethods platform v8.0 or above.

^** Only with webMethods platform v9.0 or above.

The Service Profiler can run in any of the Operating Systems and CPU architectures supported by the webMethods Integration Server. However, it is not ready available in all of them.

The list of currently ready-available Operating and CPU architectures are as follows^*:

• Windows 2000, XP & 2003 Server (intel 32-bit)
• Windows 2003 Server x64 (AMD 64-bit)
• Windows 8 x64
• Linux Redhat (intel 32-bit) (AMD 64-bit)
• Linux Suse (intel 32)
• SUN Solaris 8 (SPARC 32-bit)
• SUN Solaris 9 (SPARC 32-bit & 64-bit)
• SUN Solaris 10 (AMD 64-bit)
• HP-UX B10 & B11 (PA RISC 32-bit & 64-bit) (Itanium 32-bit & 64-bit)
• Mac OS X (intel 32 & 64-bit)
• AIX (ppc 32 & 64-bit)

^* The list of supported Operating Systems may change through the release of new patches.

• When the command-line profiler options are actived Norton Internet Security may prevent the Integration Server from starting;
  Manually adding the java.exe file to the permitted files of the firewall configuration usually overcomes this problem.
  If it does not work, disable Norton Internet Security while the server is starting.
  This situation may also happen with other security/firewall software, even though it has not been tested.
• Globalization;
  The tool is only available in English language.
• Missing menu link;
  The Licensing menu link may happen to not appear at all.
  The reason for this is not yet known, and usually refreshing the page makes it reappear.
• Grayed/disabled links.
  This is not an issue.
  When functionality menu links are disabled, this means that either the installation of the tool is incomplete or some error/setting is preventing the tool core libraries from loading.
  Check logs and if it is a problem, please call for support.
• Files downloaded with Save As... option of the browser are truncated/corrupted.
  This has been witnessed with Mozilla v1.7.12.
  Neither IExplorer or Firefox v1.5.x have reproduced this behaviour.
  This problem has been noted when copying the PDF documents in the info page or the (link) files generated on the Export To File functionality.
  Alternative workaround is to open the file by clicking its link and:
  • PDF;
    Use the Save Copy toolbar button of the plug-in.
  • CSV or XML.
    Use the This Frame / View Frame Source context menu and save it to a file.
• Pagination of the tree of service nodes limits find feature;
  If the number of nodes in a Snapshot triggers the tree pagination in the dashboard, the find a node in the tree is limited to the current page.
  On the special case of the navigation link from the View Per Service to the Browse Snapshot, the navigation & find is always (and only) made onto the first page. However, jumping to the next/previous page and repeat the find is always possible, but hits on the entire snapshot are not seen all at once.
• In the snapshot identification the host port may appear as -1 or missing.
  This will not happen if using the Service Profiler manually; i.e., start the profiling when the Integration Server has already completed its startup sequence, and the Service Profiler is also already loaded.
  The -1 value will happen if the port is inquired to the Integration Server during a package startup sequence.
  During the Integration Server startup sequence, its listening port number is also undetermined. Depending how it is inquired, it may result in -1 or nothing at all.