Parallels H-Sphere 3.4.1 Release Notes

Copyright (c) 2011 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.4.1

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

Installation:

To install Parallels H-Sphere on Unix:

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

  2. Run the script with the install option:

    # sh U34.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.4/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.

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.4.1 from the version 3.4.0.

Note: in case you have older H-Sphere version it will be needed to upgrade to 3.4.0 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

Upgrade:

To upgrade Parallels H-Sphere on Unix:

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

  2. Run the script:

    # sh U34.0P1 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.4/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.4.1 from the version 3.4.0.

Before Update:

  1. Parallels H-Sphere 3.4.1 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.4.1 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.4/upgrade/html/index.htm.

After Update:

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

3. Supported Operating Systems

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

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

4.1 Changelog

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

Features and improvements in 3.4.1:

Common

  1. [+]  Added new type of promotion validator which allows discount for specified period of time.

  2. [+]  Added integration with Softaculous scripts auto installer.

  3. [*]  Added Virtuozzo hardware node hostname to a sample name in the container samples list.

  4. [*]  Allow zero priority for DNS MX records.

  5. [*]  Fixed incorrect notification claiming that charge stays within credit limit when taxes are used.

  6. [-]  Fixed incorrect warning about exhausting VZ disk space limit.

Unix

  1. [+]  ProFTPD updated to 1.3.2e (with ZDI-CAN-925 patch).

  2. [+]  ClamAV updated to 0.96.5.

  3. [+]  Apache 2 updated to 2.2.17.

  4. [+]  PHP 5 updated to 5.2.17.

  5. [+]  BIND updated to 9.6-ESV-R3.

  6. [*]  FTP sub-accounts now have username prefix by default, you may revert to old behavior by setting USE_FTP_SUBACCOUNT_PREFIX option to FALSE.

  7. [*]  Default value for MRTG's MaxBytes setting is now ten times bigger (12.5mln instead of 1.25mln), to fit for 100Mbit networks.

  8. [*]  Default key length of SSL Certificates generated by user request is increased to 2048 bits (was 1024).

  9. [*]  Updated blackhole.conf and enabled its customization: if blackhole.conf.custom exists and blackhole.conf is symbolic link to it, upgrade will not alter blackhole.conf.

  10. [-]  PostgreSQL service on RedHat is made automatically startable.

  11. [-]  MySQL 5.1.49 should now install smoothly on RedHat EL 3.

  12. [-]  Upgrade of old ProFTPD config files (using deprecated DisplayFirstChdir keyword) will be performed during upgrade of hsphere-ftp package.

  13. [-]  phpMyAdmin will not complain about MySQL client/server versions mismatch.

  14. [-]  hs_bck script is back in hsphere-scripts package.

  15. [-]  Support for both Perl versions on FreeBSD 7.3 is included into H-Sphere 3.4.1.

  16. [-]  X-PHP-Script header is added again to mails sent using PHP 5.

Windows

  1. [-]   IDN sites are now working in IIS7.

  2. [-]  Useless ASP.NET 4.0 option is not shown in ASP.NET editing combobox for domains hosted on Windows 2003.

  3. [-]  SSL options (Force SSL Connection / 128-bit key required) are now propagated to Windows boxes.

  4. [-]  Fixed processing of custom error documents of type ExecuteURL on Windows 2008.

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.
  6. 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.
  7. 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.
  8. 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.
  9. 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.
  10. 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.
  11. Rules Du Jour updates stopped function as deprecated.

Windows:

  1. Urchin statistics are not updating.
  2. Windows 2008 x64 specific problems:
  3. Migration problems (Windows 2003 to Windows 2008 x64):
  4. FTP subaccounts are unable to log on to the File Manager (WebShell).
  5. After performing "content move", anonymous FTP virtual hosts aren't removed from the "source" server.
  6. Web statistics isn't calculated if ISAPI_Rewrite is enabled.
    Solution for IIS7: use UrlRewrite module.
  7. "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.
  8. 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.
  9. 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 2011 Parallels. All rights reserved.