Parallels H-Sphere 3.6 Release Notes

Copyright (c) 2012 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

2. Upgrading Parallels H-Sphere

3. Supported Operating Systems

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

5. Contact Information


1. Installing Parallels H-Sphere

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

Pre-Installation:

Before installing H-Sphere 3.6:

Installation:

To install Parallels H-Sphere on Unix:

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

  2. Run the script with the install option:

    # sh U36.0 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.6.0/installation/cp/html/index.htm.

Post-Installation:

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 and HsInstaller MSI packages for your OS:

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

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

  6. (Windows 2008 R2) Run the downloaded HsGeneralHosting_IIS75 installation package and follow the wizard's instructions.

  7. (Windows 2008 R2) Run the downloaded HsWeb_IIS75 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.).

2. Upgrading Parallels H-Sphere

This section instructs on how to upgrade Parallels H-Sphere to version 3.6 from the version 3.5.1.

Note: in case you have older H-Sphere version it will be needed to upgrade to 3.5.1 first.

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

Pre-upgrade:

  1. Make sure you have an up-to-date license.

Upgrade:

To upgrade Parallels H-Sphere on Unix:

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

  2. Run the script:

    # sh U36.0 update

    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 Parallels H-Sphere Upgrade Guide at http://hsphere.parallels.com/docs/3.6.0/upgrade/html/index.htm.

Post-upgrade:

2.2 Upgrading Parallels H-Sphere Winbox

This section instructs on how to upgrade Parallels H-Sphere Windows software to version 3.6 from the version 3.5.1.

Before Update:

  1. Parallels H-Sphere 3.6 for Windows is not compatible with Parallels H-Sphere 3.3 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. Parallels H-Sphere 3.6 for Windows requires ASP.NET 2.0. Ensure that your server has ASP.NET 2.0 before upgrading Parallels H-Sphere.
  3. 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. 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.6.0/upgrade/html/index.htm.

3. Supported Operating Systems

This is a list of supported operating systems for Parallels H-Sphere 3.6.

4. What's new in Parallels H-Sphere 3.6

4.1 Changelog

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

Windows

  1. [*]  ColdFusion 9.0.1 is supported.

Unix

  1. [+]  Added RedHat EL 6.x, CentOS 6.x i386/amd64 support

  2. [+]  Added FreeBSD 7.4 support

  3. [+]  Added PHP5.3 support

  4. [*]  Updated Apache to 2.2.22.

  5. [*]  Updated ClamAV to 0.97.4.

  6. [*]  Updated MySQL to 5.1.63 (5.1.62 for FreeBSD).

  7. [*]  Updated ModSecurity to 2.6.5.

  8. [*]  Updated Tomcat (jakarta) to 6.0.35.

4.2 Possible Issues & Recommended Workarounds

Windows:

  1. Subaccount prefix doesn’t work for windows accounts.
  2. Edit SSL / "Install Certificate based on previously generated Certificate request" option doesn’t work for windows boxes.
  3. Coldfusion 9.0.1 works only on sites with 64-bit application pools on Windows 2008x64 and Windows 2008x64 R2
  4. Windows 2008 x64 / Windows 2008 R2 specific problems:
  5. Migration problems (Windows 2003 to Windows 2008 x64):
  6. FTP subaccounts are unable to log on to the File Manager (WebShell).
  7. After performing "content move", anonymous FTP virtual hosts aren't removed from the "source" server.
  8. Web statistics isn't calculated if ISAPI_Rewrite is enabled.
    Solution for IIS7: use UrlRewrite module.
  9. "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.
  10. When HsMiva, HsColdFusion, HsUrchin are not installed on Winbox, it causes "!" critical warning near the win_hosting logical server on the Enteprise Manager page. However, it does not affect the workability of Winbox.
  11. 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.

