Changing the Default Java Location for CentraSite
CentraSite must point to a JDK or JRE. By default, CentraSite points to the location of the JDK (in the <Software AG_directory>/jvm directory) installed at the same time you installed CentraSite. You can specify a different location, if required.
You can specify a non-default JDK or JRE for CentraSite to use.
Important: | If you specify a non-default JRE or JDK, ensure that you apply maintenance updates from the appropriate vendor on a regular basis, just as you would with JREs and JDKs that you install yourself. |
Before you specify the location of Java for CentraSite, determine whether you need to specify the location of the JDK or the JRE. If you intend to install CentraSite Eclipse Plug-ins to execute CentraSite reporting using BIRT, specify the location of the JDK. If you are not using this installation of CentraSite to execute BIRT reporting, you can specify the location of a JRE.
If you specify a different JDK or JRE, do not remove the JDK or JRE that Software AG Installer installed with CentraSite. The JDK and JRE installed with CentraSite are required to run the Software AG Uninstaller.
You must modify the following configuration files to point to the non-default JDK or JRE installation directory:
<CentraSiteInstall_Directory>/centrasite_setenv.cmd or
centrasite_setenv.sh <Software AG_directory>/profiles/CTP/configuration/wrapper.conf <Software AG_directory>/profiles/CTP/configuration/custom_wrapper.conf To specify a non-default JDK or JRE
1. Open the centrasite_setenv.cmd/sh file in a text editor.
You can find the centrasite_setenv.cmd/sh file in the directory: <CentraSiteInstall_Directory>/bin
a. Set the CS_JAVA_EXE parameter so that it specifies the location of the JDK or JRE executable file.
For example:
CS_JAVA_EXE=C:\my_java\bin\java
b. Set the CS_JAVA_HOME parameter so that it specifies the location of the JDK or JRE installation directory.
For example:
CCS_JAVA_HOME=C:\my_java
c. Save and close the file.
2. Open the wrapper.conf file in a text editor.
You can find the wrapper.conf file at the location: <Software AG_directory>/profiles/CTP/configuration
a. Set the wrapper.java.command property so that it specifies the location of the non-default JDK or JRE installation directory.
For example:
wrapper.java.command=C:\my_java\bin\java
b. Save and close the file.
3. Open the custom_wrapper.conf file in a text editor.
You can find the custom_wrapper.conf file at the location: <Software AG_directory>/profiles/CTP/configuration
a. Set the set.JAVA_HOME property so that it specifies the location of the non-default JDK or JRE installation directory.
For example:
set.JAVA_HOME=C:\my_java
b. Save and close the file.
4. Restart Software AG Runtime.