How to Resolve ActiveVOS Sample Project Java Library Dependencies
Introduction
Many of the ActiveVOS Sample projects describe how to build client applications, custom invoke handlers, custom functions and other components using the Java Programming Language. These Java-based components depend on one or more jar files at compile- and run-time, and it is best to resolve these dependencies using the jars that are deployed with the version of ActiveVOS and/or the server platform where you'll be running the sample applications. This document describes how to resolve these dependencies with the specific combination of development environment, version of ActiveVOS and type of application server platform you're using.
Most of the jar files required during compilation and execution are supplied as part of your ActiveVOS product distribution. For the JBoss, WebLogic and WebSphere application servers some jar files, such as jaxrpc.jar, are not included with the ActiveVOS distribution because they are included in the application server's distribution. The location of these files is dependent upon your ActiveVOS distribution and will be discussed in the next three sections.
Any sample requiring the use of these libraries expects an environment variable named AESAMPLES_LIB be set to the directory location containing these jar files. For simplicity this sample assumes that we have created a root level directory on our file system named AESAMPLES_LIB and then set the environment variable.
On Windows, you would set AESAMPLES_LIB as follows:
set AESAMPLES_LIB=c:\AESAMPLES_LIB
Once this environment variable is set it is a simple matter of copying the jar files from the ActiveVOS distribution and the application server distribution to the directory specified in the AESAMPLES_LIB environment variable.
-- Please read ALL applicable instructions before performing any steps! ---
ActiveVOS Designer Embedded Engine
If you're running samples on the ActiveVOS engine that ships with the free ActiveVOS Designer then setting up dependency resolution is fairly simple. Simply copy the files located in the following location to the AESAMPLES_LIB location:
[ActiveVOS Designer install location]\designer\plugins\org.activebpel.enginep_5.0.2\server\shared\lib
Note: Part of the location path (org.activebpel.enginep_5.0.2) shown here is for version 5.0.2 of the ActiveVOS Designer. Modify this path according to the version of ActiveVOS Designer that you have installed.
ActiveVOS Professional on the Tomcat Platform
If you using ActiveVOS Enterprise for Tomcat skip ahead to the next section.
If you're running samples on the ActiveVOS Professional for Apache Tomcat, then setting up dependency resolution is fairly simple. Simply copy the files located in the following location to the AESAMPLES_LIB location:
[ActiveVOS Professional install location]\server-professional\tomcat_config\shared\lib
ActiveVOS Enterprise on the Tomcat, JBoss, WebLogic or WebSphere Platforms
As mentioned previously, all the jar files required by the Java-based sample components are not shipped in your ActiveVOS Enterprise distribution for JBoss, WebLogic and WebSphere. As in the case of the ActiveVOS Professional for Tomcat all the files are included in the
ActiveVOS Enterprise for Tomcat
If you're running samples on the ActiveVOS Enterprise for Apache Tomcat, then setting up dependency resolution is fairly simple. Simply copy the files located in the following location to the AESAMPLES_LIB location:
[ActiveVOS Enterprise install location]\server-enterprise\tomcat_config\shared\lib
ActiveVOS Enterprise for JBoss
If you're setting up to work with ActiveVOS Enterprise for JBoss then you need to copy files from both the ActiveVOS Enterprise Server distribution and the JBoss installation.
1. Copy the files located in the following location to the AESAMPLES_LIB location:
[ActiveVOS Enterprise install location]\server-enterprise\jboss_config\deploy\abe_jboss\lib
2. Copy the jaxrpc.jar file from your JBoss installation to the AESAMPLES_LIB location. Check your sample's build.xml file for other jar file dependencies and copy them from the application server installation to the AESAMPLES_LIB location.
ActiveVOS Enterprise for WebLogic
If you're setting up to work with ActiveVOS Enterprise for WebLogic then you need to copy files from both the ActiveVOS Enterprise Server distribution and the WebLogic installation.
1. Copy the files located in the following location to the AESAMPLES_LIB location:
[ActiveVOS Enterprise install location]\server-enterprise\weblogic_config\deploy\abe_weblogic\APP-INF\lib
2. Copy the jaxrpc.jar file from your WebLogic installation to the AESAMPLES_LIB location. Check your sample's build.xml file for other jar file dependencies and copy them from the application server installation to the AESAMPLES_LIB location.
ActiveVOS Enterprise for WebSphere
If you're setting up to work with ActiveVOS Enterprise for WebSphere then you need to copy files from both the ActiveVOS Enterprise Server distribution and the WebSphere installation.
1. Copy the files located in the following location to the AESAMPLES_LIB location:
[ActiveVOS Enterprise install location]\server-enterprise\websphere_config\deploy\abe_websphere\lib
2. Copy the jaxrpc.jar and saaj.jar files from your WebSphere installation to the AESAMPLES_LIB location. Check your sample's build.xml file for other jar file dependencies and copy them from the application server installation to the AESAMPLES_LIB location.
Copyright © 2004–2008 Active Endpoints, Inc.