systems.cfg

systems.cfg is where you specify computer system hostnames, aliases, and groups.  The top-level systems.cfg file might reference smaller #include files, some of them perhaps auto-generated.

You use these systems specifications together with the '#if <machine class>' preprocessor directive to customize your PIKT configurations on a per-machine(s) basis and/or by operating system.

This is a rather elaborate example systems.cfg file, with many different host groups and aliases and auto-generated #include files.  Especially for smaller organizations, a typical systems.cfg might be much simpler than this.

///////////////////////////////////////////////////////////////////////////////
// 
// PIKT systems.cfg -- host systems, aliases, and groups
// 
///////////////////////////////////////////////////////////////////////////////
// 
// since #if-#endif's reference system names, this file cannot contain
// any #if-#endif's, since the system names are still in the process of
// specification!  (neither can this file contain #ifdef's or any of the
// other #-style preprocessor directives, except for #include; it can
// contain comments, though and obviously)
// 
///////////////////////////////////////////////////////////////////////////////
///////////////////////////////////////////////////////////////////////////////

// hosts, grouped by Unix or Linux operating system or operating system
// version

///////////////////////////////////////////////////////////////////////////////

solaris
        hosts           vienna
                        nantes berlin berlin2 warsaw moscow
                        athens2 athens4 milan
                        calais calais2 brussels
                        copenhagen madrid
                        kiev kiev2
                        paris paris4 paris5 paris6 paris7 paris8
                        hamburg cadiz trondheim rotterdam cologne naples

                        leiden ankara minsk uppsala padua bucharest sheffield

///////////////////////////////////////////////////////////////////////////////

// for linux, here is alternative way of registering hosts; here we
// subcategorize by os version, then in the hostgroups section below we
// aggregate the os subcategories into one big os host group (see the
// linux host groups below); doing it this way helps ensure that each
// host gets subcategorized; it also involves less typing overall

redhat
        hosts           manila davao dumaguete

suse
        hosts           vancouver toronto montreal calgary winnipeg ottawa

debian
        hosts           firenze murmansk

///////////////////////////////////////////////////////////////////////////////
///////////////////////////////////////////////////////////////////////////////

// host aliases

vienna
        aliases         piktmaster      // note: although =piktmaster is a
                                        // predefined macro, the piktmaster
                                        // alias here is needed if you want
                                        // to use '#if piktmaster' later
                                        // on in the configuration files
                        vienna.uppity.edu
                        piktdevsys

kiev
        aliases         antwerp

milan
        aliases         bonn rome

madrid
        aliases         madrid2

nantes
        aliases         nismaster ypmaster

paris
        aliases         paris3

moscow
        aliases         mailmanserver

// d153-82.twilight.zone.net
//      aliases         davao

// d153-241.twilight.zone.net
//      aliases         manila

///////////////////////////////////////////////////////////////////////////////
///////////////////////////////////////////////////////////////////////////////

// host groups

///////////////////////////////////////////////////////////////////////////////

// since we reference down in many of the '#verbatim [<proc>] directives
// that follow, we want to specify down as early in systems.cfg as
// possible so that subsequent references are most up-to-date

down                    // set '-H down' for these

        members // note: systems specially listed here must also be specially
                // listed in the =down specification in macros.cfg
                rotterdam
                padua
#verbatim <systems/down_systems.cfg> [/pikt/lib/programs/downsys.pl 10]

///////////////////////////////////////////////////////////////////////////////

// linux hostgroups

linux
        members        
                redhat
                suse
                debian

///////////////////////////////////////////////////////////////////////////////

// sun arch groups

sun4d
        members
#verbatim <systems/sun4d_systems.cfg> [/pikt/bin/piktc -xI +C "=uname -a |
          =egrep -i sun4d >/dev/null && =hostname"
          +H solaris -H down 2>/dev/null] 

sun4m
        members
#verbatim <systems/sun4m_systems.cfg> [/pikt/bin/piktc -xI +C "=uname -a |
          =egrep -i sun4m >/dev/null && =hostname"
          +H solaris -H down 2>/dev/null] 

sun4u
        members
#verbatim <systems/sun4u_systems.cfg> [/pikt/bin/piktc -xI +C "=uname -a |
          =egrep -i sun4u >/dev/null && =hostname"
          +H solaris -H down 2>/dev/null]

///////////////////////////////////////////////////////////////////////////////

// administrative-class hostgroups

itsys
        members         vienna
                        nantes berlin berlin2 warsaw moscow
                        athens2 athens4 milan
                        calais calais2 brussels
                        copenhagen madrid
                        kiev kiev2
                        paris paris4 paris5 paris6 paris7 paris8

                        hamburg cadiz trondheim rotterdam cologne

                        murmansk firenze
                        manila davao dumaguete

                        suse

mussys
        members         nonitsys

pvtsys                  // private systems

        members         manila davao dumaguete

///////////////////////////////////////////////////////////////////////////////

// shared-systems hostgroups

mus
        members
#verbatim <systems/mus_systems.cfg> [/pikt/bin/piktc -xI +C "=hostname |
          =grep kiev" -H down 2>/dev/null] 

perf
        members
#verbatim <systems/perf_systems.cfg> [/pikt/bin/piktc -xI +C "=hostname |
          =grep paris" -H down 2>/dev/null] 

comp
        members
                        milan
#verbatim <systems/comp_systems.cfg> [/pikt/bin/piktc -xI +C "=hostname |
          =grep madrid" -H down 2>/dev/null] 

