Approach

Copyright © TIBCO Software Inc. All Rights Reserved

Chapter 2 Using TIBCO ActiveMatrix Updater Tool for Java Runtime Environment (JRE) : Approach

Approach

In all TIBCO ActiveMatrix installations, the path to JRE home is specified in the CLASSPATH .tra files in the TIBCO_HOME directory. When a new TIBCO Host is created, a TIBCO_CONFIG_HOME directory is created, and all the host and node files in this TIBCO_CONFIG_HOME directory point to the CLASSPATH .tra files in the corresponding TIBCO_HOME directory.

•

One or more TIBCO_CONFIG_HOME directories can point to the same TIBCO_HOME directory.

•

A single TIBCO_CONFIG_HOME can contain multiple "TIBCO ActiveMatrix Administrator Instances" pointing to different TIBCO_HOME directories.

The following diagrams illustrate the relationship between the files in the two directories.

In these diagrams, the:

•

Diamond shaped nodes are from TIBCO_CONFIG_HOME and oval shaped are from TIBCO_HOME.

•

Dark colored nodes are modified during the update to JRE 1.8.

Figure 1 TIBCO ActiveMatrix 3.1.5

Figure 2 TIBCO ActiveMatrix 3.2.0

Figure 3 TIBCO ActiveMatrix 3.3.0

Updating the JRE path in the common CLASSPATH .tra files in the TIBCO_HOME directory updates the JRE version for all the hosts and nodes in the TIBCO_CONFIG_HOME directories pointing to it. Any new node instance created after that will also use JRE 1.8.

The TIBCO ActiveMatrix Updater Tool for Java Runtime Environment (JRE) updates files at TIBCO_HOME level, and not at an individual TIBCO_CONFIG_HOME level. This means that when .tra files in TIBCO_HOME are updated all the tibchosts and nodes in different TIBCO_CONFIG_HOMEs that point to a particular TIBCO_HOME will be automatically updated to use JRE 1.8.

Properties Updated in CLASSPATH .tra Files

Following is a list of JRE properties in the CLASSPATH .tra files which are updated by the TIBCO ActiveMatrix Updater Tool for Java Runtime Environment (JRE) for a vanilla installation of the TIBCO ActiveMatrix platform:

TIBCO ActiveMatrix Version 3.1.5

TIBCO_HOME/amx/3.1/bin/hpaclient_classpath_3.1.5.tra :
[java.library], [tibco.env.PATH], [tibco.env.LIBPATH]
TIBCO_HOME/amx/3.1/bin/nodeutil_classpath_3.1.5.tra :
[java.library], [tibco.env.PATH], [tibco.env.LIBPATH]
TIBCO_HOME/amx/3.1/templates/rpflauncher_classpath_1.0.0.tra :
[java.library], [tibco.env.PATH]
TIBCO_HOME/tibcohost/3.1/scripts/bootstraptcs_classpath_3.1.5.tra:
[java.library], [tibco.env.PATH], [tibco.env.LIBPATH]
TIBCO_HOME/tibcohost/3.1/scripts/rdacompiler_classpath_3.1.5.tra :
[java.library], [tibco.env.PATH], [tibco.env.LIBPATH]
TIBCO_HOME/tibcohost/3.1/scripts/node_classpath_3.1.5.tra :
[java.library], [tibco.env.PATH], [tibco.env.LIBPATH]
TIBCO_HOME/tibcohost/3.1/scripts/tibcohost_classpath_3.1.5.tra :
[java.library], [tibco.env.PATH]

TIBCO ActiveMatrix Version 3.2.0

TIBCO_HOME/amx/3.2/scripts/rpflauncher_classpath_1.0.1.tra :
[java.library], [tibco.env.PATH], [tibco.env.LIBPATH]

TIBCO ActiveMatrix Version 3.3.0

TIBCO_HOME/amx/3.3/scripts/rpflauncher_classpath_3.3.0.tra :
[java.library], [tibco.env.PATH], [tibco.env.LIBPATH]

Multiple Product Installation

If multiple products are installed in the same TIBCO_HOME, this utility can be run multiple times with different include files each time, specific to the different products. Multiple runs of this tool do not affect the .tra and .ini files, which have already been modified.