Unix:

  1. If the server is running RHEL / CentOS 6, customer sites must use WebShell 4. WebShell 5 requires the end-of-life PHP 4, which is not supported by these operating systems.
  2. On apache 1.3, PHP version 5.3 is currently supported only in libphp mode.
  3. RHEL / CentOS 6 is not supported as CP server in H-Sphere 3.6.
  4. PHP version 4 is not supported on RHEL / CentOS 6 in H-Sphere 3.6.
  5. Apache fails to start after installation on RHEL / CentOS 6
    Workaround: Login to CP as admin, go to the Physical server settings, disable all available php4 modes and click Submit.
  6. Some modules don't work with perl 5.10.1 on FreeBSD 7.4. Therefore we recommend to update the perl package to 5.12.4 on FreeBSD. For example, you can run the following command to update it:
    $ pkg_delete -f perl-* ; pkg_add -r perl
    After perl update you need to switch hsphere's perl modules to new version by running the following command:
    $ /hsphere/local/config/perl/hspmod.switch
  7. "Will be charged" info is shown incorrectly when refund is greater then recurrent.
  8. Java 1.6 requires kernel 2.6.9-55.0.9.EL and higher to work correctly in RHEL / CentOS 4 operating system family.
  9. Internal server error during publishing SiteBuilder site.
    Workaround: add "FastCgiConfig -idle-timeout 60" string right after FastCgiServer directive to ~cpanel/apache/conf/sitebuilder.conf, ~cpanel/apache/conf/sitebuilder.conf.tmpl.linux and restart httpdcp service.
  10. Sitebuilder installation/update (as a part of physical server update) can fail if there are two or more IP addresses assigned to Control Panel logical server.
    Workaround: remove all extra IP addresses from Control Panel logical server, and restart update of corresponding physical server.
  11. During physical server update, MySQL warns about three deprecated configuration settings.
    Workaround: before updating the physical server, create /hsphere/local/config/mysql/my.cnf_tmpl.custom based on /hsphere/local/config/mysql/my.cnf_tmpl, fix the created custom template using information from MySQL web site, and run /hsphere/local/config/mysql/scripts/config_mysql.
  12. On FreeBSD, /hsphere/shared/bin/rrdtool will refuse to run if these packages are not installed: freetype2, png (all FreeBSD versions) and libart_lgpl (only modern FreeBSD versions).
    When you try to run it manually, error message looks like:
    /libexec/ld-elf.so.1: Shared object "libpng.so.5" not found, required by "rrdtool"
    Workaround: install needed packages manually.
  13. On RedHat, /hsphere/shared/bin/rrdtool and /hsphere/shared/bin/mrtg will refuse to run if these packages are not installed: freetype, libpng (all RedHat versions) and libart_lgpl (only modern RedHat versions).
    When you try to run rrdtool manually, error message looks like:
    /hsphere/shared/bin/rrdtool: error while loading shared libraries: libart_lgpl_2.so.2: cannot open shared object file: No such file or directory
    Similarly, mrtg service will start, but in /var/log/mrtg/current you will see continuous errors like:
    @400000004d5064950cb85edc Can't load '/hsphere/shared/lib/perl5/site_perl//auto/RRDs/RRDs.so' for module RRDs: libpng12.so.0: cannot open shared object file: No such file or directory at /usr/lib64/perl5/5.8.8/x86_64-linux-thread-multi/DynaLoader.pm line 230.
    @400000004d5064950cc7f70c at /hsphere/shared/bin/mrtg line 342

    Workaround: install needed packages manually.

Announcements

Parallels Hsphere will not support DNS bogon list (blackhole.conf) in the hsphere-bind package starting from the next 3.6.1 release.

5. Contact Information

Parallels Holdings, Ltd.
c/o Parallels International GmbH
Vordergasse 59
CH-Schaffhausen
Switzerland
Phone: +41-526320-411
Fax: +41-52672-2010

Web: http://www.parallels.com

E-mail:
For billing information, send e-mail to accounting@parallels.com
For purchasing information, send e-mail to sales@parallels.com
For technical support, use our Online Support Form.
To report problems with Parallels software, send e-mail to bugreport@parallels.com
For information on career opportunities with Parallels, send e-mail to careers@parallels.com
For press contact information, send e-mail to press@parallels.com
For information about becoming a partner, send e-mail to partners@parallels.com
For information on translating Parallels software into your language, send e-mail to i18n@parallels.com
For general product information, send e-mail to info@parallels.com

Copyright © 1999-2012 Parallels Holdings, Ltd. and its affiliates. All rights reserved.

This product is protected by United States and international copyright laws. The product.s underlying technology, patents, and trademarks are listed at http://www.parallels.com/trademarks.

Microsoft, Windows, Windows Server, Windows NT, Windows Vista, and MS-DOS are registered trademarks of Microsoft Corporation.

All other marks and names mentioned herein may be trademarks of their respective owners.