Installation

last change: 2014/06/20

Installation:

Extract the zip (arsdatabase-${project.version}.zip) in the "./data-integreation/plugin/databases" directory manually,
or use the di marketplace function to install the plugin. (Spoon-Help-Marketplace)

The following directorys will be created
./data-integration/plugins/databases/pdi-arsystem-database-plugin

Post-Installation:
The arapi jar files are not included in this package. So it's necessary to copy them from your
ARS System Server, EMail Engine or Midtier 7.x installation.
The plugin is tested with api version 7.1 and 7.6. Older versions will not work because of an API change.
But it's possible to run API V7.1 against a AR Server Version 6.3 or against a higher versions without problems.

put the JARs into the data-integration lib path (./data-integration/lib/)

Notes:

• API version 7.6
  ardoc7604_build002.jar
  if you running the plugin against a AR System Server prior 7.1,
  the operating system depened library files (nativelibs) are required as well.
  see the native libs instructions under API version 7.1.
  API version 7.6 doesn't work against a AR-Server v6.3 and prior.

• API api version 7.1
  arutil71.jar,arrpc71.jar,arcmn71.jar,oncrpc.jar

  the operating system depended ar system library files (nativelibs) are required as well.
  ( arjni71.dll,arapi71.dll .. ). The Version of the nativelibs must match to the version of jar files.
  put the files to any location, and make the following modifications

  Windows:
  append the path to the system wide %PATH variable or alternativly extend the spoon.bat,kitchen.bat,pan.bat
  * e.g.: set PATH=%PATH%;/path/to/native/libs
  extend the java option line in spoon.bat,kitchen.bat,pan.bat, append the java.library.path
  * e.g. set OPT="%PENTAHO_DI_JAVA_OPTIONS%" "-Djava.library.path=/path/to/native/libs;..

  Linux/Solaris:
  append the path to the users LD_LIBRARY_PATH variable or alternativly you can edit the spoon.sh,kitchen.sd,pan.sh startup scripts.
  * LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/path/to/native/libs; export LD_LIBRARY_PATH;
  extend the java option line in spoon.sh,kitchen.sh,pan.sh, append the java.library.path
  * e.g. set OPT="$OPT $PENTAHO_DI_JAVA_OPTIONS -Djava.library.path=/path/to/native/libs:$LIBPATH

• API api version prior 7.1
  is not working

• API api version 7.5 or higher 7.6
  not tested, but should work as well

NOTE: The API Version don't need to match to the AR Server version.

Possible errors:
- java.lang.ClassNotFoundException: com.bmc.arsys.api.ARServerUser
=> the plugin can not access the API JARs, check the post installation steps

Only if your are using JNI
- "java.lang.UnsatisfiedLingError: com.bmc.arsys.api.Proxy"
=> your are using a API Version prior v7.5 or against a AR Server prior v7.5. and the native libs could not located
* check your LD_LIBRARY_PATH (linux/solaris) or PATH (windows) Variable
* check -Djava.library.path in the spoon/kitchen/pan startup scripts.

• java.lang.UnsatisfiedLinkError: no arjni71 in java.library.home

  • check the -Djava.library.path in the spoon/kitchen/pan startup scripts, need to point to the native libs

• java.lang.UnsatisfiedLinkError: \path\to\lib\arjni71.dll: Can't find dependent libraries

  • the api could locate the native libs ( -Djava.library.path), but not the dependent libraries
  • check your LD_LIBRARY_PATH (linux/solaris) or PATH (windows) Variable, must show to the same directory like -Djava.library.path
  • may some of the native libs are missing

• java.lang.UnsatisfiedLinkError: Native Library \path\to\lib\arjni71.dll already loaded in another classloader ( only in Spoon )

  • may you actived both installation options