CAP JTAPI Installation Guide

Version: $Revision: 1.4 $
Created on: $Date: 2011-04-20 19:45:10 $

The ilink JTAPI implementation does not need any special installation or setup procedure.
All you need to do is copy the following jar files to your application's classpath:

- jtapi1_3_1.jar
- cap-jtapi.jar
- CSTABean.jar
- jaxp-api.jar
- log4j-1.2.7.jar
- sax.jar
- w3c_full.jar
- xercesImpl.jar

These files are included in the lib directory of the distribution zip. Please refer to your JDK's documentation about how to add jars to your classpath.

NOTE: Although it works in most cases, it is not recommended to put the libraries in the JDK's / JRE's extensions directory (usually situated under JAVA_HOME/jre/lib/ext), since some classloading issues may arise with different classloader configurations.

To manually add the libraries to an applications classpath on startup use the following command (assumes that the libraries reside in a directory called lib just below the execution directory from where java is called).

Windows :

rem Keep an already existing classpath (if any)
set JTAPI_CP=%CLASSPATH%;lib\jtapi1_3_1.jar
set JTAPI_CP=%JTAPI_CP%;lib\cap-jtapi.jar
set JTAPI_CP=%JTAPI_CP%;lib\CSTABean.jar
set JTAPI_CP=%JTAPI_CP%;lib\jaxp-api.jar
set JTAPI_CP=%JTAPI_CP%;lib\log4j-1.2.7.jar
set JTAPI_CP=%JTAPI_CP%;lib\sax.jar
set JTAPI_CP=%JTAPI_CP%;lib\w3c_full.jar
set JTAPI_CP=%JTAPI_CP%;lib\xercesImpl.jar

java -classpath %JTAPI_CP% MyApplicationClassName

Unix (bash) :

export JTAPI_CP=$CLASSPATH:lib/jtapi1_3_1.jar
export JTAPI_CP=$JTAPI_CP:lib/cap-jtapi.jar
export JTAPI_CP=$JTAPI_CP:lib/CSTABean.jar
export JTAPI_CP=$JTAPI_CP:lib/jaxp-api.jar
export JTAPI_CP=$JTAPI_CP:lib/log4j-1.2.7.jar
export JTAPI_CP=$JTAPI_CP:lib/sax.jar
export JTAPI_CP=$JTAPI_CP:lib/w3c_full.jar
export JTAPI_CP=$JTAPI_CP:lib/xercesImpl.jar

java -classpath $JTAPI_CP MyApplicationClassName