H-Sphere config.xml

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.

config.xml

config.xml (sample config.xml) is used in H-Sphere Pre-Configuration Wizard. It contains H-Sphere cluster configuration: physical servers with their IPs and root passwords to install H-Sphere to, and logical servers to be installed on these boxes.

During regular H-Sphere installation, config.xml is formed in H-Sphere Pre-Configuration wizard in admin CP and is temporarily stored in the ~cpanel/.settings directory. After completing H-Sphere installation in the postinstall mode, installer removes this file. However, the postinstall mode won't continue if config.xml is missing or is different from the one used at the installation.

When installer runs in the install mode, it is required that you specify location of the correctly formed config.xml. See installer options.

config.xml Elements and Attributes

In the following chart xml elements are marked as bold and their attributes in italics.

physicalServers - a list of H-Sphere physical servers, each of them described as physicalServer with attributes:
   id - id of the physical server
   name - name of the physical server
   password - root password to a physical server

Each physicalServer contains ip and logicalServers elements:

• ip - server IP with attribute:
     type - type of the physical server
  
  Element ip contains such child elements:
  
  • addr - IP address
  • ipExt - external IP for NAT mapping
    * in case H-Sphere doesn't use NAT this child element is redundant
  • mask - IP mask
  
  
• logicalServers - a list of H-Sphere logical servers each of them described as logicalServer with attributes:
     group - group of the logical server
     id -id of the logical server
     name - name of the logical server

  Each logicalServer element contains ips element - a list of IPs, each of them described as ip with the following child elements:
  

  • addr - IP address
  • ipExt - external IP for NAT mapping
    * in case H-Sphere doesn't use NAT this child element is redundant
  • mask - IP mask