last changed: 05.03.2006    
Monitoring Tools Documentation
About     Doxygen Documentation     Download     Installation

I. Components
  1. Server

    The log file parser "Server" only deals with the current srbLog file and with the latest srbLog*.gz file. The start script "start_server.py" can be run as a daemon and can be stopped with the script "stop_server.sh".


  2. Client

    The log file parser "Client" is handeling the database issues concerning inserting the error messages. For each parsing event, a mail can be send to people spezified in the config file (config_client.ini). The start script "start_client.py" also can be run as a daemon and can be stopped with the script "stop_client.sh".


  3. Visualiser

    The "Visualiser" can be used to query the database. The results can be displayed in a graph. The graph can be saved as a postscript file for further usage.


  4. Remote Controller

    With the "Remote Controller" the parsing behaviour of the server can be influenced.


  5. GZ Parser

    The "GZ Parser" can be used to work up all the older srbLog*.gz files. The XML files are placed in the server directory where the client can access the files.
II. Requirements
  1. Server

    • Python 2.2.3 or higher
    • M2Crypto 0.13
    • egrep
    • awk


  2. Client

    • Python 2.2.3 or higher
    • M2Crypto 0.13
    • sqlite 2.8.16
    • pysqlite 1.0.1
    • egrep
    • awk


  3. Visualiser

    • Python 2.2.3 or higher
    • sqlite 2.8.16
    • pysqlite 1.0.1


  4. Remote Controller

    • Python 2.2.3 or higher
    • M2Crypto 0.13


  5. GZ Parser

    • Python 2.2.3 or higher
III. Installations
  1. M2Crypto 0.13

    M2Crypto is a Python interface to OpenSSL.

    $ unzip m2crypto-0.13.zip
    $ cd m2crypto-0.13
    $ python setup.py build
    # python setup.py install


    or if you want to install it locally

    $ python setup.py install --home=/home/yourhome/yourpath_to_the_desired_folder
    $ cd tests # optional
    $ python alltests.py # optional


  2. sqlite 2.8.16

    SQLite is a small C library that implements a self-contained, embeddable, zero-configuration SQL database engine.

    $ tar -xzf sqlite-2.8.16.tar.gz
    $ cd sqlite-2.8.16
    $ ./configure


    or if you want to install it locally

    $ ./configure --prefix=/home/yourhome/yourpath_to_the_desired_folder
    $ make
    # make install


    or if you want to install it locally

    $ make install


  3. pysqlite 1.0.1

    Pysqlite is a Python DB-API 2.0 interface for the SQLite embedded relational database engine.

    $ tar -xzf pysqlite-1.0.1.tar.gz
    $ cd pysqlite
    $ python setup.py build
    # python setup.py install


    or if you want to install it locally

    $ python setup.py install --home=/home/yourhome/yourpath_to_the_desired_folder

    You might have to export the python path, if you use the local installation

    $ export PYTHONPATH=/home/yourhome/yourpath_to_the_desired_folder/lib/Python


    You can use the module test_modules.py to check if all necessary modules are installed.


  4. Server

    Make sure you edit the configuration and keyword file properly beforehand.

    $ python start_server.py -c config config_server.ini [optional parameters]

    Enter python start_server.py -h for more information. A bash script for stopping the server is provided too -> ./stop_server.


  5. Client

    Make sure you edit the configuration file properly beforehand.

    $ python start_client.py -c config config_client.ini [optional parameters]

    Enter python start_client.py -h for more information. A bash script for stopping the client is provided too -> ./stop_client.


  6. Virtualiser

    Make sure you edit the configuratin file beforehand.

    $ python gui.py -c config_gui.ini [optional parameters]

    Enter python gui.py -h for more information and usage examples.


  7. Remote Controller

    Make sure you edit the configuratin file beforehand.

    $ python admin_server.py -c config_admin.ini [optional parameters]

    Enter python admin_server.py -h for more information and usage examples.


  8. GZ Parser

    Make sure you edit the configuration and keyword file beforehand.

    $ python gz_parser.py -c config_gz_parser.ini [optional parameters]

    Enter python gz_parser.py -h for more information.

User manuals to for the applications 4 - 7 can be found in the appendix of the dissertation.
Created 2006 by Andrea Weise (Content) and Tomáš Bžatek (Design) - best viewed with Opera