Adding an External Library or Custom Function Path

This functionality is also available in the Debug Configurations > ClassPath, and the Run Configurations > ClassPath tab, for your convenience.

    Procedure
  1. Open the project in TIBCO BusinessEvents Studio.
  2. In BusinessEvents Studio Explorer, right-click the project and click Properties (or press Alt-Enter). You see the properties dialog for the project.
  3. In the left panel, select Build Path and then select one of the following:
    The Custom Functions tab, to add custom functions paths
    The Java Libraries tab, to add third-party libraries paths
  4. Click Add Library and select the JAR file.
  5. If a library or custom function depends on additional third-party Java archives, follow these steps:
    1. Expand the library or custom function entry and double-click the Native library location entry.
    2. At the Native Library Folder Configuration dialog, select External Folder or Workspace as appropriate, and browse to and select the folder containing the native libraries.
    3. Click OK to dismiss this dialog.
  6. Click OK. One of the following occurs:
    If a custom function depends on third-party Java archives and you did not complete Step 5, a dialog is displayed when you click OK. It lists the name of the class or classes that could not be loaded. To resolve the problem, complete Step 5.
    You see the message: "It is recommended that you rebuild your project after changing the build path. Would you like to rebuild now?" Click Yes to validate and fix any references already in code to the JARs you have added.
  7. Save the resource.
Result
Deploytime Action Required
 To make custom functions or external libraries available at runtime, complete the following steps on all machines where TIBCO BusinessEvents is installed:
  • Either copy the JAR or JARs to the lib/ext/tpcl directory, or other directory in the class path; or update the class path in the TRA file to point to the location of the JAR or JARs.
  • If a JAR has dependencies on native libraries, edit BE_HOME/bin/be-engine.tra and as needed, update PATH LD_LIBRARY_PATH, SHLIB_PATH, and LIBPATH as needed, depending on the operating system.

    See TIBCO BusinessEvents Administration for more details.

To Remove an External Library or Custom Functions JAR Path, follow the instructions in Adding an External Library or Custom Function Path, but instead of clicking Add Library, select the JAR file you want to remove and click Remove Library. The entry for any native libraries it depends on is also removed.