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.

Note: For TIBCO ActiveMatrix 3.2.0, the JRE updater tool needs to be installed separately. For TIBCO ActiveMatrix 3.4.1, the tool is installed by default in <TIBCO_HOME>\amx\3.4\bin\amx_jre_updater\. When you upgrade from 3.2.0 to 3.4.1, you must run the utility from the directory of the higher version (for example, <TIBCO_HOME>/amx/3.4/) and not the lower version (for example, <TIBCO_HOME>/amx/3.2/).

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/<JDK version>/jre -updateIni

Arguments of 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, 3.3.0, and 3.3.1. 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

E:\tibco\AMXTestInstaller\amx\3.4\bin>amx_jre_updater.exe update -jreHome "C:\Program Files\Java\jre1.8.0_181" -updateIni -dryRun

The output of the command is as follows: 

File 'E:\tibco\amx\3.4\scripts\rpflauncher_classpath_3.4.1.tra' has been modified: JRE.HOME in property [java.libr
ary] has been changed to C:\Program Files\Java\jre1.8.0_181
File 'E:\tibco\amx\3.4\scripts\rpflauncher_classpath_3.4.1.tra' has been modified: JRE.HOME in property [tibco.env
.PATH] has been changed to C:\Program Files\Java\jre1.8.0_181
File 'E:\tibco\amx\3.4\bin\TIBCOConfigurationTool.ini' has been modified: [E:/tibco/tibcojre64/1.8.0] has be
en changed to C:\Program Files\Java\jre1.8.0_181
File 'E:\tibco\amx\3.4\bin\TIBCOConfigurationToolc.ini' has been modified: [E:/tibco/tibcojre64/1.8.0] has b
een changed to C:\Program Files\Java\jre1.8.0_181
File 'E:\tibco\studio\5.0\eclipse\amx_eclipse_ant.tra' has been modified: JRE.HOME in property [java.library] has
been changed to C:\Program Files\Java\jre1.8.0_181
File 'E:\tibco\studio\5.0\eclipse\amx_eclipse_ant.tra' has been modified: JRE.HOME in property [tibco.env.PATH] ha
s been changed to C:\Program Files\Java\jre1.8.0_181
File 'E:\tibco\studio\5.0\eclipse\TIBCOBusinessStudio.ini' has been modified: [E:/tibco/tibcojre64/1.8.0] ha
s been changed to C:\Program Files\Java\jre1.8.0_181
File 'E:\tibco\tct\1.6\TIBCOConfigurationTool.ini' has been modified: [E:/tibco/tibcojre64/1.8.0] has been c
hanged to C:\Program Files\Java\jre1.8.0_181
File 'E:\tibco\tct\1.6\TIBCOConfigurationToolc.ini' has been modified: [E:/tibco/tibcojre64/1.8.0] has been
changed to C:\Program Files\Java\jre1.8.0_181
File 'E:\tibco\amx_it_mediation\3.5\bin\AutoMediate.tra' has been modified: JRE.HOME in property [tibco.env.TIBCO_
JVM_LIB_DIR] has been changed to C:\Program Files\Java\jre1.8.0_181
File 'E:\tibco\amx_it_mediation\3.5\bin\AutoMediate.tra' has been modified: JRE.HOME in property [tibco.env.PATH]
has been changed to C:\Program Files\Java\jre1.8.0_181
File 'E:\tibco\amx_it_mediation\3.5\bin\AutoMediate.tra' has been modified: JRE.HOME in property [java.library] ha
s been changed to C:\Program Files\Java\jre1.8.0_181
File 'E:\tibco\amx_it_mediation\3.5\samples\Util\bin\samplesdb.tra' has been modified: JRE.HOME in property [tibco
.env.TIBCO_JVM_LIB_DIR] has been changed to C:\Program Files\Java\jre1.8.0_181
File 'E:\tibco\amx_it_mediation\3.5\samples\Util\bin\samplesdb.tra' has been modified: JRE.HOME in property [tibco
.env.PATH] has been changed to C:\Program Files\Java\jre1.8.0_181
File 'E:\tibco\amx_it_mediation\3.5\samples\Util\bin\samplesdb.tra' has been modified: JRE.HOME in property [java.
library] has been changed to C:\Program Files\Java\jre1.8.0_181