
How to Install 
----------------

1.  If you installed from RPM skip to step 4

2.  If you install from tar.gz instead of RPM, move
    featurekong_httpd.conf to your /etc/httpd/conf.d 
    directory or paste the contents to your httpd.conf.
    You will need to update it with the location 
    of featurekong_startup.pl.    

3.  Edit featurekong_startup.pl with the location
    of where you unpacked the featurekong files.

4.  If MySQL is not running, install and start it.

    /etc/init.d/mysql start

5.  Optionally change the root database password from
    the default of empty.

    mysqladmin -u root passwd

6.  Optionally create a non-root database user with 
    selective permissions for FeatureKong.  

   bash# mysql -u root -p mysql
   mysql> GRANT SELECT,INSERT,UPDATE,DELETE,INDEX,
   ALTER,CREATE,DROP,REFERENCES ON kong.* TO kong@localhost IDENTIFIED BY
   'fkong_password';
   mysql> FLUSH PRIVILEGES;
   mysql> quit

7.  Edit the database connection parameter at the top of 
    featurekong_startup.pl 

8.  Run ./checksetup.pl to create or update the databases 
    and create a first administrator account.
    Whenever you upgrade you will need to rerun
    ./checksetup.pl.

9.  Start or restart your web server.

    /etc/init.d/httpd restart

10. Use a web browser to connect to FeatureKong at
    http://localhost/fkong



Security
-----------------

FeatureKong runs inside your web server process for 
speed.  Unfortunately, it means anyone who can run
code as that unix user, such as a CGI writer, can obtain
the database passwords of FeatureKong.  If this
is a problem for you, consider running two instances
of Apache, and having one (port 80 with CGI) proxy to the 
other (non-standard port, only loopback, with featurekong).

Likewise, you must worry about the permissions of the
featurekong_startup.pl script because it has the database passwords.
If you installed from RPM, then your permissions should be
fine.

Anyone who can modify the FeatureKong modules (*.pm files)
or create new modules in the FeatureKong directory, 
would also be able to steal the database password.

FeatureKong does not store passwords directly in the
database but instead stores a MD5 hash of the password.


Customization
---------------

Consider editing the template in the html/templates 
directory.  They use keywords surrounded by double curly
braces.  To see the elligible keywords turn on debug
mode (either in featurekong_startup.pl or the Toggle
debug link at the bottom of the administrator's pages.)

Bugs
----------
  software@fdd.com and please put fkong in the subject







