BW 5.15.1 HF04, 5.14.1 HF05 and 5.14.0 HF19 require activation via a license in order to start.  Licenses can be generated in the TIBCO Software Downloads site at https://www.tibco.com/downloads. For complete details on activating TIBCO products, see the TIBCO® Activation Service documentation at https://docs.tibco.com/products/tibco-activation-service.

Important: BW engines will shut down when you reach the end date of your entitlement to the product, and will not restart until you replace your license file with one that contains a new entitlement end date. It is recommended that you do so well in advance of your entitlement end date to avoid business disruption.

There are two options for activating the product:

• In-Product Activation (RECOMMENDED option): Copy your license file to the host system where you are running BW.
• TIBCO® Activation Service (remote activation): Install TIBCO® Activation Service (TAS)  software and upload your license file to the TAS instance before activating BW software. Consult the TAS documentation for installation instructions, and to determine the URL for your TAS instance. Note that BW 5.14.0 HF19 supports TAS 1.1.0 only. BW 5.15.1 HF04 and 5.14.1 HF05 support TAS 1.0.0 and 1.1.0.

Note: License generated for a TAS instance and In-Product Activation are not compatible with each other. Consult the TAS documentation for instructions on generating a license for the activation option you choose.

Configuring BW for activation

During installation

BW can be configured for activation during the installation of the hotfix. The following screen is displayed during installation of the hotfix.

Enter TIBCO Activation Service Instance URL - Provide the TAS instance URL.
For example, https://activationserver.example.com:7070?fp=98fdb7e7d06fe3aac5841086684d8069d883984b4 030ad8edfa97b363bc0620a

Enter full path to license file directory(for in-product activation) - Provide the full path to the directory that contains your license file.
For example, c:/tmp/tiblic

After installation

If you do not configure activation during installation, you may configure it as a post-installation step based on the activation option you choose.

In-Product Activation

Set the property java.property.TIB_ACTIVATION to the full path of the directory that contains your license file in bwengine.tra and deployed application .tra files as follows:

java.property.TIB_ACTIVATION=<Full path to the directory that contains license file>
For example: java.property.TIB_ACTIVATION=c:/tmp/tiblic

TIBCO® Activation Service

Set the property java.property.TIB_ACTIVATION to the TAS instance URL in bwengine.tra and deployed application.tra files as follows:

java.property.TIB_ACTIVATION=<TIBCO® Activation Service instance URL>

For example: 
java.property.TIB_ACTIVATION=https://activationserver.example.com:7070?fp=98fdb7e7d06fe3aac5841086684d8069d883984b4 030ad8edfa97b363bc0620a

Silent Mode installation

During silent mode installation, the license details can be provided by adding the following entry to the .silent file:

In-Product Activation

<entry key="TIB_ACTIVATION"><Full path to directory that contains license file></entry>

For example,
<entry key="TIB_ACTIVATION">c:/tmp/tiblic</entry>

TIBCO® Activation Service

<entry key="TIB_ACTIVATION"><TIBCO Activation Service instance URL></entry>

For example,
<entry key="TIB_ACTIVATION">https://activationserver.example.com:7070?fp=98fdb7e7d06fe3aac5841086684d8069d883984b4 030ad8edfa97b363bc0620a</entry>

Providing license details using environment variable

It is possible to provide license details using the environment variable TIB_ACTIVATION. Set this to either the full path up to the directory that contains the local license file (In-Product Activation) or TAS URL (remote activation).

Default License Folder

BW uses BW_HOME/license as the default license location. This directory is created during the installation of the hotfix. If the license details are not provided during the installation (the System property TIB_ACTIVATION not set) and the environment variable TIB_ACTIVATION is not set, BW looks for a license file in the default license location and will use the license file found in this location for activation.

Note: The System property TIB_ACTIVATION takes precedence over the environment variable TIB_ACTIVATION and the environment variable takes precedence over the default license location.