applyEB

The "applyEB" command applies a given Engineering Build (EB) to TIBCO_HOME and to the specified TIBCO Host instance in the CONFIG_HOME. If the instance name is not provided, it applies the Engineering Build to all TIBCO Host instances in a provided CONFIG_HOME. By default, it stops all TIBCOHost Instances before applying the Engineering Build and after successful application of the Engineering Build, it starts all TIBCO Host Instances with "clearCache". If a TIBCO Host Instance is installed as Windows Service, this command starts the Instance as a service.

Before applying the Engineering Build, it takes a backup of the existing files into the <CONFIG_HOME>/EngineeringBuilds/Before_<nameOfEBZip>_backup/ folder where "nameOfEBZip" is the name of the Engineering Build zip file (for example, "TIB_amx_<version>_engineering_build<buildNumber>" ). It also copies the readme file for the specified Engineering Build to <TIBCO_HOME>/_ebInstallInfo folder.

This command identifies whether the Engineering Build is targeted for the ActiveMatrix Hawk microagent. If the Engineering Build is targeted for the ActiveMatrix Hawk microagent, the command applies the Engineering Build to the given ActiveMatrix Hawk microagent and to TIBCO_HOME. In such case, the Engineering Build is not applied to the CONFIG_HOME.

Note:
  • The TIBCO Host instances must not be running and all nodes on the instances must be stopped to apply an Engineering Build. If you have other CONFIG_HOME running from same TIBCO_HOME, all Host instances on those CONFIG_HOME must be stopped manually before applying an Engineering Build. This command stops Host instances from the given CONFIG_HOME only.
  • After applying the Engineering Build, the command copies the readme file released with the Engineering Build (for example, TIB_amx_<version>_engineering_build<buildNumber>_readme.txt for Engineering Build TIB_amx_<version>_engineering_build<buildNumber>) to the <TIBCO_HOME>/_ebInstallInfo folder.
  • This command applies the JAR files from the specified Engineering Build into the appropriate locations. However, there might be additional actions required to enable this Engineering Build, that is, updating TRA properties and so on. Refer to the readme file released with the Engineering Build (for example, TIB_amx_<version>_engineering_build<buildNumber>_readme.txt for Engineering Build TIB_amx_<version>_engineering_build<buildNumber>) to ensure that all of the required steps are carried out.

Arguments

Argument Description
-configHomeLocation The location of the CONFIG_HOME.
-instanceName

Name of TIBCO Host instance. This argument is optional.

It applies EB to all TIBCO Host instances in the CONFIG_HOME, if not provided.

-ebLocation The location of the Engineering Build file.
-hawkLibLocation

The location of ActiveMatrix Hawk microagent's 'lib' folder.

For example, HAWK_HOME/hawk/<version>/lib.

This argument is required if the Engineering Build is targeted for the ActiveMatrix Hawk microagent.

-skipStop Does not stop TIBCO Host instance before applying the Engineering Build.
Note: If you are using this argument, ensure that ALL the Hosts in the given CONFIG_HOME are shut down completely before calling this command as it could cause severe errors if it is not the case. This command does not verify that the Hosts are shut down.
-skipStart Does not start TIBCO Host instance after applying the Engineering Build.
Note: If you are using this argument and intend to start the host instances manually, ensure that all hosts are started with "clearCache". Alternatively, you can use "-clearCache" when running this command. This clears the cache of all nodes on all host instances after applying the Engineering Build without starting them.
-nonInteractive Runs in the non-interactive manner. No interaction is required from the user during command execution.
-clearCache Clear the cache without starting TIBCO Host instance.
Note: If you have Hosts running as NT service, you must specify the "-clearCache" flag to start the Hosts with "clearCache".
-delayInSeconds Adds delay after applying the Engineering Build and between each TIBCO Host instance startup.

Examples

>applyEB -configHomeLocation /path/to/confighome/location -instanceName myTibcoHostInstance -ebLocation /path/to/TIB_amx_3.x.x_engineering_build085.zip

This stops TIBCOHost Instance myTibcoHostInstance in the CONFIG_HOME path/to/confighome/location, applies the Engineering Build TIB_amx_3.x.x_engineering_build085.zip to TIBCO_HOME and to the Instance myTibcoHostInstance and starts the Instance with "clearCache" .

>applyEB -configHomeLocation /path/to/confighome/location -ebLocation /path/to/TIB_amx_3.x.x_engineering_build085.zip

This stops all TIBCOHost Instances in the CONFIG_HOME path/to/confighome/location, applies the Engineering Build TIB_amx_3.x.x_engineering_build085.zip to TIBCO_HOME and to all of the Instances and starts the Instances with "clearCache".

>applyEB -configHomeLocation /path/to/confighome/location -ebLocation /path/to/TIB_amx_3.x.x_engineering_build085.zip -skipStop -skipStart

This skips the step to stop TIBCO Host instances and applies the Engineering Build TIB_amx_3.x.x_engineering_build085.zip to TIBCO_HOME and to all of the instances in the CONFIG_HOME /path/to/confighome/location. It skips the step to start TIBCO Host instances.