Parallels H-Sphere 3.3 Patch 1 (Build 1154) Release Notes

Copyright (c) 2009 by Parallels

Please report all bugs and issues using the following feedback form: http://www.parallels.com/en/psoft/feedback. Also, we will appreciate that you communicate successful installations and upgrades over the same system.

Parallels H-Sphere documentation is available at http://www.parallels.com/en/products/hsphere/docs.

1. Installing Parallels H-Sphere

• 1.1 Installing Parallels H-Sphere Control Panel and *nix Servers
• 1.2 Installing Parallels H-Sphere Winbox

2. Upgrading Parallels H-Sphere

• 2.1 Updating Parallels H-Sphere Control Panel and *nix Servers
• 2.2 Updating Parallels H-Sphere Winbox

3. List of Packages Installed with Parallels H-Sphere

4. What's New in Parallels H-Sphere 3.3

• 4.1 Changelog
  • Unix Features and Improvements in H-Sphere 3.3 Patch 1
  • Windows Features and Improvements in H-Sphere 3.3 Patch 1
  • Unix Features and Improvements in H-Sphere 3.3
  • Windows Features and Improvements in H-Sphere 3.3
• 4.2 Known Problems

5. Contact Information

1. Installing Parallels H-Sphere

1.1 Installing Parallels H-Sphere Control Panel and *nix Servers

Pre-Installation:

Parallels H-Sphere 3.2 and later require a new License according to the Parallels H-Sphere Licensing. To purchase or lease a new license key, go to http://www.parallels.com/store/hsphere/.

Before installing H-Sphere 3.3 Patch 1:

• Make sure you have an up-to-date license.
• In your firewall settings, open the port 5224 and specify the connection type 'tcp'.
• Make sure the ifconfig utility on CP box has 755 permissions.

Installation:

To install Parallels H-Sphere on Unix:

1. Download Parallels H-Sphere 3.3 Installation/Update script available at http://download.hsphere.parallels.com/shiv/HS/releases/U33.0/U33.0P1/U33.0P1.

2. Run the script with the install option:

   # sh U33.0P1 install

   Installation script will run in interactive mode.

3. Follow instructions of the interactive installation wizard.

For more details on installing Parallels H-Sphere on Unix, refer to the H-Sphere Control Panel Installation Guide at http://hsphere.parallels.com/docs/3.3/installation/cp/html/index.htm.

Post-Installation:

• When the installation is finished, Parallels H-Sphere Control Panel will be available at http://SERVICE_IP:8080.
• Parallels H-Sphere installation program does not set up missing service IPs. You should set them up manually.
• After Parallels H-Sphere is installed, it includes two accounts which may not be deleted:
  1. the admin account (login: admin, password: admin) to configure system settings. It is highly recommended to change the password of this account as soon as the installation and testing have been completed.
  2. the wwwuser account to manage the control panel domain, which is also used by other servers in the system.

1.2 Installing Parallels H-Sphere Winbox

Pre-Installation:

You can also refer to the Preparing Windows Server documentation.

Installation:

To install Parallels H-Sphere Winbox:

1. In Control Panel, add proper physical and logical servers.

   For details, please refer to the Winbox Installation documentation.

2. (Optional) If adding new Windows server to a NAT configured Parallels H-Sphere cluster, add this server IPs to the ~cpanel/shiva/psoft_config/ips-map.xml file.

3. Download Parallels H-Sphere Windows HsCore MSI package available at http://download.hsphere.parallels.com/shiv/HS/WINDOWS/HsCore_3.3.281.3415.msi.

4. Run the downloaded installation package and follow the wizard's instructions.

Note: Some third-party Parallels H-Sphere services (like Miva or ColdFusion) will not be installed on the Windows server if the original software is absent on the box. First, install the third-party software, and then run the Update Wizard on this box again to install respective Parallels H-Sphere MSI packages (HSMiva, HSColdFusion, etc.).

Post-Installation:

Please contact support and inform us about the installation. This is required to get appropriate support from Parallels.

