.. -*- mode: rst -*-

.. _EPEL: http://fedoraproject.org/wiki/EPEL

.. This is combination of the Ubuntu guide and the Centos guide for
   installing the web reports.

.. _appendix-guides-web-reports-install:

==================================
Dynamic (web) Reports installation
==================================

You need to install the bcfg2-web package that is available for your
particular distribution. All packages for Fedora are in the Fedora
Package Collection.

You can find packages for CentOS and RHEL in EPEL_::

    [root@system01 ~]# yum -y install bcfg2-web

The same packages are needed for Debian/Ubuntu systems::

    [root@system01 ~]# aptitude install bcfg2-web

Add DBStats to the plugins line of ``bcfg2.conf``. The resulting
**[server]** section should look something like this::

    [server]
    repository = /var/lib/bcfg2
    plugins = Base,Bundler,Cfg,...,DBStats

You then need to initialize the DBStats reporting database::

    [root@system01 ~]# bcfg2-admin reports init

Start/restart the Bcfg2 server::

    [root@system01 ~]# /etc/init.d/bcfg2-server restart

Run the Bcfg2 client in order to populate the statistics database
(this run should take a bit longer since you are uploading the client
statistics to the database).

Copy server/statistics sections of ``bcfg2.conf`` to
``/etc/bcfg2-web.conf`` (make sure it is world-readable).  You should
then have something like this::

    [server]
    repository = /var/lib/bcfg2
    plugins = Base,Bundler,Cfg,...,DBStats

    [statistics]
    sendmailpath = /usr/lib/sendmail
    database_engine = sqlite3
    # 'postgresql', 'mysql', 'mysql_old', 'sqlite3' or 'ado_mssql'.
    database_name =
    # Or path to database file if using sqlite3.
    #<repository>/etc/brpt.sqlite is default path if left empty
    database_user =
    # Not used with sqlite3.
    database_password =
    # Not used with sqlite3.
    database_host =
    # Not used with sqlite3.
    database_port =

Restart apache and point a browser to your Bcfg2 server.

If using sqlite be sure the sql database file and directory containing
the database are writable to apache.