Parallels H-Sphere Documentation System Administrator Guide


Control Panel Server Configuration


Last modified: 27 Dec 2007


WARNING: This documentation covers Parallels H-Sphere versions up to 3.1. For the latest up-to-date Parallels H-Sphere documentation, please proceed to the official Parallels site.

Control Panel (CP) is the H-Sphere logical representation for managing servers and hosting resources via web interface. It is implemented as a Java servlet that runs on its own Apache server. CP is a separate logical server and is included in every H-Sphere configuration.

This document covers the following Control Panel issues:


Installed Software

  • Apache server version 1.3.x (before HS 3.1), 2.2.x (HS 3.1 and up)
  • SSL support: OpenSSL
  • CP back-end servlet engine: Jakarta Tomcat
  • System database: PostgreSQL 7.4.x and up
  • SiteStudio - site builder optionally installed with H-Sphere on the CP server.

See the list of installed packages per version for CP Server.


Interaction Between Servers

Servers in H-Sphere clusters communicate only through the Control Panel. There is no way for servers like web and DNS exchange commands directly.

To communicate with Linux/Unix servers, CP uses Shell or Perl scripts via SSH protocol (port 22) as the cpanel user.
Communication between the CP and Windows servers is performed through the SOAP protocol (port 10125), which allows for cross-platform exchange of data in XML documents via HTTP.


Location Of CP Files And Directories

By default, the cpanel user home directory is /hsphere/local/home/cpanel.

There you will find the following files and directories:

apache - CP Apache installation
apache/etc - CP Apache configuration
apache/etc/httpd.conf - CP Apache configuration file
shiva - H-Sphere related binary and config files
shiva/psoft_config - H-Sphere config files
shiva/psoft_config/ - H-Sphere config file
shiva/psoft_config/HS_VERSION - file that contains version number of H-Sphere
shiva/shiva-templates - H-Sphere templates location, DocumentRoot for Apache server.
shiva/shiva-templates/index.html - Redirect to control panel; served when the CP URL is accessed

/hsphere/shared/SiteStudio/psoft_config/ - SiteStudio config file (could be on a different server)

To make changes in these files, log into the CP server as the cpanel user.


The H-Sphere Configuration File (

The H-Sphere configuration file should be located at ~cpanel/shiva/psoft_config/

1) CP URL configuration - URL by which H-Sphere is called:
CP_HOST = -- host name
CP_PORT = 8443 -- port
CP_PROTOCOL=https:// -- protocol
CP_URI = /psoft/servlet/psoft.hsphere.CP

- This is not the only place where those settings have to be altered.
- URI cannot be changed here at the moment.
- Make sure that DNS is properly configured if you want to change domain.
- Make sure to alter Apache if you want to change domain and port.

2) Database settings (see the system dababase settings below)

3) Log file:
log4j.appender.A1.File=/var/log/hsphere/hsphere.log - location of the log file.


Control Panel Apache Server Configuration

CP Apache home directory is /hsphere/local/home/cpanel/apache.

All CP Apache server configurations are placed into the etc/jserv subdirectory of the Apache home directory: /hsphere/local/home/cpanel/apache/etc/jserv.

This directory also has its symlink: /hsphere/local/home/cpanel/apache/conf.


Control Panel Back-End Servlet Engine

CP server uses Jakarta Tomcat servlet engine and is automatically installed with Tomcat embedded.

Read about Tomcat configuration in a separate document.


Reseller Configuration

/hsphere/local/home/cpanel/apache/etc/sites/ contains resellers' SSL and virtual host configuration.

  • /hsphere/local/home/cpanel/apache/etc/{reseller_main_account_name}.conf - reseller Apache virtual host configuration file
  • /hsphere/local/home/cpanel/apache/etc/{reseller_main_account_name}/ - reseller SSL directory.

Reseller SSL Configuration

If SSL is enabled for reseller, the following files are placed into the reseller SSL directory:

  • server.crt - reseller SSL certificate
  • server.key - reseller SSL private key

CP SSL Configuration

In the /hsphere/local/home/cpanel/apache CP Apache home directory:

  • etc/ssl.crt/server.crt - file with server SSL certificates.
  • etc/ssl.csr/server.csr - file with SSL signing request.
  • etc/ssl.key/server.key - file with SSL/RSA private key.

CP Apache Log Files

Log files are located in the /hsphere/local/home/cpanel/apache/logs directory.


CP Traffic Calculation

Traffic generated from browsing the Control Panel is not included in the summary traffic. To track it, H-Sphere owners may set up any third-party utilities.


The H-Sphere System Database

The H-Sphere system database is used to store system data. In normal H-Sphere configuration, it runs on PostgreSQL server. Usually, the system database is located on the same server with the Control Panel.

The system database is not for user hosting! PostgreSQL hosting server cannot be installed on the same box with the system database!

The H-Sphere database is executed under the pgsql or postgres user.

The System Database Settings

Database settings in (this should be enough to connect to db):

DB_DRIVER = org.postgresql.Driver
DB_URL = jdbc:postgresql:// - the system database name, usually hsphere
DB_USER = wwwuser - the system db user name, usually wwwuser
DB_PASSWORD = your_db_password - the system db user password
DB_NEWID = SELECT nextval(''{0}'')

Logging Into The System Database

To log into the system database:

  1. Login as the cpanel user to the server where the system database is located (usually, CP server).
  2. Enter the hsphere database (usually, under the wwwuser user name):
    # psql hsphere [user_name]

See also the instructions on:

VACUUM Utility

The Postgres VACUUM instruction allows cleaning up the server transactions. Enter the psql server:
# psql hsphere wwwuser and type in the password set in

In the psql command line, type the 'vacuum full' command:
vacuum full;
The command may vary in different versions of Postgres.

Note: vacuum is a time-consuming procedure; it may take up to several hours to complete!


CP Mail Queue

The mail queue file is assigned to store unsent CP messages (e.g., trouble tickets, system notifications, mass mail, etc.) when CP is restarted - formerly, they were lost after CP restart. Mail queue location is set in


© Copyright 2018. Parallels Holdings. All rights reserved.