This document explains how to upgrade Java SDK on the H-Sphere control panel server.

Supported Versions

RedHat Linux

It is recommended that RedHat Linux owners use the Java SDK 1.4.2 by Sun Microsystems. This applies to all products in the RedHat Linux product line.

FreeBSD

FreeBSD users are recommended to stick to Caffe Diablo JDK 1.3.1.

Upgrade Procedure

1. Log into the CP server as root:
   # su -
2. Stop H-Sphere:
   # /etc/rc.d/init.d/httpdcp stop
3. Stop all java processes on your system:
   # killall java
4. Set up Java JDK 1.4.2 following the instructions by Sun Microsystems.
5. In the file /hsphere/local/home/cpanel/apache/etc/jserv/jserv.properties update java-related parameters:
   wrapper.bin - the Java Virtual Machine interpreter, e.g.:
     wrapper.bin=/usr/java/jdk1.4.2/bin/java
   wrapper.bin.parameters - arguments passed to Java interpreter to ensure it has enough memory resources:
     wrapper.bin.parameters=-Xms64M -Xmx512M
   wrapper.classpath - the Java class library, e.g.:
     wrapper.classpath=/usr/java/jdk1.4.2/jre/lib/rt.jar
   
6. Open file /hsphere/shared/SiteStudio/imaker.sh and check if it has the line:
   JAVA_HOME=`su - cpanel -c 'echo $JAVA_HOME'`
   If it doesn't, update the JAVA_HOME parameter in this file, e.g.:
   JAVA_HOME=/usr/java/jdk1.4.2
7. To ensure correct work with OpenSRS, download the "Unlimited Strength" Jurisdiction Policy Files. The files for version 1.4.2 can be downloaded from page http://java.sun.com/j2se/1.4.2/download.html#docs, section "Other Downloads". Put the files in the directory JAVA_HOME/jre/lib/security
   where JAVA_HOME is the Java SDK home directory.
8. Upgrade to one of the latest versions of H-Sphere.
9. Start H-Sphere:
   # /etc/rc.d/init.d/httpdcp start