Symptom:

When trying to apply the AMX 3.4.0 HF2 patch, users may notice that it fails with error "Caused by: product feature com.tibco.amx.platform.patch.rpf 3.4.2.000 contains a release unit com.tibco.tct.admin.feature 1.6.1.003 that does not exist in the machine model".

==============================
EXCEPTIONS WHILE APPLYING PATCH TO HOST INSTANCE(S)
<SomeHostInstance> : TIBCO-AMX-TOOLS-PATCHMGR-000001: error applying patch amx.platform.patch:3.4.0.HF2 to TIBCO Host instance
Caused by: product feature com.tibco.amx.platform.patch.rpf 3.4.2.000 contains a release unit com.tibco.tct.admin.feature 1.6.1.003 that does not exist in the machine model
Caused by: product feature com.tibco.amx.platform.patch.rpf 3.4.2.000 contains a release unit com.tibco.tct.admin.feature 1.6.1.003 that does not exist in the machine model
==============================


Root Cause:

This is a defect with the AMX 3.4.0 HF2 installation package.

Patching the environment with AMX 3.4.0 HF2 is not supposed to add/patch any TCT features (such as com.tibco.tct.admin.****** and com.tibco.tct.tpclshells.******) in runtime. So currently these features are mistakenly added to the Patch rpf. As a result you will see these two TCT features in <Config_Home>\tibcohost\Admin-<enterprise>-<adminInstance>\data_3.2.x\host\plugins .

Applying ActiveMatrix Service Grid 3.4.0 HF2 patch fails with error "Caused by: product feature com.tibco.amx.platform.patch.rpf 3.4.2.000 contains a release unit com.tibco.tct.admin.feature 1.6.1.003 that does not exist in the machine model".

All Supported OS Platforms

Workaround:

1. Take a backup of the "machine.xmi" file under <TIBCO_Home>\tools\machinemodel\shared\1.0.0

2. Comment out or remove the below two dependencies from the above "machine.xmi" file.

<releaseUnits version="3.4.2.000" componentID="com.tibco.amx.platform.patch.rpf" location="file:/C:/svn/amf/scripts/workflows/alacarte/tibco.home/components/shared/1.0.0/features/com.tibco.amx.platform.patch.rpf_3.4.2.000/" name="TIBCO ActiveMatrix Platform 3.4.0 Hotfix-002 RPF" description="TIBCO ActiveMatrix Platform 3.4.0 Hotfix-002">
....
....
<!--dependencies componentID="com.tibco.tct.admin.feature" rangeLow="1.6.1.003" rangeHigh="1.6.1.003" lowInclusive="true" highInclusive="true"/>
   <dependencies componentID="com.tibco.tct.tpclshells.feature" rangeLow="1.6.1.003" rangeHigh="1.6.1.003" lowInclusive="true" highInclusive="true"/-->
...
</releaseUnits>

3. Take a backup of the folder "com.tibco.amx.platform.patch_3.4.2.000" under <TIBCO_Home>\components\shared\1.0.0\plugins 

4. Edit the "patch.properties" file under the following folder

        <TIBCO_Home>\components\shared\1.0.0\plugins\com.tibco.amx.platform.patch_3.4.2.000\META-INF\com.tibco.amx.patch\amx.platform.patch\3.4.0.HF2

by removing two entries

        com.tibco.tct.admin.feature:1.6.1.003;appliesTo="[1.999.0,1.999.1)",
        com.tibco.tct.tpclshells.feature:1.6.1.003;appliesTo="[1.999.0,1.999.1)",

5. Run the AMX 3.4.0 HF2 patch command again, and this time it should go through successfully. After the successful patching, you can also see that the two features (com.tibco.tct.admin.xxx and com.tibco.tct.tpclshells.xxx ) are removed from <Config_Home>\tibcohost\Admin-<enterprise>-<adminInstance>\data_3.2.x\host\plugins .

AMX-18044