Preparing for Upgrading Parallels H-Sphere

Consider this before you update Parallels H-Sphere:

• Before upgrading earlier versions to 3.2 and up, make sure to upgrade your key at https://www.parallels.com/hsphere/key_upgrade/ The upgrade will not work without a new valid Parallels H-Sphere license from unified Parallels licensing system to cover all accounts in the system. Upon upgrade to version 3.2 Patch 2, you would lose your older license and would not be able to enter your control panel unless you apply a new one.
• Please refer to the list of operating systems supported by Parallels H-Sphere.

  Warnings:

  1. Update to Parallels H-Sphere 2.5 and up is not recommended for Parallels H-Sphere clusters with CP servers under FreeBSD 4.x up to FreeBSD 4.9, as these FreeBSD versions do not fully support Java 1.5.
  2. Parallels H-Sphere Winbox versions earlier than 2.5 won't work correctly with Parallels H-Sphere 2.5 RC 1 and up. In the same way, Winbox 2.5 RC 1 and up won't work with Parallels H-Sphere under 2.5.
  3. Serv-U FTP is no longer supported in Parallels H-Sphere Winbox 2.5 and up. If you are currently using it and would like to update to this version, first switch to MS FTP as described in the Migration of Serv-U to MS-FTP section of Parallels H-Sphere System Administrator Guide.
  4. We currently don't recommend updating Parallels H-Sphere to version 2.5 and up when there are 512 and more ColdFusion mappings on a Windows server (i.e., ColdFusion is turned on for more than 511 Winbox users).
  5. No update is any longer available for RedHat 7.3, RedHat AS/ES/WS, FreeBSD 4.x, 5.x, 6.0. All Parallels H-Sphere servers under these operating systems need to be migrated to other supported OS's before the update.
• configuration files for Apache, FTP, PHP, DNS, MySQL, and PostgreSQL should be customized indirectly via respective template files. Otherwise, all custom changes in major default configuration files are removed with each Parallels H-Sphere update. Please carefully follow the configuration file templates customization instruction.

  If you update to Parallels H-Sphere 3.2 Patch 2 from Parallels H-Sphere 2.5 or 3.0, your custom configuration file templates will be ignored. You need to recustomize them.

• Update on boxes with FreeBSD 5.3 and up will halt if the /hsphere directory is a symlink! Please re-partition your servers' HDD to move Parallels H-Sphere content to the /hsphere directory before you proceed with the update. Please refer to Appendix B. HDD Partitioning.
• If you have CP installed on a FreeBSD box, especially in case of multiprocessor architecture, please make sure you have the /etc/libmap.conf file on the CP box that can be downloaded from http://hsphere.parallels.com/downloads/libmap.conf.
• If you have a mail server running on the same box as the CP server, and CP server uses port 80, change CP port to 8080 in /hsphere/local/home/cpanel/apache/conf/httpd.conf or contact Parallels H-Sphere support (http://www.parallels.com/support/hsphere/).
• Custom server groups for name (DNS) logical servers are no longer supported. If you are upgrading from Parallels H-Sphere 2.4.3 or earlier versions, please remove all custom name server groups (including all respective logical/physical servers). Please refer to Server Groups section of Parallels H-Sphere Administrator Guide at http://www.parallels.com/en/hsphere/docs/ for details.
• MySQL Updates.
  • If you are running MySQL version 3.x, please update to the latest MySQL 4.x version prior to updating Parallels H-Sphere.
  • Update MySQL v. 4.0 to 4.1: If your clients created databases/tables/fields in the tables with specific charset, please refer to the following documentation:
    • Character set upgrade (http://dev.mysql.com/doc/refman/4.1/en/charset-upgrading.html).
    • Connection Character Sets and Collations (http://dev.mysql.com/doc/refman/4.1/en/charset-connection.html).
  • The procedure of MySQL update from version 4.x to 5.0 is performed automatically. But it is reasonable to refer to the following documentation:
    • Upgrading from MySQL 4.1 to 5.0 (http://dev.mysql.com/doc/refman/5.0/en/upgrading-from-4-1.html).
    • mysql_upgrade - Check Tables for MySQL Upgrade (http://dev.mysql.com/doc/refman/5.0/en/mysql-upgrade.html).
    • mysql_fix_privilege_tables - Upgrade MySQL System Tables (http://dev.mysql.com/doc/refman/5.0/en/mysql-fix-privilege-tables.html).
• Since Parallels H-Sphere 3.0+, you can download installation/update script from our mirror site at http://download2.hsphere.parallels.com. For more information refer to Parallels H-Sphere install/update script options section.
• If you update from Parallels H-Sphere 3.1 Beta 1 or earlier, please make sure to update EasyApp with the respective collection package built for Parallels H-Sphere 3.2 Patch 2.