Parallels H-Sphere Documentation System Administrator Guide


hsphere-info: Collecting Information about H-Sphere Servers into XML Configs

(version 2.5 Beta 2 and up)

Last modified: 24 Nov 2005


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.

H-Sphere 2.5 Beta 2 and up includes the hsphere-info package installed on each 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:

   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 H-Sphere version, etc.

Sample config.xml

Note: This sample XML is for NAT configured H-Sphere cluster. Otherwise, if external IPs are used for H-Sphere logical and physical servers, the extIP attribute is omitted, for example:

<ip type="shared">

© Copyright 2017. Parallels Holdings. All rights reserved.