summaryrefslogtreecommitdiffstats
path: root/doc/server/plugins/misc/ohai.txt
blob: e9fec7cc033ccacbe8c7dade7519afdb1a933239 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
.. -*- mode: rst -*-

.. _server-plugins-misc-ohai:

Ohai
====

.. _Ohai: http://wiki.opscode.com/display/ohai/Home
.. _Ohai-Install: http://wiki.opscode.com/display/ohai/Installation

The `Ohai`_ plugin is used to detect information about the client
operating system. The data is reported back to the server using JSON.

Client prerequisites
--------------------

On the client, you need to install `Ohai`_. See `Ohai-Install`_ for more
information.

Server prerequisites
--------------------

If you have python 2.6 or later installed, you can continue on to
:ref:`ohai-setup`. Otherwise, you will need to install the
python-simplejson module found packaged in most distributions.

.. _ohai-setup:

Setup
-----

To enable the Ohai plugin, you need to first create an ``Ohai`` directory
in your Bcfg2 repository (e.g. ``/var/lib/bcfg2/Ohai``). You then need
to add **Ohai** to the plugins line in ``bcfg2.conf``. Once this is done,
restart the server and start a client run. You will have the JSON output
from the client in the ``Ohai`` directory you created previously.