10.3. Making the SysOrb overview available to other programs

As a way to import the information from the SysOrb overview page into other programs, the Web interface has a special page, which outputs an overview of all nodes and domains in plain text.

In order to view this page, type in the following URL in our browser:

http://localhost/sysorb/index.cgi?path=2&username=your
login &passwd=your
password&tld=domain&server=servername:port
      

Where your login, your password, domain are replaced with the values normaly used to login (for the default user these are "admin", "admtest" and "."). The servername and port should be the dns-name of the SysOrb Server and the port it is running on. If the Webinterface runs on the same server as the SysOrb Server these values are "localhost" and "3241"

The output from this page has the following layout:

SysOrb text overview page

world   N: Ugly C: Good A: Good
*** Nodes ***
        test.sysorb.com N: Good C: Good A: Good
        *** NetChecks ***
                 [HTTP/80]      Good
        *** AgentChecks ***
                FS free space for /home Good
                FS free space for /     Good
                Free Memory for phys    Good
                Free Memory for swap    Good
                Free Memory for virt    Good
                System Load for load    Good
                Process Presence for httpd      Good
                Process Presence for init       Good
                Process Presence for syslogd    Good
                Process Presence for ntpd       Good
                System Uptime for uptime        Good
                RAID status for md0     Good
                System handles for alloc_fh     Good
                System handles for alloc_ino    Good
                System handles for free_fh      Good
                System handles for free_ino     Good
                Interface throughput for total receive drops eth0       Good
                Interface throughput for total receive errors eth0      Good
                Interface throughput for total received bytes eth0      Good
                Interface throughput for total transmitted bytes eth0   Good

The format is simple. After the introductionary line at the top the first line encountered is the name of the domain, the user is logged in to. After the name of the domain a there is a TAB character, and then the status for Network, Checkin and Agents, again seperated by TAB characters.

The next line is an identification line, which can be one of two. If there are subdomains in the users root-domain, the line is *** Domains ***, otherwise it is *** Nodes *** just as in the example above.

The lines following the identification line, will all be indented by a TAB character until another identification line is outputtet for the current domain, or the information for another domain is outputted.

After the *** Domains *** (if present) line all the subdomains to the current domain will be listed in the same way as the root domain is.

After the *** Nodes *** line all the nodes in the current domain will be listed, with their name first on the line, and the status after it, just like the status for the domain.

After the node line comes another identification line which can be either *** NetChecks ***, *** AgentChecks *** or *** snmpChecks ***. Afther the identification line, all the checks of the given type is listed, again idendented with another TAB character. After the name of the check, the status for it is listed.