How to perform a minor version JRE upgrade on the Silver Fabric TRA Distributions for versions TRA 5.8 and above on Unix Platform

How to perform a minor version JRE upgrade on the Silver Fabric TRA Distributions for versions TRA 5.8 and above on Unix Platform

book

Article ID: KB0094759

calendar_today

Updated On:

Products Versions
TIBCO Silver Fabric -
Not Applicable -

Description

Resolution:
NOTE 1: These instructions only apply to minor version JRE upgrade, ie., You need to substitute JRE A.B.C_yy with JRE A.B.C_zz (For example, you must substitute JRE 1.7.0_54 with JRE 1.7.0_99). Only the build number changes and the version change does not need to be reflected in the JRE installation directory. A change to only the JRE build number is considered a minimal risk. These instructions DO NOT apply for a major version JRE upgrade, ie., form 1.7. to 1.8. 
 
To upgrade the JRE included within the SF TRA 5.8 distribution to a newer minor version the customer has to do the following,
 
1) Download and install the selected JDK - (JDK A.B.C_zz) 
 
For example: 
/opt/java/1.7.0_99
 
2) Add the javac and tools.jar files from the jdkA.B.C_zz package into its JRE package.
 
For example:
cp /opt/java/1.7.0_99/bin/javac /opt/java/1.7.0_99/jre/bin
cp /opt/java/1.7.0_99/lib/tools.jar /opt/java/1.7.0_99/jre/lib
 
3) Copy the SilverFabric tra distribution gridlib file from the SF Broker's gridlib location to a temporary location.
 
For Example:
cp [SF_ROOT]/fabric/webapps/livecluster/deploy/resources/gridlib/SilverFabric_tra_5.8.0_0_linux26gl23_x86_64_distribution_gridlib.zip /opt/temp
 
4) Extract the SilverFabric tra distribution gridlib in the temporary location
 
For Example:
unzip  /opt/temp/SilverFabric_tra_5.8.0_0_linux26gl23_x86_64_distribution_gridlib.zip -d /opt/temp/SilverFabric_tra_5.8.0_0_linux26gl23_x86_64_distribution_gridlib/
 
5) Navigate to the tibcojre64/ directory in the extracted location under /opt/temp/SilverFabric_tra_5.8.0_0_linux26gl23_x86_64_distribution_gridlib/ and  rename the directory A.B.C  under tibcojre64/ to A.B.C.yy.backup.YYYYMMDD.
 
For example:
cd /opt/temp/SilverFabric_tra_5.8.0_0_linux26gl23_x86_64_distribution_gridlib/tibcojre64/
mv 1.7.0 1.7.0.54.backup.20160519
(where yy is the current JRE update version)
 
6) Copy the downloaded and altered external JRE from step 2  to the tibcojre64 directory in the extracted location and rename the newly copied jre directory  as [A.B.C].
This is required in order to maintain the original folder structure. 
 
For example:
cp -R /opt/java/1.7.0_59/jre /opt/temp/SilverFabric_tra_5.8.0_0_linux26gl23_x86_64_distribution_gridlib/tibcojre64/
mv jre 1.7.0
 
7) Re-zip all the files under /opt/temp/SilverFabric_tra_5.8.0_0_linux26gl23_x86_64_distribution_gridlib as SilverFabric_tra_5.8.0_0_linux26gl23_x86_64_distribution_gridlib.zip.
Please make sure in the resulting archive all the files from /opt/temp/SilverFabric_tra_5.8.0_0_linux26gl23_x86_64_distribution_gridlib as SilverFabric_tra_5.8.0_0_linux26gl23_x86_64_distribution_gridlib 
are in the root of the archive.
 
For Example:
cd /opt/temp/SilverFabric_tra_5.8.0_0_linux26gl23_x86_64_distribution_gridlib as SilverFabric_tra_5.8.0_0_linux26gl23_x86_64_distribution_gridlib 
zip -r SilverFabric_tra_5.8.0_0_linux26gl23_x86_64_distribution_gridlib as SilverFabric_tra_5.8.0_0_linux26gl23_x86_64_distribution_gridlib.zip *
 
The above set of commands will make sure the files are included in the root of the archive.
 
8) Delete the original gridlibrary (SilverFabric_tra_5.8.0_0_linux26gl23_x86_64_distribution_gridlib.zip) from the broker under [SF_ROOT]/fabric/webapps/livecluster/deploy/resources/gridlib/ and 
deploy the new gridlibrary created on Step 7.
 
9) Once the updated tra distribution is deployed to Silver Fabric, the running Admin and BW components will turn to red, just restart all out of date components, then all of them should be restarted with updated tra 5.8.0 distribution. 
 
NOTE 2: The impact of upgrading the SF TRA 5.8 to include a new JRE file will make any component running in a engine using this distribution to turn red and request a engine restart, so this task has to be planned in advanced to avoid a big impact.
 
NOTE 3: All new components created henceforth which uses the updated tra distribution will have the updated JRE. Also, existing components which do not use  FT will start using the updated JRE after a component restart.
For all existing components that use FT there are additional steps that needs to be perfomed to update the JRE in the FT location as well. Please follow steps 10 - 12 to update the JRE for existing components that use FT.  
 
10) Stop any running stack or component that uses the updated tra distribution.
 
11) Navigate to the tibcojre64/ directory in the FT location and  rename the directory A.B.C  under tibcojre64/ to A.B.C.yy.backup.YYYYMMDD.
 
For example:
cd [FT_ROOT]/tibcojre64/
mv 1.7.0 1.7.0.54.backup.20160519
(where yy is the current JRE update version)
 
12) Copy the downloaded and altered external JRE from step 2  to the tibcojre64 directory in the FT location and rename the newly copied jre directory  as [A.B.C].
This is required in order to maintain the original folder structure. 
 
For example:
cp -R /opt/java/1.7.0_59/jre [FT_ROOT]/tibcojre64/ 
mv jre 1.7.0
 
13) Restart the stopped components and stacks and upon the restart the will star using the updated JRE. 
 
NOTE 4: There are two methods to confirm if the new JRE is applied:
A) Check the About page in TIBCO Administrator, the JRE version should be 1.7.0_99
B) Check the java version from the $TIBCO_HOME/tibcojre64/1.7.0/bin directory which should show the updated JRE version as 1.7.0_99
 

Issue/Introduction

How to perform a minor version JRE upgrade on the Silver Fabric TRA Distributions for versions TRA 5.8 and above on Unix Platform
Powered by Wolken Software