2. Upgrading Parallels H-Sphere

This section instructs on how to upgrade Parallels H-Sphere to version 3.3 Patch 1 (Build 1154) from the version 2.5 and higher.

If there are Winboxes in your H-Sphere environment, please address both the following sub-sections consequently.

2.1 Upgrading Parallels H-Sphere Control Panel and *nix Servers

Before Update

Parallels H-Sphere 3.2 and higher requires a new License according to the Parallels H-Sphere Licensing structure. When upgrading to H-Sphere 3.3 Patch 1, you lose your older license and will not be able to enter your control panel unless you apply a new license.

Before upgrading to H-Sphere 3.3 Patch 1:

• Make sure to upgrade your key by going to: https://www.parallels.com/hsphere/key_upgrade/.
• In your firewall settings, open the port 5224 and specify the connection type 'tcp'.
• Make sure the ifconfig utility on the CP box has 755 permissions.
• If you are on RHEL 4 operating system, use kernel 2.6.9-55.0.9.EL and higher to work correctly with Java 1.6.

Update:

To update Parallels H-Sphere on Unix:

1. Download Parallels H-Sphere 3.3 Installation/Update script available at http://download.hsphere.parallels.com/shiv/HS/releases/U33.0/U33.0P1/U33.0P1.

2. Run the script:

   # sh U33.0P1

   Installation script will run in interactive mode.

3. Follow instructions of the interactive installation wizard.

For more details, please address to Parallels H-Sphere Upgrade Guide at http://hsphere.parallels.com/docs/3.3/upgrade/html/index.htm.

After Update

After you have updated Parallels H-Sphere, please make sure you meet the following requirements:

• Winbox Update. Upgrade Winbox to Parallels H-Sphere 3.3 Patch 1.
• Customization. If you have custom Parallels H-Sphere templates, you may probably need to update them according to changes introduced in this version.
• IMP Horde (Webmail). Having updated the package, make sure to migrate your Horde histories data into a separate table located in the Horde database (introduced in a new Horde version).

Find other post-upgrade issues in the H-Sphere Upgrade Guide.

2.2 Upgrading Parallels H-Sphere Winbox

This section instructs on how to upgrade Parallels H-Sphere Windows software to version 3.3 Patch 1 (Build 1154) from the version 2.5 and higher.

Before Update:

1. Parallels H-Sphere 3.3 Patch 1 for Windows is not compatible with Parallels H-Sphere 3.2 and lower version. Before upgrading a Windows box to the newer version, make sure that the Control Panel of the same version is already installed on the CP server.
2. Open SOAP port 10125 for data communication between Control Panel and Windows server.
3. If you are going to use Microsoft Windows SharePoint Services, make sure to install SharePoint before upgrading Parallels H-Sphere Winbox.
4. We currently do not recommend updating Parallels H-Sphere Winbox when there are 512 and more ColdFusion mappings on a Windows server (i.e., ColdFusion is turned on for more than 511 user domains).

Update:

To update Parallels H-Sphere Winbox:

1. (If upgrading from H-Sphere before v.3.1) Install on the target Winbox the HsCore package available at http://download.hsphere.parallels.com/shiv/HS/WINDOWS/HsCore_3.3.281.3415.msi.

2. Update the Winbox from the Control Panel:

   1. Go to E.Manager > Update > Update Boxes.

   2. Select checkboxes of the servers you need to update.

   3. Click Start Update.

For details, refer to the Parallels H-Sphere Upgrade Guide at http://hsphere.parallels.com/docs/3.3/upgrade/html/index.htm.

Installation Notes

• If you update from Parallels H-Sphere 2.5 or 3.0, Parallels H-Sphere home folder (for example, C:\HSphere or C:\HSphere.NET) will be moved to C:\Program Files\HSphere.
• If you update Winbox 2.5 or 3.0 with EasyApp installed, Update Wizard will build an MSI package out of EasyApp applications and install them into a new location. An older collection package will be uninstalled.

