Update Mode

Copyright © TIBCO Software Inc. All Rights Reserved

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

Update Mode

The Update command updates the JRE for a given TIBCO_HOME and all the "TIBCO ActiveMatrix Administrator Instances" referencing it. Specify the JRE_HOME location. JRE is updated for the TIBCO_HOME, from which the tool is invoked.

When TIBCO ActiveMatrix 3.1.5 is upgraded to TIBCO ActiveMatrix 3.2.0 or 3.3.0, the tool is installed in both the $TIBCO_HOME/amx/3.1/ and the higher version directory (for example, $TIBCO_HOME/amx/3.3/). When you upgrade, you must run the utility from the directory of the higher version (for example, $TIBCO_HOME/amx/3.3/) and not the lower version (for example, $TIBCO_HOME/amx/3.1/).

The general syntax of the command is:

update -jreHome <path to JRE> -updateIni -dryRun

The -dryRun option only lists the files that will be updated. It does not modify any files. To modify the files, run the update command without the -dryRun option.

Example:

update -jreHome C:/test/amx3/PlatformSupport/jdk1.8.0_31/jre -updateIni

For Other Products

For other products (other than TIBCO ActiveMatrix Service Bus and TIBCO ActiveMatrix Service Grid), specify the include file that contains the list of .tra and .ini files that needs to be updated.

Example:

update -jreHome C:/test/amx3/PlatformSupport/jdk1.8.0_31/jre -includeFile C:/test/amx3/IncludeFile.txt -updateIni -dryRun

For more information on the include file, see Arguments of the Update Command.

Arguments of the Update Command

Argument

Description

-jreHome <path>

The path to the JRE_HOME to which you want to update.

NOTE: Provide the JRE_HOME (and not the JDK_HOME) bundled inside the JDK. If you point to JDK_HOME, the path updated for tra/ini does not work for Runtime.

-includeFile <include-file-path>

The path to the file containing the list of .tra or .ini files to be included in the update process.

The path in the file can be an absolute path or relative to TIBCO_HOME.

Sample content in the include file:

TIBCO_HOME/a

TIBCO_HOME/b

TIBCO_HOME/c/d

/home/AMX-products/AMX3x-HFs/e/f

Where a, b, c and d are the name of folders which gets created for products other than TIBCO ActiveMatrix.

-excludeFile <exclude-file-path>

The path to the file containing the list of .tra or .ini files to be excluded in the update process.

The path in the file can be an absolute path or relative to TIBCO_HOME.

Sample content in the exclude file:

TIBCO_HOME/a

TIBCO_HOME/b

TIBCO_HOME/c/d

/home/AMX-products/AMX3x-HFs/e/f

Where a, b, c and d are the name of folders which gets created for products other than TIBCO ActiveMatrix.

-updateIni

This argument is applicable only with version 3.2.0 and 3.3.0. The default value is false. If set, the command also updates the .ini files in the specified TIBCO_HOME.

-dryRun

Optional argument; default value is false. If set, the command does not make any changes. It only displays information on what would have been done.

-configFile <path>

The location of a configuration file that can preconfigure the command. This argument is optional.

Sample content in the configuration file:

tibamx_jreupdater.DefaultJreHome=/a/b/c/jdk1.8.0_31/jre

tibamx_jreupdater.DefaultConfigHomeLocation=/a/b/c/d

tibamx_jreupdater.DefaultIncludeFile=a/b/c/includeFile.txt

tibamx_jreupdater.DefaultExcludeFile=a/b/c/excludeFile.txt

-logFile <path>

The location of a log file that keeps track of command execution. This argument is optional; commands write to a default log file as needed.

-stackTrace

Creates a full exception stack trace on encountering an error. This argument is optional.

Example of Update Command for 3.1.5

update -jreHome C:/test/amx3/PlatformSupport/jdk1.8.0_31/jre/ -dryRun

The output of the command is as follows:

File 'TIBCO_HOME/amx/3.1/templates/rpflauncher_classpath_1.0.0.tra' will be modified: JRE.HOME in property [java.library] will be changed to C:/test/amx3/jdk1.8.0_31/jre/

File 'TIBCO_HOME/amx/3.1/templates/rpflauncher_classpath_1.0.0.tra' will be modified: JRE.HOME in property [tibco.env.PATH] will be changed to C:/test/amx3/jdk1.8.0_31/jre/

File 'TIBCO_HOME/amx/3.1/bin/nodeutil_classpath_3.1.5.tra' will be modified: JRE.HOME in property [java.library] will be changed to C:/test/amx3/jdk1.8.0_31/jre/

File 'TIBCO_HOME/amx/3.1/bin/nodeutil_classpath_3.1.5.tra' will be modified: JRE.HOME in property [tibco.env.PATH] will be changed to C:/test/amx3/jdk1.8.0_31/jre/

File 'TIBCO_HOME/amx/3.1/bin/nodeutil_classpath_3.1.5.tra' will be modified: JRE.HOME in property [tibco.env.LIBPATH] will be changed to C:/test/amx3/jdk1.8.0_31/jre/

File 'TIBCO_HOME/amx/3.1/bin/hpaclient_classpath_3.1.5.tra' will be modified: JRE.HOME in property [java.library] will be changed to C:/test/amx3/jdk1.8.0_31/jre/

