The TIBCO BusinessWorks™ Container Edition Buildpack

The TIBCO BusinessWorks™ Container Edition buildpack must be uploaded in your Cloud Foundry environment before deploying any applications.

1. Download the TIBCO BusinessWorks™ Container Edition build pack zip file from http://edelivery.tibco.com.
   To download this file:
   1. Select Container from the Operating Systems drop down list.
   2. Read and Accept the TIBCO End User License Agreement.
   3. Select the radio button for Individual file Download.
   4. Click the + sign to view the individual components and select bwce_buildpack_cf-vx.x.x.zip.
2. Extract the contents of the zip file to a temporary location.
3. Customize the build pack for the database drivers.
   1. Follow steps outlined in JBDC Connection in the Bindings and Palettes Reference guide.
   2. Copy the appropriate driver bundle from TIBCO_HOME/bwce/version/config/drivers/shells/<driverspecific runtime>/runtime/plugins/ to the <your local buildpack repo>/resources/addons/jars folder in your temporary location.
4. Provision the OSGi bundle jar(s).
   Copy OSGi bundle jar(s) into <your buildpack repo>/resources/addons/jars folder in your temporary location.
5. Application Configuration Management
   For more information, see Using Configurations from Configuration Management Services.
6. Certificate Management
   Certificates are used by applications to connect to different systems. For example, a certificate to connect to Spring Cloud Config service or a certificate to connect to TIBCO Enterprise Message Service.
   Bundling certificates with your application is not a good idea as you would need to rebuild your application when the certificates expire. To avoid that, copy your certificates into the <your local buildpack repo>/resources/addons/certs folder in your temporary location.
   Once the certificates expire, you can copy the new certificates into the buildpack without rebuilding your application. Just deploy your application with the new buildpack. To access the certificates folder from your application, use the environment variable BW_KEYSTORE_PATH. For example, #BW_KEYSTORE_PATH#/mycert.jks in your application property.
7. Provision the BusinessWorks Container Edition Plug-in Runtime
   To add TIBCO certified plug-ins:

   1. Download appropriate Plug-in packaging, for example TIBCO ActiveMatrix BusinessWorks™ Plug-in for WebSphere MQ, from https://edelivery.tibco.com.
   2. Locate the plug-in zip file, <product id>_ePaas.zip or TIB_<version>_<build number>_bwce-runtime.zip from the downloaded artifacts and copy into <your local buildpack repo>/resources/addons/plugins.
   To add a plug-ins created using TIBCO ActiveMatrix BusinessWorks™ Plug-in Development Kit to runtime into your buildpack:

   1. Install the plug-in if it is not installed.
   2. Navigate to the TIBCO_HOME/bwce/palettes/<plug in name>/<plugin version> directory and zip the lib and runtime folders into <plugin name>.zip.
   3. Copy <plugin name>.zip to the <your buildpack repo>/resources/addons/plugins folder.
   Copy any required OSGi bundles e.g. driver bundles into <your buildpack repo>/resources/addons/jars
8. Provision to add third-party client installation at runtime
   1. Package third party client installation into zip.
   2. Copy zip file to <YOUR-BUILDPACK-REPO>/resources/addons/thirdparty-installs folder
9. Provision to add custom JDBC driver
   1. Follow steps outlined in Enabling Custom Drivers section of JDBC Connection topic in the Bindings and Palette Reference guide.
   2. After the project has been exported as a plug-in to the location you specified, locate the JAR file in the plug-in folder, and copy paste the JAR to <YOUR-BUILDPACK-REPO>/resources/addons/jars folder.
10. Provision to add custom JMS driver
    1. Follow steps outlined in Enabling Custom Drivers section of JNDI Connection topic in the Bindings and Palette Reference guide.
    2. After the project has been exported as a plug-in to the location you specified, locate the JAR file in the pulg-in folder, and copy paste the JAR to <YOUR-BUILDPACK-REPO>/resources/addons/jars folder.
11. Provision to use custom logs
    1. Create a new folder custom-logback in the <YOUR-BUILDPACK-REPO>/resources/addons folder.
    2. Add the customized logback file in the folder. The name of the logback file should be logback.xml.
       Note: While running the application, set the environment variable CUSTOM_LOGBACK="true".
12. Zip the contents of the temporary location to create the TIBCO BusinessWorks™ Container Edition buildpack zip file.
13. Push the buildpack to the Cloud Foundry environment.