After Update:

Please contact support and inform us about the upgrade. This is required to get appropriate support.

3. Packages Installed with Parallels H-Sphere

This is a list of the latest stable packages for Parallels H-Sphere 3.3 Patch 1 (Build 1154).

Linux/FreeBSD rpm/tgz package list for Parallels H-Sphere 3.3 Patch 1 (Build 1154) is located at http://download.hsphere.parallels.com/shiv/HS/releases/U33.0/U33/pkglist.

Windows MSI package list for Parallels H-Sphere 3.3 Patch 1 (Build 1154) is located at http://download.hsphere.parallels.com/shiv/HS/releases/U33.0/U33/win_pkglist.

Some packages may be updated after you have installed/updated to this Parallels H-Sphere version! To update packages to their latest stable versions, run Parallels H-Sphere updater with the hspackages option.

Supported Operating Systems

• RedHat Enterpise Linux 3.x, CentOS 3.x, White Box Enterprise Linux 3.x
• RedHat Enterpise Linux 4.x, CentOS 4.x, White Box Enterprise Linux 4.x
• RedHat EL 4.x, CentOS 4.x, White Box EL 4.x (x86_64)
• RedHat Enterpise Linux 5.x, CentOS 5.x
• RedHat EL 5.x, CentOS 5.x (x86_64)
• FreeBSD 6.1, FreeBSD 6.2
• FreeBSD 6.3
• FreeBSD 7.0
• FreeBSD 7.0 amd64
• FreeBSD 7.2
• FreeBSD 7.2 amd64
• Windows 2000/2003

List of all Linux/FreeBSD operating systems supported by H-Sphere

RedHat Enterpise Linux 3.x, CentOS 3.x, White Box Enterprise Linux 3.x

Download location: http://download.hsphere.parallels.com/shiv/HS/RHES3/

RedHat Enterpise Linux 4.x, CentOS 4.x, White Box Enterprise Linux 4.x

Download location: http://download.hsphere.parallels.com/shiv/HS/RHES4/

RedHat EL 4.x, CentOS 4.x, White Box EL 4.x (x86_64)

Download location: http://download.hsphere.parallels.com/shiv/HS/RHES4_64/

RedHat Enterpise Linux 5.x, CentOS 5.x

Download location: http://download.hsphere.parallels.com/shiv/HS/RHES5/

RedHat EL 5.x, CentOS 5.x (x86_64)

Download location: http://download.hsphere.parallels.com/shiv/HS/RHES5_64/

FreeBSD 6.1, FreeBSD 6.2

Download location: http://download.hsphere.parallels.com/shiv/HS/FBSD61/

FreeBSD 6.3

Download location: http://download.hsphere.parallels.com/shiv/HS/FBSD63/

FreeBSD 7.0

Download location: http://download.hsphere.parallels.com/shiv/HS/FBSD70/

FreeBSD 7.0 amd64

Download location: http://download.hsphere.parallels.com/shiv/HS/FBSD70_64/

FreeBSD 7.2

Download location: http://download.hsphere.parallels.com/shiv/HS/FBSD72/

FreeBSD 7.2 amd64

Download location: http://download.hsphere.parallels.com/shiv/HS/FBSD72_64/

Windows 2000/2003

Download location: http://download.hsphere.parallels.com/shiv/HS/WINDOWS/

4. What's new in Parallels H-Sphere 3.3 Patch 1

4.1 Changelog

Legend:     [+]  Added new features       [*]  Improvements       [-]  Fixes

Unix features and improvements in 3.3 Patch 1:

1. [+]  Added FreeBSD 7.0 amd64, 7.2 i386/amd64 support

2. [*]  Updated System Packages:

   • hsphere-bind-9.4.3-3
   • hsphere-ftp-1.3.2-6
   • hsphere-phpmyadmin-2.11.9.5-1
   • hsphere-php 5.2.10-1
   • hsphere-php-accelerators-1-4
   • hsphere-cpanel-apache2-2.2.13-1
   • hsphere-apache2-h3.1-2.2.13-1
   • hsphere-mail-service-5-9

