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 Runtime Environment
The BIRT iHub installation program installs Java Runtime Environment 1.8. By default, BIRT iHub uses this JRE. If you want to use a different JRE, you must set the appropriate environment variables in the configuration files used by BIRT iHub Visualization Platform and System Console.
Modifying BIRT iHub Visualization Platform configuration files
This section assumes the BIRT iHub installation directory is C:\Actuate3\iHub3.
For BIRT iHub Visualization Platform, you must modify two files:
*ihub.properties, located in C:\Actuate3\iHub3\modules\BIRTiHub
*acpmdconfig.xml, located in C:\Actuate3\iHub3\modules\BIRTiHub\iHub\etc\
In ihub.properties, modify the following lines so that the paths point to the JRE you want to use.
 
#AC_JRE_HOME=C:/Actuate3/iHub3/java
#AC_JAVA_HOME=C:/Actuate3/iHub3/java
 
In acpmdconfig.xml, modify the following lines so that the paths point to the JRE you want to use.
<EnvironmentVariable Name="JAVA_HOME"
Value="C:/Actuate3/iHub3/java" />
<EnvironmentVariable Name="AC_JAVA_HOME"
Value="C:/Actuate3/iHub3/java" />
<EnvironmentVariable Name="AC_JRE_HOME"
Value="C:/Actuate3/iHub3/java" />
Modifying System Console configuration files
This section assumes the System Console installation directory is C:\Actuate3
SystemConsole.
For System Console, you must modify two files:
*systemconsole.properties, located in C:\Actuate3\SystemConsole\modules\SystemConsole
*wrapper.properties, located in C:\Actuate3\SystemConsole\modules\SystemConsole\tomcat\conf\jk\
In systemconsole.properties, comment out the following entries and create new ones that point to the JRE you want to use.
#AC_JRE_HOME=C:/Actuate3/iHub3/java
#AC_JAVA_HOME=C:/Actuate3/iHub3/java
In wrapper.properties, modify the following line so that the path points to the JRE you want to use.
wrapper.java_home=C:\Actuate3\iHub3\java
Accessing JAR files for document generation
To generate some documents, iHub requires access to jar files in the Jar directory of the iHub installation, so you must include the location of the jar file in the CLASSPATH. If the BIRT iHub installation directory is C:\Actuate3\iHub3, the Jar directory is in C:\Actuate3\iHub3\modules\BIRTiHub\iHub.