Copyright © TIBCO Software Inc. All Rights Reserved

Invoking the Tool

Prerequisites

•

Before running TIBCO ActiveMatrix Updater Tool for Java Runtime Environment (JRE), shutdown the tibcohost intance you are managing to avoid severe errors by running the "tibcohost stop -wait true" command. The TIBCO ActiveMatrix Updater Tool for Java Runtime Environment (JRE) does NOT verify that the tibcohost is shut down.

•	When run in the update mode, the JRE Updater tool only updates files in the TIBCO_HOME from which it is run. However, in the discover mode, it discovers all tibcohost and node instances in a TIBCO_CONFIG_HOME irrespective of which TIBCO_HOME they point to.

•	The operation of the utility depends on the location from where the utility is being run. For example, if the tool is run from $TIBCO_HOME/amx/3.2/bin/, only the tibcohost and node instances that are of version 3.2.0 (and not of 3.1.5 and 3.3.0) are discovered.

•	The bit version of the JRE to which you are upgrading must match the bit version of the operating system architecture.

Modes

•	Interactive Mode (default) — To execute the TIBCO ActiveMatrix Updater Tool for Java Runtime Environment (JRE) in the interactive mode, run the following command from <TIBCO_HOME>/amx/<version>/bin/.

amx_jre_updater.exe (Microsoft Windows)

./amx_jre_updater (UNIX)

The tool enters an interactive shell where you can execute all TIBCO ActiveMatrix Updater Tool for Java Runtime Environment (JRE) commands, including any command specific arguments. The exit command exits the shell.

•	Non-interactive Mode — To execute the TIBCO ActiveMatrix Updater Tool for Java Runtime Environment (JRE) in a non-interactive (scripted) mode, run the following from <TIBCO_HOME>/amx/<version>/bin/:

./amx_jre_updater <command> -jreHome <JRE_HOME_PATH> <Optional arguments> (UNIX)

amx_jre_updater.exe <command> -jreHome <JRE_HOME_PATH> <Optional arguments> (Microsoft Windows)

where <command> is one of the TIBCO ActiveMatrix Updater Tool for Java Runtime Environment (JRE) commands, followed by command specific arguments.

The tool uses the existing JRE when it is invoked. The tool’s own TRA is updated during every update operation.

Help

All commands in the TIBCO ActiveMatrix Updater Tool for Java Runtime Environment (JRE) are documented within the tool:

•	Use the help command to get a list of all available commands:

amx_jre_updater.exe help (Microsoft Windows)

./amx_jre_updater help (UNIX)

In the interactive mode, use: help

•	Use help <command> to get detailed help on a specific command, including command examples:

amx_jre_updater.exe help <command> (Microsoft Windows)

./amx_jre_updater help <command> (UNIX)

In the interactive mode, use: help <command>

•	Use help jreUpdaterCommands to get detailed help on common command arguments:

amx_jre_updater.exe jreUpdaterCommands (Microsoft Windows)

./amx_jre_updater jreUpdaterCommands (UNIX)

In the interactive mode, use: jreUpdaterCommands

 

Copyright © TIBCO Software Inc. All Rights Reserved