Parallels H-Sphere 3.2 (Build 1000) Release Notes

Copyright (c) 2008 by Parallels

Please report all bugs and issues through the following feedback form: http://www.parallels.com/en/psoft/feedback. Also we will apreciate that you communicate successful installations and upgrades over 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.2

• 4.1 Changelog
  • Unix features and improvements in 3.2
  • Windows features and improvements in 3.2
• 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:

H-Sphere 3.2 requires a new License according to 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.2:

• 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 ifconfig utility on CP box has 755 permissions

Installation:

To install Parallels H-Sphere on Unix, follow our H-Sphere Control Panel Installation Guide at http://hsphere.parallels.com/docs/3.2/installation/cp/html/index.htm

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

Post-installation:

• When the installation is finished, Parallels H-Sphere Control Panel will be available at http://SERVICE_IP:8080
• Parallels H-Sphere install program doesn't 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 very highly recommended to change the password of the admin account after the installation and testing have been completed.
  2. the wwwuser account to manage the control panel domain, which is also used by the other servers of the system.

1.2 Installing Parallels H-Sphere Winbox

Pre-installation:

You can also refer to the Preparing Windows Server documentation.

Installation:

• Parallels H-Sphere Winbox resources are installed by means of respective MSI packages.
• Some third party Parallels H-Sphere services (like Miva or ColdFusion) won't be installed to 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).

