Installing and configuring prewikka

 

 

Files included for the distribution (prewikka-0.9.5.tar)

NCSA/Mithril version (prewikka-0.9.5_ncsa.tar)

 

If this is a reinstall, make sure that all prewikka remnants are cleaned up. This includes everything in the following directories, files and the mysql database prewikka.

 

/etc/prewikka/

/usr/share/prewikka/

/usr/lib/python2.3/site-packages/prewikka/

and the daemon /usr/bin/prewikka-httpd

 

First of all, extract the files from prewikka-0.9.5.tar into /etc/prewikka

From /etc/prewikka/prewikka-0.9.5/

 

1) Run the setup

python setup.py install

 

2) Create the mysql database prewikka with the following steps:

 

mysql -u root -p
mysql> CREATE database prewikka;
GRANT ALL PRIVILEGES ON prewikka.* TO prewikka@'localhost' IDENTIFIED BY 'password';
$ mysql -u prewikka prewikka -p < /usr/share/prewikka/database/mysql.sql

 

3) Configure by editing /etc/prewikka/prewikka.conf

 

[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: NCSA
title: Prelude/Mithril
 
#The following are the setting for your prelude database
[idmef_database]
type: mysql
host: localhost
user: prelude
pass: <password>
name: prelude
 
#This is the database information for the prewikka DB you created above
[database]
type: mysql
host: localhost
user: prewikka
pass: <password>
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

 

4) Configure apache2 by editing /etc/apache2/apache2.conf

 

Add the following at the end of the file then restart apache2:

 

Alias /prewikka/prewikka/ /etc/prewikka/prewikka-0.9.5/htdocs/

ScriptAlias /prewikka/ /etc/prewikka/prewikka-0.9.5/cgi-bin/prewikka.cgi

<Directory /etc/prewikka/prewikka-0.9.5/htdocs/>

    Options None

    AllowOverride None

    Order allow,deny

    Allow from all

</Directory>

<Directory /etc/prewikka/prewikka-0.9.5/cgi-bin/>

    AllowOverride None

    Options ExecCGI

    <IfModule mod_mime.c>

        AddHandler cgi-script .cgi

    </IfModule>

    Order allow,deny

    Allow from all

</Directory>

 

5) test prewikka from the command line

 

/usr/bin/prewikka-httpd

 

6) run prewikka through the browser

 

http://pkirack3/prewikka/

 

7) initially there is only one user admin/admin

   add another with al privileges, then delete the admin

 

8) Modifications –

   do all in /etc/prewikka/prewikka-0.9.5/

   then run ‘python setup.py install’

   to build and distribute the changes

 

a)    Adding a shell command to a drop-down menu for an IP address link

      - in general, follow the insertions for other commands

      - changes need to be made in:

        prewikka.conf – add the command name and path

        commands.py – add an appropriate class

                      e.g. class example(HostCommand):

                               view_name = "example"

                               command = "example"

       

        messagelisting.py – add “example” to the list on line 322

                      e.g. for command in "netstat", "nmap", "traceroute", "whois", "ipdrop", “example”:

 

        __init__.py – add the appropriate object

                      e.g. commands.Example()

 

        finally - run ‘python setup.py install’