File 'TIBCO_HOME/amx/3.1/bin/hpaclient_classpath_3.1.5.tra' will be modified: JRE.HOME in property [tibco.env.PATH] will be changed to C:/test/amx3/jdk1.8.0_31/jre/

File 'TIBCO_HOME/amx/3.1/bin/hpaclient_classpath_3.1.5.tra' will be modified: JRE.HOME in property [tibco.env.LIBPATH] will be changed to C:/test/amx3/jdk1.8.0_31/jre/

File 'TIBCO_HOME/tibcohost/3.1/scripts/node_classpath_3.1.5.tra' will be modified: JRE.HOME in property [java.library] will be changed to C:/test/amx3/jdk1.8.0_31/jre/

File 'TIBCO_HOME/tibcohost/3.1/scripts/node_classpath_3.1.5.tra' will be modified: JRE.HOME in property [tibco.env.PATH] will be changed to C:/test/amx3/jdk1.8.0_31/jre/

File 'TIBCO_HOME/tibcohost/3.1/scripts/node_classpath_3.1.5.tra' will be modified: JRE.HOME in property [tibco.env.LIBPATH] will be changed to C:/test/amx3/jdk1.8.0_31/jre/

File 'TIBCO_HOME/tibcohost/3.1/scripts/bootstraptcs_classpath_3.1.5.tra' will be modified: JRE.HOME in property [java.library] will be changed to C:/test/amx3/jdk1.8.0_31/jre/

File 'TIBCO_HOME/tibcohost/3.1/scripts/bootstraptcs_classpath_3.1.5.tra' will be modified: JRE.HOME in property [tibco.env.PATH] will be changed to C:/test/amx3/jdk1.8.0_31/jre/

File 'TIBCO_HOME/tibcohost/3.1/scripts/bootstraptcs_classpath_3.1.5.tra' will be modified: JRE.HOME in property [tibco.env.LIBPATH] will be changed to C:/test/amx3/jdk1.8.0_31/jre/

File 'TIBCO_HOME/tibcohost/3.1/scripts/tibcohost_classpath_3.1.5.tra' will be modified: JRE.HOME in property [java.library] will be changed to C:/test/amx3/jdk1.8.0_31/jre/

File 'TIBCO_HOME/tibcohost/3.1/scripts/tibcohost_classpath_3.1.5.tra' will be modified: JRE.HOME in property [tibco.env.PATH] will be changed to C:/test/amx3/jdk1.8.0_31/jre/

File 'TIBCO_HOME/tibcohost/3.1/scripts/rdacompiler_classpath_3.1.5.tra' will be modified: JRE.HOME in property [java.library] will be changed to C:/test/amx3/jdk1.8.0_31/jre/

File 'TIBCO_HOME/tibcohost/3.1/scripts/rdacompiler_classpath_3.1.5.tra' will be modified: JRE.HOME in property [tibco.env.PATH] will be changed to C:/test/amx3/jdk1.8.0_31/jre/

File 'TIBCO_HOME/tibcohost/3.1/scripts/rdacompiler_classpath_3.1.5.tra' will be modified: JRE.HOME in property [tibco.env.LIBPATH] will be changed to C:/test/amx3/jdk1.8.0_31/jre/

Argument	Description
-jreHome <path>	The path to the JRE_HOME to which you want to update. NOTE: Provide the JRE_HOME (and not the JDK_HOME) bundled inside the JDK. If you point to JDK_HOME, the path updated for tra/ini does not work for Runtime.
-includeFile <include-file-path>	The path to the file containing the list of .tra or .ini files to be included in the update process. The path in the file can be an absolute path or relative to TIBCO_HOME. Sample content in the include file: TIBCO_HOME/a TIBCO_HOME/b TIBCO_HOME/c/d /home/AMX-products/AMX3x-HFs/e/f Where a, b, c and d are the name of folders which gets created for products other than TIBCO ActiveMatrix.
-excludeFile <exclude-file-path>	The path to the file containing the list of .tra or .ini files to be excluded in the update process. The path in the file can be an absolute path or relative to TIBCO_HOME. Sample content in the exclude file: TIBCO_HOME/a TIBCO_HOME/b TIBCO_HOME/c/d /home/AMX-products/AMX3x-HFs/e/f Where a, b, c and d are the name of folders which gets created for products other than TIBCO ActiveMatrix.
-updateIni	This argument is applicable only with version 3.2.0 and 3.3.0. The default value is false. If set, the command also updates the .ini files in the specified TIBCO_HOME.
-dryRun	Optional argument; default value is false. If set, the command does not make any changes. It only displays information on what would have been done.
-configFile <path>	The location of a configuration file that can preconfigure the command. This argument is optional. Sample content in the configuration file: tibamx_jreupdater.DefaultJreHome=/a/b/c/jdk1.8.0_31/jre tibamx_jreupdater.DefaultConfigHomeLocation=/a/b/c/d tibamx_jreupdater.DefaultIncludeFile=a/b/c/includeFile.txt tibamx_jreupdater.DefaultExcludeFile=a/b/c/excludeFile.txt
-logFile <path>	The location of a log file that keeps track of command execution. This argument is optional; commands write to a default log file as needed.
-stackTrace	Creates a full exception stack trace on encountering an error. This argument is optional.