///////////////////////////////////////////////////////////////////////////////

// it hostgroups

missioncritical             // mission-critical systems
        members
#include <systems/missioncritical_systems.cfg>

adminsys                // administrative, non-user systems
        members         vienna
                        nantes
                        berlin berlin2
                        moscow
                        athens2 athens4
                        calais calais2 brussels
                        copenhagen cologne

systems                 // sysadmin systems
        members         hamburg cadiz trondheim

db                      // database systems
        members         athens2 athens4 milan

usersys                 // in effect an alias for sunsuser
        members         berlin berlin2
                        moscow madrid perf mus

backupclient
        members         solaris linux

///////////////////////////////////////////////////////////////////////////////

// server hostgroups

mailserver
        members         moscow paris // kiev

appserver
        members         berlin2 // berlin

printserver
        members         helsinki copenhagen

backupserver
        members         calais brussels // calais2

webserver
        members         
#verbatim <systems/webserver_systems.cfg> [/pikt/bin/piktc -xI +C "=psall |
          =grep http | =egrep -v 'piktc|grep|ab2|-http' >/dev/null &&
          =hostname" +H solaris -H down 2>/dev/null]

dnsserver
        members         calgary ottawa

dnsmaster
        members         calgary

dnsslave
        members         ottawa

///////////////////////////////////////////////////////////////////////////////

// nis hostgroups

nisserver
        members
#include <systems/nisserver_systems.cfg>

nisclient
        members         solaris

///////////////////////////////////////////////////////////////////////////////

// nfs hostgroups

nfsserver
        members
#verbatim <systems/nfsserver_systems.cfg>
          [/pikt/bin/piktc -xI +C "=showmount -e |
          =egrep -ivs 'rpc: program not registered|no exported file systems'
          >/dev/null && =hostname" +H solaris -H down 2>/dev/null]

nfsclient
        members         solaris

no_usr_local            // no NFS crossmounted /usr/local on these machines
        members         linux
#verbatim <systems/no_usr_local_systems.cfg> [/pikt/bin/piktc -xI +C "=lld
          /usr/local/etc/tmp 2>&1 | =grep -i 'no such' >/dev/null &&
          =hostname" +H solaris -H down]

usr_local               
        members         nonno_usr_local

no_opt_local            // no NFS crossmounted /opt/local on these machines
        members         linux

opt_local
        members         nonno_opt_local

///////////////////////////////////////////////////////////////////////////////

// network hostgroups

local                   // sharing the same network segment with the piktmaster
        members
#verbatim <systems/local_systems.cfg> [/pikt/bin/piktc -xI +C "=ifconfig -a |
          =grep 123.111.130 >/dev/null && =hostname" -H down 2>/dev/null]

baksubnet               // sharing the machine room bak subnet
        members
#verbatim <systems/baksubnet_systems.cfg> [/pikt/bin/piktc -xI +C "=ifconfig -a |
          =grep 192.168.0 >/dev/null && =hostname" -H down 2>/dev/null]

///////////////////////////////////////////////////////////////////////////////

// special-function hostgroups

nosendmail
        members         kiev kiev2 athens2 athens4 warsaw vienna berlin
                        berlin2 nantes milan brussels madrid
                        paris4 paris5 paris6 paris7 paris8
                        calais2 // calais
                        murmansk firenze cologne leiden copenhagen calais

crem
        members         madrid kiev kiev2 paris4 paris5 paris6 paris7 paris8
                        naples // kiev3

kbt
        members         // empty

///////////////////////////////////////////////////////////////////////////////

// files and/or process management hostgroups

sudo
        members
#verbatim <systems/sudo_systems.cfg> [/pikt/bin/piktc -xI +C "=ls /etc/sudoers
          2>/dev/null | =grep sudoers >/dev/null && =hostname" -H down
          2>/dev/null]

tcpd
        members
                firenze
#verbatim <systems/tcpd_systems.cfg> [/pikt/bin/piktc -xI +C "=grep tcpd
          /etc/inetd.conf | =grep -v '^#'>/dev/null &&
          =hostname" -H down 2>/dev/null]

ntpd
        members
#verbatim <systems/ntpd_systems.cfg>
          [/pikt/bin/piktc -xI +C "=psall | =grep ntpd |
          =egrep -v ' piktc|grep' >/dev/null &&
          =ls /etc/ntp.conf 2>&1 |
          =grep -iv 'no such' >/dev/null &&
          =hostname" -H down 2>/dev/null]

///////////////////////////////////////////////////////////////////////////////
///////////////////////////////////////////////////////////////////////////////

// pikt admin hostgroups

///////////////////////////////////////////////////////////////////////////////

newsys                  // set '-D doexec +D verbose' for these (or just
                        // set these in defines.cfg accordingly)

        members         davao
                        //cadiz trondheim
                        //firenze

///////////////////////////////////////////////////////////////////////////////

testsys                 // set '+D debug' for these (or just
                        // set this in defines.cfg accordingly)

        members         davao
                        // piktmaster

///////////////////////////////////////////////////////////////////////////////

sick                    // set '-H sick' for these

        members
#verbatim <systems/sick_systems.cfg>

///////////////////////////////////////////////////////////////////////////////

(A note about page layout:  In the interest of readability, we have added artificial line wraps in many examples.  Even though displayed here broken up across several screen lines, in general quoted strings, preprocessor directives, macro definitions, .log & .conf entries, and so on should all be unbroken on a single line.)

For more examples, see Samples.