3. [*]  Included changes to meet the PCI DSS requirements. Please refer to KB#6585 to pass the PCI Compliants tests for your control panel server.

4. [*]  Zend Optimizer is updated to the latest available version

5. [*]  Updated mail service packages to be based on new ClamAV 0.95.2

6. [-]  Fixed problem with the recreate operation for DNS

7. [-]  Resolved problem with new requirements for ordering Comodo SSL certificates

8. [-]  Resolved problem with disabling promotions in plans

9. [-]  Resolved problem when dinamic zones update failed

10. [-]  Fixed problem with incorrect xferlog file rotation in FTP package

11. [-]  Fixed bug when statistics for only one year is displayed on index page after updating webalizer to 2.20.01

12. [-]  Fixed problem related to hsphere jail with usernames of more than 8 digits

13. [-]  Fixed a problem with recreating reseller end users when running the CommonUserCreator tool

14. [-]  Fixed problem when MX records related to Mail Relay remained in Mail Service Alias configuration after the Mail Relay is turned off for the primary domain's Mail Service

15. [-]  Fixed problem when e-mails with only LF endings caused segfault if the 'newline' option is disabled

16. [-]  Fixed problem with "SMTP cannot transfer messages with partial final lines. (#5.6.2)" messege returned by mail server

17. [-]  Resolved the issue with ClamAV not processing RAR archives due to the missed shared libraries

18. [-]  Fixed a problem when broken e-mails (FROM,TO or BODY removed) were delivered while RBL check-ups should have blocked these e-mails.

19. [-]  Fixed problem with segmentation fault if running clamdscan utility from console

20. [-]  Fixed a problem with Traffic Limit notifications not sent to resellers

21. [-]  Solved a problem with setting the "Pass-Through Value" when configuring PayPal Merchant Gateway

22. [-]  Solved a problem with CNAME, MX and TXT records not created when running CommonUserCreator

23. [-]  Fixed a problem with editing plans in case a logical server group set previously does not exist any longer

24. [-]  Fixed a problem when Dedicated Server prices lost after editing reseller plans

25. [-]  Removed the option to enable Miva 4.14 for Windows platform in logical server settings

26. [-]  Improved navigation in the Reseller Plan Editing wizards when using the "Leave prices as they are" options

27. [-]  Fixed a problem when determining Parallels Sitebuilder Hotfix key failed

28. [-]  Fixed a problem with adding sitebuilder plans

29. [-]  Fixed a problem with Parallels Sitebuilder installation with separate MySQL box (used for Sitebuilder)

30. [-]  Fixed a bug with MySQL configuration failing during Parallels Sitebuilder installation in case H-Sphere 3.3 Control Panel box is installed with DNS service only

31. [-]  Solved a problem with turning on the reseller CP SSL feature the problem might have arisen after upgrade to Parallels H-Sphere 3.3)

32. [-]  Solved a problem with "package deletion error!" message that might appear when upgrading Parallels H-Sphere core related packages

33. [-]  Added validation of user info provided for domain registration to prevent sending international characters to registrars, which might cause the “Unrecognized Message Format” errors

34. [-]  Fixed an issue with the Virtuozzo Server group available for adding for all physical servers

35. [-]  Solved a problem with setting the “Memory Limit” value for Virtuozzo Containers

36. [-]  Fixed a bug with H-Sphere Apache FreeBSD 6.2 Segmentation Fault

37. [-]  Fixed a problem with the CVV code not passed when signing up users via the Parallels H-Sphere XML API

38. [-]  Fixed a problem with invoking method 'getPlanPeriodIds()' when using the Parallels H-Sphere XML API

Windows features and improvements in 3.3 Patch 1:

1. [*]  Updated PHP to version 5.2.10 for Windows servers

Unix features and improvements in 3.3:

