Description:
NOTE:TIBCO ActiveMatrix BusinessWorks Service Engine 5.9.3 + HF-006 or above
     (5.9.3-HF-006 or above is mandatory for use with this hotfix)

================================================================================
Product Name:    TIBCO ActiveMatrix(R) Platform
Release Version: 3.1.5_hotfix011
Release Date:    August 2013

================================================================================
Legal Notice

This Hotfix is provided pursuant to the terms and conditions of the written
maintenance and support agreement between you (or your company) and TIBCO and
use of the Hotfix is controlled by the terms of such written maintenance and
support agreement.

================================================================================
Introduction

Hotfixes are cumulative. This hotfix includes all previous generally available
hotfixes for TIBCO ActiveMatrix(R) Platform 3.1.5.

================================================================================
Applicable Products

This hotfix applies to the following products and versions:

   - TIBCO ActiveMatrix Service Bus 3.1.5
   - TIBCO ActiveMatrix Service Grid 3.1.5
   - TIBCO ActiveMatrix BPM 1.3.X, 2.0.0, 2.1.0
   - TIBCO Business Studio BPM Edition 3.5.3, 3.5.5, 3.5.10, 3.5.20
   - TIBCO ActiveMatrix BusinessWorks Service Engine 5.9.3 + HF-006 or above
     (5.9.3-HF-006 or above is mandatory for use with this hotfix)

================================================================================
Installation

The installation steps refer to two locations:

- &ltTIBCO_HOME> is the fully-qualified path to the installation folder.

- &ltTIBCO_CONFIG_HOME> is the fully-qualified path to the folder that stores
  configuration data generated by TIBCO products.

All Platforms:
Follow the steps in scenario 1 or 2 as appropriate.

--------------------------------------------------------------------------------
Scenario 1: Steps for applying the hotfix to a new installation of
the above products.
--------------------------------------------------------------------------------

1. Follow the installation instructions for the applicable products.
   Note the installation profile selected. In the last panel of the installer,
   uncheck the checkbox labeled "Run TIBCO Configuration Tool", if it is
   present.

2. Extract the hotfix archive file to a temporary directory, different
   from where the product installer archive was extracted.

3. Download TIBCO Universal Installer 2.9.7 V1 from the TIBCO Support
   server ftp://support-ftp.tibco.com to the same temporary directory as
   step 2.

4. Navigate to the temporary directory where the hotfix archive file was
   extracted.

5. Invoke the TIBCO Universal Installer, selecting an existing &ltTIBCO_HOME>.

6. If the installation profile selected in step 1 above included
   Runtime Host or Administration, run TIBCO Configuration Tool from
   &ltTIBCO_HOME>/tct/1.1.

--------------------------------------------------------------------------------
Scenario 2: Steps for applying the hotfix to an existing installation of the
above products.

NOTE: The hotfix will be automatically applied to only new nodes that are
created after installation of the hotfix. To apply the hotfix to existing
instances, perform the steps below.
--------------------------------------------------------------------------------

1. Shut down all TIBCO Host instances. If you have replicated TIBCO
   ActiveMatrix Administrator servers, do not stop all servers at once while
   upgrading. Only stop the one you are upgrading.

2. Repeat steps 3-8 for all machines in the TIBCO ActiveMatrix enterprise:

   a. First, on each machine on which TIBCO ActiveMatrix Administrator server
      is running.
   b. On each machine running one or more TIBCO Host instances.

3. Extract the hotfix archive file to a temporary directory.

4. Download TIBCO Universal Installer 2.9.7 V1 from the TIBCO Support FTP
   server ftp://support-ftp.tibco.com to the same temporary directory as
   step 3.

5. Navigate to the same temporary directory where the hotfix archive was
   extracted.

6. Invoke the TIBCO Universal Installer, selecting the existing &ltTIBCO_HOME>
   to which the hotfix needs to be applied.

7. For the TIBCO Host instance that you want to update, perform a backup
   (required to support uninstallation):

   a. Open a terminal window and change to
      "&ltTIBCO_HOME>/amx/3.1/scripts/upgrade/upgrade-to-3.1.5".

   b. Run the command:
      "ant backup-tibcohost -Dth.backup.tag=pre3.1.5-HF11
      -Dtibco.config.mgmt.home=&ltTIBCO_CONFIG_HOME>
      -Dtibcohost.instance.name=&ltINSTANCE_NAME>
      -Denterprise.name=dummy -Dadmin.server.name=dummy"

   c. Make a backup of the &ltTIBCO_CONFIG_HOME>/tibamx_patchmgr folder.

8. For the TIBCO Host instance that you want to update:

   a. Open a terminal window and change to "&ltTIBCO_HOME>/amx/3.1/bin".

   b. Run this command:
      "tibamx_patchmgr applyPatch -configHomeLocation &ltTIBCO_CONFIG_HOME>
      -instanceName &ltinstanceName> -ID amx.platform.patch:3.1.5.HF11"

   c. Restart the TIBCO Host instances.

9. If the hotfix has been applied to TIBCO ActiveMatrix BPM 1.3.X or
   BPM 2.0.0 and amx.bpm.app and amx.bpm.sysorgmodel appear to be stuck
   in the status "Waiting for dependencies" after restarting their TIBCO
   Host instance(s), perform the following steps in the ActiveMatrix
   Administrator UI:

   a. Go to Infrastructure --> Nodes
   b. Make sure the BPMEnvironment is selected
   c. Select the BPMNode
   d. Click on the "Install" drop down and select the "Resolve only" option

