================================================================================
  Service Profiler for webMethods Integration Server - Wrightia (c) 2006-2008
================================================================================

README file for r1.0.2 Patch #4 (build 2769)

0. Dependencies
1. Introduction
2. Contents
3. Install

0. Dependencies
    - Must have the WiaServiceProfiler package v1.0.2 already installed;
    - This patch includes, replaces and deprecated all previous patches for
      Service Profiler v1.0.2.
    - Read further before starting any installation process.

1. Introduction
    This patch is a cumulative collection of bug corrections. See the
    'Contents' section for details.
    It updates your WiaServiceProfiler from v1.0.2(patch #3) to v1.0.3.

2. Contents
   This patch contains updates to the following parts of the delivery:
    > Native libraries;
    > tool core library;
    > Windows batch file;
    > Posix shell script file;
    > Start/Stop services;
    > Release Notes & Version History pages.

    New supported platforms:
    -----------------------
    This patch adds support for using the Service Profiler in an Integration
    Server running under:
        - Linux RedHat 64-bit (AMD64);
        - Windows 2003 Server x64 (AMD64);
        - Mac OS X (32 & 64-bit) (intel);
        - Solaris 9 64-bit (SPARC).

    Bug corrections:
    ---------------
    a) WiaServiceProfiler v1.0.2 patch #3 would not install as a package patch
       but rather as a full package.

       Patch #4 replaces patch #3 and includes all corrections and changes
       introduced by the latter.

    b) In Windows systems where the IS has been installed in a path that
       contains spaces (e.g., C:\Program Files\webMethods), starting the
       Service Profiler raises an error.

    c) In a singular situation, the server name was reported in the snapshot
       identification data with port -1.

       This is a network system problem, but this patch implements an
       workaround that allows the name of the server to be set with the correct
       port number.

    d) Java error "java.lang.NoSuchMethodError: com.wrightia.wm.is.profiler.
       intercept.IssprofClassLoaderTransformationHelper.beforeDefineClassCall
       (Ljava/lang/ClassLoader;Ljava/lang/String;Ljava/nio/ByteBuffer;IILjava/
       security/ProtectionDomain;)[B" when loading some of the webMethods
       packages (e.g. WmFlatFile).

       The package was left loaded as 'partial' and every attempt to use one
       of its services would issue the error message above.

       This problem is resolved on every platform it was reported to happen.

    e) Java error message "JVMPI not supported with this garbage collector;
       please refer to the GC/JVMPI documentation".

       This problem is resolved, with exception of the following supported
       platforms:
        - HP-UX (PA & itanium);

       Workaround:
          Alter the Integration Server start script to add one of the following
          Java options to the JVM command line:
            -client
            -XX:-JVMPICheckGCCompatibility

3. Install
    The package is installed as a regular IS Package.

    a) The installation should be done immediately after installing the
       WiaServiceProfiler IS package and before copying any files and/or
       customizing the 'server.sh|.bat' script.

       If the installation is being made for an already completely installed
       Service Profiler, complete the patch installation by completely
       replacing the '<is_dir>/serviceprofiler/' folder by the
       '<is_dir>/packages/WmServiceProfiler/config/serviceprofiler/' one.

    b) After installing the patch, if you are installing the Service
       Profiler from scratch, complete the installation process as
       documented in the tool's installation instructions.
       This step includes stopping and starting the IS.

================================================================================
  http://www.wrightia.com