Enabling JFFNMS
===============
There is a configuration file at /etc/apache2/conf-available/jffnms.conf
The easiest way is to edit one of the configuration files for a site and
add the line
  Include /etc/apache2/conf-available/jffnms.conf

and re-start Apache.

JFFNMS can be found at http://<your-web-server>/jffnms/ 
You will see the initial configuration screen. click "save changes" at the 
bottom to save the configuration file.

Postgresql access for webserver
-------------------------------
    Allow the webserver to be able to access the postgresql database.
    There is a jffnms unix user that cron runs under that has ownership of
    the database. For MySQL you can just use that user.  For postgresql,
    the simplest way is to add a password to the jffnms user.
    Whatever you set the password to, make sure it is the same in the
    setup screen at step 3.
    # su -s /bin/sh postgres
    $ psql jffnms
    jffnms=# ALTER USER jffnms PASSWORD 'mypassword';
    ALTER USER
    jffnms=# \q
    
Further Documentation
---------------------
There is a JFFNMS Document on the web at http://www.jffnms.org/docs/jffnms.html
which you probably want to read.

Default User
------------
The default user for JFFNMS is username admin, password admin.

Configuration file Changed
--------------------------
From JFFNMS 0.7.9 to 0.8.0 the configuration file changed from
/etc/jffnms/config.ini to /etc/jffnms/jffnms.conf. The format of the
file also changed.  There should not be much in the new configuration
file as it is only for items that change from the default.

Directory Changes
-----------------
A lot of the examples and documentation in the package will refer to
directories beginning with /opt/jffnms  The Debian JFFNMS package follows
the filesystem standards which means instead of /opt/jffnms files
are found at:
  * /etc for configuration files
  * /usr/share/jffnms for the program and unchanging files
  * /var/lib/jffnms for changing and status files, such as RRD
  * /var/log/jffnms for logs

TFTPd Configuration
-------------------
Whatever TFTP daemon you choose to use, if you want config transfers to
work correctly then you need to make it get/put files into /var/lib/jffnms/tftp

Manual Database Updates
-----------------------
The database installation and updating is now being performed by a 
package called dbconfig-common.  If you decide not to let it do automatic
installation and updates, then you will need to create the database manually.

The database creation files are found in 
/usr/share/dbconfig-common/data/jffnms/install, one file each for mysql or
pgsql.  You will need to create a jffnms user and make sure it owns the
tables.

For updating the files are found in
/usr/share/dbconfig-common/data/jffnms/install/<database_type>, eg
mysql or pgsql.  You will need to import each file in the
directory in order, starting from the version above the version
you previously installed.

SNMP trap receiver
------------------
To get the SNMP trap receiver to work you will need to:
  * Install the snmpd package, which contains snmptrapd
  * Change /etc/snmp/snmptrapd.conf file, look in /usr/share/doc/jffnms/examples

Why is this version DFSG?
-------------------------
The upstream package ships with a non-free (in fact most likely 
unredistributable) font. I have had to remove that font and rebuild
the source and binary packages. We now use the Bitstream Vera one by default.

 -- Craig Small <csmall@debian.org>
