man get_state




NAME

  get_state - generate current state files


SYNOPSIS

  get_state [-options] [type[...]]


DESCRIPTION

  The  get_state  script is distributed with uaxtools and utilizes a suite of scripts
  in sbin/gs_type to collect information about a node.  These scripts have been  used
  with various Linux and cluster implementations to scrape information about nodes to
  facilitate monitoring changes.  The scripts utilize the etc/gs.base and etc/gs.host
  configuration  files  to facilitate customizing what is collected.  If no 'type' or
  'test' is specified the GSGET and GSADD variables in the configuration files define
  what  is collected.  There are a number of customizable variables in the configura-
  tion files and it is intended that scripts can be added or modified as needed.  The
  suites  vary  by  cluster type and this distribution includes samples from Cray XT,
  Penquin scyld/beowulf, and IBM xcat clusters.  The  get_state  script  can  be  run
  daily,  weekly,  or  on demand depending on site needs and should be run before and
  after any significant upgrade.

  The distribted default for output files is /var/local/state.  Files named *.txt are
  current  with previous versions being *.1, *.2, ....  The scripts and configuration
  files are intended to filter volatile information so the current files can be  eas-
  ily compared with previous versions.

  There  are  many  sbin/gs_* type scripts included in the distrubution.  The default
  GSGET for a Linux host are:

  hardware uses /etc/mtab, /etc/etab, lspci, lsusb, lsscsi,  fdisk,  dmidecode,  uals
  /dev and other commands.

  network uses ifcfg-eth*, netstat, route, exportfs, ifconfig, ethtool and ibstat.

  chkconfig uses chkconfig, systemctl and beochkconfig.

  sysctl uses sysctl and drop_caches.

  iptables uses iptables and ip6tables.

  rpm uses rpm.

  modules uses module avail.

  software uses lsmod and uaps.
         The  uaps  is filtered to identify all ppid=1 root and other defined daemons
         (e.g., to identify when a daemon is missing).

  etc uses uals /etc with sum and filters.

  var uses uals --type d /var.

  mbr uses dd mbr and sfdisk.


OPTIONS

  -all   entire cluster (run from boot|head node).

  -e     do NOT exit non-zero if changes, forced with -all (push).

  -q     do not report 'no changes' (quiet).

  +q     do report 'no changes'.

  -d     enable set -x (debug).

  -p     purge unchanged *.0 files.

  -t test
         specify tests to run.

  -T test
         specify tests to ADD.

  +t test
         specify tests to exclude.

  -c dir specify output directory.

  -b dir specify directory where etc and sbin reside.

  -u uid invoke as specified user.

  -g gid specify group to own files.

  -v     verbose mode.


ACKNOWLEDGEMENTS

  Written at the University of Alaska.  Ongoing maintenance via SourceForge by Denali
  Sun Consulting.

  Suggestions or bug reports can be directed to denalisun907@gmail.com.


RELATED INFORMATION

  See: uaxtools(8), chk_state(8), uals(1), uaps(1), push(8).