Parallels Virtualization and Automation Software

RESOLUTION

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 =
DEFAULT_CP_PORT =
If you are running SiteStudio, also update this line:
PATH_SITE_STUDIO = http://:/studio/servlet/psoft.masonry.Builder
3. Edit /hsphere/local/home/cpanel/apache/conf/httpd.conf:
Port
4. If you are running SiteStudio, update all SiteStudio configuration files that are located in /hsphere/shared/SiteStudio/psoft_config/.

Changing H-Sphere URL:

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.