1. [+]  Implemented management of Virtuozzo clusters through Parallels H-Sphere. For more details, refer to the Parallels Virtuozzo Containers chapter in the Parallels H-Sphere Administrator Guide.

2. [+]  Added Sitebuilder support. For more information, refer to the Parallels H-Sphere Administrator Guide: Parallels Sitebuilder Integration.

3. [+]  Added experimental support of PHP accelerators (APC, eAccelerator, XCache).

4. [+]  Added PHP encoding support (ionCube Loader, Zend Optimizer).

5. [+]  Added the greylisting method of filtering spam to user interface. For details, see the Parallels H-Sphere User Guide: Managing Greylisting Settings.

6. [+]  Introduced new mail service schema based on the qmail-qfilter (improves support of new clamAV versions).

7. [+]  Introduced mail domain keys management.

8. [*]  Updated System Packages:

   • hsphere-bind-9.4.3-2
   • hsphere-phpmyadmin-2.11.9.4-1
   • hsphere-php 5.2.9-1
   • mysql-5.0.77
   • hsphere-php 4.4.9-3
   • hsphere-apache2-h3.1-2.2.11-1

      based on new version 2.5.7 of modsecurity;

   • hsphere-cpanel-apache2-2.2.11-1
   • hsphere-utils-1_10
   • hsphere-apache-shared-h3.1-1_7
   • hsphere-webmails-h2.5-2_35

      based on Horde 3.2.4, Turba 2.2.2 and IMP 4.2.2;

   • hsphere-sudo-1.6.9p20-1
   • hsphere-ftp-1.3.2-2
   • hsphere-php-accelerators-1-2
   • hsphere-mail-service-5-2

      supports the latest ClamAV version 0.95.1;

   • hsphere-update-3.0-1
   • hsphere-info-1-15
   • hsphere-aspell-0.60.5-1
   • hsphere-awstats-6.8-2

9. [*]  Rolled back the possibility to turn on old scheme's domain aliases that allows adding paid domains, free domain aliases, and free subdomains.

10. [*]  Updated Parallels SiteStudio to version 1.8.

    • [*]  Included new Parallels skin and made it default.

    • [-]  Fixed a problem with the "Contact Us" form.

    • [-]  Solved a configuration problem on FreeBSD when upgrading to a newer version.

    • [-]  Solved minor layout template issues.

11. [-]  Fixed a bug when Parallels H-Sphere could not get system information for FreeBSD 7.0.

12. [-]  Fixed a bug when Extra Packages could not be removed.

13. [-]  Fixed a problem with the external_credits table not processed.

14. [-]  Fixed the platformchange package incompatibility with Parallels H-Sphere 3.2+.

15. [-]  Fixed a bug when subdomains could not be set to Free for H-Sphere 3.2+.

16. [-]  Fixed an issue with Apache failing to switch to fastcgi mode.

17. [-]  Fixed a problem with getting box information on large Windows server installations.

18. [-]  Added localizable resource descriptions that were missing in previous versions.

19. [-]  Fixed a problem with Mail Service records duplicated in the plan_iresource table.

20. [-]  Fixed a problem with adding Miva licenses if there are empty lines in the list.

21. [-]  Fixed a problem with the absent 'isa_trademark' required field in requests for .ca domain registration.

22. [-]  Fixed a problem with generating SSL Certificate Requests if some parameters are empty strings (for example, organizationName).

23. [-]  Fixed a problem with renewing ComodoSSL certificates.

24. [-]  Fixed a bug with generating an internal ticket when Miva license update number is too long.

25. [-]  Solved a problem with occasional appearance of inappropriate description "Refund reseller" in Reseller Billing Statements instead of "Recurrent reseller".

26. [-]  Solved a problem with MySQL client libraries used for various operating systems.

27. [-]  Solved a problem with spell-checker not working in the Control Panel.

28. [-]  Solved a problem with incorrect data in the quota usage report on FreeBSD 7.0.

29. [-]  Solved a problem with configuration of HTTP Accept Filter when upgrading Parallels H-Sphere.

