Appendix A. Installing with Prepared Parallels H-Sphere Configuration

It is possible to perform Parallels H-Sphere installation by importing a specially formatted config.xml file with all Parallels H-Sphere physical and logical servers' configuration.

Run the install script with the install option. In the installer's command line, enter:

install xml=CONFIG_XML_LOCATION [ skip-sitestudio ]

Creating config.xml file

Parallels H-Sphere includes the hsphere-info package installed on each Parallels H-Sphere Unix server. The package installs the /hsphere/shared/bin/hsinfo script on each server, and the script collects information about this server into the /hsphere/shared/etc/config.xml file.

The hsinfo has the following syntax:

Usage: 
hsinfo [ -ame ] [ -p box IP ] [ -g group ] [ -t type ] [ -f xmlfile ] [ -s delimiter ] 
hsinfo -l [ -p box IP ] [ -g group ] [ -s delimiter ] [ -f xmlfile ] 
hsinfo -i [ -ame ] [ -g group ] [ -f xmlfile ] [ -s delimiter ] 
hsinfo -n [ -p box IP ] [ -g group ] [ -f xmlfile ] 
hsinfo -o a[ddress]|i[nterface]|n[umber] [ -f xmlfile ] 
hsinfo -d [ -f xmlfile ] 
hsinfo -v [ -f xmlfile ] 
hsinfo -G 
hsinfo -T 
hsinfo -h -l list of logical server names 
	-i list of physical server IPs -n domain name of the logical server 
	-d servise zone name -p phisical box IP (default: local physical box) 
	-v hspere version 
	-a show IP address -m show mask 
	-e show external IP addreyyss 
	-o show network interface name of the physical IP 
	-G list of possible logical server groups 
	-T list of possible IP types 
	-h help 
by default show only IP addresses 
group: cp, mail, unix_hosting, windows_hosting, mysql, pgsql, mssql, dns, mrtg, system (default: all) 
type: system, service, shared, dedicated, resellerSSL, resellerDNS, all (default: service) 
xmlfile: XML file location (default: /hsphere/shared/etc/config.xml)

The /hsphere/shared/etc/config.xml XML file contains information about physical and logical server names, ids, IPs; system zones; current Parallels H-Sphere version, etc.

Sample config.xml

The /hsphere/local/config/customs/customs utility returns the files customized by user according to the customization conf_file. It has the following syntax:

Usage: 
customs [ -hmv ] [ -c conf_file ] { package_name1 } 
[ package_name2 ... ] 
	-h : to see this help message; 
	-m : to return the masks of the given packages (names only); 
	-v : verbose, package mask output before the list of its customized files; 
	-c conf_file : path to the user customization configuration file, 
				default: /hsphere/local/config/customs/customs.conf; 
package_nameN : name of the package to list the customized files for.