Resolution:
Description:
============
TIBCO Runtime Agent 5.7.x and 5.8.0 compatibility issue with TIBCO Rendezvous 8.4.1.

Environment:
============
TIBCO Rendezvous 8.4.1
TIBCO Administrator 5.7.x or higher version.
TIBCO Runtime Agent 5.7.x or higher version.
OS : ALL

Impact:
======
Due to compatibility issues with TIBCO Rendezvous 8.4.1 we have observed issue and errors in Domain Utility operations such as TIBCO Administrator Domain creation, TIBCO Administrator startup, Administrator RV heartbeats, AppManage. JIRA defect ADM-5345  impacts TIBCO Runtime Agent 5.7.x and 5.8.0 when used with TIBCO Rendezvous 8.4.1.

Cause:
======
The CLASSPATH being used by Administrator or AppManage or DomainUtility currently includes rvlat.jar (via %RV_HOME%/bin) which causes compatibility issue with %RV_HOME%/lib/tibrvj.jar file in RV 8.4.1.


Resolution:
============
Option 1).
Manually remove the %RV_HOME%/bin entries from extended classpath of the tra file and template tra files.
Remove the entry from DomainUtility.tra ,DomainUtilitycmd.tra, AppManage.tra found under &ltTRA_HOME>/5.8/bin/.
If you have created the Domain then you will have to remove the entries from tibcoadmin_&ltdomainname>.tra file found under &ltADMIN_HOME>/Domain/&ltDomainName>/bin and from hawkagent_&ltdomainname>.tra file found under &ltTRA_HOME>/Domain/&ltDomainName>/bin.

Also make the changes to tibcoadmintra.template found under &ltADMIN_HOME>/5.8/template and hawkagenttra.template found under &ltTRA_HOME>/5.8/template . This will make sure any new Admin 5.8.0 Domain created will not have %RV_HOME%/bin entries in their respective domain tra tibcoadmin_&ltdomainname>.tra and hawkagent_&ltdomainname>.tra files.



Option 2).
Do not upgrade to RV 8.4.1 and use RV 8.4.0 until TRA Engineering fixes ADM-5345.