Parallels H-Sphere Documentation System Administrator Guide

 

Changing CP URL

 
 

Related Docs:   Tomcat 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.

 

Changing IP Address To Domain Name In CP URL

Sometimes, mostly when you have just installed H-Sphere, you receive the following error while trying to access your Control Panel by domain name:

Control Panel Error
You have entered invalid control panel location. Please enter your account login and password.

In this case, you need to change your hostname to your CP domain name instead of the IP address:

  1. Log into your CP server as the cpanel user.
  2. Edit the hsphere.properties file:
    vi ~cpanel/shiva/psoft_config/hsphere.properties
    In the CP_HOST field, enter the domain name instead of the IP address.
  3. Important: If you changed the PATH_SITE_STUDIO variables in ~cpanel/shiva/psoft_config/hsphere.properties file to a domain name, make sure to change IP to the domain name in all SS conf files (/hsphere/shared/SiteStudio/psoft_config/).

  4. Restart H-Sphere.
 

Changing H-Sphere Port

By default, H-Sphere is configured to use port 8080, and it is not recommended to use other ports. However, if you still need to change the port:

  1. Login to CP server as the cpanel user.
  2. Edit ~cpanel/shiva/psoft_config/hsphere.properties:
    CP_PORT = <CUSTOM_CP_PORT>
    DEFAULT_CP_PORT = <CUSTOM_CP_PORT>
    If you are running SiteStudio, also update this line:
    PATH_SITE_STUDIO = http://<CP_IP>:<CUSTOM_CP_PORT>/studio/servlet/psoft.masonry.Builder
  3. Edit /hsphere/local/home/cpanel/apache/conf/httpd.conf:
    Port <CUSTOM_CP_PORT>
  4. If you are running SiteStudio, update all SiteStudio configuration files that are located in /hsphere/shared/SiteStudio/psoft_config/.
 

Changing Entire CP URL

Control Panel runs on the Tomcat servlet engine and therefore CP URL pathname configuration differs from that of JServ in prevous versions.

A typical H-Sphere control panel URL looks similar to
http://example.com:8080/psoft/servlet/psoft.hsphere.CP/
where:
example.com   is the domain name,
psoft/servlet   is the mount point,
psoft.hsphere.CP   is the servlet name.

  1. Login to CP server as the cpanel user.
  2. Edit ~cpanel/shiva/psoft_config/hsphere.properties to change your servlet name and mount point:
    # old settings -- commented out
    # UPLOADER_URL = /psoft/servlet/psoft.hsphere.Uploader
    # DOWNLOAD_URI = /psoft/servlet/psoft.hsphere.Downloader
    # CP_URI = /psoft/servlet/psoft.hsphere.CP
    # CLIENT_CP_URL = psoft.hsphere.CP

    # new settings
    UPLOADER_URL = /cp/servlet/hsphere.Uploader
    DOWNLOAD_URI = /cp/servlet/hsphere.Downloader
    CP_URI = /cp/servlet/hsphere.CP
    CLIENT_CP_URL = hsphere.CP

    Important: To avoid problems, please check that the same servlet name and mount point are set in all these parameters! CP_URI takes the precedence otherwise.

  3. Logout from cpanel back to root and run the jakarta_servlet_upt.pl script to apply the new servlet name and mount point to the Tomcat configuration files and to the index page template ~cpanel/shiva/shiva-templates/index.html:
    cd ~cpanel/shiva/psoft_config
    ./jakarta_servlet_upt.pl
    The script replaces old servlet name and mount point in the following files:
    ~cpanel/hsphere/WEB-INF/web.xml
    ~cpanel/apache/etc/mod_jk.conf
    ~cpanel/jakarta/conf/server.xml
    ~cpanel/shiva/shiva-templates/index.html
    Original configuration files are backed up:
    ~cpanel/hsphere/WEB-INF/web.xml.ORG
    ~cpanel/apache/etc/mod_jk.conf.ORG
    ~cpanel/jakarta/conf/server.xml.ORG
    ~cpanel/shiva/shiva-templates/index.html.ORG

    Important: Don't forget to run this script after the H-Sphere update to apply your CP URL customization in the new version!

  4. Restart H-Sphere.
 

Setting Multiple Alternative CP URL's

(H-Sphere 3.0 and up)

To specify several alternative CP URL's for main Admin CP:

  1. Log into your CP server as the cpanel user.
  2. Enter the hsphere.properties file:
    vi ~cpanel/shiva/psoft_config/hsphere.properties
  3. In the CP_HOST field, set several host names using semicolon as separator:
    CP_HOST=cp.testhost.com;cp.testhost1.com;10.0.1.20
  4. Restart H-Sphere.

Related Docs:   Tomcat Configuration



© Copyright 2017. Parallels Holdings. All rights reserved.