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

Supported Versions

Linux

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

FreeBSD

Starting with H-Sphere 2.4.3 RC 2, Java 1.4.2 is implemented on CP server under FreeBSD 4.x. Please update your H-Sphere to the latest version where you can update Java to 1.4.2.

FreeBSD users with H-Sphere below 2.4.3 are bound to use Caffe Diablo JDK 1.3.1.

Upgrade Procedure

You have two alternative ways to upgrade Java. Choose one of the alternatives:

Automatically by means of H-Sphere update script (for H-Sphere 2.4.3 RC 2 and up)

1. Log into the CP server as root:
   
   # su -
2. Make sure you have H-Sphere 2.4.3 or higher installed:
   
   # cat ~cpanel/shiva/psoft_config/hsphere.properties | grep HS_VERSION
   If you have an older version, update to the latest stable version.
3. Download the upgrade package for your H-Sphere version, untar it and execute as specified in steps 2-5 of the update instructions for this version.
4. In the upgrade script interface, type the following option to update Java to 1.4.2:
   javaupdate
   This will update your Java to 1.4.2 and will also update your H-Sphere Java classes.

Manually from Java 1.4.2 SDK by Sun Microsystems (Linux Only)

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. 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