updated some specifics on database and syslogds

This commit is contained in:
Rainer Gerhards 2008-04-24 11:50:59 +02:00
parent 579a564f2c
commit 93bd2430e0

109
INSTALL
View File

@ -1,47 +1,62 @@
phpLogCon Installation help
----------------------------------
To install phpLogCon, you will need:
* Apache or IIS Webserver
* PHP5
Optionally, you may need:
* MySQL Database
Installation in Detail
----------------------
1. Upload all files from the phplogcon/src/ folder to you webserver.
The other files are not needed on the webserver.
2. If you webserver has write access to the phplogcon folder,
you can skip the following step:
Upload the scripts configure.sh and secure.sh from the
contrib folder to your webserver, and set the execution
flag to them (chmod +x configure.sh secure.sh).
Now run ./configure.sh, this will create a blank config.php,
and will also set write access to everyone to it.
You can of course do this manually if you want.
3. Now open your phplogcon installation in your favourite webbrowser,
you will see an error, and you will be pointed to the installation
script. The install script will guide you through the phplogcon
installation, just follow the instructions.
4. If everything went right, you should see syslog messages already
in your phplogcon installation. You can now remove the install.php
script now.
Note on MySQL Databases
--------------------------------
phpLogCon does support using a MySQL database as syslog source.
Currently we support the Adiscon WinSyslog database schema, and
partionally the SyslogNG database schema.
phpLogCon Installation help
----------------------------------
To install phpLogCon, you will need:
* Apache or IIS Webserver
* PHP5
Optionally, you may need:
* MySQL Database
For obvious reasons, you also need some syslog data. Any standard
syslogd will do. From a feature and stability point of view, we
recommend either one of these (which we also wrote ;)):
- WinSyslog (for Windows Environments - http://www.winsyslog.com)
- rsyslog (for Linux/Unix Environments - http://www.rsyslog.com)
Both of them are also capable to writing to a database. Rsyslog is
a drop-in replacement for stock syslogd and also *is* the stock
syslogd on some platforms (e.g. Fedora 8 and above).
Installation in Detail
----------------------
1. Upload all files from the phplogcon/src/ folder to you webserver.
The other files are not needed on the webserver.
2. If you webserver has write access to the phplogcon folder,
you can skip the following step:
Upload the scripts configure.sh and secure.sh from the
contrib folder to your webserver, and set the execution
flag to them (chmod +x configure.sh secure.sh).
Now run ./configure.sh, this will create a blank config.php,
and will also set write access to everyone to it.
You can of course do this manually if you want.
3. Now open your phplogcon installation in your favourite webbrowser,
you will see an error, and you will be pointed to the installation
script. The install script will guide you through the phplogcon
installation, just follow the instructions.
4. If everything went right, you should see syslog messages already
in your phplogcon installation. You can now remove the install.php
script now.
Note on MySQL Databases
--------------------------------
phpLogCon does support using a MySQL database as syslog source.
PhpLogCon supports Adiscon's MonitorWare database schema. The schema
used by php-syslog-ng is also partly supported. That schema, however, is
somewhat inefficient in that it stores facility and severity codes as
textual values. We do not currently convert these values back to their
native format and consequently facility and severity can not be taken
from a php-syslog-ng database.