30. [-]  Solved a problem with incorrect environment variables set for Apache version 2.xx on FreeBSD boxes.

31. [-]  Corrected the GeoIP.dat download location used for the Awstats service.

32. [-]  Solved a problem with disk quotas not enabled when installing Parallels H-Sphere.

33. [-]  Solved a problem with CRAM MD5 SMTP authorization method not working.

34. [-]  Solved a problem with the mail sslserver process that could fail on CentOS 5.xx x86_64.

35. [-]  Solved a problem with apache/PHP segmentation fault on CentOS 4.xx x86_64.

36. [-]  Solved a problem with the 'hspackages exclude' command used when installing/upgrading Parallels H-Sphere.

Windows features and improvements in 3.3:

1. [+]  Added Sitebuilder support for Windows hosting.

2. [+]  Added support for PHP 4.4.9 and PHP 5.2.9.

3. [-]  Fixed an issue with Urchin statistics for Windows hosted sites not updating.

4. [-]  Fixed an issue when some AWstats logs were processed improperly.

5. [-]  Fixed a problem with AWStats and Webalizer log when the AWStats parameter PurgeLogFile is set to 1.

6. [-]  Fixed a problem with the size of insufficient network buffer (500k) for some requests, for example, when sending cluster configuration information for large clusters.

7. [-]  Fixed a problem with WebShell file manager not working.

8. [-]  Fixed a problem with recreating/migrating Windows domains when instant domain alias is off.

9. [-]  Fixed an issue when the installer service fails to start.

10. [-]  Fixed an issue with restarting the "hsphere" service when upgrading Windows boxes for future Parallels H-Sphere versions.

4.2 Known Problems

Unix:

1. In libphp mode, PHP scripts run under httpd, while in CGI/FastCGI mode, under their user, and this may cause permission conflicts when switching between PHP modes.
2. PHP settings redefined at the level of the Apache VirtualHost (VH) configuration (in case of customized VH templates) will be ignored in CGI/FastCGI mode.
3. Java 1.6 requires kernel 2.6.9-55.0.9.EL and higher to work correctly in RHEL 4 operating system family.
4. Using PHP op-code cache accelerators often leads to the web server crash by causing a segmentation fault.
5. If customization related to PHP Acceleration and Encoding (iOn Cube, Zend) has not been removed from the PHP configuration files before the upgrade, this may lead to configuration errors or even crashes.

Windows:

1. FTP subaccounts are unable to log on to the File Manager (WebShell).
2. After performing "content move", anonymous FTP virtual hosts aren't removed from the "source" server.
3. "Default web site" and entries below can prompt access credentials because authentication for "default web site" is set to allow only "integrated windows authentication". The problem appears after upgrading Parallels H-Sphere Winbox from 3.0 to 3.1.
4. When HsMiva, HsColdFusion, HsUrchin are not installed on Winbox, it causes "!" critical warning near the win_hosting logical server. However, it does not affect the workability of Winbox.
5. PHP SQLite extension for Parallels Sitebuilder on WinBox does not support UTF-8 encoding, so text information on the site may be displayed incorrectly. Customers will see the warning:

   PHP SQLite extension does not support UTF-8 encoding on the publishing server. Text information on the site may be displayed incorrectly.

5. Contact Information

Parallels Holdings
660 SW 39th Street
Suite 205
Renton, Washington 98057
USA

Phone: +1 (425) 282 6400
Fax: +1 (425) 282 6444

Web: http://www.parallels.com/

E-mail:
For billing information, email accounting@parallels.com
For purchasing or partnering information, email sales@parallels.com
To report problems with Parallels software, email bugreport@parallels.com
For information on career opportunities with Parallels, email careers@parallels.com
For press contact information, email press@parallels.com
For information about becoming a Partner, email partners@parallels.com
For information on translating into your language, email i18n@parallels.com
For general product information, email info@parallels.com

©Copyright 2009 Parallels. All rights reserved.