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
.
- 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 thoseCONFIG_HOME
must be stopped manually before applying an Engineering Build. This command stops Host instances from the givenCONFIG_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 BuildTIB_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 BuildTIB_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 ' 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.