To install Parallels H-Sphere Winbox, refer to our H-Sphere Winbox Installation Guide (http://hsphere.parallels.com/docs/3.2/installation/win/html/index.htm)

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

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

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

This guide instructs how to upgrade Parallels H-Sphere Windows software to 3.2 (Build 1000) from the version 2.5 and up.

Before Update

IMPORTANT: H-Sphere 3.2 requires a new License according to Parallels H-Sphere Licensing structure. When upgrading to H-Sphere 3.2, you would lose your older license and would not be able to enter your control panel unless you apply a new one.

Before upgrading to H-Sphere 3.2:

• 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 ifconfig utility on 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, follow our Parallels H-Sphere Upgrade Guide at http://hsphere.parallels.com/docs/3.2/upgrade/html/index.htm

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

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.2. Parallels H-Sphere Winboxes of earlier versions are not compatible with Parallels H-Sphere Control Panel 3.1 and up.
• 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 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 guide instructs how to upgrade Parallels H-Sphere Windows software to 3.2 (Build 1000) from the version 2.5 and up.

Before Update:

1. Parallels H-Sphere Windows 3.1 and higher is not compatible with Parallels H-Sphere 3.0 or lower. Before you update Parallels H-Sphere Winbox to 3.1+, make sure to update Parallels H-Sphere to the corresponding version.
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 don't 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 H-Sphere Winbox, follow our Parallels H-Sphere Upgrade Guide at http://hsphere.parallels.com/docs/3.2/upgrade/html/index.htm

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

• Parallels H-Sphere Winbox resources are installed by means of respective MSI packages.
• 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 the list of latest stable packages for Parallels H-Sphere 3.2 (Build 1000).

Linux/FreeBSD rpm/tgz package list for Parallels H-Sphere 3.2 (Build 1000) is located here: http://download.hsphere.parallels.com/shiv/HS/releases/U32.0/U32.0/pkglist

Windows MSI package list for Parallels H-Sphere 3.2 (Build 1000) is located here: http://download.hsphere.parallels.com/shiv/HS/releases/U32.0/U32.0/win_pkglist

Important: 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 5.5
• FreeBSD 6.1, FreeBSD 6.2
• FreeBSD 6.3
• Windows 2000/2003

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 5.5

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

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/

Windows 2000/2003

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

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

4.1 Changelog

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

Unix features and improvements in 3.2:

1. [+]  Updated System Packages:

   • hsphere-bind-9.4.2.2-1
   • hsphere-webalizer-2.20.01_2
   • hsphere-mail-service-4-43
   • hsphere-webmails-h2.5-2_34
   • hsphere-phpmyadmin-2.11.9.2-1
   • hsphere-awstats-6.8-1
   • hsphere-rsync-3.0.4-1
   • H-Sphere PHP 4.4.9 packages
   • H-Sphere PHP 5.2.6-2 packages
   • hsphere-update-2.1-29
   • hsphere-apache-shared-h3.1-1-5
   • hsphere-jail-1.9_2
   • H-Sphere MySQL-5.0.67 packages
   • H-Sphere Webshell packages

2. [+]  Introduced uniform Parallels licensing. Licenses will be automatically updated from the Parallels Key Administrator site.

3. [+]  The Hosting resource is made billable in Plan Wizard. Due to this, you can now set independent prices for domain and domain alias resources.

4. [+]  Now if a customer changes his payment type from Trial to Paid, he is charged for all resources he used during the trial period. Added an option in plan wizard to zero out the customer's balance before changing payment type from Trial to Paid.

5. [+]  Added support for FreeBSD 6.3.

6. [*]  Payflow Pro SDK: PayPal announced EOL for v2 and v3. Support for a new PayPal Pro for SSL SDK is implemented by a separate .hsp package.

7. [*]  Added MySQL and PostgreSQL drivers in addition to the pdo_sqlite PHP extension implemented in 3.1 Patch 1.

8. [*]  Added support of new fuctions in Webalizer config file /hsphere/local/config/webalizer/webalizer.cfg: webalizer_init_config(), webalizer_get_config(), webalizer_get_version()

9. [-]  Restored the deprecated ASPSecuredResource class for compatibility reasons

10. [-]  Fixed XSS vulneribility in Webshell

11. [-]  Added a correct notification text on adding new IPs in the Signup Guard, Moderation section.

12. [-]  Fixed a security issue when one could log from a restricted admin account into the main admin account.

13. [-]  Now mail alias cannot contain dots in its name.

14. [-]  Now MX record cannot point to an alias defined by CNAME record.

15. [-]  Removed a duplicate addAutoResponder function from MailServices WSDL, added addAutoResponderWithoutIncMsg function.

16. [-]  Fixed an issue with setting separate prices for TrustLogo and Card Payment TrustLogo in Settings -> Comodo SSL in user CP.

17. [-]  Fixed an issue when Comodo Premium SSL Certificate with TrustLogo cannot be purchased.

18. [-]  Fixed an issue with allowing duplicate requests during Comodo SSL addition/renewal.

19. [-]  Added creation of the /hsphere/tmp directory into the postinstall scriptlets to eliminate an error message about Urchin temp log directory creation.

20. [-]  Fixed an issue with submitting SSL Options in user CP with "128-bit key required" and "Force SSL Connection" set.

21. [-]  Fixed an issue with httpd_extra, httpd2_extra, httpdcp_extra ctemplates options not being supported by the updater script.

22. [-]  Implemented graceful Apache restart in the analyze.pl script for Apache 2.x, prefork mode or with libphp5 enabled.

23. [-]  Fixed an error with adding accounts with the Turkish "i" letter.

24. [-]  Fixed an issue with not finding physical boxes during the update in Turkish locale.

25. [-]  Fixed handling of Error 503 page.

Windows improvements:

1. [-]  Fixed an issue with creation of duplicate dedicated IP bindings when a virtual host was created outside H-Sphere or when Indexes are enabled for a domain.

2. [-]  Fixed a Windows user problem with submitting an intermediate certificate for dedicated SSL.

3. [-]  Fixed an issue with submitting SSL Options in user CP with "128-bit key required" and "Force SSL Connection" set.

4. [-]  Fixed a bug with Awstats resource deletion.

5. [-]  Fixed an issue with launching AWStats service.

6. [-]  Fixed a problem with creation of the HSCleanup package during the update on a MSSQL-only server.

7. [-]  Fixed an issue with upgrade failure on Win2000 server.

8. [-]  Fixed an error during the Windows server content: Service "rsyncservice" not found

9. [-]  Fixed upgrade failure when the MySQL driver file is in use by another process.

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 possible 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

Windows:

1. FTP subaccounts are unable to log on to the File Manager (WebShell)
2. After the "content move" process 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 win_hosting logical server. However, it doesn't affect the workability of Winbox.

5. Contact Information

Parallels Headquarters
660 SW 39th Street
Suite 205
Renton, Washington 98057
USA
Phone: +1 (425) 282 6400 
Fax: +1 (425) 282 6444 
World Wide Web: http://www.parallels.com

E-mail:
 For billing information, email accounting@parallels.com
 For purchasing or partnering information, email sales@parallels.com and psoft@parallels.com
 For technical support, use our Online Support Form.
 To report problems, 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 general product information, email info@parallels.com

Copyright (c) 2008, Parallels Inc. All rights reserved.