func-inventory (1) - Linux Manuals

func-inventory: Takes inventory of data from func minions, and stores them in git.

NAME

func-inventory -- Takes inventory of data from func minions, and stores them in git.

SYNOPSIS

func-inventory [--verbose] [--server-spec glob] [--methods list] [--modules list] [--tree path] [--no-git]

DESCRIPTION

func-inventory runs against func-minions to gather information, and stores this information on the filesystem, in a tree arranged by hostname, module name, and method name.

After each update, differences are commited to version control (using git), where they can be examined with tools such as ``git log'' and ``gitk''.

--verbose

Provides extra output about what func-inventory is doing.

--server-spec

A glob, as can be given to ``func'', that describes what machines the inventory program should run against. The default is ``*''.

--modules list

A comma-seperated list of modules that should be included in the inventory, for instance ``hardware,packages''. The default is ``all''.

--methods list

A comma-seperated list of methods that should be included in the inventory, for each module being queried. The default is ``info'', which saves the data for any module that has an ``info'' method.

--tree-path

Selects the location where func-inventory will output data. The default is /var/lib/func/inventory. This directory will contain a tree structure based on the hostnames, modules, and methods included in the inventory.

--no-git

Disables git integration, meaning changes will not be tracked using version control. This option is present for those that do not have the ``git-core'' package installed, though installing it is highly recommended to get the full degree of power out of func-inventory.

VIEWING CHANGES

Since func-inventory integrates with git, all changes to the remote systems (including additions of new systems) can be tracked using standard git-tools such as ``git log'' and ``gitk'', when run on the directory specified for --tree.

Additional built in hooks to notify changes can be written using git's own trigger mechanism, though something more specific to func will likely be developed in the future --- also eliminating the need to grok git internals.

ALTERNATIVE OUTPUT FORMATS

func-inventory can be passed a --json or --xmlrpc parameter to override the default output format. These output formats are much less readable in the git-produced diffs, but are more easily loaded by other programs that may want to ``mine'' the output of a func-inventory tree. Using --json requires that the python-simplejson RPM be installed.

ADDITONAL RESOURCES

See https://fedorahosted.org/func/ for more information.

See also the manpages for ``func'', ``funcd'', ``certmaster'', ``certmaster-ca'', and ``func-transmit''.

AUTHOR

Michael DeHaan <mdehaan [at] redhat.com>