prewikka for Debian
-------------------

The Prewikka installation guide is available at:
https://trac.prelude-ids.org/wiki/InstallingPrewikka


Editing prewikka.conf
=====================

Once you have created the database for Prewikka you need to edit /etc/prewikka/prewikka.conf to fit your database settings prior to starting Prewikka.
The debian installation script will try to create the database and set the values, for the [database] section ONLY.
Even if you used the installer to create the database and tables, you will need to edit the configuration file for
other values.

[interface]
#This is the name at the top right and left of the Prewikka interface
#You can change it or leave as is
software: Prewikka
place: company ltd.
title: Prelude management

#The following are the setting for your prelude database
[idmef_database]
type: mysql
host: localhost
user: prelude
pass: prelude
name: prelude

#This is the database information for the prewikka DB you created above
[database]
type: mysql
host: localhost
user: prewikka
pass: prewikka
name: prewikka

#You can comment this out to stop logs from writing to stderr
[log stderr]

#No real need to edit this except to increase/decrease expiration time
[auth loginpassword]
expiration: 60





Choose one of the following methods to configure your web server:

Running Prewikka from the Apache web server (CGI/Apache)
========================================================

Apache / CGI setup with VirtualHost
-----------------------------------

<VirtualHost *:80>
 ServerName my.server.org
 Setenv PREWIKKA_CONFIG "/etc/prewikka/prewikka.conf"

<Location "/">
        AllowOverride None
        Options ExecCGI

        <IfModule mod_mime.c>
                AddHandler cgi-script .cgi
        </IfModule>

        Order allow,deny
        Allow from all
</Location>

Alias /prewikka/ /usr/share/prewikka/htdocs/
ScriptAlias / /usr/share/prewikka/cgi-bin/prewikka.cgi

</VirtualHost>

Note that the PREWIKKA_CONFIG environment variable is optional, if unset the default configuration file relative to your installation path will be used.


Apache / mod_python setup with VirtualHost
------------------------------------------

Experimental mod_python support is available in Prewikka starting from rc9.

<VirtualHost *:80>
        ServerName my.server.org
        
        <Location />
                SetHandler mod_python
                PythonHandler prewikka.ModPythonHandler
                PythonOption PrewikkaConfig /etc/prewikka/prewikka.conf
        </Location>

        <Location /prewikka>
                SetHandler None
        </Location>

        Alias /prewikka /usr/share/prewikka/htdocs
</VirtualHost>

Note that the PrewikkaConfig? settings is optional, if unset the default configuration file relative to your installation path will be used.



Running Prewikka from the command line tool
===========================================

If you didn't install Prewikka system wide (ie: you specified a prefix), use:

   $ PYTHONPATH=$prefix/lib/python2.4/site-packages $prefix/bin/prewikka-httpd

If you installed Prewikka system wide:

   $ /usr/bin/prewikka-httpd

You can then use your browser to connect to your machine on port 8000. The default login/password is admin please remember to change it.



Initial login
=============

Once everything is setup, you can use your browser to connect to the machine were Prewikka was installed. If you are not using Apache support, then remeber you should use the port 8000 to access Prewikka.

The default login/password is admin please remember to change it.


 -- Pierre Chifflier <chifflier@cpe.fr>  Wed,  7 Feb 2007 16:51:26 +0100
