Upgrading Java

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. Update symlink /usr/java/jdk/ to point to your installation, for example to /usr/java/jdk1.4.2_06.
   [-] If you don't have the /usr/java/jdk/ symlink -
   1) Create it to point to your installation;
   2) In the file /hsphere/local/home/cpanel/apache/etc/jserv/jserv.properties, set the following:

   wrapper.bin=/usr/java/jdk/bin/java
   wrapper.classpath=/usr/java/jdk/jre/lib/rt.jar
6. Skip this step if you don't run SiteStudio.
   Open file /hsphere/shared/SiteStudio/imaker.sh and check if it has the line:
   JAVA_HOME=`su -l 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. 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