10.If the hotfix has been applied to TIBCO ActiveMatrix BPM 1.3.X or
   BPM 2.0.0 and amx.bpm.app is in the Start Failed state and the log shows
   a Null Pointer Exception in TranQL at
   org.tranql.connector.AbstractManagedConnection.getConnection
   (AbstractManagedConnection.java:171, restart the node to recover.

When you view a node to which this patch has been applied in the Administrator
UI, some of the feature versions displayed under "Infrastructure > Nodes >
Configuration > Features" or "Infrastructure > Software Management >
Features" will not reflect the latest versions of the features installed with
the hotfix. The inconsistency is expected. Do not perform any actions on the
node to correct it.

To determine the patch level of all the nodes managed by a TIBCO host instance,
use the "describeAppliedPatches" command in tibamx_patchmgr.

Run "tibamx_patchmgr intro" and "tibamx_patchmgr help" for more details on the
tool.

================================================================================
Post-Installation

If you install another TIBCO ActiveMatrix product (for example, TIBCO
ActiveMatrix BPM) after installing this hotfix, execute the
post-install steps to remove duplicate plug-ins from TIBCO Business Studio:

1. Exit TIBCO Business Studio.

2. Open a command window and change to
   "&ltTIBCO_HOME>/eclipse-platform/ganymede/eclipse/p2postinstall".

3. Run "ant -Dtibco.home.esc=&ltTIBCO_HOME> -f post-install.xml".

4. Run "TIBCOBusinessStudio -clean -initialize".

================================================================================
Uninstallation

TIBCO Business Studio does not support uninstalling a hotfix. To roll
back to the previous version of TIBCO Business Studio, reinstall the previous
version of the product in a new installation environment and choose the
SOA Development profile.

To roll back the hotfix from TIBCO Host instances and nodes in an enterprise
managed by TIBCO ActiveMatrix Administrator, follow these steps:

1. Any changes made through ActiveMatrix Administrator after the hotfix was
   installed must be rolled back before uninstalling the hotfix; this includes
   rolling back any nodes created, applications deployed, and resource instances
   installed.  Otherwise, after uninstalling the hotfix these runtime objects will
   no longer be manageable.

2. For every TIBCO Host instance in the TIBCO ActiveMatrix enterprise where
   the patch was applied:

   a. Shut down the TIBCO Host instance.

   b. Open a command window and change to
      "&ltTIBCO_HOME>/amx/3.1/scripts/upgrade/upgrade-to-3.1.5".

   c. Run the command:

      "ant restore-tibcohost -Dth.restore.zip=&ltBACKUP_ZIP>
      -Dtibco.config.mgmt.home=&ltTIBCO_CONFIG_HOME>
      -Dtibcohost.instance.name=&ltINSTANCE_NAME>
      -Denterprise.name=dummy -Dadmin.server.name=dummy"

      where:

      &ltBACKUP_ZIP> is the ZIP file created by the backup-tibcohost command above;
      the file will be found in
      &ltTIBCO_CONFIG_HOME>/tibcohost/&ltINSTANCE_NAME>/upgrade-to-3.1.5/backups

   d. Change to "&ltTIBCO_HOME>/amx/3.1/scripts".

   e. Run "ant -f uninstall-hotfix-3.1.5.HF11.xml".

   f. Restore the backup of the &ltTIBCO_CONFIG_HOME>/tibamx_patchmgr folder
      (made in step 7.c, Installation Scenario 2) to that same location.

   g. Run TIBCO Configuration Tool and restore any required third party
      drivers (for example, Oracle 11g driver) that were removed in step e.

   h. Start the TIBCO Host instance.


================================================================================
Affected Files for 3.1.5_hotfix011

The following files are installed by this hotfix.

All Platforms:

&ltTIBCO_HOME>/amx/3.1/bin directory:
tibamx_patchmgr

&ltTIBCO_HOME>/amx/3.1/scripts directory:
uninstall-hotfix-3.1.5.HF11.xml


================================================================================
Closed Issues in 3.1.5_hotfix011 (This Release)

AMRP-4605
Undeploying and deleting TIBCO ActiveMatrix BPM user applications no longer
occasionally fails due to a low-level provisioning error.

AMRP-4625
The describeHost command (used with the tibcohost executable) no longer returns
the incorrect hotfix version, which only occurred in some cases.

MED-3275
For a one-way MEP operation, invoke tasks on the fault path no longer fail, and
tasks after the invoke task are now processed.

PER-1745
Requests that contain unsigned SAML tokens with a signed X509 certificate are no
longer authenticated as signed SAML tokens.

TAP-12136
When deploying an upgraded TIBCO ActiveMatrix BPM user application, the
upgrade will not change the state of existing versions until the new version is
successfully upgraded. This ensures that if a failure happens during deployment
of an upgraded application it does not change the state of the previous version
that was running.

TAP-12256
During deployments after an application has been upgraded, the CLI no longer
returns prematurely while there are still pending tasks for the new version.

TAP-12257
When deploying several applications together, applications are deployed serially
according to the application’s components’ dependencies. This prevents
applications from missing dependencies, which causes TIBCO
Administrator to get into an inconsistent state.

TAP-12289
Connections now are restored correctly when TIBCO Enterprise Message Service
is shut down and restarted in replicated Administrator environments.

TAP-12313
The ActiveMatrix Administrator no longer enters an inconsistent state when
deployment fails during application upgrades. In the event of a
deployment failure users will now be able to force undeploy the failed
deployment and go back to a state prior to the deployment failure.

TIBCO ActiveMatrix BusinessWorks Service Engine 5.9.3 hotfix TIB_amx_3.1.5_hotfix011is now available

Product: TIBCO ActiveMatrix BusinessWorks Service Engine Version: OS: --------------------