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

README file for v1.5 Patch #7 (build 9812)

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

0. Dependencies
    Before installing this patch package, you must already have installed:
     - The WiaServiceProfiler package v1.5
       This patch includes and replaces all previous patches for this version.

    Also mind that:

     - If you are instaling this patch in the sequence of a new installation of
       the Service Profiler v1.5, install the package in the sequence of package
       installations and then proceed to complete the tool installation.

     - Else, if you already have a working installation of the tool,
       complete all the installation steps contained in this readme file.

1. Introduction
    This patch is recommended for all v1.5 installations, regardless of the
    operating system or webMethods version.

    With the application of this patch the installation becomes equivalent to
    v1.5.7, but will not change the package version.
    Instead, you may install the full v1.5.7. If you install the full version
    you still need to observe the actions listed in section 3.

    This is the last patch targeting v1.5 especifically.


2. Contents
    New Features:
    ----------------
    a) Add a filter by elapsed time to the 'Browse Running Services' dashboard.
       By setting a value in the minimum elapsed time option, and refreshing
       the dashboard, only threads that have top-level services running for at
       least that amount of time are shown.
       This is a way of quickly show which threads are running for a very long
       time. For instance, is 'a long time' is 10 minutes, setting the value
       of the option to '10:00.0' will only show the threads that have an elapsed
       time of at least that time... all the others are not shown.
    b) Improved the controlled replacement of 'static' JAR when installing a new
       version of the tool.
    c) Prepare for 'Next Upgrade'.
       The shutdown sequence of the package verifies if there are changes to
       be installed in the startup of the server and make preparation actions
       for it.
       These actions, specially in MS Windows environments, try to avoid errors
       during the next startup. This is also why the new script editing
       instructions for webMethods v9.x focus on making sure the Service
       Profiler setup scripts only run on startup.
    d) Validate new License Key before applying.
       Up until this patch, the new License Key would be directly applied and
       validated as part of that process. However, should the new license be
       invalid the instance would be set with that invalid license.
       With this patch, the key is validated prior to applying, and if invalid
       it does not invalidate/overwrite the one that is currently active.

    Bug Corrections:
    ----------------
    a) In the 'Browse Running Services' dashboard all services in the current
       stack now present a value for the 'Running Instance' field.
    b) Depending on the webMethods version, the error messages would appear in
       the DSPs with a font size too small, too large or OK;
    c) Stopping the Service Profiler from the 'Admin' page would not
       automatically freeze the snapshot.
    d) When the license key expired, the message on the top frame would be
       'Installation Incomplete', which is misguiding.
    e) Correct a bug introduced by Patch #3.
       (Only) on a new installation, the license management page would issue a
       NullPointerException, and even if the tool was correctly installed
       it would still indicate 'Installation Incomplete'.
    f) Correction of the error
       'java.lang.ClassCastException: java.lang.String cannot be cast to java.lang.Boolean',
       thrown when using the public services to download as CSV or JSON, via
       HTTP request and using the parameter 'resetCounters'.
    g) The assignment od the ACL 'WiaServiceProfilers' to the folder
       'wia.pub.issprofiler' would be lost with a server restart.

3. Install
    The package is installed as a regular IS Package.
    Immediately after installing the package:

    1. Shutdown the server;
    2. If on a webMethods v9.x Integration Server and Patch #2 **not** yet installed:
        2.a) Remove any script editions introduced by previous versions;
        2.b) Make changes to the webMethods startup scripts as indicated in the
             dedicated page in the website;
    3. Start the server up.


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