This document explains how to upgrade H-Sphere 2.2 final or 2.3 RCx to version 2.3 final. If you have H-Sphere older than 2.2, upgrade yourself to 2.2 final first.

Procedure

1. Make sure to have version 2.2 final or 2.3 RCx installed:
   # cat ~cpanel/shiva/psoft_config/HS_VERSION
   
2. Unpack the downloaded file:
   # tar -xzf U23.tgz
3. Enter the unpacked directory:
   # cd U23
4. Stop H-Sphere Control Panel using the following commands:
   (they depend on the OS type and java servlet running engine):
   Linux + ApacheJServ:
   # /etc/rc.d/init.d/httpdcp stop
   FreeBSD + ApacheJserv:
   # /usr/local/etc/rc.d/apachecp.sh stop
   Any OS + Tomcat:
   # ~cpanel/tomcat/tomcat.sh stop
5. To update H-Sphere to 2.3 final, type:
   # make install
6. To update your SiteStudio to 1.6 RC1, type:
   # make ss
7. To update WebShell to version 3.0 and php to version 4.3.0, type:
   # make webshellphp
   To Update WebShell to version 3.0 without updating PHP, type:
   # make webshell
   You need to update WebShell with PHP if your PHP is older than 4.2.3.

   Note: With WebShell update -
   - the /usr/local/lib/php.ini file is backed up and then replaced during the update (by the H-Sphere default php.ini file). If you have custom php.ini settings, check the file after the update and reconfigure it according to your requirements. Make sure PHP safe mode is off.
   - the new version of PHP doesn't support some of the old PHP scripts that may cause problems;
   - osCommerce 2.0 may stop running, so make sure to update osCommerce to version 2.2.

8. Restart your SiteStudio ImageMaker. The simplest way to do it is type:
   killall java
   as root. Kill these processes one by one if you have any other java processes running.
9. Start H-Sphere CP using one of the following commands:
   Linux + ApacheJServ:
   # /etc/rc.d/init.d/httpdcp start
   FreeBSD + ApacheJserv:
   # /usr/local/etc/rc.d/apachecp.sh start
   Any OS + Tomcat:
   # ~cpanel/tomcat/tomcat.sh start
10. After your have completed the upgrade, check the version of H-Sphere using the following command:
    # cat ~cpanel/shiva/psoft_config/HS_VERSION
    
    You will get something similar to this:
    
    Where:
    2.3 is the version of H-Sphere,
    321 is H-Sphere the build number,
    is the build date (in YYYYMMDD format)
    
    
11. If you have updated H-Sphere database when updating to any of H-Sphere 2.3 release candidates, skip this step. Otherwise, type:
    # make moddb
    This will back up old H-Sphere database and modify H-Sphere DB scheme (increase some fields length, e.g: email, notes, suspend/resume reason etc).
12. If you have configured and used H-Sphere domain registrar manager with any of H-Sphere 2.3 release candidates, skip this step.
    H-Sphere 2.2 and earlier versions used the external OpenSRS package and the OpenSRS configuration was placed into the /etc/OpenSRS.conf file. Starting with version 2.3, H-Sphere has an internal OpenSRS engine and should be configured using the admin Control Panel interface. At this point, you need to migrate OpenSRS data from the /etc/OpenSRS.conf file into H-Sphere DB using the OpenSRSMigrator tool. If you haven't been providing OpenSRS domain registratioin services and don't have the OpenSRS.conf file and the external OpenSRS package installed and configured, skip this step.
    1. Log into your CP box as cpanel:
    su -l cpanel
    2. Launch OpenSRS migrator to process plans and migrate OpenSRS prices:
    java psoft.hsphere.tools.OpenSRSMigrator
    3. Login as root and restart H-Sphere.
    More on H-Sphere Domain Registrar Manager.
13. If you have configured your OpenSRS account settings to work with any of H-Sphere 2.3 release candidates, skip this step.
    Go to your OpenSRS web interface and Re-register your OpenSRS keys to use the Blowfish crypting algorithm. Then go to your admin control panel and select Domain Registrar in the Settings menu. In the OpenSRS settings, enter the generated OpenSRS keys. Don't enter them in the opensrs.conf file. This is required because in version 2.3, H-Sphere doesn't use OpenSRS client and addresses OpenSRS directly using Blowfish.
14. Starting with version 2.3 RC4, H-Sphere uses A records instead of CNAME records for reseller server aliasing to improve reseller transparancy. To force these changes on resellers' control panels, you or your resellers have to:
    1. Log into the reseller admininstrative panel.
    2. Go to E.Manager -> Server aliases.
    3. Delete all server aliases in the "Other reseller`s server aliases" section.
    4. Click Submit to regenerate reseller server aliases based on A records.

    To check if the changes have taken effect, go to E.Manager -> DNS manager and click the Edit icon for this DNS zone. The Type of Built-in DNS records for reseller server aliases should change to "A". This step can be done for different resellers at different times.