Understanding the BIRT iHub installation environment
The following sections provide supplementary information about the BIRT iHub installation environment.
Running different releases on the same machine
A BIRT iHub 3 installation cannot coexist on the same machine with an earlier release of BIRT iHub or iServer.
Understanding the Java Software Development Kit
BIRT iHub requires a 64-bit version of the JAVA SE Development Kit (JDK) 1.6 or higher. The BIRT iHub installation process installs a Java Software Development Kit (JDK) if it does not detect one already installed in the environment. The iHub installation routine installs the JDK files in:
\Actuate\iHub3\modules\JDK64
To use a different JDK with iHub, change the files in the installation directory or change the values of the following environment variables:
*AC_JAVA_HOME
*AC_JVM_HOME
*AC_JRE_HOME
*AC_JRE64_HOME
Using an earlier JDK release can cause some BIRT iHub features to fail or to work incorrectly. For example, using an earlier release of JDK can cause Actuate products to display charts incorrectly.
The following types of Actuate executable files use AC_JRE_HOME and AC_JVM_HOME:
*Files containing charts use AC_JVM_HOME to locate the java.exe to generate the chart.
*Files using the Actuate Java Object Interface use AC_JVM_HOME to locate the JVM DLL or library.
Accessing JAR files for document generation
To generate some documents, iHub requires access to jar files in the Jar directory of the iHub installation files. In Windows, include the location of the jar file in the CLASSPATH.
Gathering LDAP information
An optional Open Security application ships with Actuate iHub Integration Technology. This application uses a Lightweight Directory Access Protocol (LDAP) security database to control access to the volume. To use the Open Security application, you need to perform a custom installation, which requires the following additional information:
*Name of the LDAP server and the port on which the LDAP server listens
*LDAP account and password used to query the LDAP server
*LDAP server organization that contains the BIRT iHub users and user groups
*LDAP base domain names and object classes that contain iHub users and user groups information
Actuate Open Security uses an LDAP configuration file to map BIRT iHub system information to LDAP object attributes. For more information about Actuate Open Security, see the System Console documentation in System Administration Guide and reference implementations available in BIRT iHub Integration Technology.