• Changing IP Address To Domain Name In CP URL
• Changing Entire CP URL

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:
   su - cpanel
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. Restart H-Sphere.

Changing Entire CP URL

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:
   su -
   su - cpanel
   
   
2. Changing SERLVET NAME
   
   1. Edit the ~cpanel/apache/conf/jserv/zone.properties file.
   2. Find section "# Servlet Aliases" and add the line
      servlet.yourname.code = psoft.hsphere.CP
      Example:
      servlet.cp.code = psoft.hsphere.CP
      servlet.example.cp.code = psoft.hsphere.CP
      This will allow you to use cp, or example.cp instead of psoft.hsphere.CP.
   
   
3. Changing CP domain name
   

   Edit the ~cpanel/shiva/psoft_config/hsphere.properties file:
   CLIENT_CP_URL = NEW_SERLVET_ALIAS
   Example:
   CLIENT_CP_URL = cp
   
   CP_URI = NEW_MOUNT_POINT/NEW_SERVLET_ALIAS
   Example:
   CP_URI = /cp
   
   DOWNLOAD_URI = NEW_MOUNT_POINT/psoft.hsphere.Downloader
   Example:
   DOWNLOAD_URI = /psoft.hsphere.Downloader
   You can also add another servlet alias for psoft.hsphere.Downloader servlet, see above for more details.
   
   UPLOADER_URL = http://host:port/NEW_MOUNT_POINT/psoft.hsphere.Uploader
   Example:
   UPLOADER_URL = http://psoft.net:8080/psoft.hpshere.Uploader
   
   CP_HOST = NEW_CP_HOST
   Example:
   CP_HOST = example.com

   Again, you can setup another servlet alias, to change it as well.
   
4. In /hsphere/local/home/cpanel/shiva/shiva-templates/index.html, change line
   <a href="/psoft/servlet/psoft.hsphere.CP">Control Panel</a>
   to specify the correct location of H-Sphere.
5. Restart CP.

At this moment, we don't have a solution to change the mount point without affecting the performance of H-Sphere.