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

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:

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 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">
  <addr>11.22.33.44</addr>
  <mask>255.255.255.0</mask>
</ip>

The /hsphere/local/config/customs/customs utility returns the files customized by user acording 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.