revertEB

The "revertEB" command reverts an Engineering Build from TIBCO_HOME and from the given TIBCOHost Instance in the CONFIG_HOME. If Instance name is not provided, it reverts the Engineering Build from all TIBCOHost Instances in a provided CONFIG_HOME. To revert an Engineering Build, the user needs to specify the location of the backup folder created by "applyEB" command for that Engineering Build inside <CONFIG_HOME>/EngineeringBuilds folder. By default, it stops all TIBCOHost Instances before reverting the Engineering Build and after successfully reverting the Engineering Build, it starts all TIBCOHost Instances with "clearCache". If a TIBCOHost Instance is installed as Windows Service, this command starts the Instance as a Service.

This command identifies whether the Engineering Build to be reverted is for ActiveMatrix Hawk microagent. If the Engineering Build is for ActiveMatrix Hawk microagent, it will revert the Engineering Build from TIBCO_HOME only and the revert from ActiveMatrix Hawk microagent must be handled manually. In such case, the Engineering Build does not need to be reverted from the CONFIG_HOME.

Note: The TIBCO Host instances must not be running and all nodes on the instances must be stopped to revert 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 reverting an Engineering Build. This command will stop Host instances from the given CONFIG_HOME only.

Arguments

Argument Description
-configHomeLocation The location of CONFIG_HOME.

-instanceName

Name of TIBCO Host instance. This argument is optional; It will revert EB from all TIBCO Host instances in the <CONFIG_HOME>.
-ebBackupLocation The location of the Engineering Build backup folder inside <CONFIG_HOME>/EngineeringBuilds/. This is the location where the original bundles were copied before applying the Engineering Build.
-skipStop Skip automated stopping of TIBCO Host instances before reverting the Engineering Build. This argument is optional.
Note: If you are using "-skipStop" argument, ensure that the Hosts are shutdown 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 shutdown.
-skipStart Skip automated starting of TIBCO Host instances after reverting the Engineering Build. This argument is optional.
Note: If you are using "-skipStart" argument and intend to start Host instances manually, ensure that ALL Hosts are started with "clearCache". Alternatively, you can use a flag "-clearCache" when running this command. This clears cache of all Nodes on all Host instances after reverting the Engineering Build without starting them.
-clearCache Clear the cache of ALL nodes on ALL TIBCO Host instances without starting them. This argument is optional.
Note: This command does not handle "clearCache" start of Hosts running as NT Service by default. This can be also be handled by "-clearCache" flag. If you have Hosts running as NT Service, you must specify "-clearCache" flag in order to start the Hosts with "clearCache".
-delayInSeconds Delay after reverting Engineering Build and between each TIBCO Host instance startup. This argument is optional. The command will use the default delay of 10 seconds.
-nonInteractive Runs in non-interactive manner. No interaction is required from the user during command execution.

Examples

>revertEB -configHomeLocation /path/to/confighome/location -instanceName myTibcoHostInstance -ebBackupLocation /path/to/confighome/EngineeringBuilds/Before_ TIB_amx_3.x.x_engineering_build085_backup

This stops the TIBCOHost Instance myTibcoHostInstance in the CONFIG_HOME /path/to/confighome/location, reverts Engineering Build TIB_amx_3.x.x_engineering_build085 from TIBCO_HOME and from the Instance myTibcoHostInstance using the backup folder at /path/to/confighome/EngineeringBuilds/Before_ TIB_amx_3.x.x_engineering_build085_backup and starts the Instance with "clearCache". 

>revertEB -configHomeLocation /path/to/confighome/location -ebBackupLocation /path/to/confighome/EngineeringBuilds/Before_ TIB_amx_3.x.x_engineering_build085_backup

This stops all TIBCOHost Instances in the CONFIG_HOME /path/to/confighome/location, reverts Engineering Build TIB_amx_3.x.x_engineering_build085 from TIBCO_HOME and from all of the Instances using the backup folder at /path/to/confighome/EngineeringBuilds/Before_ TIB_amx_3.x.x_engineering_build085_backup and starts the Instances with "clearCache". 

>revertEB -configHomeLocation /path/to/confighome/location -ebBackupLocation /path/to/confighome/EngineeringBuilds/Before_ TIB_amx_3.x.x_engineering_build085_backup -skipStop -skipStart

This skips the step to stop TIBCOHost instance(s) and reverts Engineering Build TIB_amx_3.x.x_engineering_build085 from TIBCO_HOME and from all of the Instances in the CONFIG_HOME /path/to/confighome/location using the backup folder at /path/to/confighome/EngineeringBuilds/Before_TIB_amx_3.x.x_engineering_build085_backup. It skips the step to start TIBCOHost instance(s).