When you work with external libraries or custom functions in your project at design time, and when you run, test, or debug such projects in TIBCO BusinessEvents Studio, you must ensure that the engine can find all libraries (including dependencies on third-party libraries) and custom functions, if the project requires any.If a project uses Rendezvous channels, for example, Java allows the user to set a property, java.library.path, to ensure that the environment path contains a reference to the directory containing Rendezvous DLLs (or on UNIX the SO files).Similarly TIBCO BusinessEvents captures the native library path along with the build path information to pass to engines running inside TIBCO BusinessEvents Studio. You can enter this information as described below, or when you are configuring a run configuration or debug configuration.
Test Connection Feature To make the Test Connection feature work for JMS Connection and JDBC Shared Connection shared resources, see Enabling the Test Connection Feature.
This functionality is also available in the Debug Configurations > ClassPath tab, and the Run Configurations > ClassPath tab, for your convenience. See Chapter 23, Testing and Debugging Projects.
2. In TIBCO 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 browse to and select the JAR file.
5. If a library or custom function depends on additional third-party Java archives, do the following:
a.
b. 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.
c. 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 do step 5, a dialog displays when you click OK. It lists the name of the class or classes that could not be loaded. To resolve the problem, do 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.
Deploytime Action Required To make custom functions or external libraries available at runtime, do the following 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 classpath; or update the classpath 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.Follow the instructions in To Add 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.
Copyright © TIBCO Software Inc. All Rights Reserved.